Getting Started

Install

Pip

pip install wxee

Conda

conda install -c conda-forge wxee

From Source

git clone https://github.com/aazuspan/wxee
cd wxee
make install

Setup

Once you have access to Google Earth Engine, just import ee and wxee and initialize.

import ee
import wxee

wxee.Initialize()

Note

The wxee.Initialize() function works similarly to ee.Initialize but automatically connects to the high-volume Earth Engine endpoint that should be used for all automated requests to Earth Engine, such as those made by wxee.

Usage

Basic Features

Basic wxee functionality like downloading image collections to xarray and GeoTiff are extended through the wx accessor, like so:

collection = ee.ImageCollection("IDAHO_EPSCOR/GRIDMET").filterDate("2020", "2021")
collection.wx.to_xarray()

See the example notebooks for details on the xarray interface, downloading images and collections, and visualizing color composites.

Time Series Features

More advanced functionality requires turning image collections into TimeSeries objects. Check out this example notebook for and introduction to the TimeSeries class

You can also find example notebooks on specific TimeSeries methods like temporal aggregation, temporal interpolation, climatological means, and climatological anomalies.

Applied Examples

If you prefer, you can check out the applied example notebooks that use a variety of different methods to solve specific problems like fire progression mapping.