geeViz.eeCatalogHelpers.ingest¶
Ingestion planning dataclasses and the lazy planned-image adapter.
Functions
|
Build one normalized geeViz multi-image ingest entry. |
|
Build ordered manifest bands from explicit source paths. |
|
Lazily submit ordered bands; requires the geeViz Earth Engine runtime. |
|
Join a gs:// prefix and object name without changing identifier text. |
|
Load and validate an ordered JSON band-profile list. |
|
Write deterministic, human-reviewable ingest plans. |
Classes
|
Metadata contract for one band in a multi-band image. |
|
One local source raster and its planned ingest settings. |
|
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:
objectMetadata 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:
objectOne local source raster and its planned ingest settings.
- profile: BandProfile¶
- source_path: Path¶
- gcs_uri: str¶
- nodata_value: int | float | None¶
- class geeViz.eeCatalogHelpers.ingest.PlannedImage(image_name: str, asset_id: str, bands: tuple[PlannedBand, ...], properties: Mapping[str, Any])[source]¶
Bases:
objectA deterministic Earth Engine image ingest plan.
- image_name: str¶
- asset_id: str¶
- bands: tuple[PlannedBand, ...]¶
- properties: Mapping[str, Any]¶
- 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.