eelbrain.combine¶
-
eelbrain.
combine
(items, name=None, check_dims=True, incomplete='raise', dim_intersection=False)¶ Combine a list of items of the same type into one item.
- Parameters
items (
Iterable
) – Sequence of data objects to combine (Dataset, Var, Factor, NDVar or Datalist). A sequence of numbers is converted toVar
, a sequence of strings is converted toFactor
.name (
Optional
[str
]) – Name for the resulting data-object. If None, the name of the combined item is the common prefix of all items.check_dims (
bool
) – ForNDVar
columns, check dimensions for consistency between items (e.g., channel locations in aSensor
). Default isTrue
. Set toFalse
to ignore mismatches.incomplete ("raise" | "drop" | "fill in") – Only applies when combining Datasets: how to handle variables that are missing from some of the input Datasets. With
"raise"
(default), raise aValueError
. With"drop"
, drop partially missing variables. With"fill in"
, retain partially missing variables and fill in missing values with empty values (""
for factors,NaN
for numerical variables).dim_intersection (
bool
) – Only applies to combiningNDVar
: normally, whenNDVar
have mismatching dimensions, a DimensionMismatchError is raised. Withdim_intersection
, the intersection is used instead.
Notes
The info dict inherits only entries that are equal (
x is y or np.array_equal(x, y)
) for all items.