Installation

Supported language:

• Python: 3.7

Note

We highly recommend installing and using the free Anaconda distribution of Python (or Miniconda, if you don’t want all of the extra packages that come built-in with Anaconda), which works on Mac, Linux, and Windows, both on normal computers and institutional clusters and doesn’t require root permissions.

Isca depends on the following libraries

• f90nml

• fortran-compiler

• jinja2

• libgfortran

• netcdf-fortran

• numpy

• openmpi

• pandas

• python=3.7

• pip

• pytest

• sh

• tqdm

• xarray

After the required packages are installed, Isca can be installed from source.

Clone from Github

You can obtain it directly from the Github repo

git clone https://www.github.com/execlim/isca.git
cd  isca/src/extra/python
pip install -e .

Verifying proper installation

Once installed via any of these methods, you can run isca’s suite of tests using py.test. From the top-level directory of the isca installation

conda install pytest  # if you don't have it already; or 'pip install pytest'
py.test

If the pytest command results in any error messages or test failures, something has gone wrong, and please refer to the Troubleshooting information below.

Troubleshooting

If you’re having compiler issues please speak to your computing officer. We’ve tried and tested Intel Fortran, GFortran (usually works) and Cray-Fortran. NetCDF compilers can also be an issue too.

Please search through the Issues page on Github if anybody else has had the same problem you’re facing. If none do, then please send open a new Issue.