Skip to content

axiom-data-science/ocean-model-skill-assessor

Repository files navigation

ocean-model-skill-assessor

Build Status Code Coverage License:MIT Documentation Status Code Style Status Conda Version Python Package Index

A package to fully run the comparison between data and model to assess model skill.

You can run the analysis as a Python package or with a command-line interface.

There are three steps to follow for a set of model-data validation, which is for one variable:

  1. Make a catalog for your model output.
  2. Make a catalog for your data.
  3. Run the comparison.

These steps will save files into a user application directory cache. See the demos for more details.


Project based on the cookiecutter science project template.

Installation

Set up environment

NOTE: Make sure you have Anaconda or Miniconda installed.

Create a conda environment called "omsa" that includes the package ocean-model-skill-assessor:

$ conda create -n omsa -c conda-forge ocean-model-skill-assessor

Note that installing the packages is faster if you first install mamba to your base Python and then use "mamba" in place of all instances of "conda".

Activate your new Python environment to use it with

$ conda activate omsa

Also install cartopy to be able to plot maps:

$ conda install -c conda-forge cartopy

Install into existing environment

From conda-forge:

$ conda install -c conda-forge ocean-model-skill-assessor

From PyPI:

$ pip install ocean-model-skill-assessor

To plot a map of the model domain with data locations, you'll need to additionally install cartopy. If you used conda above:

$ conda install -c conda-forge cartopy

If you installed from PyPI, check out the instructions for installing cartopy here.

Extra packages for development

To also develop this package, install additional packages with:

$ conda install --file requirements-dev.txt

To then check code before committing and pushing it to github, locally run

$ pre-commit run --all-files