Terrasaur is a suite of programs written in Java and C++. These standalone command line analysis and shape model manipulation programs complement the Small Body Mapping Tool and create data products that are well-suited to being visualized in the SBMT GUI. Among other functions, these programs facilitate the building of digital terrain models (DTMs) of small bodies, permit assessing the quality of these DTMs, and construct a broad suite of DTM products that characterize the geophysical and surface properties of small bodies.
The Terrasaur package requires Java 21 or later. Some freely available versions are
- Amazon Corretto
- Azul Zulu
- Eclipse Temurin
- OpenJDK. Most Linux distributions and HomeBrew have OpenJDK packages.
Precompiled release packages can be found on GitHub
If you don't want to use the prebuilt package, check out the code:
git clone https://github.com/JHUAPL/Terrasaur.git
The 3rd party executables and libraries are assumed to exist in
3rd-party/$(uname -s)_$(uname -m) (e.g. 3rd-party/Darwin_x86_64 on an
Intel macOS machine). The script to build the 3rd party products is in the
support-libraries directory.
cd support-libraries
./buildAll.bash ../3rd-party/$(uname -s)_$(uname -m)
You can instead use the precompiled support libraries from a release package to save a lot of time. See the support-libraries README.
Maven must be installed to build the software. Once the 3rd-party
directory has been built, compile the Terrasaur package using the
mkPackage.bash script:
./mkPackage.bash
This will create executable and source packages in the dist directory, named SBCLT-YYYY.MM.DD.tar.gz and SBCLT-YYYY.MM.DD-src.tar.gz
Sphinx with the
PD
theme is used to create the documentation in the doc/ folder.
cd (your destination directory)
tar xfz (path to command-line-tools)/dist/Terrasaur-YYYY.MM.DD.tar.gz
The scripts/ directory contains all the applications in the
package. Running without any arguments will display a usage message.
The doc/ directory contains documentation including a javadoc
directory.