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.
For optimal performance and to enable all OceanSpy features, it is highly recommended that you install the following dependencies:
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 xarray cartopy esmpy intake-xarray geopy "xesmf!=0.5.0,!=0.5.1" esmf xgcm Ipython tqdm ffmpeg aiohttp pandas $ pip install git+https://github.com/MITgcm/xmitgcm.git
The commands above install the latest stable release of OceanSpy along with its dependencies.
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/hainegroup/oceanspy.git
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/hainegroup/oceanspy/master/sciserver_catalogs/environment.yml $ conda env create -f environment.yml
Then, activate the Oceanography environment:
$ conda activate Oceanography
Step-by-step instructions on how to run the test suite are available in Contributing to the Code.