catalog.md

🗺️ Catalog Search

Check data availability & download image preview quicklooks via the catalog search. You can filter by various parameters e.g. time period, area of interest, cloud cover etc.

Initialize Catalog

import up42
up42.authenticate(project_id="123", project_api_key="456")
#up42.authenticate(cfg_file="config.json")

catalog = up42.initialize_catalog()

See the available data collections

catalog.get_collections()

Search scenes in aoi

aoi = up42.get_example_aoi(location="Berlin", as_dataframe=True)
#aoi = up42.read_vector_file("data/aoi_washington.geojson", 
#                            as_dataframe=False)

search_parameters = catalog.construct_parameters(geometry=aoi, 
                                                 start_date="2018-01-01",
                                                 end_date="2020-12-31",
                                                 collections=["PHR"],
                                                 max_cloudcover=20,
                                                 sortby="cloudCoverage", 
                                                 limit=10)
search_results = catalog.search(search_parameters=search_parameters)
display(search_results.head())

catalog.plot_coverage(scenes=search_results, 
                      aoi=aoi, 
                      legend_column="sceneId")

Download & visualize quicklooks

catalog.download_quicklooks(image_ids=search_results.id.to_list(), 
                            sensor="pleiades")

catalog.map_quicklooks(scenes=search_results, aoi=aoi)

!!! Success "Success!" Continue with Ordering!