Function _combine_1d

xarray/structure/combine.py:307–361

Applies either concat or merge to 1D list of datasets depending on value of concat_dim

(
    datasets,
    concat_dim,
    compat: CompatOptions | CombineKwargDefault,
    data_vars,
    coords,
    fill_value,
    join: JoinOptions | CombineKwargDefault,
    combine_attrs: CombineAttrsOptions,
)

def _combine_1d(
    datasets,
    concat_dim,
    compat: CompatOptions | CombineKwargDefault,
    data_vars,
    coords,
    fill_value,
    join: JoinOptions | CombineKwargDefault,
    combine_attrs: CombineAttrsOptions,
):
    """
    Applies either concat or merge to 1D list of datasets depending on value
    of concat_dim
    """

    if concat_dim is not None:
        try:
            combined = concat(
                datasets,
                dim=concat_dim,
                data_vars=data_vars,
                coords=coords,
                compat=compat,
                fill_value=fill_value,
                join=join,
                combine_attrs=combine_attrs,
            )
        except ValueError as err:
            if "encountered unexpected variable" in str(err):
                raise ValueError(
                    "These objects cannot be combined using only "
                    "xarray.combine_nested, instead either use "
                    "xarray.combine_by_coords, or do it manually "
                    "with xarray.concat, xarray.merge and "
                    "xarray.align"
                ) from err
            else:
                raise
    else:
        try:
            combined = merge(
                datasets,
                compat=compat,
                fill_value=fill_value,
                join=join,
                combine_attrs=combine_attrs,
            )
        except AlignmentError as e:
            e.add_note(
                "If you are intending to concatenate datasets, please specify the concatenation dimension explicitly. "
                "Using merge to concatenate is quite inefficient."
            )
            raise e

    return combined


def _new_tile_id(single_id_ds_pair):