easysnowdata.optical.planetscope.load#

easysnowdata.optical.planetscope.load(aoi: Any = None, time: Any = None, *, items: Any = None, order: Any = None, source: str | None = None, item_type: str = 'PSScene', bundle: str = 'analytic_sr', asset_type: str = 'ortho_analytic_4b_sr', bands: Sequence[str] | None = None, scale: bool = True, mask_nodata: bool = True, chunks: Any = True, **kwargs: Any) → Dataset[source]#

Load PlanetScope imagery as an xarray.Dataset (time, y, x).

Parameters:

  • order – A finished order (the dict order() returns, a directory, or a list of files) to open. This is the normal path: search, order once, then load the delivery as often as you like.

  • source – "orders-api" (default) or "data-api". The Data API route activates and reads whole scenes, so it takes a single scene and charges the full scene area against the quota.

  • items – For source="data-api": the scene (or scenes) to read.

Notes

load never places an order by itself — pass order= with a finished order, or call order() explicitly. That keeps quota spending visible in the calling code.