Skip to content

xarray accessor for automating choosing colormaps, aimed at geosciences

License

Notifications You must be signed in to change notification settings

pangeo-data/xcmocean

Repository files navigation

xcmocean

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

xarray accessor for automating choosing colormaps, aimed at geosciences.

Also optional dependence on cf-xarray.


Project based on the cookiecutter science project template.

Installation:

You can pip install from PyPI:

pip install xcmocean

or install from conda-forge with

conda install -c conda-forge xcmocean

Example usage:

import xcmocean

ds.salt.cmo.contourf(x='lon', y='lat')

which would make a contourf plot of the ds.salt data using the cmocean haline colormap. More examples in the docs.

Dev installation for local work

Clone the repo:

$ git clone https://github.com/pangeo-data/xcmocean.git

In the xcmocean directory, install conda environment:

$ conda env create -f environment.yml

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