stilt.observations.group_by_overpass

stilt.observations.group_by_overpass(times, *, max_gap='30min')

Label each time with the overpass it belongs to.

This is the X-STILT overpass finder: soundings from one satellite pass are seconds apart and passes are hours apart, so a new group starts wherever consecutive times (in time order) differ by more than max_gap. Each label is the group’s first time as YYYYMMDDHHMM.

The result is aligned with the input, so on a table of soundings:

df["overpass"] = group_by_overpass(df["time"])
for label, scene in df.groupby("overpass"):
    ...

Return type:

Series

Parameters:

• times (_Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | bool | int | float | complex | str | bytes | _NestedSequence[bool | int | float | complex | str | bytes] | Series)

• max_gap (str | Timedelta)