Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/two-twelve/fernery
A CLI tool for generating images of ferns 🌿 and other Iterated Function Systems
https://github.com/two-twelve/fernery
barnsley-fern cli cli-app cli-tool dragon-curve fractal fractal-generators fractal-images fractal-rendering fractals generative-art haskell haskell-cli iterated-function-system koch-snowflake prs-welcome sierpinski sierpinski-gasket sierpinski-triangle
Last synced: 2 months ago
JSON representation
A CLI tool for generating images of ferns 🌿 and other Iterated Function Systems
- Host: GitHub
- URL: https://github.com/two-twelve/fernery
- Owner: two-twelve
- License: mit
- Created: 2023-03-20T09:57:34.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-31T12:23:31.000Z (about 1 year ago)
- Last Synced: 2024-04-09T11:58:58.790Z (9 months ago)
- Topics: barnsley-fern, cli, cli-app, cli-tool, dragon-curve, fractal, fractal-generators, fractal-images, fractal-rendering, fractals, generative-art, haskell, haskell-cli, iterated-function-system, koch-snowflake, prs-welcome, sierpinski, sierpinski-gasket, sierpinski-triangle
- Language: Haskell
- Homepage:
- Size: 701 KB
- Stars: 47
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome - two-twelve/fernery - fern,cli,cli-app,cli-tool,dragon-curve,fractal,fractal-generators,fractal-images,fractal-rendering,fractals,generative-art,haskell,haskell-cli,iterated-function-system,koch-snowflake,prs-welcome,sierpinski,sierpinski-gasket,sierpinski-triangle pushed_at:2023-12 star:0.0k fork:0.0k A CLI tool for generating images of ferns 🌿 and other Iterated Function Systems (Haskell)
README
# Fernery 🌿
A CLI tool for generating images of ferns and other [Iterated Function Systems](https://en.wikipedia.org/wiki/Iterated_function_system).
## Getting Started
Install [stack](https://docs.haskellstack.org/en/stable/install_and_upgrade/), then:
```bash
git clone [email protected]:TheTeaCat/fernery.git
cd fernery
stack build
stack exec fernery-exe
```
This should generate an image of a Barnsley fern at [./fern.png](./fern.png) by default, with colours reminiscent of an [Anna Atkins cyanotype](https://www.moma.org/artists/231).
Various options are available to customise the appearance of the ferns. To see the supported options, do:
```bash
stack exec -- fernery-exe --help
```
### Installing with Homebrew (macOS)
Fernery is also available to install from our Homebrew Tap.
```bash
brew tap two-twelve/tap
brew install fernery
fernery --help
```
## [FractalTees.Shop](https://fractal-tees.teemill.com/) 🛍
A selection of images generated using Fernery are available printed on T-shirts and tote bags at [fractaltees.shop](https://fractal-tees.teemill.com/).
## Example Images
This list of examples is currently exhaustive of the IFSs provided in Fernery, but I'd love to see more added to this little CLI tool. PRs are welcome! 🧑🎨
- [Barnsley Fern](#Barnsley-Fern)
- [Leptosporangiate Fern](#Leptosporangiate-Fern)
- [Thelypteridaceae Fern](#Thelypteridaceae-Fern)
- [The Sierpinski Gasket](#The-Sierpinski-Gasket)
- [The Sierpinski Carpet](#The-Sierpinski-Carpet)
- [The Sierpinski Pentagon](#The-Sierpinski-Pentagon)
- [The Levy Dragon](#The-Levy-Dragon)
- [The Heighway Dragon](#The-Heighway-Dragon)
- [McWorter's Pentigree](#McWorters-Pentigree)
- [The Koch Curve](#The-Koch-Curve)
- [The Koch Snowflake](#The-Koch-Snowflake)
- [DavidLDewey Fractal](#DavidLDewey-Fractal)
- [Tree Fractal](#Tree-Fractal)
### Barnsley Fern
```bash
stack exec -- fernery-exe -f barnsley
```
### Leptosporangiate Fern
The transforms used in this fern were found [here](https://en.wikipedia.org/wiki/File:Barnsley_fern_mutated_-Leptosporangiate_fern.PNG).
```bash
stack exec -- fernery-exe -f leptosporangiate -s '(210, -160)'
```
### Thelypteridaceae Fern
The transforms used in this fern were found [here](https://en.wikipedia.org/wiki/File:Barnsley_fern_with_different_coefficients_plotted_with_VisSim.PNG).
```bash
stack exec -- fernery-exe -f thelypteridaceae -s '(-210, 125)'
```
### The Sierpinski Gasket
```bash
stack exec -- fernery-exe -f sierpinskiGasket -o '(500,1000)' -s '(500,500)' -c 'PixelRGBA8 0 0 0 255' -b 'PixelRGBA8 255 255 255 255'
```
### The Sierpinski Carpet
```bash
stack exec -- fernery-exe -f sierpinskiCarpet -o '(50,50)' -s '(900,900)' -i 10000000 -c 'PixelRGBA8 255 255 255 255' -b 'PixelRGBA8 114 47 55 255'
```
### The Sierpinski Pentagon
```bash
stack exec -- fernery-exe -f sierpinskiPentagon -o '(250,875)' -s '(500,500)' -b 'PixelRGBA8 135 206 235 255' -c 'PixelRGBA8 0 0 0 255'
```
### The Levy Dragon
```bash
stack exec -- fernery-exe -f levyDragon -o '(275,250)' -s '(450,450)' -d '(1000,800)' -b 'PixelRGBA8 251 206 177 255' -c 'PixelRGBA8 0 0 0 255'
```
### The Heighway Dragon
```bash
stack exec -- fernery-exe -f heighwayDragon -o '(250,500)' -d '(1000, 800)' -s '(600,600)' -c 'PixelRGBA8 0 0 0 255' -b 'PixelRGBA8 255 255 255 255' -i 2000000
```
### McWorter's Pentigree
```bash
stack exec -- fernery-exe -f mcWortersPentigree -o '(130,330)' -s '(800,800)' -b 'PixelRGBA88 202 231 193 255' -c PixelRGBA88 0 0 0 255'
```
### The Koch Curve
```bash
stack exec -- fernery-exe -f kochCurve -s '(900,-900)' -o '(50,450)' -d '(1000,600)' -b 'PixelRGBA8 120 81 169 255'
```
### The Koch Snowflake
```bash
stack exec -- fernery-exe -f kochSnowflake -o '(500,500)' -s '(450,450)' -b 'PixelRGBA8 220 243 255 255' -c 'PixelRGBA8 57 109 124 255'
```
### DavidLDewey Fractal
The transforms used to generate this fractal are from an old worksheet authored by David L. Dewey which can be found [here](https://courses.cs.washington.edu/courses/cse142/01sp/misc/fractal_lab.htm).
```bash
stack exec -- fernery-exe -f davidLDewey -s '(3,3)' -o '(850,500)' -d '(1700,1000)' -b 'PixelRGBA8 255 255 255 255' -c 'PixelRGBA8 0 0 0 255'
```
### Tree Fractal
This fractal can also be found on Peter E. Francis' [IFS Fractals](http://ifs-fractals.herokuapp.com/playground/tree).
```bash
stack exec -- fernery-exe -f treeFractal -o '(50,950)' -s '(900,-900)' -c 'PixelRGBA8 0 0 0 255' -b 'PixelRGBA8 255 255 255 255'
```
## Acknowledgements
The following have been useful sources of Iterative Function Systems to add to Fernery:
- [Larry Riddle's Classic Iterated Function Systems](https://larryriddle.agnesscott.org/ifs/ifs.htm)
- [David L. Dewey's Generating Fractals with Affine Transformations](https://courses.cs.washington.edu/courses/cse142/01sp/misc/fractal_lab.htm)
- [Peter E. Francis' IFS Fractals](http://ifs-fractals.herokuapp.com/)