Set of python tools to analyse output from the CROCO/ROMS ocean model using xarray. Heavily inspired by the original ROMSTOOLS Matlab code (Penven et al., 2007, https://doi.org/10.1016/j.envsoft.2007.07.004), with function names being largely compatible. Some inspiration was also taken from the xroms package.

Basic documentation is in preparation, please be patient and rely on the docstrings of individual methods in the meantime.

I strongly recommend to use Miniconda or Anaconda environments to manage your Python packages. However, xcroco is not available through these channels yet. To avoid problems with installing xcroco dependencies manually, make sure to install the following packages in your Conda environment before installing xcroco:

conda install xarray numpy scipy cartopy
conda install -c conda-forge xgcm

Next, clone this repository to a directory of your choice (e.g. /Users/your-username/your-code-folder/) with

cd /Users/your-username/your-code-folder/
git clone https://github.com/jaard/xcroco.git

If you dont have ssh keys set up, you may be asked to enter your GitHub password. After cloning the repository, check that which pip points to your Conda environment. If this is not already the case, activate the desired environment with source ~/miniconda3/bin/activate your-conda-environment. Now you can install xcroco from source using

pip install -e xcroco