Add README and some preview pictures

1 files changed, 24 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6b54f0d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Firmament
+
+Visualization of the sky's color using ray marching to model Rayleigh and Mie scattering.
+
+| Example                | Description                                                      |
+| ---------------------- | ---------------------------------------------------------------- |
+|`sunrise.py`            | Plain sky view with arbitrary sun direction                      |
+|`bluedot.py`            | Atmosphere seen from space                                       |
+|`local_sunrise.py`      | Course of the sun as seen from a given position at a given time  |
+|`fancy_local_sunrise.py`| The full firmament as seen from a given position at a given time |
+
+## Preview
+
+[![Pinhole view of the sky](example/2020-01-21_09-00-00_sunrise_at_karlsruhe_palace.png)](https://www.youtube.com/watch?v=ECRpKVc4RtA)
+
+[![Blue dot](example/bluedot.png)](https://www.youtube.com/watch?v=nmtQa8tnr84)
+
+[![Fisheye view of the sky](example/2020-08-01_12-00-00_firmament_at_karlsruhe_palace.png)](https://www.youtube.com/watch?v=aewYpD883WY)
+
+## Literature
+
+* Nishita et al. _Display of the Earth Taking into Account Atmospheric Scattering._ In Proceedings of the 20th Annual Conference on Computer Graphics and Interactive Techniques - SIGGRAPH ’93, 175–82. ACM Press, 1993. `10.1145/166117.166140`
+* Hillaire. _Physically Based Sky, Atmosphere and Cloud Rendering in Frostbite_
+* _Appendix D: Solar radiation_, ME 4131: Thermal Environmental Engineering Laboratory Manual