|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198 |
- # cellularAutomata
-
- !!! WARNING !!!
- this will probably leak memory until i write a clamp function
- also this readme is out of date
- !!! WARNING !!!
-
- a small application for running a one-dimensional cellular automata from random inputs, using comonads
-
- now also supports 2d automata, check out [here](conwayExample.txt) for an example of the current output of the program
-
- ## usage
-
- the program will default to the size of the window
- `-w` and `-g` inputs can be given to determine the width and height, respectively
-
- ## requirements
-
- * `getOpt`
- * `ncurses` (for detecting term width/height)
-
- ## building / running
-
- builds using nix
-
- from a local folder:
- ```
- nix build .
- ./result/bin/cellularAutomata
- ```
-
- from the repo directly:
- ```
- nix run github:techieAgnostic/cellularAutomata -- -w 40 -g 25
- ```
-
- it may also be included as a flake input, as one normally would, and added to the package list using the included overlay
-
- ## discussion
-
- this program was an exercise in using comonads to simulate cellular automata.
-
- ### cellular automata
-
- a cellular automaton is defined by a calculation on a local space, which is applied to a global space of cells.
-
- in a one dimensional cellular automata, each cell has two immediate neighbors, to the left and right of it.
-
- additionally, each cell may be in one of two state - Alive, or Dead.
-
- this program has a hard-coded (for now) xor-based rule that works as follows:
-
- regardless of the state of the current cell, it will become Alive if one of its neighbors is alive, but not both, otherwise it will Die.
-
- this local behaviour, when viewed on a global scale, can provide emergent behaviour, in this case a nice triangular pattern (when viewed over time).
-
- ### comonads
-
- a comonad is the dual to a monad.
-
- it is defined by two operations, `extract` and `duplicate`.
-
- `extract` takes a comonad (which wraps some base type) and returns a single item of that type, it can be seen in the semantics of a cellular automata space as `extract`ing the focussed cell from the global space.
-
- `duplicate` takes a comonad space, and wraps it in an extra layer of comonad, essentially creating a comonad of comonads. in semantics of a cellular automata, we can `duplicate` a space into that same space, but focussed on every possible cell in the space.
-
- finally, a comonad is a functor, meaning it can be mapped over. we can use this to our advantage in the semantics of a cellular automata, by creating a function from a comonad space, to a cell state.
-
- this function will be our transition function, and determines the new state of the focussed cell, using the non-focussed parts as its inputs.
-
- by `duplicate`ing the comonad space, and mapping the transition function over this new universe of spaces, we get back a single universe, which represents the next step in time.
-
- ### laziness
-
- due to haskell's laziness, the comonad space can (and should) be infinite in both directions, and as long as we remember to bound the space we want to print, our program will work properly.
-
- as such, the functions to change our focus within the space assumes an infinite list, and i have defaulted to "clamping" our focus at the edges if a finite list is given on either direction. im not sure this is semantically the correct choice, but in regular usage (with infinite lists) it should not come up.
-
- ## example
-
- `./cellularAutomata -w 40 -g 25`
-
- ```
- ██ ████ █ █████ █ ███ █ ███ ███
- ██ █ ███ █ ██ █ ███ ██ █ █ █ █ ██
- █ ███ ███ █ ███ █ █ ██ ██ ███
- ███ █ █ █ █ ██ █ ███████ ██ ██
- ███ █ █ █ ██ █ ██ ██ ███ ██
- █ █ █ ██████ █████ ██████ █ █
- ██ ██ █ █ █ ██ █ █ ██ ██ █
- ██ ██ ██ ███ █ █ ███ ███ █ █ █
- █ ███████ ██ ███ █ █ █ █ █ ███ █ ██
- █ █ █████ █ █ ██ █ ██ █ █
- ███ █ ██ █ █ ████ █ ██ ██
- █ █ █ ████ █ █ █ ███ ██ █ █████████
- ██ █ █ ██ █ ███████ █ ██
- █████ ██ █ █████ █ ███ █ ███
- ██ █ ██ ███ ███ █ ██ █ █ ██
- ████ █ █████ ██ ██ █ █ ███ ██ █ ████
- █ ███ █ ██ ██ ██ █ █████ █ ██
- █ █ ███ ██ █ ██ ████████ █ ██ █ ███
- █ █ █ ██ ████ █ ███ █ ███ █ █
- ██ █ █████ █ █ ██ █ █ ██ █
- ██ █ ██ ███ ██ █ ███ █ █ ██ █ █
- ████ █████ ██ █ ██ ███ ███ ██████ ███
- █ █ █ ██ █████ █ █ ██ ██ █ █
- █ █ █ ███ ██ █ ██ ███ █ █
- ██ █ █ ███ █ ███ █ █ ███ █ ███ █ █
- █ █ ██ █ █ █ █ ██ █ █ █ ██
- ```
-
- example using `rule3` and a non-random starting position:
-
- `./cellularAutomata -w 80 -g 80`
-
- ```
- █
- ███
- █ █ █
- ██ █ ██
- █ █ █
- ███ ███ ███
- █ █ █ █ █
- ██ ██ ███ ██ ██
- █ █ █
- ███ ███ ███
- █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █
- ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ██ ██ ██ █ ██ ██ ██ ██ ██
- █ █ █
- ███ ███ ███
- █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █ █ █ █ █
- ███ ███ ███ ███ ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ███ ██ ██ ██ ██ ███ ██ ██ ██ ██ ███ ██ ██
- █ █ █ █ █
- ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █ █ █ █ █ █ █
- ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
- █ █ █
- ███ ███ ███
- █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █ █ █ █ █
- ███ ███ ███ ███ ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ███ ██ ██ ██ ██ ███ ██ ██ ██ ██ ███ ██ ██
- █ █ █ █ █ █ █ █
- █ ███ ███ ███ ███ ███ ███ ███ ██
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █
- █ █ █ █ █ █ █ █ █ █ █ █
- █ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ ██
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ █ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ █ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ █ ██ ██ █
- █ █ █
- ███ ███ ███
- █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █ █ █ █ █
- ███ ███ ███ ███ ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ███ ██ ██ ██ ██ ███ ██ ██ ██ ██ ███ ██ ██
- █ █ █ █ █ █ █
- ███ ███ ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █ █ █ █ █ █ █ █ █
- ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ █ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
- █
- ███
- █ █ █
- ██ █ ██
- █ █ █
- ███ ███ ███
- █ █ █ █ █
- ██ ██ ███ ██ ██
- █ █ █
- ███ ███ ███
- █ █ █ █ █ █ █ █ █
- ██ █ ██ ██ █ ██ ██ █ ██
- █ █ █ █ █
- ███ ███ ███ ███ ███
- █ █ █ █ █ █ █ █ █ █ █
- ██ ██ ██ ██ ██ █ ██ ██ ██ ██ ██
- █ █ █
- ```
|
