WrightTools.data.join

WrightTools.data.join(datas, *, atol=None, rtol=None, name='join', parent=None, method='first', verbose=True) → Data

Join a list of data objects into one data object. The underlying dataset arrays are merged.

Joined datas must have the same axes and axes order. The axes define the array structure for the joined dataset. As such, each axis must

• map to a single Variable

• project along one or no dimension of the data shape (i.e. axis shapes should have no more than one dimension with shape greater than 1)

• be orthogonal to all other axes

Join does not perform any interpolation. For that, look to Data.map_variable or Data.heal

Parameters:

• datas (list of data or WrightTools.Collection) – The list or collection of data objects to join together. Data must have matching axes.

• atol (numeric or list of numeric) – The absolute tolerance to use (in np.isclose) to consider points overlapped. If given as a single number, applies to all axes. If given as a list, must have same length as the data transformation. None in the list invokes default behavior. Default is 10% of the minimum spacing between consecutive points in any input data file.

• rtol (numeric or list of numeric) – The relative tolerance to use (in np.isclose) to consider points overlapped. If given as a single number, applies to all axes. If given as a list, must have same length as the data transformation. None in the list invokes default behavior. Default is 4 * np.finfo(dtype).resolution for floating point types, 0 for integer types.

• name (str (optional)) – The name for the data object which is created. Default is ‘join’.

• parent (WrightTools.Collection (optional)) – The location to place the joined data object. Default is new temp file at root.

• method ({'first', 'last', 'min', 'max', 'mean'}) – Mode to use for merged points in the joined space. Default is ‘first’.

• verbose (bool (optional)) – Toggle talkback. Default is True.

Returns:

A new Data instance.

Return type:

WrightTools.data.Data