Overview

cartoee is a simple Python package used for making publication quality maps from Earth Engine results using Cartopy without having to download results.

This packages aims to do only one thing well: getting processing results from Earth Engine into a publication quality mapping interface. cartoee simply gets results from Earth Engine and plots it with the correct geographic projections leaving ee and cartopy to do more of the processing and visualization.

A typical Earth Engine workflow includes:

  1. Processing your data on Earth Engine
  2. Exporting your data from Earth Engine
  3. Creating maps of your results

Here, we omit the 2nd step and merge steps 1 and 3 into one step. This allows users to process their data using the Python Earth Engine API and quickly create a map.

Installation

cartoee is available to install via pip. To install the package, you can use pip install for your Python environment:

pip install cartoee

Or, you can install the package manually from source code using the following commands:

git clone https://github.com/kmarkert/cartoee.git
cd cartoee
python setup.py install

Dependencies

cartoee is built using pure Python code however relies on a few dependencies (earthengine-api and cartopy) that are available. Users are referred to the dependencies documentation for full installation instructions:

The easiest way to get dependencies installed correctly is to use conda for matplotlib and cartopy. The Earth Engine API requires installation through pip:

conda install -c conda-forge matplotlib cartopy
pip install google-api-python-client
pip install earthengine-api
# make sure the latest oauth2client library is installed
pip install --upgrade oauth2client
# autheticate earthengine python api
earthengine authenticate