{"id":30269803,"url":"https://github.com/kelindar/noise","last_synced_at":"2025-08-16T02:19:14.833Z","repository":{"id":309630689,"uuid":"1036016109","full_name":"kelindar/noise","owner":"kelindar","description":"Fast noise (simplex, white, blue) functions in Go","archived":false,"fork":false,"pushed_at":"2025-08-12T23:11:10.000Z","size":428,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-13T01:11:21.219Z","etag":null,"topics":["noise","procedural-generation","procgen","simplex","ssi"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kelindar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["kelindar"]}},"created_at":"2025-08-11T12:40:21.000Z","updated_at":"2025-08-12T23:06:51.000Z","dependencies_parsed_at":"2025-08-13T01:12:16.570Z","dependency_job_id":"3066e006-6736-4c4b-9ba8-9871bf72ed43","html_url":"https://github.com/kelindar/noise","commit_stats":null,"previous_names":["kelindar/noise"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/kelindar/noise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelindar%2Fnoise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelindar%2Fnoise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelindar%2Fnoise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelindar%2Fnoise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kelindar","download_url":"https://codeload.github.com/kelindar/noise/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kelindar%2Fnoise/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270657715,"owners_count":24623465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["noise","procedural-generation","procgen","simplex","ssi"],"created_at":"2025-08-16T02:19:14.388Z","updated_at":"2025-08-16T02:19:14.816Z","avatar_url":"https://github.com/kelindar.png","language":"Go","funding_links":["https://github.com/sponsors/kelindar"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\r\n\u003cimg width=\"300\" height=\"100\" src=\".github/logo.png\" border=\"0\" alt=\"kelindar/noise\"\u003e\r\n\u003cbr\u003e\r\n\r\n\u003cimg src=\"https://img.shields.io/github/go-mod/go-version/kelindar/noise\" alt=\"Go Version\"\u003e\r\n\u003ca href=\"https://pkg.go.dev/github.com/kelindar/noise\"\u003e\u003cimg src=\"https://pkg.go.dev/badge/github.com/kelindar/noise\" alt=\"PkgGoDev\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://goreportcard.com/report/github.com/kelindar/noise\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/kelindar/noise\" alt=\"Go Report Card\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\r\n\u003ca href=\"https://coveralls.io/github/kelindar/noise\"\u003e\u003cimg src=\"https://coveralls.io/repos/github/kelindar/noise/badge.svg\" alt=\"Coverage\"\u003e\u003c/a\u003e\r\n\u003c/p\u003e\r\n\r\n## Procedural Generation Methods\r\n\r\nThis package provides **noise generation** and **sparse point sampling** algorithms for Go, focusing on speed and deterministic output. It includes both classic noise functions and advanced sparse sampling techniques for procedural generation, simulations, and spatial applications. I built this primarily with offline procedural generation in mind.\r\n\r\n\r\n**Use When:**\r\n- ✅ Generating procedural terrain, textures, or patterns\r\n- ✅ Creating well-spaced point distributions for sampling or placement\r\n- ✅ Needing high-throughput noise generation for real-time applications\r\n- ✅ Requiring deterministic, reproducible random patterns\r\n\r\n**Not For:**\r\n- ❌ Cryptographic randomness or security-sensitive applications\r\n- ❌ True Poisson-disk sampling (this implements SSI, which is faster but different)\r\n\r\n\r\n## Simplex Noise\r\nClassic simplex noise for smooth procedural generation.\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/simplex1d.png\" alt=\"1D Simplex Noise\" width=\"400\"\u003e\r\n\u003cbr\u003e\u003cem\u003e1D simplex noise pattern\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/simplex2d.png\" alt=\"2D Simplex Noise\" width=\"300\"\u003e\r\n\u003cbr\u003e\u003cem\u003e2D simplex noise pattern\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/simplex3d.gif\" alt=\"3D Simplex Noise\" width=\"300\"\u003e\r\n\u003cbr\u003e\u003cem\u003e3D simplex noise animation\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n```go\r\n// Create a simplex noise generator\r\ns := noise.NewSimplex(12345)\r\n\r\n// Generate 1D, 2D, or 3D noise\r\nvalue1D := s.Eval(10.5)\r\nvalue2D := s.Eval(10.5, 20.3)\r\nvalue3D := s.Eval(10.5, 20.3, 30.1)\r\n```\r\n\r\n## Fractal Brownian Motion (fBM)\r\nMulti-octave noise for complex patterns.\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/fbm1d.png\" alt=\"1D fBM Noise\" width=\"400\"\u003e\r\n\u003cbr\u003e\u003cem\u003e1D fractal Brownian motion\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/fbm2d.png\" alt=\"2D fBM Noise\" width=\"300\"\u003e\r\n\u003cbr\u003e\u003cem\u003e2D fractal Brownian motion\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/fbm3d.gif\" alt=\"3D fBM Noise\" width=\"300\"\u003e\r\n\u003cbr\u003e\u003cem\u003e3D fractal Brownian motion animation\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n```go\r\n// Create an fBM generator\r\nfbm := noise.NewFBM(12345)\r\n\r\n// Generate fractal noise with lacunarity=2.0, gain=0.5, octaves=4\r\nvalue1D := fbm.Eval(2.0, 0.5, 4, 10.5)\r\nvalue2D := fbm.Eval(2.0, 0.5, 4, 10.5, 20.3)\r\nvalue3D := fbm.Eval(2.0, 0.5, 4, 10.5, 20.3, 30.1)\r\n```\r\n\r\n## White Noise\r\nGenerate deterministic white noise in [-1, 1] range.\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/white1d.png\" alt=\"1D White Noise\" width=\"400\"\u003e\r\n\u003cbr\u003e\u003cem\u003e1D white noise pattern\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/white2d.png\" alt=\"2D White Noise\" width=\"300\"\u003e\r\n\u003cbr\u003e\u003cem\u003e2D white noise pattern\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n```go\r\n// 1D white noise\r\nvalue := noise.White(12345, 10.5)\r\n\r\n// 2D white noise\r\nvalue := noise.White(12345, 10.5, 20.3)\r\n\r\n// 3D white noise\r\nvalue := noise.White(12345, 10.5, 20.3, 30.1)\r\n\r\n// N-dimensional white noise\r\nvalue := noise.White(12345, 1.0, 2.0, 3.0, 4.0, 5.0)\r\n```\r\n\r\n\r\n## Basic Random Values\r\n\r\nGenerate deterministic random values based on seed and input coordinates.\r\n\r\n```go\r\nconst seed = uint32(12345)\r\nconst x = uint64(42) // Input coordinate/hash\r\n\r\n// Float values in [0.0, 1.0)\r\nf32 := noise.Float32(seed, x)\r\nf64 := noise.Float64(seed, x)\r\n\r\n// Integer values\r\ni := noise.Int(seed, x)\r\ni32 := noise.Int32(seed, x)\r\ni64 := noise.Int64(seed, x)\r\nu := noise.Uint(seed, x)\r\n\r\n// Normal distribution (Box-Muller)\r\nnorm32 := noise.Norm32(seed, x)\r\nnorm64 := noise.Norm64(seed, x)\r\n```\r\n\r\n## Bounded Random Values\r\n\r\n```go\r\n// Random integers in [0, n)\r\ni := noise.IntN(seed, 100, x)        // [0, 100)\r\ni32 := noise.Int32N(seed, 50, x)     // [0, 50)\r\ni64 := noise.Int64N(seed, 1000, x)   // [0, 1000)\r\nu32 := noise.Uint32N(seed, 256, x)   // [0, 256)\r\nu64 := noise.Uint64N(seed, 512, x)   // [0, 512)\r\nu := noise.UintN(seed, 128, x)       // [0, 128)\r\n\r\n// Random integers in [a, b] (inclusive)\r\ni := noise.IntIn(seed, 10, 20, x)       // [10, 20]\r\ni32 := noise.Int32In(seed, -5, 5, x)    // [-5, 5]\r\ni64 := noise.Int64In(seed, 100, 200, x) // [100, 200]\r\nu32 := noise.Uint32In(seed, 50, 100, x) // [50, 100]\r\nu64 := noise.Uint64In(seed, 0, 255, x)  // [0, 255]\r\nu := noise.UintIn(seed, 1, 10, x)       // [1, 10]\r\n```\r\n\r\n## Probability Functions\r\n\r\n```go\r\n// Roll dice - returns true if random value \u003c probability\r\nsuccess32 := noise.Roll32(seed, 0.3, x) // 30% chance\r\nsuccess64 := noise.Roll64(seed, 0.75, x) // 75% chance\r\n```\r\n\r\n\r\nThe package provides Simple Sequential Inhibition (SSI) algorithms for generating well-spaced point distributions. These are ideal for procedural placement, sampling, and avoiding clustering artifacts.\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/sparse1d.png\" alt=\"1D Sparse Points\" width=\"400\"\u003e\r\n\u003cbr\u003e\u003cem\u003e1D sparse point distribution\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n## 1D Sparse Points\r\n\r\n```go\r\n// Generate 1D points with minimum distance of 1.0 unit\r\nfor x := range noise.SSI1(12345, 128) {\r\n    fmt.Printf(\"Point at x=%.2f\\n\", x)\r\n}\r\n\r\n// Generate integer positions with custom spacing\r\nfor ix := range noise.Sparse1(12345, 512, 8) {\r\n    fmt.Printf(\"Pixel at x=%d\\n\", ix)\r\n}\r\n```\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"fixtures/sparse2d.png\" alt=\"2D Sparse Points\" width=\"400\"\u003e\r\n\u003cbr\u003e\u003cem\u003e2D sparse point distribution\u003c/em\u003e\r\n\u003c/p\u003e\r\n\r\n## 2D Sparse Points\r\n\r\n```go\r\n// Generate 2D points with minimum distance of 1.0 unit\r\nfor pt := range noise.SSI2(12345, 64, 64) {\r\n    x, y := pt[0], pt[1]\r\n    fmt.Printf(\"Point at (%.2f, %.2f)\\n\", x, y)\r\n}\r\n\r\n// Generate integer positions for pixel placement\r\nfor pt := range noise.Sparse2(12345, 512, 256, 8) {\r\n    x, y := pt[0], pt[1]\r\n    fmt.Printf(\"Pixel at (%d, %d)\\n\", x, y)\r\n}\r\n```\r\n\r\n## Performance\r\n\r\nBenchmarks run on 13th Gen Intel(R) Core(TM) i7-13700K CPU. Results may vary based on hardware and environment.\r\n\r\n```\r\nname                 time/op      ops/s        allocs/op   \r\n-------------------- ------------ ------------ ------------\r\nsimplex 1D (seq)     15.9 ns      62.9M        0           \r\nsimplex 1D (rnd)     16.0 ns      62.6M        0           \r\nsimplex 2D (seq)     12.9 ns      77.7M        0           \r\nsimplex 2D (rnd)     16.5 ns      60.7M        0           \r\nsimplex 3D (seq)     22.6 ns      44.3M        0           \r\nsimplex 3D (rnd)     28.6 ns      34.9M        0           \r\nfbm 1D (seq)         49.1 ns      20.4M        0           \r\nfbm 1D (rnd)         51.5 ns      19.4M        0           \r\nfbm 2D (seq)         43.0 ns      23.3M        0           \r\nfbm 2D (rnd)         54.9 ns      18.2M        0           \r\nfbm 3D (seq)         71.6 ns      14.0M        0           \r\nfbm 3D (rnd)         105.3 ns     9.5M         0           \r\nwhite 1D (seq)       6.2 ns       161.6M       0           \r\nwhite 1D (rnd)       6.1 ns       163.4M       0           \r\nwhite 2D (seq)       8.9 ns       112.6M       0           \r\nwhite 2D (rnd)       8.9 ns       112.5M       0           \r\nwhite 3D (seq)       12.2 ns      81.7M        0           \r\nwhite 3D (rnd)       12.2 ns      82.2M        0           \r\nsparse 1D            620.4 ns     1.6M         1           \r\nsparse 2D            25.9 µs      38.6K        1           \r\nssi 1D               5.5 µs       181.2K       1           \r\nssi 2D               2.2 ms       446          1           \r\nfloat                3.8 ns       261.6M       0           \r\nint n                3.8 ns       259.8M       0           \r\nnorm                 27.7 ns      36.1M        0           \r\nint in               4.4 ns       226.4M       0           \r\nroll                 3.8 ns       260.8M       0           \r\n```\r\n\r\n\r\n## Contributing\r\n\r\nWe are open to contributions, feel free to submit a pull request and we'll review it as quickly as we can. This library is maintained by [Roman Atachiants](https://www.linkedin.com/in/atachiants/)\r\n\r\n## License\r\n\r\nThis project is licensed under the [MIT License](LICENSE.md).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkelindar%2Fnoise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkelindar%2Fnoise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkelindar%2Fnoise/lists"}