diff --git a/README.org b/README.org new file mode 100644 index 0000000..2860733 --- /dev/null +++ b/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: