Fair Use Policy

STILT is freely available and we encourage others to use it. Kindly keep us informed of how you are using the model and of any publication plans. Please acknowledge the source as a citation. STILT is continuously updated and improved by the development consortium, and in some cases (as when new elements are used for the first time) we may suggest that one or more of the developers be offered participation as authors. If your work directly competes with our analysis, we may ask that we have the opportunity to submit a manuscript before you submit one that uses unpublished features. The software is updated from time to time, and it is your responsibility to ensure that your publication is consistent with the most recent version.

Installation

STILT has been compiled to run on UNIX platforms (Mac, Linux). Required software includes

Install methods

Two options exist to initialize a new STILT project.

R (preferred)

This method uses R to initialize a new project. stilt_init() in the Utah Atmospheric Trace gas & Air Quality (UATAQ) R package, which includes tools for trace gas data manipulation and analysis, is a wrapper around several system commands that do much of the heavy lifting. The uataq R package is available on Github and can be installed in R using devtools.

R
if (!require('devtools')) install.packages('devtools')
devtools::install_github('benfasoli/uataq')

A STILT project is initialized in plain R code with

R
uataq::stilt_init('myproject')
Cloning into 'stilt'...
remote: Counting objects: 1712, done.
remote: Compressing objects: 100% (275/275), done.
remote: Total 1712 (delta 71), reused 267 (delta 39), pack-reused 1384
Receiving objects: 100% (1712/1712), 32.85 MiB | 8.57 MiB/s, done.
Resolving deltas: 100% (652/652), done.
Checking connectivity... done.

STILT hymodelc installation options:
1 - Compile hymodelc from source
2 - hymodelc-centos-7.4
3 - hymodelc-ubuntu-16.04
4 - hymodelc-ubuntu-14.04
5 - hymodelc-macos-10.13

Install option (number from above):

Binaries are available for several systems or you can choose to compile the hymodelc binary from the source. Compiling from source code requires user registration to receive login credentials to the SVN repository.

Since the name of the Github Repository is “stilt”, a name other than “stilt” should be chosen for projects. Otherwise, conflicts will arise when attempting to clone the master repository for initializing future projects in the same parent directory.

Manual

While the R method is preferable since it streamlines the process of initializing new projects, the same can be accomplished manually. To reproduce the results above,

# Clone GitHub repo for R wrapper
git clone https://github.com/benfasoli/stilt
# Set the name of the project
mv stilt myproject

# Checkout merged_stilt_hysplit from SVN
svn --username {USERNAME} checkout \
    https://projects.bgc-jena.mpg.de/STILT/svn/trunk/merged_stilt_hysplit/ \
    fortran/
# Compile hymodelc using the provided makefile
(cd fortran && make)
# Move the hymodelc binary to exe/
mv fortran/hymodelc exe/hymodelc
# Ensure hymodelc is executable
chmod +x exe/hymodelc

# Compile permute DLL for footprint kernel aggregation
R CMD SHLIB r/src/permute.f90

Finally, edit settings in r/run_stilt.r, being sure to specify the project name and the working directory.