Installation#

Install the Conda environment#

You may skip this step if your Conda environment has been installed already.

Step 1: Download the installation script for miniconda3#

macOS (Intel)#

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh

macOS (Apple Silicon)#

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-arm64.sh

Linux#

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

Step 2: Install Miniconda3#

chmod +x Miniconda3-latest-*.sh && ./Miniconda3-latest-*.sh

During the installation, a path <base-path> needs to be specified as the base location of the python environment. After the installation is done, we need to add the two lines into your shell environment (e.g., ~/.bashrc or ~/.zshrc) as below to enable the conda package manager (remember to change <base-path> with your real location):

export PATH="<base-path>/bin:$PATH"
. <base-path>/etc/profile.d/conda.sh

Step 3: Test your Installation#

source ~/.bashrc  # assume you are using Bash shell
which python  # should return a path under <base-path>
which conda  # should return a path under <base-path>

Install pens#

Taking a clean installation as example, first let’s create a new environment named pens-env via conda

conda create -n pens-env python=3.11
conda activate pens-env

Then install some dependencies via conda:

conda install jupyter notebook cartopy

Once the above dependencies have been installed, simply

pip install netcdf4 xarray pens
pip install scipy==1.11.4  # to handle a dependency issue (date: 02-02-2024)

and you are ready to

import pens

in Python.

Installation

Contents