semantique.processor.arrays.Collection.concatenate#
- Collection.concatenate(dimension, track_types=True, vtype='nominal', **kwargs)[source]#
Apply the concatenate verb to the collection.
The concatenate verb concatenates the arrays in the collection along a new or existing dimension.
- Parameters:
dimension (
str
) – Name of the dimension to concatenate along. To concatenate along an existing dimension, it should be a dimension that exists in all collection members. To concatenate along a new dimension, it should be a dimension that does not exist in any of the collection members.track_types (
bool
) – Should it be checked if all arrays in the collection have the same value type?vtype (
str
:) – If the arrays are concatenated along a new dimension, what should the value type of its dimension coordinates be? Valid options are “continuous”, “discrete”, “nominal”, “ordinal” and “binary”.**kwargs – Ignored.
- Returns:
- Raises:
exceptions.InvalidValueTypeError – If
track_types = True
and the value types of the arrays in the collection are not all equal to each other.exceptions.MissingDimensionError – If the dimension to concatenate along exists in some but not all arrays in the collection.
exceptions.ReservedDimensionError – If the new dimension to concatenate along has one of the names that semantique reserves for the temporal dimension or spatial dimensions.