Workshops

We will work in a terminal window while installing necessary files and running the offline simulator. This looks different on different platforms:

• On Windows, use the "Anaconda prompt" from the start menu (instructions on how to install that below).

We will be editing Python scripts with model configurations. This can be done with many different editors, e.g., Visual Studio Code, Notepad on Windows, vi on Linux/Mac. We recommend using one you are already familiar with.

1. Install the offline simulator

This does not require administrator or root permissions.

1. Ensure you have Anaconda:

   • Linux/Mac: execute conda --version in a terminal
   • Windows: look for “Anaconda prompt” in the start menu

   If you do not have Anaconda, install Miniconda.

2. Create an isolated fabmos environment with the model and visualization tools:

   conda create -n fabmos -c conda-forge -c bolding-bruggeman -y fabmos matplotlib pyqt
   conda activate fabmos
   pip install pyncview
   

   If you experience any issue with the above, we recommend you first execute conda update conda to ensure your conda is up to date. Should this fail because of lack of permissions, we recommend you install Miniconda. After you have an up-to-date conda, retry the conda create ... command.

   The command above install a pre-compiled version of fabmos that includes reference versions of ERSEM, ECOSMO, PISCES and MOPS, among others. If you need a modified version of one of these models, or a different model altogether, you can install from source.

2. Get forcing (global transport matrices)

1. Download the MITgcm 2.8° circulation (MITgcm_2.8deg) from Samar Khatiwala
2. Extract this tar file to a directory on disk (remember where you put it; we’ll use it from a terminal later). On Windows, you may get error message such as "A required privilege is not held by the client". This can be ignored - you can skip the two affected files.