libera_utils.l1a.day_coverage.measure_time_axis_coverage#

libera_utils.l1a.day_coverage.measure_time_axis_coverage(times: ndarray, *, day: date) → TimeAxisCoverage#

Measure how much of a day and its buffers a time axis occupies.

Each sample occupies the spacing to the next one. A spacing larger than DEFAULT_GAP_FACTOR times the median spacing, and larger than DEFAULT_SEAM_TOLERANCE, is a gap: the sample before it, like the last sample, occupies one median spacing.

Parameters:

  • times (numpy.ndarray) – Datetime64 values from one data-time axis, in any order.

  • day (datetime.date) – Applicable UTC calendar day.

Returns:

Fractions for the day core and both buffers, plus the axis’s median cadence and largest gap. An empty axis returns all zeros, and a single sample occupies no time.

Return type:

TimeAxisCoverage