Getting started

This page outlines requirements and installation steps for the code. Currently, GNU/Linux and MacOS (including ARM) are supported.

Requirements

gfortran
NetCDF library for FORTRAN
make
curl

Warning

Do not install Julia using your system package manager. Install only from julialang.org

Installation

Follow the steps below in order to setup the code.

Install Julia: curl -fsSL https://install.julialang.org | sh
Download AGNI: git clone https://github.com/nichollsh/AGNI.git
Change directory: cd AGNI
Setup SOCRATES by doing either ONE of the following...
- Follow the instructions on the SOCRATES GitHub page
- Run source get_socrates.sh
julia -e 'using Pkg; Pkg.activate("."); Pkg.build()'

AGNI is now installed as a package into a Julia environment in the AGNI directory. This will also have downloaded some basic input data. You should run the tests next.

Tip

The get_socrates.sh script automatically adds the radiation code to your environment with the variable RAD_DIR, which points to the SOCRATES installation. This variable must be set whenever AGNI is being used.

Testing

Now try running the tests in your terminal.

julia ./test/runtests.jl

This will print information on whether tests passed or failed.

Using the code

See Running the model for information on using the code. See Troubleshooting for troubleshooting advice.