Skip to content

explain

lazymerge.explain

Dry-run read estimator: explains which source regions would be read.

ChunkRead dataclass

All reads required for one target chunk.

ExplainPlan dataclass

Complete dry-run read plan for a lazymerge merge operation.

SourceRead dataclass

Read details for one source within one target chunk.

explain 

explain(
    store: Any,
    crs: str,
    bbox: tuple[float, float, float, float],
    resolution: float,
    chunk_size: tuple[int, int] = (512, 512),
    source_index: ScanIndex | None = None,
    resampling: str = "nearest",
    bands: list[str] | str | None = None,
    datafusion: bool = False,
    sortby: str | None = None,
    nodata: float | None = None,
    sql_filter: str | None = None,
) -> ExplainPlan

Dry-run a merge: report which source regions would be read per chunk.

Runs the same source-finding, overview-selection, and coordinate-mapping logic as merge, but never reads pixel data.

lazymerge.ExplainPlan dataclass

Complete dry-run read plan for a lazymerge merge operation.