mirror/ioccc
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Format fix + update try in 2012/endoh1/README.md

Browse Source 
The coloured version (endoh1_color.c) was not suggested in the try
section and I think that's a shame so I remedied that.

Updated .gitignore with a file referenced by the judges (that probably
will never exist but nonetheless is referenced).

Format fix README.md.
This commit is contained in:
Cody Boone Ferguson committed 2023-05-03 11:15:33 -07:00
1 parent 00c5eed72d
commit 5d41e20499
2 files changed
+34 -24
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

2012/endoh1/.gitignore
+1
View File
@@ -1,3 +1,4 @@
endoh1 endoh1
endoh1.alt endoh1.alt
endoh1_color endoh1_color
configuration.txt
2012/endoh1/README.md
+33 -24
View File
@@ -27,6 +27,11 @@ make
./endoh1 < fountain.txt ./endoh1 < fountain.txt
``` ```
Also try using `endoh1_color` as you would `endoh1` above. `make` will compile
this by default.
### Alternate code: ### Alternate code:
An alternate version of this entry, `endoh1.alt.c`, is provided. An alternate version of this entry, `endoh1.alt.c`, is provided.
@@ -42,7 +47,7 @@ Use `endoh1.alt` as you would `endoh1` above.
## Judges' remarks: ## Judges' remarks:
Let's play Jeopardy! Let's play [Jeopardy!](https://en.wikipedia.org/wiki/Jeopardy!)
* A: An obfuscated program that deals with complex numbers and produces animated ASCII graphics. * A: An obfuscated program that deals with complex numbers and produces animated ASCII graphics.
* Q: What is a Mandelbrot simulator? * Q: What is a Mandelbrot simulator?
@@ -59,7 +64,7 @@ One configuration file was inspired by an [XKCD what if? entry](http://whatif.xk
### Synopsis ### Synopsis
**DO NOT FORGET "-DG=1 -DP=4 -DV=8"** and make your terminal window larger **DO NOT FORGET** `-DG=1 -DP=4 -DV=8` and make your terminal window larger
than 80 x 25. than 80 x 25.
```sh ```sh
@@ -73,6 +78,7 @@ cc endoh1.c -DG=1 -DP=4 -DV=8 -D_BSD_SOURCE -o endoh1 -lm
### What it is ### What it is
```
,___. ,. ,. ,. ,___. ,. ,. ,. ,___. ,. ,. ,. ,___. ,. ,. ,.
|/--' || `' || |/--' `' || |\_. |/--' || `' || |/--' `' || |\_.
|\__. || ,. ,. ,. ,__/| |\__. ,. ,____. ,. ,. || ,_. |/-' ,_. ,__. |\__. || ,. ,. ,. ,__/| |\__. ,. ,____. ,. ,. || ,_. |/-' ,_. ,__.
@@ -99,10 +105,10 @@ cc endoh1.c -DG=1 -DP=4 -DV=8 -D_BSD_SOURCE -o endoh1 -lm
`-'`' `-'`-' `-'`-' `-'`' `'`' `'`' `'`' `-'`' `-'`-' `-'`-' `-'`' `'`' `'`' `'`'
This program is a fluid simulator using "Smoothed-particle hydrodynamics (SPH)" ```
method.
<http://en.wikipedia.org/wiki/Smoothed-particle_hydrodynamics> This program is a fluid simulator using [Smoothed-particle hydrodynamics
(SPH)](http://en.wikipedia.org/wiki/Smoothed-particle_hydrodynamics) method.
The SPH particles represent the fluid flow. Particles have information about The SPH particles represent the fluid flow. Particles have information about
the position, density, and velocity. In every simulation step, they are the position, density, and velocity. In every simulation step, they are
@@ -117,20 +123,22 @@ The compilation options `-DG=1 -DP=4 -DV=8` represent, respectively, the factor
of gravity, pressure, and viscosity. By changing their values, you can see of gravity, pressure, and viscosity. By changing their values, you can see
different fluid behavior. different fluid behavior.
"Marching square"-like algorithm is used to render the particles. [Marching square](http://en.wikipedia.org/wiki/Marching_squares)-like algorithm
is used to render the particles.
<http://en.wikipedia.org/wiki/Marching_squares>
### Portability ### Portability
The program requires a C99 compiler; it uses `complex` types and one-line The program requires a C99 compiler; it uses `complex` types and one-line
comments. It also uses `usleep`, which may require `-D_BSD_SOURCE` or somewhat comments. It also uses `usleep`, which may require `-D_BSD_SOURCE` or so
to build with no warning. Under these conditions, it should be portable. to build with no warning. Under these conditions, it should be portable.
At least, recent compilers with `-std=c99 -Wall -W -Wextra -pedantic` says At least, recent compilers with `-std=c99 -Wall -W -Wextra -pedantic` say
nothing. nothing.
gcc -DG=1 -DP=4 -DV=8 -D_BSD_SOURCE -std=c99 -Wall -W -Wextra -pedantic endoh1.c ```sh
clang -DG=1 -DP=4 -DV=8 -D_BSD_SOURCE -std=c99 -Wall -W -Wextra -pedantic endoh1.c gcc -DG=1 -DP=4 -DV=8 -D_BSD_SOURCE -std=c99 -Wall -W -Wextra -pedantic endoh1.c
clang -DG=1 -DP=4 -DV=8 -D_BSD_SOURCE -std=c99 -Wall -W -Wextra -pedantic endoh1.c
```
I expect it to work in any Unix-like environment. VTxxx/ANSI sequences are I expect it to work in any Unix-like environment. VTxxx/ANSI sequences are
used to clear screen and move cursor to home. used to clear screen and move cursor to home.
@@ -146,11 +154,12 @@ First of all, the source code itself serves as an initial configuration.
Preprocessing directives (such as `#include`)'s `#` serve as walls. Preprocessing directives (such as `#include`)'s `#` serve as walls.
This program uses `double complex` to represent any 2D vector. But, note that This program uses `double complex` to represent any 2D vector. But, note that
x-axis and y-axis is swapped (real axis = y-axis, imaginary axis = x-axis). `x-axis` and `y-axis` is swapped (real axis = y-axis, imaginary axis = x-axis).
The purpose of swapping is not only obfuscation, but also short coding: for The purpose of swapping is not only obfuscation, but also short coding: for
example, to add gravity to total force, `force += G` suffices, rather than example, to add gravity to total force, `force += G` suffices, rather than
`force += G*I`. `force += G*I`.
(Incidentally, you can exert horizontal gravity by using, such as, `-DG=I`)
(Incidentally, you can exert horizontal gravity by using for instance `-DG=I`)
Every five entries of `double complex a[]` contain information of one particle: Every five entries of `double complex a[]` contain information of one particle:
position, wall-flag, density, force, and velocity, in turn. position, wall-flag, density, force, and velocity, in turn.
@@ -164,29 +173,29 @@ casting) it to an integer-type variable.
### Notes about Additional Files ### Notes about Additional Files
"logo.txt" is a source of the logo in this remark file. [logo.txt](logo.txt) is a source of the logo in this remark file.
"column.txt" is a water column collapse, which is a popular demo of SPH. [column.txt](column.txt) is a water column collapse, which is a popular demo of SPH.
"pour-out.txt" pours you a cup of tea. [pour-out.txt](pour-out.txt) pours you a cup of tea.
"tanada.txt" simulates "Terrace farming". ("Tanada" means a "terraced rice [tanada.txt](tanada.txt) simulates "Terrace farming". ("Tanada" means a "[terraced rice
fields" in Japanese.) fields](https://en.wikipedia.org/wiki/Terrace_(earthworks))" in Japanese.)
"clock.txt" is a "water" clock created by HAMANO Tsukasa. [clock.txt](clock.txt) is a "water" clock created by HAMANO Tsukasa.
Other \*.txt files are due to the judges. Other `*.txt` files are from the judges.
"endoh1\_color.c" is a variant that shows the density by using terminal 256 [endoh1_color.c](endoh1_color.c) is a variant that shows the density by using terminal 256
colors. colors.
### Acknowledgment ### Acknowledgments
I would like to thank my wife @hirekoke for her teaching me the SPH method. I would like to thank my wife @hirekoke for her teaching me the SPH method.
The judges <strike>ordered</strike> suggested creating a color version The judges <strike>ordered</strike> suggested creating a color version
after the judgment. after the contest.
The judges and HAMANO Tsukasa (The silver medalist at this IOCCC) kindly The judges and HAMANO Tsukasa (The silver medalist at this IOCCC) kindly
provided many configuration files. provided many configuration files.