geeViz.eeCatalogHelpers.ingest

Ingestion planning dataclasses and the lazy planned-image adapter.

Functions

build_ingest_entry(band_name, ...)

Build one normalized geeViz multi-image ingest entry.

build_planned_bands(profiles, source_paths, ...)

Build ordered manifest bands from explicit source paths.

ingest_planned_image(image[, overwrite])

Lazily submit ordered bands; requires the geeViz Earth Engine runtime.

join_gcs_uri(prefix, object_name)

Join a gs:// prefix and object name without changing identifier text.

load_band_profiles(path)

Load and validate an ordered JSON band-profile list.

write_manifest_preview(images, path)

Write deterministic, human-reviewable ingest plans.

Classes

BandProfile(name, source_suffix, ...)

Metadata contract for one band in a multi-band image.

PlannedBand(profile, source_path, gcs_uri, ...)

One local source raster and its planned ingest settings.

PlannedImage(image_name, asset_id, bands, ...)

A deterministic Earth Engine image ingest plan.

geeViz.eeCatalogHelpers.ingest.build_ingest_entry(band_name: str, pyramiding_policy: str, gcs_uri: str, nodata_value: Any) → dict[str, Any][source]

Build one normalized geeViz multi-image ingest entry.

class geeViz.eeCatalogHelpers.ingest.BandProfile(name: str, source_suffix: str, source_location: str, pyramiding_policy: str, valid_min: float, valid_max: float, data_type: str, conversion: str, source_valid_values: tuple[float, ...] | None, value_map: Mapping[float, int] | None, description: str)[source]

Bases: object

Metadata contract for one band in a multi-band image.

name: str
source_suffix: str
source_location: str
pyramiding_policy: str
valid_min: float
valid_max: float
data_type: str
conversion: str
source_valid_values: tuple[float, ...] | None
value_map: Mapping[float, int] | None
description: str
class geeViz.eeCatalogHelpers.ingest.PlannedBand(profile: BandProfile, source_path: Path, gcs_uri: str, nodata_value: int | float | None)[source]

Bases: object

One local source raster and its planned ingest settings.

profile: BandProfile
source_path: Path
gcs_uri: str
nodata_value: int | float | None
as_ingest_entry() → dict[str, Any][source]
class geeViz.eeCatalogHelpers.ingest.PlannedImage(image_name: str, asset_id: str, bands: tuple[PlannedBand, ...], properties: Mapping[str, Any])[source]

Bases: object

A deterministic Earth Engine image ingest plan.

image_name: str
asset_id: str
bands: tuple[PlannedBand, ...]
properties: Mapping[str, Any]
as_preview() → dict[str, Any][source]
geeViz.eeCatalogHelpers.ingest.load_band_profiles(path: str | Path) → tuple[BandProfile, ...][source]

Load and validate an ordered JSON band-profile list.

geeViz.eeCatalogHelpers.ingest.join_gcs_uri(prefix: str, object_name: str) → str[source]

Join a gs:// prefix and object name without changing identifier text.

geeViz.eeCatalogHelpers.ingest.build_planned_bands(profiles: Iterable[BandProfile], source_paths: Mapping[str, Path], gcs_prefix: str, nodata_values: Mapping[str, Any], object_prefix: str = '') → tuple[PlannedBand, ...][source]

Build ordered manifest bands from explicit source paths.

geeViz.eeCatalogHelpers.ingest.write_manifest_preview(images: Iterable[PlannedImage], path: str | Path) → None[source]

Write deterministic, human-reviewable ingest plans.

geeViz.eeCatalogHelpers.ingest.ingest_planned_image(image: PlannedImage, overwrite: bool = False) → Any[source]

Lazily submit ordered bands; requires the geeViz Earth Engine runtime.

Properties are copied before submission so the caller’s dictionary is never modified.