Skip to content

Commit

Permalink
Fix README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
InCogNiTo124 committed Feb 27, 2020
1 parent 4fac98f commit 70ab47e
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@
Plot chaos using Python3/[Kivy](https://kivy.org/)
## What is it?
It's a visualization of iterated maps. A starting population P is selected (by a vertical slider on the far left) and then run through a function (as selected in the upper left). The result is then feeded once again through the same function, over and over again. This is called *MAP ITERATION*. Sequential values are plotted with the red line on the graph in the upper right.
An interesting behaviour can be observed if the value of R (big central horizontal slide) is increased. At first, almost every^(1)^ starting population converges to a fixed number. By increasing the R slider even more, our iterated map starts to oscillate between 2 values. If R keeps getting bigger, we see the period 4, than 8, 16... and so on until it gets chaotic and starts to take any value from [0, 1] interval in a seemingly random fashion.
*AND THEN*, if R keeps increasing, from chaos emerges order. Our wild iterated map settles down to oscillations with period of 3. And then 6. And then 12. And then more chaos^(2)^, until R hits 4, where our maps starts to diverge.
An interesting behaviour can be observed if the value of R (big central horizontal slide) is increased. At first, almost every<sup>1</sup> starting population converges to a fixed number. By increasing the R slider even more, our iterated map starts to oscillate between 2 values. If R keeps getting bigger, we see the period 4, than 8, 16... and so on until it gets chaotic and starts to take any value from [0, 1] interval in a seemingly random fashion.
*AND THEN*, if R keeps increasing, from chaos emerges order. Our wild iterated map settles down to oscillations with period of 3. And then 6. And then 12. And then more chaos<sup>2</sup>, until R hits 4, where our maps starts to diverge.
If we plot the values the map converges to as a function of R, we get a [bifurcation diagram](https://en.wikipedia.org/wiki/Bifurcation_diagram) (the big graph at the bottom). "Bifurcation" is a fancy word to say "it splits in two and looks like a fork".

## How to use it?
1. Choose a function you wish to iterate. The first one usually gives the best results.
2. Observe the bifurcation diagram slowly^(3)^ appearing in front of you and be amazed.
2. Observe the bifurcation diagram slowly<sup>3</sup> appearing in front of you and be amazed.
3. Change the R with the big slider in the middle. Observe what happens with the population graph. The vertical line in the diagram shows where the population graph from above fits into the bifurcation diagram. Be more amazed.
4. Change the starting population:
1. If you're in the "tame" zone, observe how the oscillating values don't change much with respect to the starting population.
Expand All @@ -33,9 +33,9 @@ python chaosplotter.py
```
and enjoy :)

- <sup>(1)</sup> This is true for all values in [0, 1], except 0 and 1 (so technically <0, 1>), and maybe some points inside that interval
- ^(2)^ Actually, you can find periods of any length: 5, 13, 120497... You name the natural number, the corresponding period is in there somewhere
- ^(3)^ Yes, I am aware of how slow it is. It takes, on average, around 60 seconds on my Ryzen 7
- <sup>1</sup> This is true for all values in [0, 1], except 0 and 1 (so technically <0, 1>), and maybe some points inside that interval
- <sup>2</sup> Actually, you can find periods of any length: 5, 13, 120497... You name the natural number, the corresponding period is in there somewhere
- <sup>3</sup> Yes, I am aware of how slow it is. It takes, on average, around 60 seconds on my Ryzen 7
## Wish to contribute?
You are very welcome. Just open an issue or push a PR.

Expand Down

0 comments on commit 70ab47e

Please sign in to comment.