In NEDsim, display as many data rows as possible instead of a power-of-two.
[screensavers] / hacks / WolframAutomata / README.md
index 99b2410..1753510 100644 (file)
@@ -10,12 +10,13 @@ together, thereby forming a circular universe for the cells to inhabit.  This
 line is drawn horizontally on the screen.
 
 Over time, this line of cells evolves according to rules, with some cells
-switching on or off. Each new iteration is drawn below its predecessor, leading
-the screen to scroll vertically over time.
+switching on or off. Each new application of the rule to the universe is drawn
+on the screen as a new line directly below the previous generation's line,
+leading the screen to scroll vertically.
 
-The rules which govern the time evolution of this system depend only on the
-current state of a given cell and the state of its two immediate neighbors.
-These rules are formalized as
+Since these are "elementary" cellular automata, the rules which govern the time
+evolution of this system depend only on the current state of a given cell and
+the state of its two immediate neighbors.  These rules are formalized as
 [Wolfram codes](https://en.wikipedia.org/wiki/Wolfram_code),
 where the code number is directly convertible into a rule set.
 
@@ -26,11 +27,12 @@ discussed at length in a
 
 ![Rule 110 Animated Screenshot](/screensavers/.git/blob_plain/HEAD:/hacks/WolframAutomata/screenshot_rule_110.gif)
 
-Commandline flags are provided enabling the user to tweak attributes such as
-length and speed of simulation, cell size, rule number, colors, starting seed,
-and other attributes. For example, the screenshot below depicts Rule 73 with
-different colors than the Rule 110 screenshot. Like the Rule 110 screenshot, it
-uses `-cell-size 2` and seeds the simulation with only a single active cell.
+Commandline flags are provided which enable the user to tweak attributes such
+as length and speed of simulation, cell size, rule number, colors, starting
+seed, and other attributes. For example, the screenshot below depicts Rule 73
+with different colors than the Rule 110 screenshot. Like the Rule 110
+screenshot, it uses `-cell-size 2` and seeds the simulation with only a single
+active cell.
 
 ![Rule 73 Animated Screenshot](/screensavers/.git/blob_plain/HEAD:/hacks/WolframAutomata/screenshot_rule_73.gif)
 
@@ -64,9 +66,9 @@ else, edit the `Makefile` to suit your environment per the comments included in
 that file. Note that the `Makefile` assumes a copy of the screenhack library
 source code is located at `../screenhack/` relative to this directory.
 
-For assistance setting `$(DEFINES)` on non-FreeBSD platforms, consider
-downloading the XScreensaver source tarball, running `./configure` in the
-unpacked directory, and examining the resulting `config.h` file.
+For assistance setting `$(DEFINES)` in the `Makefile` on non-FreeBSD platforms,
+consider downloading the XScreensaver source tarball, running `./configure` in
+the unpacked directory, and examining the resulting `config.h` file.
 
 Although WolframAutomata can integrate with XScreensaver, the presence of
 XScreensaver is not strictly required.  WolframAutomata will both build and
@@ -239,26 +241,26 @@ example, on FreeBSD:
     
       <command arg="-root"/>
     
-      <string  id="rule_number"   _label="Rule number: "        arg="-rule %" />
-      <boolean id="rnd_rule"      _label="Random rule"          arg-set="-random-rule" />
+      <string  id="rule_number"   _label="Rule number: "      arg="-rule %" />
+      <boolean id="rnd_rule"      _label="Random rule"        arg-set="-random-rule" />
     
-      <string  id="seed_density"  _label="Seed density (%):"    arg="-seed-density %" />
-      <boolean id="seed_left"     _label="Seed left"            arg-set="-seed-left" />
-      <boolean id="seed_center"   _label="Seed center"          arg-set="-seed-center" />
-      <boolean id="seed_right"    _label="Seed right"           arg-set="-seed-right" />
+      <string  id="seed_density"  _label="Seed density (%):"  arg="-seed-density %" />
+      <boolean id="seed_left"     _label="Seed left"          arg-set="-seed-left" />
+      <boolean id="seed_center"   _label="Seed center"        arg-set="-seed-center" />
+      <boolean id="seed_right"    _label="Seed right"         arg-set="-seed-right" />
     
-      <string  id="length"        _label="Length (generation):" arg="-length %" />
-      <boolean id="rnd_length"    _label="Random length"        arg-set="-random-length" />
+      <string  id="length"        _label="Length (gen):"      arg="-length %" />
+      <boolean id="rnd_length"    _label="Random length"      arg-set="-random-length" />
     
-      <string  id="delay"         _label="Delay (usec):"        arg="-delay %" />
-      <boolean id="rnd_delay"     _label="Random delay"         arg-set="-random-delay" />
+      <string  id="delay"         _label="Delay (usec):"      arg="-delay %" />
+      <boolean id="rnd_delay"     _label="Random delay"       arg-set="-random-delay" />
     
-      <string  id="cell_size"     _label="Cell size (px):"      arg="-cell-size %" />
-      <boolean id="rnd_cellsize"  _label="Random cell size"     arg-set="-random-cell-size" />
+      <string  id="cell_size"     _label="Cell size (px):"    arg="-cell-size %" />
+      <boolean id="rnd_cellsize"  _label="Random cell size"   arg-set="-random-cell-size" />
     
-      <string  id="color_index"   _label="Color index (int):"   arg="-color-index %" />
+      <string  id="color_index"   _label="Color index (int):" arg="-color-index %" />
     
-      <string  id="admiration"    _label="Admiration (sec):"    arg="-admiration-delay %" />
+      <string  id="admiration"    _label="Admiration (sec):"  arg="-admiration-delay %" />
     
       <_description>
     Displays the time evolution of elementary cellular automata.