Global Fishing Watch

PySeas

A library to make GFW style maps in Python.

Installation

Some of the dependencies do not install cleanly via pip, so the recommended approach is to install them using Conda. The following recipes is currently preferred:

git clone https://github.com/GlobalFishingWatch/pyseas.git
cd pyseas

Then, to install in new Conda environment named pyseas:

conda create -c conda-forge -y -n pyseas python=3.8 cartopy gdal
conda activate pyseas
pip install -e ".[nb]"

Or, to install in an existing Conda environment:

conda activate CONDA-ENV-NAME
conda install -c conda-forge -y -n CONDA-ENV-NAME python=3.8 cartopy gdal
pip install -e ".[nb]"

If you'd like to skip installing jupyter and jupytext, which are not strictly necessary to use pyseas, replace ".[nb]" with . to omit the notebook dependencies. If you are not interested in the Examples notebooks, you may omit -e and avoid the in-place install.

Documentation

Examples of common plotting tasks are shown in pyseas/doc/Examples.md, or on github.

Acknowledgments

• EEZ boundaries are drawn using World EEZ v11 from Marine Regions licensed under CC-BY.

• The Roboto fonts from Google licensed under Apache 2.0