File: _validation.rst

package info (click to toggle)
python-pyvista 0.46.4-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 176,968 kB
  • sloc: python: 94,346; sh: 216; makefile: 70
file content (33 lines) | stat: -rw-r--r-- 1,184 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Validation
==========

.. warning::

    This package is under active development and is unstable. **The API may
    change without warning**. It is currently intended for internal use by
    ``PyVista`` methods only but will be made public in a future version.

Input validation methods for checking and/or validating a variable has the
correct type and/or for use by an algorithm. These methods can be useful when
writing custom ``Python`` methods, ``VTK`` wrappers, and/or when `Contributing
to PyVista <https://github.com/pyvista/pyvista/blob/main/CONTRIBUTING.rst>`_.

Some common use cases for input validation are:

Validate a 3-element vector:
    * Use :func:`~pyvista.core._validation.validate.validate_array3`
Validate an Nx3 point or vector array:
    * Use :func:`~pyvista.core._validation.validate.validate_arrayNx3`
Validate point or cell IDs:
    * Use :func:`~pyvista.core._validation.validate.validate_arrayN_unsigned`
Validate a transformation matrix:
    * Use :func:`~pyvista.core._validation.validate.validate_transform4x4`

API Reference
-------------
.. currentmodule:: pyvista.core._validation
.. autosummary::
   :toctree: _autosummary

   check
   validate