xee

library0.1.1pypypi✓ verified 83d ago

A Google Earth Engine extension for Xarray. Provides xarray accessors to read Earth Engine datasets (Image, ImageCollection, FeatureCollection) as Xarray DataArrays/Datasets. Current version 0.1.1. Pre-release, active development.

analytics

pip install xee

github ↗homepage ↗

INSTALL

IMPORT

SIG · XEE

xee

analyticspythonv0.1.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

✓ import ee

Standard Earth Engine import

✓ import xarray as xr

Standard xarray import

Initialize Earth Engine, open an Image as an Xarray dataset using the 'ee' engine.

import ee import xarray as xr import xee ee.Initialize() # Open an Earth Engine Image as an Xarray DataArray da = xr.open_dataset( 'ee://LANDSAT/LC08/C02/T1_L2', engine='ee', bands=['SR_B1', 'SR_B2'], geometry=ee.Geometry.Point([-120.0, 35.0]), scale=30, crs='EPSG:4326' ) print(da)

Debug

Known issues

breakingThe library is in early development (v0.1.1); API changes can happen without deprecation. Pin exact version in production.

fix

Use `pip install xee==0.1.1` to lock version.

affects: < 0.2.0

gotchaEarth Engine requires authentication. Initialize `ee.Initialize()` before using xee, or use service account credentials. Failure gives cryptic errors.

fix

Ensure `ee.Initialize()` is called and valid credentials are set up (e.g., `earthengine authenticate`).

affects: all

gotchaThe engine identifier for xee is 'ee' (string). Using any other engine name (e.g., 'xee') will raise a ValueError.

fix

Use `engine='ee'` in `xr.open_dataset()` or `xr.open_mfdataset()`.

affects: all

Errors

Common errors & fixes

ValueError: unknown engine 'ee'

xee is not installed or imported. The 'ee' engine is not registered.

fix

Install xee with `pip install xee` and ensure `import xee` is in your code.

ee.ee_exception.EEException: Unable to find a credentials file. Use earthengine authenticate or set GOOGLE_APPLICATION_CREDENTIALS

Earth Engine is not authenticated.

fix

Run `earthengine authenticate` in terminal or set environment variable `GOOGLE_APPLICATION_CREDENTIALS`.

Upgrade

Version history

0.1.1latest on PyPI · released May 21, 2026

Audit

Dependencies

earthengine-apirequiredRequired for Earth Engine authentication and data access

xarrayrequiredCore dependency for data structures

Agent activity

37 hits · last 30 days

node

Resources

githubhttps://github.com/google/xee ↗

homepagehttps://github.com/google/xee ↗