# cliifs
**Command Line Interface Iterated Function Systems**
Render and view fractals, using the chaos game, from iterated functions systems right on your terminal.
### Screenshots
<img width="983" alt="Screen Shot 2019-03-28 at 9 46 45 AM" src="https://user-images.githubusercontent.com/47536723/55176509-7c7e8780-513e-11e9-8598-cf8afb2a9e4b.png">
<img width="1280" alt="cliifs" src="https://user-images.githubusercontent.com/47536723/55172096-ba77ad80-5136-11e9-8c2d-49b412cd3711.png">
<img width="1280" alt="cliifs" src="https://user-images.githubusercontent.com/47536723/55172172-db400300-5136-11e9-9503-1a729f366811.gif">
# Installation
###
Install via pip with `pip install cliifs` or download the appropriate binary from [releases](https://github.com/raphaelreyna/cliifs/releases/tag/v0.4)
# How To Use
cliifs reads in a plaintext file that contains the univariate linear functions you wish to use for your IFS.
The first line must begin with either `1D` or `2D`.
The following lines each represent the coefficients of linear equations, and you may add as many as you like.
See below for specifics on how to write these files.
See the included examples for more details.
### Invocation example
To render the IFS stored in a file called `exampleFile`, simply `cd` into the directory that contains `exampleFile` and run:
`cliifs exampleFile`
To render, with animation and color, runthe command:
`cliifs exampleFile -c -a`
#### Flags
cliifs accepts the following flags
* `-h` for help.
* `-c` to render in random colors.
* `-i N` to render using N iterations.
* `-a` to animate.
* `-d D` to delay each frame by D milliseconds if animating.
* `-m M` to set the collection of markers to be used at random.
## 1 Dimensional Systems
One dimensional systems are given as a test file whose first line reads simply `1D`.
Each subsequent line has the form `a b` which represents the function `f(x) = ax+b`.
For example, the Cantor set, generated by `f(x) = x/3+0` and `g(x) = x/3+2/3`, would be given as a text file with the following lines:
`1D`
`0.333 0`
`0.333 0.666`
## 2 Dimensional Systems
Two dimensional systems are given as a test file whose first line reads simply `2D`.
Each subsequent line has the form `a1 b1 a2 b2 c1 c2` which represents the vector function `f(v) = Av+b`.
In this function, `A` is the matrix with rows `{a1, b1}` and `{a2, b2}`, `b` is the vector `{c1, c2}` and `v` is the position vector `{x,y}`.
For example, the Sierpinski Gasket, generated by `f(x,y) = (0.5x+0y, 0x+0.5y)+(0,0)`, `g(x,y) = (0.5x+0y,0x+0.5y)+(0.5,0)`,
and `h(x,y) = (0.5x+0y,0x+0.5y)+(0.25,0.5)` would be given as a text file with the following lines:
`2D`
`0.5 0 0 0.5 0 0`
`0.5 0 0 0.5 0.5 0`
`0.5 0 0 0.5 0.25 0.5`
