erosiv/soillib

Python3 / C++23 Geomorphology Simulation Library and Toolbox

soillib's Issues

What do the parameters mean in the configuration file?

In tools/basic_hydrology/config.yaml, What are the meanings of those parameters and how do they affect the geomorphology? For example, if I don't want to create any lake or pool, how should I adjust these parameters?

lrate: 0.1
scale: 80
max-cycles: 8192
min-basin: 0.05
map:
  dimension:
    - 960
    - 960
water:
  max-age: 1024
  evap-rate: 0.001
  deposition-rate: 0.05
  min-vol: 0.001
  entrainment: 10.0
  gravity: 2.0
  momentum-transfer: 1.0

Normal Calculation

Hey Nick, thanks for your blog posts and code. Been learning a lot!

I haven't managed to get any of your code running on my macOS (some issues with g++-13 when trying to run make) but have had some success in porting the code to JavaScript which I'm more familiar with. It runs very slowly in JS; so I might try AssemblyScript/WASM to speed things up, or see if I can do it GPU side with WebGPU/WebGL.

I'm a bit stuck on normal map calculation at the moment, it appears they have a dramatic effect on visuals and performance. I also see you've gone through a variety of them, is there one that is better suited? I also don't fully understand what number to choose for "scale" as it seems pretty arbitrary—is there anything that could be relative to the physical size of my map, or how the camera is viewing it? Is there a reason #3 appears to result in the smoothest normals and mountain peaks, but you've moved away from that in more recent projects?

1. soillib - layermap

2. SimpleHydrology - cellpool

3. SimpleErosion - world (I find this to be the "smoothest" so far)

Here's some differences just when I change the normal function from one to another:

Cheers!