REAMDE.org: Add.

README.org

@@ -0,0 +1,38 @@
+#+TITLE: dds: A Home-made Toolkit for Discrete Dynamical Systems in Racket
+
+This is a toolkit for playing with various discrete dynamical systems
+in [[https://racket-lang.org/][Racket]].  A discrete dynamical system is a system which evolves from
+a discrete state to some other discrete states (many or one).  The
+systems are discrete in the sense that we can identify successive
+states with no other states in between.  Equivalently, the phase state
+of the system is discrete (and is often called the state graph).
+These constraints imply the possibility of associating discrete,
+possibly branching timelines to any evolution of the system.
+
+*DISCLAIMER:* I develop this toolkit as a support for my research on
+discrete dynamical systems.  The primary objective for this framework
+is to fit my approach to these systems.  Essentially, this framework
+should fit to the "shape of my mind", which is not necessarily the
+same as yours.
+
+Currently, the toolkit includes the following files:
+
+  - [[file:generic.rkt][generic.rkt]]: The generic interface for a discrete dynamical
+    system, with functions for constructing state graphs.
+  - [[file:utils.rkt][utils.rkt]]: Misc utility functions.
+  - [[file:networks.rkt][networks.rkt]]: Implements network-based models, which generalise
+    Boolean networks, threshold Boolean automata networks, multivalued
+    networks, etc.
+  - [[file:rs.rkt][rs.rkt]]: Implements reaction systems, a variant of set rewriting.
+
+The toolkit is designed with Emacs [[https://orgmode.org/][Org-mode]] interoperability in mind.
+The file [[file:example/example.org][example/example.org]] explains the features available for
+interaction with Org-mode.
+
+
+* Local Variables                                                  :noexport:
+  # Local Variables:
+  # eval: (auto-fill-mode)
+  # ispell-local-dictionary: "en"
+  # org-link-file-path-type: relative
+  # End: