Attractor (#192)

Closes #160

Author: Notgnoshi

.rustfmt.toml

@@ -0,0 +1 @@
+edition = "2024"

Cargo.toml

@@ -67,6 +67,10 @@ path = "tools/streamline.rs"
 name = "snap"
 path = "tools/snap.rs"
 
+[[bin]]
+name = "attractor"
+path = "tools/attractor.rs"
+
 [[bin]]
 name = "geom2graph"
 path = "tools/geom2graph.rs"
@@ -79,6 +83,7 @@ cxx = { version = "1.0", optional = true }
 delaunator = "1.0"
 eyre = "0.6.12"
 geo = "0.31"
+image = { version = "0.25.8", default-features = false, features = ["png"] }
 itertools = "0.14"
 kdtree = "0.7"
 noise = "0.9"

README.md

@@ -12,6 +12,7 @@ A polyglot collection of composable generative art tools, with a focus on 2D com
 * [How to build](#how-to-build)
 * [Philosophy](#philosophy)
 * [Examples](#examples)
+  * [Chaotic attractors](#chaotic-attractors)
   * [Asemic writing](#asemic-writing)
   * [Random L-Systems](#random-l-systems)
 * [The tools](#the-tools)
@@ -29,6 +30,7 @@ A polyglot collection of composable generative art tools, with a focus on 2D com
     * [streamline](#streamline)
     * [traverse](#traverse)
     * [urquhart](#urquhart)
+    * [attractor](#attractor)
   * [Transformations](#transformations)
     * [project.py](#projectpy)
     * [geom2graph](#geom2graph)
@@ -96,6 +98,24 @@ to produce/consume a standard textual interface.
 * Graphs are in [TGF](https://en.wikipedia.org/wiki/Trivial_Graph_Format) format
 
 # Examples
+
+## Chaotic attractors
+See the [`attractor`](#attractor) tool for more details on how to generate these attractor images.
+
+![](examples/attractor/clifford.png)
+
+![](examples/attractor/ikeda.png)
+
+![](examples/attractor/johnny-svensson.png)
+
+![](examples/attractor/peter-de-jong.png)
+
+![](examples/attractor/tinkerbell.png)
+
+![](examples/attractor/fractal-dreams-ssss.png)
+
+![](examples/attractor/gumowski-mira.png)
+
 ## Asemic writing
 The following snippet generates random asemic writing glyphs
 ```sh
@@ -553,6 +573,27 @@ point-cloud --seed 11878883030565683752 --points 20 --scale 200 |
 ```
 ![](examples/urquhart/urquhart.svg)
 
+### attractor
+The `attractor` tool is very similar to the [`streamline`](#streamline) tool. It takes a Rune script
+defining a 2D dynamical system, and traces the trajectories of points in that system.
+
+For example the [tinkerbell.rn](examples/attractor/tinkerbell.rn) script defines the Tinkerbell
+attractor:
+
+```sh
+attractor \
+    --script ./examples/attractor/tinkerbell.rn \
+    --output ./examples/attractor/tinkerbell.png \
+    --output-format image \
+    -x=-0.72 \
+    -y=-0.64 \
+    --iterations 500000
+```
+![](examples/attractor/tinkerbell.png)
+
+You may use `--output-format` to get WKT POINTs or LINESTRINGs instead of a PNG image, but the PGN
+image looks better than an SVG rendering of the WKT geometries.
+
 ## Transformations
 ### project.py
 The `project.py` tool can be used to project 3D geometries to 2D. It supports several projection

README.md.in

@@ -12,6 +12,7 @@ A polyglot collection of composable generative art tools, with a focus on 2D com
 * [How to build](#how-to-build)
 * [Philosophy](#philosophy)
 * [Examples](#examples)
+  * [Chaotic attractors](#chaotic-attractors)
   * [Asemic writing](#asemic-writing)
   * [Random L-Systems](#random-l-systems)
 * [The tools](#the-tools)
@@ -29,6 +30,7 @@ A polyglot collection of composable generative art tools, with a focus on 2D com
     * [streamline](#streamline)
     * [traverse](#traverse)
     * [urquhart](#urquhart)
+    * [attractor](#attractor)
   * [Transformations](#transformations)
     * [project.py](#projectpy)
     * [geom2graph](#geom2graph)
@@ -96,6 +98,24 @@ to produce/consume a standard textual interface.
 * Graphs are in [TGF](https://en.wikipedia.org/wiki/Trivial_Graph_Format) format
 
 # Examples
+
+## Chaotic attractors
+See the [`attractor`](#attractor) tool for more details on how to generate these attractor images.
+
+![](examples/attractor/clifford.png)
+
+![](examples/attractor/ikeda.png)
+
+![](examples/attractor/johnny-svensson.png)
+
+![](examples/attractor/peter-de-jong.png)
+
+![](examples/attractor/tinkerbell.png)
+
+![](examples/attractor/fractal-dreams-ssss.png)
+
+![](examples/attractor/gumowski-mira.png)
+
 ## Asemic writing
 The following snippet generates random asemic writing glyphs
 ```sh
@@ -347,6 +367,21 @@ triangulation.
 ```
 ![](examples/urquhart/urquhart.svg)
 
+### attractor
+The `attractor` tool is very similar to the [`streamline`](#streamline) tool. It takes a Rune script
+defining a 2D dynamical system, and traces the trajectories of points in that system.
+
+For example the [tinkerbell.rn](examples/attractor/tinkerbell.rn) script defines the Tinkerbell
+attractor:
+
+```sh
+@TINKERBELL_SNIPPET@
+```
+![](examples/attractor/tinkerbell.png)
+
+You may use `--output-format` to get WKT POINTs or LINESTRINGs instead of a PNG image, but the PGN
+image looks better than an SVG rendering of the WKT geometries.
+
 ## Transformations
 ### project.py
 The `project.py` tool can be used to project 3D geometries to 2D. It supports several projection

examples/attractor/clifford.png

@@ -0,0 +1,7 @@
+let a = -2.0;
+let b = -2.4;
+let c = 1.1;
+let d = -0.9;
+
+let x_new = f64::sin(a * y) + c * f64::cos(a * x);
+let y_new = f64::sin(b * x) + d * f64::cos(b * y);

examples/attractor/clifford.rn

@@ -0,0 +1,9 @@
+// From Chaos in Wonderland, version SSSS
+
+let a = 1.468;
+let b = 2.407;
+let c = 0.194;
+let d = 1.438;
+
+let x_new = f64::sin(y * b) + c * f64::sin(x * b);
+let y_new = f64::sin(x * a) + d * f64::sin(y * a);

examples/attractor/fractal-dreams-ssss.png

@@ -0,0 +1,71 @@
+#!/bin/bash
+set -o errexit
+set -o pipefail
+set -o nounset
+set -o noclobber
+
+debug "Generating clifford ..."
+attractor \
+    --seed 1193803725491079949 \
+    --script ./examples/attractor/clifford.rn \
+    --output ./examples/attractor/clifford.png \
+    --output-format image \
+    --num-points 400 \
+    --iterations 800
+
+debug "Generating ikeda ..."
+attractor \
+    --seed 14245741203239691500 \
+    --script ./examples/attractor/ikeda.rn \
+    --output ./examples/attractor/ikeda.png \
+    --output-format image \
+    --num-points 500 \
+    --iterations 500
+
+debug "Generating johnny-svensson ..."
+attractor \
+    --seed 2310402659768744900 \
+    --script ./examples/attractor/johnny-svensson.rn \
+    --output ./examples/attractor/johnny-svensson.png \
+    --output-format image \
+    --num-points 200 \
+    --iterations 800
+
+debug "Generating peter-de-jong ..."
+attractor \
+    --seed 10329922707181609977 \
+    --script ./examples/attractor/peter-de-jong.rn \
+    --output ./examples/attractor/peter-de-jong.png \
+    --output-format image \
+    --num-points 200 \
+    --iterations 800
+
+debug "Generating tinkerbell ..."
+# BEGIN TINKERBELL_SNIPPET
+attractor \
+    --script ./examples/attractor/tinkerbell.rn \
+    --output ./examples/attractor/tinkerbell.png \
+    --output-format image \
+    -x=-0.72 \
+    -y=-0.64 \
+    --iterations 500000
+# END TINKERBELL_SNIPPET
+extract_snippet TINKERBELL_SNIPPET
+
+debug "Generating fractal-dreams-ssss ..."
+attractor \
+    --seed 4392994853744049110 \
+    --script ./examples/attractor/fractal-dreams-ssss.rn \
+    --output ./examples/attractor/fractal-dreams-ssss.png \
+    --output-format image \
+    --num-points 1000 \
+    --iterations 2000
+
+debug "Generating gumowski-mira ..."
+attractor \
+    --seed 6844197751594810350 \
+    --script ./examples/attractor/gumowski-mira.rn \
+    --output ./examples/attractor/gumowski-mira.png \
+    --output-format image \
+    --num-points 1000 \
+    --iterations 5000