samples_adjusted_envelopes

function of dascore.utils.chunk_plan

source

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

Adjust envelope columns for patch-local samples residuals.

A samples=True index window trims each patch at load, so the planner must consume the 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 whose window selects nothing (planning truth); equality comparison keeps them, since a presented-but-empty row is still a presented row.