1.1. Prerequisites¶
1.1.1. Java¶
In order to run Ichthyop, Java (>= 11) needs to be installed. Beforehand, let us clarify some of the acronyms regarding the Java technologies.
JVM
: Java Virtual Machine. It is a set of software programs that interprets the Java byte code.
JRE
: Java Runtime Environment. It is a kit distributed by Sun to execute Java programs. A JRE
provides a JVM
and some basic Java libraries.
JDK
or SDK
: Java (or Software) Development Kit bound to the programmer. It provides a JRE
, a compiler, useful programs, examples and the source of the API (Application Programming Interface: some standard libraries).
It is strongly recommended to download a JDK
, in order to both compile and run the model. Builds for different platforms can be found here.
1.1.2. NetCDF4¶
The Java library that manages input/outputs of NetCDF files requires the external NetCDF C library, which can be installed as follows:
1.1.2.1. Mac Os X¶
To install the library on a Mac Os system, open a Terminal and type:
sudo port install netcdf4
1.1.2.2. Linux¶
To install the library on a Linux system, open a Terminal and type:
sudo apt-get install netcdf4
1.1.2.3. Windows¶
To install the library on a Windows system, download the pre-built libraries ib Unidata website
Danger
During the install process, make sure that the location of the library is added to
the PATH
1.1.3. Conda environmenmt¶
There also is the possibility to use Conda environments in order to install Maven, OpenJDK and NetCDF4 easily. Instructions can be found on https://github.com/ichthyop/ichthyop-conda