Mindwerks / worldengine

World generator using simulation of plates, rain shadow, erosion, etc.
MIT License
988 stars 129 forks source link

Scientific Documentation for Algorithms #135

Open tcld opened 8 years ago

tcld commented 8 years ago

Sorry for spamming so many messages over the past few days, I hope you don't drown in mails and can withstand it for a little bit longer. My curiosity will die down eventually. (Or my time run out.^^)

After I just read about the problem with rivers (https://github.com/Mindwerks/worldengine/issues/119) and after digging through some source-files that I can technically follow but lack the knowledge to actually understand, I was wondering if you guys could maybe put links to articles/papers or similar into comments whenever you know any. I noticed how this was handled in the tectonics.js-project (https://github.com/davidson16807/tectonics.js/blob/master/scripts/model/World.js) and, being a completely empty bucket when it comes to geology, I would really appreciate hints like that. Other people may come who think the same, and overall it is just a good habit to follow in my opinion.

For example, I took a lot of time looking at irrigation.py and probably know the method it follows by heart - but I have actually no clue why it does what it does, hence I could never find a systematical error, if there was one. (And I am not asking for an explanation. Just try to add some comments, should you know any sources. Or if it is just a custom algorithm, please give a short note on what it is supposed to do. :) )