search(aoi, products=None, start_datetime=None, end_datetime=None, cloud_fraction=None, limit=100, sort_field=None, sort_order='asc', date_field='acquired', query=None, randomize=False, raster_client=None, metadata_client=None)¶
Search for Scenes in the Descartes Labs catalog.
Returns a SceneCollection of Scenes that overlap with an area of interest, and meet the given search criteria.
- aoi (GeoJSON-like dict, GeoContext, or object with __geo_interface__) – Search for scenes that intersect this area by any amount.
If a GeoContext, a copy is returned as
ctx, with missing values filled in. Otherwise, the returned
ctxwill be an AOI, with this as its geometry.
- products (str or List[str], optional) – Descartes Labs product identifiers
- start_datetime (str, datetime-like, optional) – Restrict to scenes acquired after this datetime
- end_datetime (str, datetime-like, optional) – Restrict to scenes acquired before this datetime
- cloud_fraction (float, optional) – Restrict to scenes that are covered in clouds by less than this fraction (between 0 and 1)
- limit (int, optional) – Maximum number of Scenes to return, up to 10000.
- sort_field (str, optional) – Field name in
Scene.propertiesby which to order the results
- sort_order (str, optional, default 'asc') –
- date_field (str, optional, default 'acquired') – The field used when filtering by date
- query (descarteslabs.common.property_filtering.Expression, optional) –
Expression used to filter Scenes by their properties, built from
>>> query = 150 < dl.properties.azimuth_angle < 160 & dl.properties.cloud_fraction < 0.5 >>> query = dl.properties.sat_id == "Terra"
- randomize (bool, default False, optional) – Randomize the order of the results. You may also use an int or str as an explicit seed.
- raster_client (Raster, optional) – Unneeded in general use; lets you use a specific client instance with non-default auth and parameters.
- metadata_client (Metadata, optional) – Unneeded in general use; lets you use a specific client instance with non-default auth and parameters.
scenes (SceneCollection) – Scenes matching your criteria.
ctx (GeoContext) – The given
aoias a GeoContext (if it isn’t one already), with reasonable default parameters for loading all matching Scenes.
aoiwas a GeoContext,
ctxwill be a copy of
aoi, with any properties that were
Noneassigned the defaults below.
aoiwas not a GeoContext, an AOI instance will be created with
aoias its geometry, and defaults assigned as described below:
Default Spatial Parameters:
- resolution: the finest resolution of any band of all matching scenes
- crs: the most common CRS used of all matching scenes
- aoi (GeoJSON-like dict, GeoContext, or object with __geo_interface__) – Search for scenes that intersect this area by any amount. If a GeoContext, a copy is returned as