opensimplex-loops 1.0.1

looping_animated_2D_image()

Seamlessly-looping animated 2D images.

Code: demos/demo_looping_animated_2D_image.py

looping_animated_closed_1D_curve()

Seamlessly-looping animated 1D curves, each curve in turn also closing up seamlessly back-to-front.

Code: demos/demo_looping_animated_circle.py

Code: demos/demo_looping_animated_closed_1D_curve.py

tileable_2D_image()

Seamlessly-tileable 2D image.

Code: demos/demo_tileable_2D_image.py

looping_animated_2D_image(...)

Generates a stack of seamlessly-looping animated 2D raster images drawn from 4D OpenSimplex noise.

The first two OpenSimplex dimensions are used to describe a plane that gets projected onto a 2D raster image. The last two dimensions are used to describe a circle in time.

Args:

N_frames (int, default = 200)

Number of time frames

N_pixels_x (int, default = 1000)

Number of pixels on the x-axis

N_pixels_y (int | None, default = None)

Number of pixels on the y-axis. When set to None N_pixels_y will be set equal to N_pixels_x.

t_step (float, default = 0.1)

Time step

x_step (float, default = 0.01)

Spatial step in the x-direction

y_step (float | None, default = None)

Spatial step in the y-direction. When set to None y_step will be set equal to x_step.

dtype (type, default = numpy.double)

Return type of the noise array elements. To reduce the memory footprint one can change from the default numpy.double to e.g. numpy.float32.

seed (int, default = 3)

Seed value for the OpenSimplex noise

verbose (bool, default = True)

Print ‘Generating noise…’ to the terminal? If the numba_progress package is present a progress bar will also be shown.

Returns:

The 2D image stack as 3D array [time, y-pixel, x-pixel] containing the OpenSimplex noise values as floating points. The output is garantueed to be in the range [-1, 1], but the exact extrema cannot be known a-priori and are probably quite smaller than [-1, 1].

looping_animated_closed_1D_curve(...)

Generates a stack of seamlessly-looping animated 1D curves, each curve in turn also closing up seamlessly back-to-front, drawn from 4D OpenSimplex noise.

The first two OpenSimplex dimensions are used to describe a circle that gets projected onto a 1D curve. The last two dimensions are used to describe a circle in time.

Args:

N_frames (int, default = 200)

Number of time frames

N_pixels_x (int, default = 1000)

Number of pixels of the curve

t_step (float, default = 0.1)

Time step

x_step (float, default = 0.01)

Spatial step in the x-direction

dtype (type, default = numpy.double)

Return type of the noise array elements. To reduce the memory footprint one can change from the default numpy.double to e.g. numpy.float32.

seed (int, default = 3)

Seed value for the OpenSimplex noise

verbose (bool, default = True)

Print ‘Generating noise…’ to the terminal? If the numba_progress package is present a progress bar will also be shown.

Returns:

The 1D curve stack as 2D array [time, x-pixel] containing the OpenSimplex noise values as floating points. The output is garantueed to be in the range [-1, 1], but the exact extrema cannot be known a-priori and are probably quite smaller than [-1, 1].

tileable_2D_image(...)

Generates a seamlessly-tileable 2D raster image drawn from 4D OpenSimplex noise.

The first two OpenSimplex dimensions are used to describe a circle that gets projected onto the x-axis of the 2D raster image. The last two dimensions are used to describe another circle that gets projected onto the y-axis of the 2D raster image.

Args:

N_pixels_x (int, default = 1000)

Number of pixels on the x-axis

N_pixels_y (int | None, default = None)

Number of pixels on the y-axis. When set to None N_pixels_y will be set equal to N_pixels_x.

x_step (float, default = 0.01)

Spatial step in the x-direction

y_step (float | None, default = None)

Spatial step in the y-direction. When set to None y_step will be set equal to x_step.

dtype (type, default = numpy.double)

Return type of the noise array elements. To reduce the memory footprint one can change from the default numpy.double to e.g. numpy.float32.

seed (int, default = 3)

Seed value for the OpenSimplex noise

verbose (bool, default = True)

Print ‘Generating noise…’ to the terminal? If the numba_progress package is present a progress bar will also be shown.

Returns:

The 2D image as 2D array [y-pixel, x-pixel] containing the OpenSimplex noise values as floating points. The output is garantueed to be in the range [-1, 1], but the exact extrema cannot be known a-priori and are probably quite smaller than [-1, 1].

1.0.1 (2024-08-12)

• Obtained a DOI from Zenodo

1.0.0 (2023-08-27)

• Stable release

• Added looping animated circle demo

0.1.3 (2023-01-27)

• Fixed wrong docstr description on the return value of tileable_2D_image()

• Generalized the internal functions

0.1.2 (2023-01-26)

• Using raw.githubusercontent.com for the images in README to show up in PyPi

0.1.0 (2023-01-26)

• First release on PyPI