pyvista_validation.check.check_length

pyvista_validation.check.check_length(sized_input: float | Sized, /, exact_length: int | VectorLike[int] | None = None, *, min_length: int | None = None, max_length: int | None = None, must_be_1d: bool = False, allow_scalar: bool = False, name: str = 'Array') → None

Check if the length of an array meets specific requirements.

Parameters:

sized_inputfloat | Sized

Number or array to check.

exact_lengthint | VectorLike[int], optional

Check if the array has the given length. If multiple numbers are given, the array’s length must match one of the numbers.

min_lengthint, optional

Check if the array has this length or greater.

max_lengthint, optional

Check if the array has this length or less.

must_be_1dbool, default: False

If True, check if the shape of the array is one-dimensional, that is, that the array’s shape is (1,).

allow_scalarbool, default: False

If True, a scalar input will be reshaped to have a length of 1. Otherwise, the check will fail since a scalar does not have a length.

namestr, default: “Array”

Variable name to use in the error messages if any are raised.

Raises:

ValueError

If the array’s length is outside the specified range.

See also

check_shape

check_ndim

Notes

By default, this function operates on multidimensional arrays, where len(arr) may differ from the number of elements in the array. For one-dimensional cases (where len(arr) == arr.size), set must_be_1D=True.

Examples

Check if an array has a length of 2 or 3.

>>> from pyvista_validation import check_length
>>> check_length([1, 2], exact_length=[2, 3])

Check if an array has a minimum length of 3.

>>> check_length((1, 2, 3), min_length=3)

Check if a multidimensional array has a maximum length of 2.

>>> check_length([[1, 2, 3], [4, 5, 6]], max_length=2)