jarotsim docs corrections

This commit is contained in:
sejo 2022-04-06 19:39:44 -05:00
parent 43581a984c
commit 587f352926
1 changed files with 23 additions and 10 deletions

View File

@ -28,6 +28,8 @@ the table of rules is read as follows: given a specific pose of the bird with a
* which should be the new pose of the bird with a hat?
* in which direction should the bird with a hat move, in order to stand in a different tile?
=> ./img/screenshot_jarotsim-rule-active.png an active rule as described in the section below
the process is repeated over and over again. it might never end, unless the table of rules tells the bird with a hat to stop.
and yes, in case you didn't know yet, all of that is what a turing machine does!
@ -49,27 +51,27 @@ the top section of this screen allows you to modify:
* the state of the row of tiles: click on a tile to rotate between the four possible designs
* the current pose of the bird with a hat: click on the bird to rotate between the four possible poses
* the position of the bird with a hat on the row of tiles: click on the arrows to shift the row right or left
* the position of the bird on the row of tiles: click on the arrows to shift the row right or left
you can clear the row of tiles by clicking on the bin icon at the top right corner when you are in edit mode.
you can clear the row of tiles by clicking on the bin icon at the top right corner.
### table of rules
the rest of the screen allows you to modify the table of rules.
there is one rule for each combination of pose and tile. therefore there are sixteen rules.
there is one rule for each combination of pose and tile; therefore there are sixteen rules.
depending on the size of the screen, you might be able to see them all, or you might need to use the arrows to rotate between the pages of the table.
=> ./img/screenshot_jarotsim-rule-active.png an active rule as described blow
a rule consists of the following elements:
* a combination of pose and tile at the top: you can't modify these
* at the top, a combination of pose and tile design: these are fixed.
* the tile design that will be used to replace the current tile: you can click on it to rotate between the four possible designs.
* the pose of the bird in the next step: you can click on the bird to rotate between the four possible poses, and a fifth one that indicates that the bird will halt.
* where in the row the bird should move, right or left of the current tile. you can click on the empty space at the left or right of the tile to have the bird move there.
=> ./img/screenshot_jarotsim-rule-active.png an active rule as described above
the table of rules highlights the rule that would currently apply, given the pose of the bird and the tile design where they are standing.
the halt pose will hide the new tile design, and additionally it will never be highlighted.
@ -80,6 +82,14 @@ the halt pose will hide the new tile design, and additionally it will never be h
=> ./img/screenshot_jarotsim_timeline.png screenshot of the timeline mode as described below
the timeline mode accumulates several past iterations of the process so that you can see its evolution.
when the screen has been filled, the timeline automatically scrolls so that the current state is at the bottom.
the previous states are always arranged relative to the bird with a hat in the current state.
it's very encouraged to use this mode as a source of visuals for algoraves.
# toolbar
the toolbar at the bottom has the following buttons, from left to right:
@ -87,12 +97,17 @@ the toolbar at the bottom has the following buttons, from left to right:
* step: apply the current rule and get to the next step.
* play/pause: have the bird with a hat move automatically according to the rules.
* speed: rotate between three different speed levels for the automatic movement.
* mode: allow you to toggle between edit and timeline mode.
* mode: toggle between edit and timeline mode.
the toolbar can be used regardless of the mode that jarotsim is on. therefore you can e.g. see how the rules are applied live, and even modify them while the bird with a hat is moving.
the toolbar can be used regardless of the mode that jarotsim is on.
therefore you can e.g. see how the rules are applied live, and even modify them while the bird with a hat is moving.
note that the bird will pause when it arrives at a rule with a halt pose. you won't be able to step or press play until you change the rule, the current pose, and/or the current tile design.
have fun!
=> ./img/icono_jarotsim_64p.png jarotsim icon: a bird with a hat
# about
@ -105,5 +120,3 @@ for the moment the idea is to have a maximum of 4 states and 4 symbols. accordin
=> https://www.wolframscience.com/nks/p78--turing-machines/ Turing Machines: A New Kind of Science | Online by Stephen Wolfram
as of now, all of the machines described in {máquinas de turing} can be simulated in jarotsim.
=> ./img/icono_jarotsim_64p.png jarotsim icon: a bird with a hat