Initial commit

zmwangx · Feb 14, 2017 · 36bae16 · 36bae16
commit 36bae16
Show file tree

Hide file tree

Showing 278 changed files with 664 additions and 0 deletions.
diff --git a/COPYING b/COPYING
@@ -0,0 +1,20 @@
+Copyright (c) 2017 Zhiming Wang <zmwangx@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/README.rst b/README.rst
@@ -0,0 +1,136 @@
+========
+ rule30
+========
+
+|Supported Python versions| |Docs| |License|
+
+This project efficiently implements Stephen Wolfram's elementary cellular automata (Rule 30 being a notable example), specifically their single 1 histories. Histories can be generated in various matrix formats (including ``numpy.ndarray``) and exported as strings or images.
+
+.. |Supported Python versions| image:: https://img.shields.io/badge/python-3.6-blue.svg?maxAge=2592000
+.. |Docs| image:: https://img.shields.io/badge/docs-latest-green.svg?maxAge=2592000
+   :target: https://rule30.zhimingwang.org
+.. |License| image:: https://img.shields.io/badge/license-MIT-blue.svg?maxAge=2592000
+   :target: COPYING
+
+.. contents::
+   :backlinks: top
+
+API reference
+-------------
+
+See `rule30.zhimingwang.org <https://rule30.zhimingwang.org>`_.
+
+Console script
+--------------
+
+::
+
+   $ rule30 --help
+   usage: rule30 [-h] [-n ROWS] [-r [RULE]] [-s BLOCK_SIZE] [--version] [--debug]
+                 image
+
+   Generate images for the single 1 histories of Stephen Wolfram's elementary
+   cellular automata.
+
+   positional arguments:
+     image                 path to the output image (PNG format)
+
+   optional arguments:
+     -h, --help            show this help message and exit
+     -n ROWS, --rows ROWS  number of rows to generate; default is 256
+     -r [RULE], --rule [RULE]
+                           Wolfram code of the rule (between 0 and 255); default
+                           is 30
+     -s BLOCK_SIZE, --block-size BLOCK_SIZE
+                           the size in pixels for each cell; default is 1
+     --version             show program's version number and exit
+     --debug               enable debug messages
+
+See also
+--------
+
+- `Elementary Cellular Automaton <https://en.wikipedia.org/wiki/Elementary_cellular_automaton>`__, Wikipedia;
+- `Rule 30 <https://en.wikipedia.org/wiki/Rule_30>`__, Wikipedia;
+- `Elementary Cellular Automaton <http://mathworld.wolfram.com/ElementaryCellularAutomaton.html>`__, Wolfram MathWorld;
+- `Cellular Automata <https://plato.stanford.edu/entries/cellular-automata/index.html>`__, Stanford Encyclopedia of Philosophy;
+- `The 256 Rules <https://plato.stanford.edu/entries/cellular-automata/supplement.html>`__, Stanford Encyclopedia of Philosophy.
+
+Images
+------
+
+Here are the images for some interesting rules with individual pages on `Wolfram MathWorld <http://mathworld.wolfram.com/ElementaryCellularAutomaton.html>`_. Images for all 256 rules can be found in the ``images`` directory.
+
+`Rule 30 <http://mathworld.wolfram.com/Rule30.html>`_:
+
+.. image:: images/rule30.png
+
+`Rule 50 <http://mathworld.wolfram.com/Rule50.html>`_:
+
+.. image:: images/rule50.png
+
+`Rule 54 <http://mathworld.wolfram.com/Rule54.html>`_:
+
+.. image:: images/rule54.png
+
+`Rule 60 <http://mathworld.wolfram.com/Rule60.html>`_:
+
+.. image:: images/rule60.png
+
+`Rule 62 <http://mathworld.wolfram.com/Rule62.html>`_:
+
+.. image:: images/rule62.png
+
+`Rule 90 <http://mathworld.wolfram.com/Rule90.html>`_:
+
+.. image:: images/rule90.png
+
+`Rule 94 <http://mathworld.wolfram.com/Rule94.html>`_:
+
+.. image:: images/rule94.png
+
+`Rule 102 <http://mathworld.wolfram.com/Rule102.html>`_:
+
+.. image:: images/rule102.png
+
+`Rule 110 <http://mathworld.wolfram.com/Rule110.html>`_:
+
+.. image:: images/rule110.png
+
+`Rule 126 <http://mathworld.wolfram.com/Rule126.html>`_:
+
+.. image:: images/rule126.png
+
+`Rule 150 <http://mathworld.wolfram.com/Rule150.html>`_:
+
+.. image:: images/rule150.png
+
+`Rule 158 <http://mathworld.wolfram.com/Rule158.html>`_:
+
+.. image:: images/rule158.png
+
+`Rule 182 <http://mathworld.wolfram.com/Rule182.html>`_:
+
+.. image:: images/rule182.png
+
+`Rule 188 <http://mathworld.wolfram.com/Rule188.html>`_:
+
+.. image:: images/rule188.png
+
+`Rule 190 <http://mathworld.wolfram.com/Rule190.html>`_:
+
+.. image:: images/rule190.png
+
+`Rule 220 <http://mathworld.wolfram.com/Rule220.html>`_:
+
+.. image:: images/rule220.png
+
+`Rule 222 <http://mathworld.wolfram.com/Rule222.html>`_:
+
+.. image:: images/rule222.png
+
+License
+-------
+
+Copyright (c) 2017 Zhiming Wang <zmwangx@gmail.com>
+
+This project is licensed under the MIT license. See ``COPYING`` for details.
diff --git a/doc/.gitignore b/doc/.gitignore
@@ -0,0 +1 @@
+_build
diff --git a/doc/CNAME b/doc/CNAME
@@ -0,0 +1 @@
+rule30.zhimingwang.org
diff --git a/doc/Makefile b/doc/Makefile
@@ -0,0 +1,11 @@
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = rule30
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+html:
+
+# $(O) is meant as a shortcut for $(SPHINXOPTS).
+%:
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/doc/README.rst b/doc/README.rst
@@ -0,0 +1,11 @@
+To install dependencies for building docs::
+
+  pip install requirements.txt
+
+To build HTML documentation::
+
+  make
+
+To run doctest::
+
+  make doctest
diff --git a/doc/conf.py b/doc/conf.py
@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+
+import sphinx_rtd_theme
+
+HERE = os.path.dirname(os.path.realpath(__file__))
+PROJECT_ROOT = os.path.dirname(HERE)
+sys.path.insert(0, PROJECT_ROOT)
+
+from rule30.version import __version__
+
+project = 'rule30'
+copyright = '2017, Zhiming Wang'
+author = 'Zhiming Wang'
+version = release = __version__
+
+extensions = [
+    'sphinx.ext.autodoc',
+    'numpydoc',
+    'sphinx.ext.autosummary',
+    'sphinx.ext.doctest',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.githubpages',
+]
+
+source_suffix = '.rst'
+master_doc = 'index'
+exclude_patterns = ['README.rst', '_build']
+pygments_style = 'sphinx'
+
+html_favicon = 'favicon.ico'
+html_extra_path = [
+    'CNAME',
+]
+
+# sphinx_rtd_theme
+html_theme = 'sphinx_rtd_theme'
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+
+# autodoc
+autodoc_member_order = 'bysource'
+
+# numpydoc
+numpydoc_show_class_members = False
diff --git a/doc/favicon.ico b/doc/favicon.ico
diff --git a/doc/index.rst b/doc/index.rst
@@ -0,0 +1,21 @@
+========
+ rule30
+========
+
+This site hosts API reference for the ``rule30`` python package. For general information, please refer to the project `README <https://github.com/zmwangx/rule30#readme>`_ on GitHub.
+
+API reference
+=============
+
+.. toctree::
+   :maxdepth: 1
+
+   rule30.automaton
+   rule30.visualize
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/doc/requirements.txt b/doc/requirements.txt
@@ -0,0 +1,2 @@
+Sphinx
+sphinx_rtd_theme
diff --git a/doc/rule30.automaton.rst b/doc/rule30.automaton.rst
@@ -0,0 +1,7 @@
+======================
+ ``rule30.automaton``
+======================
+
+.. automodule:: rule30.automaton
+   :members:
+   :undoc-members:
diff --git a/doc/rule30.visualize.rst b/doc/rule30.visualize.rst
@@ -0,0 +1,7 @@
+======================
+ ``rule30.visualize``
+======================
+
+.. automodule:: rule30.visualize
+   :members:
+   :undoc-members:
diff --git a/images/README.rst b/images/README.rst
@@ -0,0 +1 @@
+Images in this directory are generated with the script ``generate``. The individual image for each rule is generated with 256 rows and a block size of 1 pixel.
diff --git a/images/combined.png b/images/combined.png
diff --git a/images/generate b/images/generate
@@ -0,0 +1,21 @@
+#!/usr/bin/env zsh
+
+here=$0:A:h
+for rule in {0..255}; do
+    filename=rule$rule.png
+    print "Generating $filename ..." >&2
+    rule30 --rule $rule --rows 256 $here/$filename
+done
+
+print "Generating combined.png ..." >&2
+
+tmpdir=$(mktemp -d -t rule30.XXXXXXX) || { print "Error: Failed to make tempdir" >&2; exit 1; }
+trap 'rm -rf $tmpdir' EXIT HUP INT PIPE ALRM TERM
+# Generate labels
+for rule in {0..255}; do
+    convert -font Courier -size 511x18 -pointsize 12 -gravity south label:"Rule $rule" $tmpdir/rule$rule-label.png
+done
+# Copy individual images
+print -l $here/rule{0..255}.png | parallel --xargs cp '{}' $tmpdir
+setopt numericglobsort
+print -l $tmpdir/rule*.png | convert @- -append $here/combined.png
diff --git a/images/rule0.png b/images/rule0.png
diff --git a/images/rule1.png b/images/rule1.png
diff --git a/images/rule10.png b/images/rule10.png
diff --git a/images/rule100.png b/images/rule100.png
diff --git a/images/rule101.png b/images/rule101.png
diff --git a/images/rule102.png b/images/rule102.png
diff --git a/images/rule103.png b/images/rule103.png
diff --git a/images/rule104.png b/images/rule104.png
diff --git a/images/rule105.png b/images/rule105.png
diff --git a/images/rule106.png b/images/rule106.png
diff --git a/images/rule107.png b/images/rule107.png
diff --git a/images/rule108.png b/images/rule108.png
diff --git a/images/rule109.png b/images/rule109.png
diff --git a/images/rule11.png b/images/rule11.png
diff --git a/images/rule110.png b/images/rule110.png
diff --git a/images/rule111.png b/images/rule111.png
diff --git a/images/rule112.png b/images/rule112.png
diff --git a/images/rule113.png b/images/rule113.png
diff --git a/images/rule114.png b/images/rule114.png
diff --git a/images/rule115.png b/images/rule115.png
diff --git a/images/rule116.png b/images/rule116.png
diff --git a/images/rule117.png b/images/rule117.png
diff --git a/images/rule118.png b/images/rule118.png
diff --git a/images/rule119.png b/images/rule119.png
diff --git a/images/rule12.png b/images/rule12.png
diff --git a/images/rule120.png b/images/rule120.png
diff --git a/images/rule121.png b/images/rule121.png
diff --git a/images/rule122.png b/images/rule122.png
diff --git a/images/rule123.png b/images/rule123.png
diff --git a/images/rule124.png b/images/rule124.png
diff --git a/images/rule125.png b/images/rule125.png
diff --git a/images/rule126.png b/images/rule126.png
diff --git a/images/rule127.png b/images/rule127.png
diff --git a/images/rule128.png b/images/rule128.png
diff --git a/images/rule129.png b/images/rule129.png
diff --git a/images/rule13.png b/images/rule13.png
diff --git a/images/rule130.png b/images/rule130.png
diff --git a/images/rule131.png b/images/rule131.png
diff --git a/images/rule132.png b/images/rule132.png
diff --git a/images/rule133.png b/images/rule133.png
diff --git a/images/rule134.png b/images/rule134.png
diff --git a/images/rule135.png b/images/rule135.png
diff --git a/images/rule136.png b/images/rule136.png
diff --git a/images/rule137.png b/images/rule137.png
diff --git a/images/rule138.png b/images/rule138.png
diff --git a/images/rule139.png b/images/rule139.png
diff --git a/images/rule14.png b/images/rule14.png
diff --git a/images/rule140.png b/images/rule140.png
diff --git a/images/rule141.png b/images/rule141.png
diff --git a/images/rule142.png b/images/rule142.png
diff --git a/images/rule143.png b/images/rule143.png
diff --git a/images/rule144.png b/images/rule144.png
diff --git a/images/rule145.png b/images/rule145.png
diff --git a/images/rule146.png b/images/rule146.png
diff --git a/images/rule147.png b/images/rule147.png
diff --git a/images/rule148.png b/images/rule148.png
diff --git a/images/rule149.png b/images/rule149.png
diff --git a/images/rule15.png b/images/rule15.png
diff --git a/images/rule150.png b/images/rule150.png
diff --git a/images/rule151.png b/images/rule151.png
diff --git a/images/rule152.png b/images/rule152.png
diff --git a/images/rule153.png b/images/rule153.png
diff --git a/images/rule154.png b/images/rule154.png
diff --git a/images/rule155.png b/images/rule155.png
diff --git a/images/rule156.png b/images/rule156.png
diff --git a/images/rule157.png b/images/rule157.png
diff --git a/images/rule158.png b/images/rule158.png
diff --git a/images/rule159.png b/images/rule159.png
diff --git a/images/rule16.png b/images/rule16.png
diff --git a/images/rule160.png b/images/rule160.png
diff --git a/images/rule161.png b/images/rule161.png
diff --git a/images/rule162.png b/images/rule162.png
diff --git a/images/rule163.png b/images/rule163.png
diff --git a/images/rule164.png b/images/rule164.png
diff --git a/images/rule165.png b/images/rule165.png
diff --git a/images/rule166.png b/images/rule166.png
diff --git a/images/rule167.png b/images/rule167.png
diff --git a/images/rule168.png b/images/rule168.png
diff --git a/images/rule169.png b/images/rule169.png
diff --git a/images/rule17.png b/images/rule17.png
diff --git a/images/rule170.png b/images/rule170.png
diff --git a/images/rule171.png b/images/rule171.png
diff --git a/images/rule172.png b/images/rule172.png
diff --git a/images/rule173.png b/images/rule173.png
diff --git a/images/rule174.png b/images/rule174.png
diff --git a/images/rule175.png b/images/rule175.png
diff --git a/images/rule176.png b/images/rule176.png
diff --git a/images/rule177.png b/images/rule177.png
diff --git a/images/rule178.png b/images/rule178.png
diff --git a/images/rule179.png b/images/rule179.png
diff --git a/images/rule18.png b/images/rule18.png
diff --git a/images/rule180.png b/images/rule180.png
diff --git a/images/rule181.png b/images/rule181.png
diff --git a/images/rule182.png b/images/rule182.png
diff --git a/images/rule183.png b/images/rule183.png
diff --git a/images/rule184.png b/images/rule184.png
diff --git a/images/rule185.png b/images/rule185.png
diff --git a/images/rule186.png b/images/rule186.png
diff --git a/images/rule187.png b/images/rule187.png
diff --git a/images/rule188.png b/images/rule188.png
diff --git a/images/rule189.png b/images/rule189.png
diff --git a/images/rule19.png b/images/rule19.png
diff --git a/images/rule190.png b/images/rule190.png
diff --git a/images/rule191.png b/images/rule191.png
diff --git a/images/rule192.png b/images/rule192.png
diff --git a/images/rule193.png b/images/rule193.png
diff --git a/images/rule194.png b/images/rule194.png
diff --git a/images/rule195.png b/images/rule195.png
diff --git a/images/rule196.png b/images/rule196.png
diff --git a/images/rule197.png b/images/rule197.png
diff --git a/images/rule198.png b/images/rule198.png
diff --git a/images/rule199.png b/images/rule199.png
diff --git a/images/rule2.png b/images/rule2.png
diff --git a/images/rule20.png b/images/rule20.png
diff --git a/images/rule200.png b/images/rule200.png
diff --git a/images/rule201.png b/images/rule201.png
diff --git a/images/rule202.png b/images/rule202.png
diff --git a/images/rule203.png b/images/rule203.png
diff --git a/images/rule204.png b/images/rule204.png
diff --git a/images/rule205.png b/images/rule205.png
diff --git a/images/rule206.png b/images/rule206.png
diff --git a/images/rule207.png b/images/rule207.png
diff --git a/images/rule208.png b/images/rule208.png
diff --git a/images/rule209.png b/images/rule209.png
diff --git a/images/rule21.png b/images/rule21.png
diff --git a/images/rule210.png b/images/rule210.png
diff --git a/images/rule211.png b/images/rule211.png
diff --git a/images/rule212.png b/images/rule212.png
diff --git a/images/rule213.png b/images/rule213.png
diff --git a/images/rule214.png b/images/rule214.png
diff --git a/images/rule215.png b/images/rule215.png
diff --git a/images/rule216.png b/images/rule216.png
diff --git a/images/rule217.png b/images/rule217.png
diff --git a/images/rule218.png b/images/rule218.png
diff --git a/images/rule219.png b/images/rule219.png
diff --git a/images/rule22.png b/images/rule22.png
diff --git a/images/rule220.png b/images/rule220.png
diff --git a/images/rule221.png b/images/rule221.png
diff --git a/images/rule222.png b/images/rule222.png
diff --git a/images/rule223.png b/images/rule223.png
diff --git a/images/rule224.png b/images/rule224.png
diff --git a/images/rule225.png b/images/rule225.png
diff --git a/images/rule226.png b/images/rule226.png
diff --git a/images/rule227.png b/images/rule227.png
diff --git a/images/rule228.png b/images/rule228.png
diff --git a/images/rule229.png b/images/rule229.png
diff --git a/images/rule23.png b/images/rule23.png
diff --git a/images/rule230.png b/images/rule230.png
diff --git a/images/rule231.png b/images/rule231.png
diff --git a/images/rule232.png b/images/rule232.png
diff --git a/images/rule233.png b/images/rule233.png
diff --git a/images/rule234.png b/images/rule234.png
diff --git a/images/rule235.png b/images/rule235.png
diff --git a/images/rule236.png b/images/rule236.png
diff --git a/images/rule237.png b/images/rule237.png
diff --git a/images/rule238.png b/images/rule238.png
diff --git a/images/rule239.png b/images/rule239.png
diff --git a/images/rule24.png b/images/rule24.png
diff --git a/images/rule240.png b/images/rule240.png
diff --git a/images/rule241.png b/images/rule241.png
diff --git a/images/rule242.png b/images/rule242.png
diff --git a/images/rule243.png b/images/rule243.png
diff --git a/images/rule244.png b/images/rule244.png
diff --git a/images/rule245.png b/images/rule245.png
diff --git a/images/rule246.png b/images/rule246.png
diff --git a/images/rule247.png b/images/rule247.png
diff --git a/images/rule248.png b/images/rule248.png
diff --git a/images/rule249.png b/images/rule249.png
diff --git a/images/rule25.png b/images/rule25.png
diff --git a/images/rule250.png b/images/rule250.png
diff --git a/images/rule251.png b/images/rule251.png
diff --git a/images/rule252.png b/images/rule252.png
diff --git a/images/rule253.png b/images/rule253.png
diff --git a/images/rule254.png b/images/rule254.png
diff --git a/images/rule255.png b/images/rule255.png
diff --git a/images/rule26.png b/images/rule26.png
diff --git a/images/rule27.png b/images/rule27.png
diff --git a/images/rule28.png b/images/rule28.png
diff --git a/images/rule29.png b/images/rule29.png
diff --git a/images/rule3.png b/images/rule3.png
diff --git a/images/rule30.png b/images/rule30.png
diff --git a/images/rule31.png b/images/rule31.png
diff --git a/images/rule32.png b/images/rule32.png
diff --git a/images/rule33.png b/images/rule33.png
diff --git a/images/rule34.png b/images/rule34.png
diff --git a/images/rule35.png b/images/rule35.png
diff --git a/images/rule36.png b/images/rule36.png
diff --git a/images/rule37.png b/images/rule37.png
diff --git a/images/rule38.png b/images/rule38.png
diff --git a/images/rule39.png b/images/rule39.png
diff --git a/images/rule4.png b/images/rule4.png
diff --git a/images/rule40.png b/images/rule40.png
diff --git a/images/rule41.png b/images/rule41.png
diff --git a/images/rule42.png b/images/rule42.png
diff --git a/images/rule43.png b/images/rule43.png
diff --git a/images/rule44.png b/images/rule44.png
diff --git a/images/rule45.png b/images/rule45.png
diff --git a/images/rule46.png b/images/rule46.png
diff --git a/images/rule47.png b/images/rule47.png
diff --git a/images/rule48.png b/images/rule48.png
diff --git a/images/rule49.png b/images/rule49.png
diff --git a/images/rule5.png b/images/rule5.png
diff --git a/images/rule50.png b/images/rule50.png
diff --git a/images/rule51.png b/images/rule51.png
diff --git a/images/rule52.png b/images/rule52.png
diff --git a/images/rule53.png b/images/rule53.png
diff --git a/images/rule54.png b/images/rule54.png
diff --git a/images/rule55.png b/images/rule55.png
diff --git a/images/rule56.png b/images/rule56.png
diff --git a/images/rule57.png b/images/rule57.png
diff --git a/images/rule58.png b/images/rule58.png
diff --git a/images/rule59.png b/images/rule59.png
diff --git a/images/rule6.png b/images/rule6.png
diff --git a/images/rule60.png b/images/rule60.png
diff --git a/images/rule61.png b/images/rule61.png
diff --git a/images/rule62.png b/images/rule62.png
diff --git a/images/rule63.png b/images/rule63.png
diff --git a/images/rule64.png b/images/rule64.png
diff --git a/images/rule65.png b/images/rule65.png
diff --git a/images/rule66.png b/images/rule66.png
diff --git a/images/rule67.png b/images/rule67.png
diff --git a/images/rule68.png b/images/rule68.png
diff --git a/images/rule69.png b/images/rule69.png
diff --git a/images/rule7.png b/images/rule7.png
diff --git a/images/rule70.png b/images/rule70.png
diff --git a/images/rule71.png b/images/rule71.png
diff --git a/images/rule72.png b/images/rule72.png
diff --git a/images/rule73.png b/images/rule73.png
diff --git a/images/rule74.png b/images/rule74.png
diff --git a/images/rule75.png b/images/rule75.png
diff --git a/images/rule76.png b/images/rule76.png
diff --git a/images/rule77.png b/images/rule77.png
diff --git a/images/rule78.png b/images/rule78.png
diff --git a/images/rule79.png b/images/rule79.png
diff --git a/images/rule8.png b/images/rule8.png
diff --git a/images/rule80.png b/images/rule80.png
diff --git a/images/rule81.png b/images/rule81.png
diff --git a/images/rule82.png b/images/rule82.png
diff --git a/images/rule83.png b/images/rule83.png
diff --git a/images/rule84.png b/images/rule84.png
diff --git a/images/rule85.png b/images/rule85.png
diff --git a/images/rule86.png b/images/rule86.png
diff --git a/images/rule87.png b/images/rule87.png
diff --git a/images/rule88.png b/images/rule88.png
diff --git a/images/rule89.png b/images/rule89.png
diff --git a/images/rule9.png b/images/rule9.png
diff --git a/images/rule90.png b/images/rule90.png
diff --git a/images/rule91.png b/images/rule91.png
diff --git a/images/rule92.png b/images/rule92.png
diff --git a/images/rule93.png b/images/rule93.png
diff --git a/images/rule94.png b/images/rule94.png
diff --git a/images/rule95.png b/images/rule95.png
diff --git a/images/rule96.png b/images/rule96.png
diff --git a/images/rule97.png b/images/rule97.png
diff --git a/images/rule98.png b/images/rule98.png
diff --git a/images/rule99.png b/images/rule99.png
diff --git a/requirements.txt b/requirements.txt
@@ -0,0 +1,2 @@
+Pillow
+bitarray
diff --git a/rule30/__init__.py b/rule30/__init__.py
@@ -0,0 +1,3 @@
+#!/usr/bin/env python3
+
+from .automaton import Automaton