complex-range 1.0.0__py3-none-any.whl → 1.0.0.post1__py3-none-any.whl

{complex_range-1.0.0.dist-info → complex_range-1.0.0.post1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: complex-range
-Version: 1.0.0
+Version: 1.0.0.post1
 Summary: Generate ranges of complex numbers - rectangular grids and linear sequences in the complex plane
 Author-email: Daniele Gregori <dangregori@gmail.com>
 Maintainer-email: Daniele Gregori <dangregori@gmail.com>
@@ -71,15 +71,17 @@ line = complex_range([0, 3+3j])
 # [0j, (1+1j), (2+2j), (3+3j)]
 ```
 
-## Features
+## Overview
+
+`complex_range` generates ranges of complex numbers, extending Python's `range` functionality to the complex plane. It supports two modes:
+
+- **Rectangular ranges**: Generate all points on a 2D grid spanning from minimum to maximum real and imaginary parts
+- **Linear ranges**: Generate points along a line between two complex numbers
+
+Step sizes can be specified as a complex number (e.g., `0.5+0.5j`) or as separate real and imaginary steps in list form (e.g., `[0.5, 0.5]`). By default, the imaginary part is incremented first throughout its range with the real part fixed, then the real part is incremented—this behavior can be reversed via the `increment_first` option.
+
+The `farey_range` option enables a complex generalization of the Farey sequence, creating mathematically refined point distributions in the complex plane.
 
-- **Rectangular ranges**: Generate 2D grids of complex numbers
-- **Linear ranges**: Generate points along a line in the complex plane
-- **Flexible step sizes**: Control spacing independently for real and imaginary axes
-- **Negative steps**: Support for descending ranges with negative step values
-- **Farey sequence subdivision**: Create refined grids using number-theoretic sequences
-- **Iteration order control**: Choose whether to iterate real or imaginary component first
-- **Pure Python**: No dependencies required
 
 ## Usage
 
@@ -87,6 +89,16 @@ line = complex_range([0, 3+3j])
 
 Generate a grid of complex numbers between two corners:
 
+```
+Im ↑
+ 3 │  ·  ·  ·
+ 2 │  ·  ·  ·
+ 1 │  ·  ·  ·
+ 0 │  ·  ·  ·
+   └──────────→ Re
+      0  1  2
+```
+
 ```python
 from complex_range import complex_range
 
@@ -107,10 +119,25 @@ complex_range(0, 4+6j, [2, 3])
 # Real step = 2, Imaginary step = 3
 ```
 
+With `increment_first='im'` (default), points are generated column by column:
+`(0,0), (0,1), (0,2), (0,3), (1,0), (1,1), ...`
+
 ### Linear Ranges
 
 Generate points along a line (diagonal) in the complex plane:
 
+```
+Im ↑
+ 3 │        ·
+ 2 │     ·
+ 1 │  ·
+ 0 │·
+   └──────────→ Re
+   0  1  2  3
+```
+
+Points increment along both axes simultaneously.
+
 ```python
 # Linear from 0 to endpoint
 complex_range([3+3j])
@@ -168,11 +195,11 @@ farey_sequence(3)
 # [Fraction(0,1), Fraction(1,3), Fraction(1,2), Fraction(2,3), Fraction(1,1)]
 ```
 
-## API Reference
+## Syntax
 
 ### `complex_range(z1, z2=None, step=None, *, increment_first='im', farey_range=False)`
 
-Generate a range of complex numbers.
+Generates a range of complex numbers.
 
 **Parameters:**
 
@@ -200,41 +227,6 @@ Generate the Farey sequence of order n.
 
 **Returns:** `List[Fraction]` - Sorted list of fractions in [0, 1]
 
-## Understanding the Ranges
-
-### Rectangular Range
-
-A rectangular range generates all points on a 2D grid:
-
-```
-Im ↑
- 3 │  ·  ·  ·
- 2 │  ·  ·  ·
- 1 │  ·  ·  ·
- 0 │  ·  ·  ·
-   └──────────→ Re
-      0  1  2
-```
-
-With `increment_first='im'` (default), points are generated column by column:
-`(0,0), (0,1), (0,2), (0,3), (1,0), (1,1), ...`
-
-### Linear Range
-
-A linear range generates points along a diagonal:
-
-```
-Im ↑
- 3 │        ·
- 2 │     ·
- 1 │  ·
- 0 │·
-   └──────────→ Re
-   0  1  2  3
-```
-
-Points increment along both axes simultaneously.
-
 ## Examples
 
 ### Visualizing a Rectangular Grid
@@ -264,16 +256,19 @@ from complex_range import complex_range
 coarse = complex_range(0, 2+2j, 1+1j)
 
 # Refined grid using Farey sequence
-refined = complex_range(0, 2+2j, 2+2j, farey_range=True)
+refined = complex_range(0, 2+2j, 3+3j, farey_range=True)
 print(f"Coarse: {len(coarse)} points, Refined: {len(refined)} points")
 ```
 
-### Iterating Over Complex Regions
+## Applications
+
+### Mandelbrot Set Visualization
 
 ```python
 from complex_range import complex_range
+import matplotlib.pyplot as plt
+import numpy as np
 
-# Evaluate a function over a region of the complex plane
 def mandelbrot_escape(c, max_iter=100):
     z = 0
     for i in range(max_iter):
@@ -282,49 +277,40 @@ def mandelbrot_escape(c, max_iter=100):
             return i
     return max_iter
 
-# Create a grid and evaluate
-grid = complex_range(-2-1.5j, 1+1.5j, [0.1, 0.1])
-escapes = [mandelbrot_escape(c) for c in grid]
-```
-
-## Author
-
-**Daniele Gregori**
-
-- Original [Wolfram Language ComplexRange](https://resources.wolframcloud.com/FunctionRepository/resources/ComplexRange/) function
-- Python implementation
+# Grid parameters
+re_min, re_max = -2, 1
+im_min, im_max = -1.5, 1.5
+step = 0.005
 
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-```bash
-# Clone the repository
-git clone https://github.com/Daniele-Gregori/PyPI-packages.git
-cd PyPI-packages/packages/complex-range
+# Generate grid and compute escape times
+grid = complex_range(re_min + im_min*1j, re_max + im_max*1j, [step, step])
+escapes = [mandelbrot_escape(c) for c in grid]
 
-# Install development dependencies
-pip install -e ".[dev]"
+# Reshape and plot
+n_re = int((re_max - re_min) / step) + 1
+n_im = int((im_max - im_min) / step) + 1
+escape_array = np.array(escapes).reshape(n_re, n_im).T
 
-# Run tests
-pytest
+plt.figure(figsize=(10, 8))
+plt.imshow(escape_array, extent=[re_min, re_max, im_min, im_max],
+           origin='lower', cmap='hot', aspect='equal')
+plt.colorbar(label='Escape iterations')
+plt.xlabel('Real')
+plt.ylabel('Imaginary')
+plt.title('Mandelbrot Set')
+plt.savefig('mandelbrot.png', dpi=150)
+plt.show()
+```
 
-# Run type checking
-mypy src/complex_range
+![Mandelbrot Set](mandelbrot.png)
 
-# Format code
-black src tests
-isort src tests
-```
 
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## Acknowledgments
+## See Also
 
-Original [Wolfram Language ComplexRange](https://resources.wolframcloud.com/FunctionRepository/resources/ComplexRange/) resource function contributed by Daniele Gregori and reviewed by the Wolfram Review Team.
+Original [Wolfram Language "ComplexRange"](https://resources.wolframcloud.com/FunctionRepository/resources/ComplexRange/)  resource function contributed by Daniele Gregori and reviewed by the Wolfram Review Team.
 
-## Changelog
 
-See [CHANGELOG.md](CHANGELOG.md) for a list of changes.

complex_range-1.0.0.post1.dist-info/RECORD

@@ -0,0 +1,10 @@
+complex_range/__init__.py,sha256=hZC54Rv4f2Zvha7IDM-DngPqqwDYFugErkzGSLir7-Y,779
+complex_range/core.py,sha256=pgq185F5KX3hjju7k4bGJoeMegarncoAHx2-Y20wd-Y,18196
+complex_range/dev.py,sha256=I2uaDDWVMJoDfdRPZin-0XTKElRz3ianknT_7oOrPws,929
+complex_range/farey.py,sha256=xDcZSJi1h2vMtghkP8TbaEc2dqHbGc4_C7UaD1H6qS0,2305
+complex_range/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+complex_range-1.0.0.post1.dist-info/licenses/LICENSE,sha256=S2_QCHbwpFs9uShfKzzbIYGKLwPhrlcUUVZnpieCdDU,1072
+complex_range-1.0.0.post1.dist-info/METADATA,sha256=thWiQketttG8tf13cct-praJ70iEHpv3YrOhJ0Ql228,9421
+complex_range-1.0.0.post1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+complex_range-1.0.0.post1.dist-info/top_level.txt,sha256=AjyB3ZnFm0s9ReE4FvZzVKfwOJ62TI7NU_ieImIlutk,14
+complex_range-1.0.0.post1.dist-info/RECORD,,

complex_range-1.0.0.dist-info/RECORD

@@ -1,10 +0,0 @@
-complex_range/__init__.py,sha256=hZC54Rv4f2Zvha7IDM-DngPqqwDYFugErkzGSLir7-Y,779
-complex_range/core.py,sha256=pgq185F5KX3hjju7k4bGJoeMegarncoAHx2-Y20wd-Y,18196
-complex_range/dev.py,sha256=I2uaDDWVMJoDfdRPZin-0XTKElRz3ianknT_7oOrPws,929
-complex_range/farey.py,sha256=xDcZSJi1h2vMtghkP8TbaEc2dqHbGc4_C7UaD1H6qS0,2305
-complex_range/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-complex_range-1.0.0.dist-info/licenses/LICENSE,sha256=S2_QCHbwpFs9uShfKzzbIYGKLwPhrlcUUVZnpieCdDU,1072
-complex_range-1.0.0.dist-info/METADATA,sha256=zcL9a78XhglVg2qIR1emviUJr7h8ey1tJFxtM-Kh-b4,9311
-complex_range-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-complex_range-1.0.0.dist-info/top_level.txt,sha256=AjyB3ZnFm0s9ReE4FvZzVKfwOJ62TI7NU_ieImIlutk,14
-complex_range-1.0.0.dist-info/RECORD,,