RunningDemosAndTests

How to run Demos and Tests to get started with your own ATS simulations

Often a beginner user will want to start building their own ATS simulations from existing examples. The ATS community and developers have put together a large suite of Demos and Tests that will be handy for this purpose.

Instructions on how to run these Demos and Tests via python scripts are given in corresponding repositories. However, if you want to run them directly without using these python intermediaries, be mindful of the relative paths to external components needed in these simulations, such as .exo mesh files, .h5 forcing data files, or input files and databases used by the geochemical engines pflotran and crunchflow.

The directory structure of the Demos and Tests repositories assumes that the user will be creating specific directories and running these examples inside them. That is,

1. go to directory where the .xml file lives, e.g.

cd ats-demos/02_richards

2. create a directory for the run and change into it, e.g.

mkdir infiltration

cd infiltration

3. run ats using relative path to the .xml file, which now sits in the directory up, e.g.

ats ../infiltration.xml

Then, you can start editing and modifying the .xml file to build your own ATS simulation. Have fun.