# cliifs Release 0.5

Render and view fractals from iterated functions systems right on your terminal.

Keywords
fractals chaos ifs
GPL-3.0
Install
``` pip install cliifs==0.5 ```

# cliifs

Command Line Interface Iterated Function Systems

Render and view fractals, using the chaos game, from iterated functions systems right on your terminal.

# Installation

Install via pip with `pip install cliifs` or download the appropriate binary from releases

# 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`