Skip to content

msmu.dt.concat

Concatenate samples, retaining modalities in first-seen order.

Features and observation annotations use an outer join. Feature metadata and .uns use the first available value, without filling metadata nulls or concatenating lists. Provenance joins both input histories separately. At least two flat, sample-aligned (axis=0) MuData inputs are required.

Parameters:

Name Type Description Default
mdatas dict[str, MuData]

Dictionary mapping dataset names to at least two flat, sample-aligned (axis=0) MuData objects. Keys become the dataset observation annotation.

required

Returns:

Type Description
MuData

A new MuData containing the union of modalities/features and concatenated samples. Input objects are not modified.

Examples:

import msmu as mm
combined = mm.dt.concat({"batch_a": first, "batch_b": second})