Installation

Prerequisite

Make sure you have installed or loaded a python version that is 3.7 or later but not newer than 3.10 (see also Before you continue). Use a pip version that is up-to-date (to update run pip install -U pip). Also make sure that the location to which the python binaries of ESM-Tools will be installed (which is ~/.local/bin by default) is in your PATH. For that purpose, add the following lines to one of your login or profile files, i.e. ~/.bash_profile, ~/.bashrc, ~/.profile, etc.:

$ export PATH=$PATH:~/.local/bin
$ export LC_ALL=en_US.UTF-8
$ export LANG=en_US.UTF-8

Installing in local environment

After downloading the ESM-Tools software (see Get ESM-Tools) you have a new folder named esm_tools. In this new folder you find the script to install ESM-Tools on the HPC your are running this install script on.

To change into the new folder and execute the instalation script, execute the following commands:

$ cd esm_tools
$ ./install.sh

This should install all necessary python packages of ESM-Tools. If you wonder where they end up, take a look at ~/.local/lib/python%versionnumber%/site-packages.

To see where ESM-Tools are installed, run the following command:

$ which esm_tools

A possible (default) output can be ~/.local/bin/esm_tools.

Installing using pip

tbd

Installing in a conda environment

Work in progress. We are still testing it.

Update ESM-Tools

If you installed in editable mode as described above, you can update ESM-Tools by using git:

$ cd esm_tools
$ git pull origin release

Uninstall ESM-Tools

We are sorry to see you go! To uninstall your current installation make sure you have the most recent version of pip available for your system:

$ python3 -m pip install -U pip

Then, you can use use the following command to uninstall all ESM-Tools packages:

$ pip freeze | grep esm | xargs pip uninstall -y

You can also choose to manually uninstall. In order to do that, remove the installed Python packages and delete the esm_* executables. The following commands will do the trick if you installed with the install.sh script or installed using pip with user mode

$ rm -ri ~/.local/bin/esm*
$ rm -ri ~/.local/lib/python3.<version>/site-packages/esm*

Note that you may have a different Python version, so the second command might need to be adapted. You may also use pip to uninstall any of the packages:

$ pip uninstall [--user] esm-tools

The --user flag may be required when using pip if you are not uninstalling in either a virtual environment or a global install (you would need to be root in that case).