Welcome to pynoise’s documentation!

pynoise is a modular coherent noise generation system. With pynoise you can combine various noise sources and operations to create interesting effects.

pynoise aims to be a complete, “batteries included” package, enabling a user to generate, manipulate and render noise in a single package.

As an example, here is how to output a grayscale 512x512 image of some Perlin noise:

from pynoise.noisemodule import *
from pynoise.noiseutil import *

width, height = 512, 512
perlin = Perlin()
noise_map = noise_map_plane(width, height, 2, 6, 1, 5, perlin)
gradient = grayscale_gradient()

render = RenderImage()
render.render(noise_map, width, height, 'perlin.png', gradient)

Features

  • Base noise modules:
    • Perlin
    • Ridged Multi-Fractal
    • Voronoi
    • Sphere
    • Cylinders
    • Checkerboard
    • Billow
    • Const
  • Noise module modifiers:
    • Abs
    • Add
    • Blend
    • Clamp
    • Curve
    • Displace
    • Exponent
    • Invert
    • Max
    • Min
    • Multiply
    • Power
    • RotatePoint
    • ScaleBias
    • ScalePoint
    • Select
    • Terrace
    • TranslatePoint
    • Turbulence

Installation

Install the project by running:

pip install pynoise

Support

If you have any issues, please email me at tim at timchi dot me

License

This is licensed under MPL 2.0