Installation#

Quick Install#

You can use pip to install directly.

pip install sacpy

Install Sacpy in 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 Silicone)#

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

Linux#

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

Windows#

wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe # or Copy Link to Browser for download

Step 2: Install Miniconda3#

chmod +x Miniconda3-latest-*.sh && ./Miniconda3-latest-*.sh # windows just click the .exe and install

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

Windows can add conda-bin path to $PATH automatically.

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>

Windows can skip this step, or

conda activate

Step 4: Install Sacpy#

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

conda create -n sacpy python=3.9
conda activate sacpy

Then install some dependencies via conda:

conda install jupyter notebook cartopy xarray scipy numpy pandas netcdf4

Once the above dependencies have been installed, simply

pip install sacpy

and you are ready to

import sacpy as scp

in Python.