In your data folder, run PrepareDirectoriesForBasinSpawn.py.
You will need to update the path and the prefix at the bottom of this file.

In addition, sample names with the underscore character () are not allowed. The script
EliminateUnderscoreFromCRNDataSampleNames.py will replace all characters with - characters.
You need to open this file and change the target directory before running. It will modify all *_CRNData.csv files it finds in that directory.

Next up, spawn the basins. Go into the source code directory and run:

$ ./Spawn_DEMs_for_CRN.exe PATHNAME DATAPREFIX

Now, you are ready to calculate topographic shielding. You should run:

$ ./Shielding_for_CRN.exe PATHNAME DATAPREFIX

Note

If you ran the spawning the data prefix will now have a *_spawned in it.

Warning

This is the most computationally expensive component of the process. It could take a while. In the full documentation there is some instructions as to how to do this computation using an embarrassingly parallel approach.

If you decide to use previously reported snow shielding values, run the JoinSnowShielding.py function.
This will result in data files with the text *_SS in it.

Some more information on setting up LSDTopoTools

LSDTopoTools are written in C++ and work best in Linux.
We realise, however, not that many people use Linux.
We have therefore set up something called a virtual machine that runs a Linux operating system within whichever operating system you normally use (be it Windows, OSX, or Linux).
To do this, we use a nifty bit of software called Vagrant that automates the setup process.
You can read the instructions on our documentation website,
but basically you need to download a few bits of software that are very easy to install, download something called a vagrantfile,
and this vagrantfile automates the construction of a working linux system that has several LSDTopoTools packages.