patch_local_adjusted_envelopes

function of dascore.utils.chunk_plan

source

patch_local_adjusted_envelopes(
    df: DataFrame ,
    residuals ,
    drop_empty: bool = True,
)-> ‘pd.DataFrame’

Replay coordinate residuals onto relation envelopes in call order.

Absolute and relative residuals trim membership and envelopes. A sample selection preserves row membership, but the planner must consume its trimmed envelopes or it publishes outputs that lie entirely outside the selected samples (phantom empties). Negative indices resolve per patch against the envelope-derived sample count (rows whose count is unknown keep their envelope as a candidacy superset — exactness is always re-applied at load). drop_empty removes rows emptied by sample selection for planning; presentation keeps those rows. Relative selections always remove rows whose resolved windows are empty.