check_point_clouds¶
-
gtda.utils.
check_point_clouds
(X, distance_matrix=False, **kwargs)[source]¶ Input validation on an array or list representing a collection of point clouds or distance matrices.
The input is checked to be either a single 3D array using a single call to
check_array
, or a list of 2D arrays by callingcheck_array
on each entry. In the latter case, warnings are issued when not all point clouds are in the same Euclidean space.Conversions and copies may be triggered as per
check_list_of_arrays
.- Parameters
X (object) – Input object to check / convert.
distance_matrix (bool, optional, default:
False
) – Whether the input represents a collection of distance matrices or of concrete point clouds in Euclidean space. In the first case, entries are allowed to be infinite unless otherwise specified in kwargs.kwargs – Keyword arguments accepted by
check_list_of_arrays
.
- Returns
Xnew – The converted and validated object.
- Return type
ndarray or list