concatenate_planned

function of dascore.utils.patch

source

concatenate_planned(
    patches: collections.abc.Sequence[Patch] ,
    dim: str ,
    count: int | None[int, None] = None,
    conflict: Literal[‘drop’, ‘raise’, ‘keep_first’] = raise,
)-> ‘dc.Patch’

Concatenate the members of one planned output, as the plan decided.

A concat plan (dascore.utils.chunk_plan.build_concat_plan) has already decided kind, dimensions, and the dimensions’ identities, so none of that is asked again. The attrs fold as a merge folds them (combine_patch_attrs, a missing value matching anything and known conflicts policed by conflict).

Coordinates are not policed by conflict; they are reconciled or refused. A coordinate riding dim is joined along it, provided every member states it the same way; every other coordinate must agree, or the output raises rather than dropping metadata the catalog describes.