bakaano.alpha_earth¶

AlphaEarth embedding download and preprocessing.

Role: Provide static catchment descriptors from AlphaEarth bands.

class bakaano.alpha_earth.AlphaEarth(working_dir, study_area, start_date, end_date)[source]¶

Bases: object

AlphaEarth Class:¶

Role: Download and manage AlphaEarth embedding bands for the basin.

This class facilitates the downloading and preprocessing of Alpha Earth satellite embedding datasets. It includes methods for checking existing data, downloading missing bands, and ensuring data integrity.

Key Methods: - get_alpha_earth: Downloads Alpha Earth satellite embeddings. It checks for existing bands and downloads only the missing ones. The data is saved in GeoTIFF format.

Dependencies: - Google Earth Engine (GEE) for data retrieval. - Geopandas for shapefile handling. - Geemap for GEE integration.

Usage:

alpha_earth = AlphaEarth(
    working_dir="/path/to/working_dir",
    study_area="/path/to/shapefile.shp",
    start_date="YYYY-MM-DD",
    end_date="YYYY-MM-DD",
)
alpha_earth.get_alpha_earth()

get_alpha_earth()[source]¶

Download AlphaEarth embedding bands for the study area.

Downloads only missing bands and writes them to {working_dir}/alpha_earth as GeoTIFFs.

plot_alpha_earth(variable='A00')[source]¶

Plot a single AlphaEarth band.

Parameters:: variable (str) – Band name, e.g. "A00" through "A63".
Returns:: None. Displays a matplotlib plot.