coincident.search.cascading_search

coincident.search.cascading_search(primary_dataset, secondary_datasets=[('maxar', 14), ('icesat', 40), ('gedi', 40)], min_overlap_area=20)

Perform an cascading search to find overlapping datasets acquired within specific time ranges.

Secondary datasets are searched based only on spatial overlap areas with previous datasets. In other words, the overlapping area is progressively reduced.

Temporal buffer is applied as either (datetime-buffer <= acquisition <= datetime+buffer)

or (start_datetime-buffer <= acquisition <= end_datetime+buffer)

Parameters:

• primary_dataset (gpd.GeoDataFrame) – The primary dataset having ‘datetime’ or ‘start_dateteime’ and ‘end_datetime’ columns.

• secondary_datasets (list of tuple, optional) – Each tuple contains the name of the secondary dataset and temporal buffer in days.

• min_overlap_area (int, optional) – The minimum overlap area in km^2. Default is 20.

Returns:

A list of GeoDataFrames containing the search results for each secondary dataset.

Return type:

list of gpd.GeoDataFrame