build_gap_frame

function of dascore.utils.chunk_plan

source

build_gap_frame(
    df: DataFrame ,
    name: str ,
    tolerance: float = 1.5,
    group: str | collections.abc.Sequence[str, collections.abc.Sequence[str], None] = None,
    missing_dim: Literal[‘raise’, ‘drop’] = drop,
)-> ‘pd.DataFrame’

Report every discontinuity along name in a flat patch relation.

One row per gap, over the same cells and the same continuity rule build_chunk_plan uses, so a gap here is exactly a boundary chunk refuses to merge. {name}_min is the last sample before the gap and {name}_max the first sample after it, so gap_size is their difference.