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
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
./src/get_socrates.sh
- Finally, install AGNI:
./src/get_agni.sh
AGNI is now installed as a package into the Julia environment of the AGNI directory. This will also have downloaded some basic input data and run the tests.
The RAD_DIR
environment variable must be set to your SOCRATES path whenever AGNI is being used. This is so that AGNI can locate the SOCRATES libraries.
Testing
If you want to run the tests manually, simply use the script in the test/
folder...
julia test/runtests.jl
This will print information on whether tests passed or failed.
Updating
It's important that you keep AGNI up to date, especially if you are using as part of the PROTEUS framework. Use this script to automatically pull changes from GitHub and download any required data files.
./src/get_agni.sh
Using the code
See Using the model for information on using the code. See Troubleshooting for troubleshooting advice.
Coupling with FastChem
Coupling with FastChem can be enabled using the configuration parameter composition.chemistry
. Of course, it is first necessary to set up FastChem, which can be done by running:
./src/get_fastchem.sh
You must then set the FC_DIR
environment variable to the location of the FastChem installation folder. Ideally you should also add this variable to your bashrc file.