Installation

If you would like to use OceanSpy for your own datasets and run it on a local machine or server, you will need to download and install it first.

Required dependencies

Optional dependencies

For optimal performance and to enable all OceanSpy features, it is highly recommended that you install the following dependencies:

Step-by-step instructions

  1. First, download and install Miniconda or Anaconda.

  2. The easiest way to install OceanSpy and the above mentioned dependencies is to use the conda-forge channel. Open a terminal, then run the following commands:

$ conda update conda
$ conda config --set channel_priority strict
$ conda config --prepend channels conda-forge
$ conda install -y oceanspy dask distributed bottleneck netCDF4 "xarray>=0.11.3" cartopy esmpy ffmpeg intake-xarray geopy "xgcm>=0.2" xesmf Ipython tqdm "xmitgcm>=0.3"
$ pip install ffmpeg

The commands above install the latest stable release of OceanSpy along with its dependencies.

  1. Finally, in case you would like to use the latest version of OceanSpy under development rather than the stable release, add the following command:

$ pip install --upgrade git+https://github.com/malmans2/oceanspy.git

Note

For experts: Use the following commands to Create an environment identical to the Oceanography environment available on SciServer:

$ conda update conda
$ conda config --set channel_priority strict
$ conda config --prepend channels conda-forge
$ wget https://raw.githubusercontent.com/malmans2/oceanspy/master/sciserver_catalogs/environment.yml
$ conda env create -f environment.yml

Then, activate the Oceanography environment:

$ conda activate Oceanography

Test suite

Step-by-step instructions on how to run the test suite are available in Contributing to the Code.