====== Compiling and running Terrest ======


  * There are two parts to Terrest: the code itself and the GUI written by Seth, which makes it easier to edit the parameters. These are located on the DEM svn at **svn://dem.cs.umass.edu** in folders Winrock and WinrockFE. Right click on the desktop and go to the SVN browser:

{{ :documentation:compileterrest_0.jpg }}

{{ :documentation:compileterrest_1.jpg }}


  * You need to check both of these out of the repository but into separate locations - each folder contains a file named setup.py, which is a collection of python compilation instructions. After you have a copy of these on your drive, you need to compile the contents by running the command **python setup.py py2exe** on each of the setup.py files:

{{ :documentation:compileterrest_2.jpg }}

{{ :documentation:compileterrest_3.jpg }}


  * Launch a command prompt, navigate to one of the directories containing the source code and run the **python setup.py py2exe** command

{{ :documentation:compileterrest_4.jpg }}


  * If everything compiles without trouble (and it should, provided that you have the necessary python prerequisites and windows DLLs installed), you will see two new directories: **build** and **dist**. The **dist** directory will contain the compiled code and the main executable for Terrest, **TerrestDEM.exe**

{{ :documentation:compileterrest_5.jpg }}


  * When you repeat the compilation process for the front end, you will see a dist directory again containing the main executable **WinrockFE.exe**

{{ :documentation:compileterrest_6.jpg }}


  * If you run **WinrockFE.exe**, you'll see the GUI for Terrest, where you can change parameters:

{{ :documentation:compileterrest_7.jpg }}


  * You will need to point the GUI to the correct directories for images / work and image / triangulation report files. Once that is done, and you want to run Terrest, the program will ask you about the location of **TerrestDEM.exe**, which is the file that we compiled above.

{{ :documentation:compileterrest_8.jpg }}