# Uniformly Distributed Perlin Noise

**URL:** <https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768>\
**Category:** Gallery\
**Created:** [August 17, 2021, 6:50pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768 "2021-08-17T18:50:43Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![micycle](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/micycle/32/201_2.png) [@micycle](https://discourse.processing.org/u/micycle)\
**Post date:** [August 17, 2021, 6:50pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/1 "2021-08-17T18:50:43Z")

</div>

## Problem

Processing’s noise implementation has many issues:

- Repeats after a very small cycle in the x and y axes.
- Strange repeating motion in z axis.
- Block-like pattern/artefacts
- Normally distributed (bell-curve distribution). Sometimes this is good, but I’d say this is generally undesirable in creative coding, and particularly undesirable for color generation (as exemplified below).

## Solution

To mainly solve the fourth point, I created a small library that outputs noise values that are **uniformly distributed** between [0, 1]. In most of my use-cases (in creative coding and elsewhere) this distribution is much more desirable. Not only that, the library wraps [FastNoiseLite](https://github.com/Auburn/FastNoiseLite) providing “much better quality” noise compared the abysmal offering in Processing.

> **[GitHub - micycle1/UniformNoise: Fast uniformly distributed Perlin noise](https://github.com/micycle1/UniformNoise/tree/main)**
>
> main

## Comparison

Images showing Processing’s `noise()` on the left verrsus _UniformNoise_ on the right.

### Octaves = 1

 ![image](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/f/fad427c824ec794898aa9ce5b6d81f9d9e051d45.jpeg)

### Octaves = 4

 ![image](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/1/17f5bf54150beb6cd536bc97f460dd926c9d3a0e.jpeg)

### Octaves = 16

 ![octaves=16](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/1/182dccefffb9267331b926a2aa2846a3b7379a6e.jpeg)

### Small scale, octaves = 4

 ![image](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/5/59db55ddcc2a8e59bc3bc4428f1e627da78e4834.jpeg)

### Sketch Code

> **Code...**
>
> ```auto
> import micycle.uniformnoise.*;
> 
> UniformNoise noise;
> 
> int octaves = 4;
> 
> void setup() {
> size(800, 800);
> loadPixels();
> noise = new UniformNoise();
> noiseDetail(octaves);
> }
> 
> void draw() {
> float scale = 1;
> for (int y = 0; y < height; y++) {
> for (int x = 0; x < width; x++) {
> float val;
> int col;
> if (x < width/2) {
> val = noise(x * 0.015f*scale, y * 0.015f*scale, frameCount*0.035f);
> col = hsbToRgb(val, 1, 1);
> } else {
> val = noise.uniformNoise(x * 0.0085f*scale, y * 0.0085f*scale, frameCount*0.01f, octaves, 0.5f);
> col = hsbToRgb(val, 1, 1);
> }
> pixels[y * width + x] = col;
> }
> }
> updatePixels();
> }
> 
> public static int hsbToRgb(float hue, float saturation, float value) {
> float r = 0, g = 0, b = 0;
> 
> int h = (int)(hue * 6);
> float f = hue * 6 - h;
> float p = value * (1 - saturation);
> float q = value * (1 - f * saturation);
> float t = value * (1 - (1 - f) * saturation);
> 
> if (h == 0) {
> r = value;
> g = t;
> b = p;
> } else if (h == 1) {
> r = q;
> g = value;
> b = p;
> } else if (h == 2) {
> r = p;
> g = value;
> b = t;
> } else if (h == 3) {
> r = p;
> g = q;
> b = value;
> } else if (h == 4) {
> r = t;
> g = p;
> b = value;
> } else if (h <= 6) {
> r = value;
> g = p;
> b = q;
> }
> return -16777216 | ((int) (r*255) << 16 | (int) (g*255) << 8 | (int) (b*255));
> }
> 
> ```

---

<div class="post-metadata">

**Author:** ![glv](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/glv/32/18785_2.png) [@glv](https://discourse.processing.org/u/glv)\
**Post date:** [August 18, 2021, 1:57pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/2 "2021-08-18T13:57:06Z")

</div>

> [@micycle](#):
>
> Not only that, the library wraps [FastNoiseLite](https://github.com/Auburn/FastNoiseLite) providing “much better quality” noise compared the abysmal offering in Processing.

This may provide some context to the use of Perlin noise in Processing:

[![](https://img.youtube.com/vi/Lv9gyZZJPE0/maxresdefault.jpg "I.7 : What is OpenSimplex Noise?") ](https://www.youtube.com/watch?v=Lv9gyZZJPE0)

Processing reference:

> **[noise() / Reference](https://processing.org/reference/noise_.html)**
>
> Returns the Perlin noise value at specified coordinates. Perlin noise is a random sequence generator producing a more natural, harmonic succession of numbers than that of the standard random() …

`:)`

---

<div class="post-metadata">

**Author:** ![monkstone](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/monkstone/32/64_2.png) [@monkstone](https://discourse.processing.org/u/monkstone)\
**Post date:** [August 25, 2021, 2:10pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/3 "2021-08-25T14:10:23Z")

</div>

I thought I would compare JRubyArt noise (derived from [KdotJPG OpenSimplex2](https://github.com/KdotJPG/OpenSimplex2)) to see how that would fare, here is the test code:-

```ruby
load_library :uniform_noise

java_import 'micycle.uniformnoise.UniformNoise'
java_import 'java.awt.Color'

OCTAVES = 4

def setup
  sketch_title 'Uniform Noise Test'
  load_pixels
  @unoise = UniformNoise.new
end

def draw
  grid(width, height) do |x, y|
    val = if x < width / 2
            (noise(x * 0.015, y * 0.015, frame_count * 0.035) + 1) / 2
          else
            @unoise.uniform_noise(x * 0.0085, y * 0.0085, frame_count * 0.01, OCTAVES, 0.5)
          end
    col = Color.HSBtoRGB(val, 1, 1)
    pixels[y * width + x] = col
  end
  update_pixels
end

def settings
  size(800, 800)
end

```

Here is the result

 ![noise_test](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/2X/f/f2e523b33c0c67e07b359227327d07a6a1b59791.jpeg)

The uniform noise is clearly the winner here, but OpenSimplex2 is an improvement over the processing “perlin noise”. There is even a variation that is more suitable for creating terrains.

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 29, 2022, 2:55pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/4 "2022-07-29T14:55:50Z")

</div>

This is immensely useful to me. Thanks for writing the library and sharing it. Now, pardon me being a total Java n00b, but how do I install UniformNoise in my Processing 4 library folder? Can’t seem to find it via the Contribution Manager. Thanks!

---

<div class="post-metadata">

**Author:** ![GoToLoop](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/gotoloop/32/86_2.png) [@GoToLoop](https://discourse.processing.org/u/GoToLoop)\
**Post date:** [July 29, 2022, 3:05pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/5 "2022-07-29T15:05:50Z")

</div>

> [@stixan](#):
>
> Can’t seem to find it via the Contribution Manager.

I don’t think @micycle had published it there yet.

Either download & drag the “.jar” file from the link below into your sketch:

> **[Releases · micycle1/UniformNoise](https://github.com/micycle1/UniformNoise/releases)**
>
> Fast uniformly distributed Perlin noise. Contribute to micycle1/UniformNoise development by creating an account on GitHub.

Or download all the “.java” files and paste them into your sketch’s root folder:

> **[UniformNoise/src/main/java/micycle/uniformnoise at main · micycle1/UniformNoise](https://github.com/micycle1/UniformNoise/tree/main/src/main/java/micycle/uniformnoise)**
>
> Fast uniformly distributed Perlin noise. Contribute to micycle1/UniformNoise development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 29, 2022, 5:41pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/6 "2022-07-29T17:41:19Z")

</div>

I really appreciate your fast response, @GoToLoop. I have dragged all the .java (no .jar file AFAIK) files to the root folder of my sketch. They show up as separate tabs, and the sketch compiles and runs just fine, but I’m not sure what to do from here. Attempting to call `uniformNoise(1.0, 1.0)` returns an error stating that `"The function uniformNoise(float, float) does not exist."` Am I missing an `import` statement here, or do I need to make an instance of the `UniformNoise` class?

Any hints on how to proceed?

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 29, 2022, 5:47pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/7 "2022-07-29T17:47:58Z")

</div>

Follow up: I commented out the `package` part of the .java files, and successfully called `uniformNoise()` from a manually created instance of `UniformNoise`.

So for now I got it to work. Great. But I might have violated a few conventions and good practice norms in the process. Please let me know if there’s a more common approach that I should follow.

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 29, 2022, 5:56pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/8 "2022-07-29T17:56:58Z")

</div>

YA follow up: So, it appears my “hack” doesn’t work with Processing’s Tweak Mode, which I am very reliant on. The code in the imported .java files throws a `"tweakmode_int cannot be resolved to a variable"` error when I attempt to run the sketch in Tweak Mode. I suspect replacing the imported .java with a .jar would fix this issue. Trouble is, I have absolutely ZERO clue on how to compile .java files into a .jar that’ll work with Processing. Any takers on this one?

---

<div class="post-metadata">

**Author:** ![GoToLoop](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/gotoloop/32/86_2.png) [@GoToLoop](https://discourse.processing.org/u/GoToLoop)\
**Post date:** [July 30, 2022, 10:07am UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/9 "2022-07-30T10:07:21Z")

</div>

> [@stixan](#):
>
> Am I missing an `import` statement here,

Classes & interfaces within files w/ extension “.java” needs to be imported before usage.

> [@stixan](#):
>
> I commented out the `package` part of the “.java” files,

You should keep the `package` statements.  
Within file [“UniformNoise.java”](https://github.com/micycle1/UniformNoise/blob/main/src/main/java/micycle/uniformnoise/UniformNoise.java) we have `package micycle.uniformnoise;`  
That means in order to import its `public class` UniformNoise in our “.pde” file we do:  
`import micycle.uniformnoise.UniformNoise;`  
Which is the combination of `package` path + `class` name:

> **[import / Reference](https://processing.org/reference/import.html)**
>
> The keyword import is used to load a library into a Processing sketch. A library is one or more classes that are grouped together to extend the capabilities of Processing. The \* characte…

---

<div class="post-metadata">

**Author:** ![micycle](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/micycle/32/201_2.png) [@micycle](https://discourse.processing.org/u/micycle)\
**Post date:** [July 30, 2022, 12:32pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/10 "2022-07-30T12:32:18Z")

</div>

You can install it as a library yourself in the Processing libraries folder:

On windows:

 ![image](https://canada1.discourse-cdn.com/flex036/uploads/processingfoundation1/original/3X/9/5/950304578ec9012405eba8c1c1e0525b29ed057a.png)

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 30, 2022, 7:30pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/11 "2022-07-30T19:30:33Z")

</div>

Thank you for the clarification @GoToLoop. I followed your advise and it works like a charm despite throwing an initial “`No library found for micycle.uniformnoise`” error.

There’s still an issue with me not being able to run the sketch in Tweak Mode, but I’ll work out a way to circumvent this.

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 30, 2022, 7:34pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/12 "2022-07-30T19:34:09Z")

</div>

Thanks for chiming in on this thread and thanks for making the library @micycle! I might have missed something, but I can’t find a .jar file in zip I download from your Github repo. Where did you get the .jar file from?

---

<div class="post-metadata">

**Author:** ![micycle](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/micycle/32/201_2.png) [@micycle](https://discourse.processing.org/u/micycle)\
**Post date:** [July 30, 2022, 9:55pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/13 "2022-07-30T21:55:44Z")

</div>

The .jar is right there in releases section.

---

<div class="post-metadata">

**Author:** ![stixan](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/stixan/32/21628_2.png) [@stixan](https://discourse.processing.org/u/stixan)\
**Post date:** [July 31, 2022, 9:00am UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/14 "2022-07-31T09:00:38Z")

</div>

Doh! It’s been right in front of me the whole time. Mea culpa 😅

---

<div class="post-metadata">

**Author:** ![GoToLoop](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/gotoloop/32/86_2.png) [@GoToLoop](https://discourse.processing.org/u/GoToLoop)\
**Post date:** [July 31, 2022, 9:04am UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/15 "2022-07-31T09:04:48Z")

</div>

Notice though this “.jar” file is just those 3 “.java” files but pre-compiled together.

Simplest way to use a “.jar” file in Processing is to drag it into the sketch and it automatically creates a subfolder named “code/”.

---

<div class="post-metadata">

**Author:** ![jeremym](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremym/32/16749_2.png) [@jeremym](https://discourse.processing.org/u/jeremym)\
**Post date:** [August 4, 2022, 4:11pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/16 "2022-08-04T16:11:41Z")

</div>

> [@micycle](#):
>
> - Repeats after a very small cycle in the x and y axes.
> - Strange repeating motion in z axis.
> - Block-like pattern/artefacts

These are basically all the same and relate to the functions periodicity. I wouldn’t call them “issues” exactly. The period isn’t really a problem and, in fact, it can be useful.

If you want to avoid repetition (or extend the period) the way to do it is with your scaling factor(s). Most of the examples you’ll find will use scales of something like 0.02 or 0.05 or 0.1… and these will extend the period, but not really by that much. If you want much longer periods, use a scalar that doesn’t easily divide into the period lengths (which are powers of 2, btw.) So… instead of 0.02 pick 0.0217 or instead of 0.05 pick 0.493 or something.

---

<div class="post-metadata">

**Author:** ![javagar](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/javagar/32/11434_2.png) [@javagar](https://discourse.processing.org/u/javagar)\
**Post date:** [August 4, 2022, 5:25pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/17 "2022-08-04T17:25:59Z")

</div>

> [@jeremym](#):
>
> The period isn’t really a problem and, in fact, it can be useful.

However, isn’t noise most often used as a form of randomness, in which case the periodicity would be generally regarded as an unfortunate artifact, even though it might sometimes be useful?

---

<div class="post-metadata">

**Author:** ![jeremym](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremym/32/16749_2.png) [@jeremym](https://discourse.processing.org/u/jeremym)\
**Post date:** [August 4, 2022, 5:36pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/18 "2022-08-04T17:36:50Z")

</div>

Looks like we are having this conversation in two threads now. 🙂 As I said above and in the other is that I believe you can essentially extend the period (and possibly make it very long indeed) by using a noise scale that doesn’t divide into the period… like choose 0.0217 instead of 0.02.

---

<div class="post-metadata">

**Author:** ![javagar](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/javagar/32/11434_2.png) [@javagar](https://discourse.processing.org/u/javagar)\
**Post date:** [August 4, 2022, 5:40pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/19 "2022-08-04T17:40:13Z")

</div>

> [@jeremym](#):
>
> Looks like we are having this conversation in two threads now.

Yeah, that’s true. But they are both good threads. 🙂 We can follow your lead regarding which one to continue within.

---

<div class="post-metadata">

**Author:** ![micycle](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/micycle/32/201_2.png) [@micycle](https://discourse.processing.org/u/micycle)\
**Post date:** [August 4, 2022, 8:14pm UTC](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768/20 "2022-08-04T20:14:40Z")

</div>

Can you demonstrate what you mean by this? Using any scaling factor (whether an irrational number or not) simply zooms/scales the noise and doesn’t alleviate the problems I listed.

[Next page](https://discourse.processing.org/t/uniformly-distributed-perlin-noise/31768.md?page=2)