coincident.search.cascading_search#
- coincident.search.cascading_search(primary_dataset, secondary_datasets=[('vantor', 14), ('icesat', 40), ('gedi', 40)], min_overlap_area=20)[source]#
Perform a “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 (
GeoDataFrame) – The primary dataset having ‘datetime’ or ‘start_dateteime’ and ‘end_datetime’ columns.secondary_datasets (
list[tuple[str,int]]) – Each tuple contains the name of the secondary dataset and temporal buffer in days.min_overlap_area (
float) – The minimum overlap area in km².
- Return type:
- Returns:
A list of GeoDataFrames containing the search results for each secondary dataset.