easysnowdata.optical.planetscope.open_delivery#

easysnowdata.optical.planetscope.open_delivery(delivery: Any, aoi: Any = None, *, bands: Sequence[str] | None = None, scale: bool = True, mask_nodata: bool = True, chunks: Any = 'easysnowdata-default', source: Any = None, **kwargs: Any) → Dataset[source]#

Open delivered Planet COGs (a directory, file list, or order result).

Scenes are stacked on time from their file names, the analytic bands are named (BAND_NAMES), and each delivered udm2 mask is decoded into its named layers (easysnowdata.processing.decode_udm2()) and matched to its scene by file name. A scene delivered without a UDM2 (Planet does not produce one for every scene) gets NaN mask layers.

With scale, surface-reflectance scenes (analytic_sr bundles, files named ..._AnalyticMS_SR...) are multiplied by SCENE_SCALE. TOA radiance scenes (the analytic bundle) are converted to top-of-atmosphere reflectance with the per-band reflectanceCoefficient in the delivered metadata XML; without that XML they stay radiance and a warning is logged. The reflectance attribute records which applied.