Skip to main content

Easier Pythonic interface to VTK

Project description

pyvista

Deployment

pypi

conda

Build Status

azure

GH-CI

Metrics

codacy

codecov

Activity

PyPIact

condaact

Citation

joss

zenodo

License

MIT

Community

slack

discuss

3D plotting and mesh analysis through a streamlined interface for the Visualization Toolkit (VTK)

PyVista is…

  • “VTK for humans”: a high-level API to the Visualization Toolkit (VTK)

  • mesh data structures and filtering methods for spatial datasets

  • 3D plotting made simple and built for large/complex data geometries

PyVista is a helper module for the Visualization Toolkit (VTK) that wraps the VTK library through NumPy and direct array access through a variety of methods and classes. This package provides a Pythonic, well-documented interface exposing VTK’s powerful visualization backend to facilitate rapid prototyping, analysis, and visual integration of spatially referenced datasets.

This module can be used for scientific plotting for presentations and research papers as well as a supporting module for other mesh 3D rendering dependent Python modules; see Connections for a list of projects that leverage PyVista.

Share this project on Twitter: tweet

Highlights

Head over to the Quick Examples page in the docs to explore our gallery of examples showcasing what PyVista can do! Want to test-drive PyVista? All of the examples from the gallery are live on MyBinder for you to test drive without installing anything locally: Launch on Binder

Overview of Features

  • Extensive gallery of examples (see Quick Examples)

  • Interactive plotting in Jupyter Notebooks using server-side rendering with ipyvtklink or client-side rendering with panel or ipygany.

  • Filtering/plotting tools built for interactivity (see Widgets)

  • Direct access to mesh analysis and transformation routines (see Filters)

  • Intuitive plotting routines with matplotlib similar syntax (see Plotting)

  • Import meshes from many common formats (use pyvista.read()). Support for all formats handled by meshio is built-in!

  • Export meshes as VTK, STL, OBJ, or PLY (mesh.save()) file types or any formats supported by meshio (pyvista.save_meshio())

Documentation

Refer to the documentation for detailed installation and usage details.

For general questions about the project, its applications, or about software usage, please create a discussion in pyvista/discussions where the community can collectively address your questions. You are also welcome to join us on Slack or send one of the developers an email. The project support team can be reached at info@pyvista.org.

Installation

PyVista can be installed from PyPI using pip on Python >= 3.6:

pip install pyvista

You can also visit PyPI, Anaconda, or GitHub to download the source.

See the Installation for more details if the installation through pip doesn’t work out.

Connections

PyVista is a powerful tool that researchers can harness to create compelling, integrated visualizations of large datasets in an intuitive, Pythonic manner. Here are a few open-source projects that leverage PyVista:

  • itkwidgets: Interactive Jupyter widgets to visualize images, point sets, and meshes in 2D and 3D. Supports all PyVista mesh types.

  • ansys-mapdl-reader: Pythonic interface to ANSYS results, full, and archive files

  • PVGeo: Python package of VTK-based algorithms to analyze geoscientific data and models. PyVista is used to make the inputs and outputs of PVGeo’s algorithms more accessible.

  • omfvista: 3D visualization for the Open Mining Format (omf). PyVista provides the foundation for this library’s visualization.

  • discretize: Discretization tools for finite volume and inverse problems. discretize provides toVTK methods that return PyVista versions of their data types for creating compelling visualizations.

  • pymeshfix: Python/Cython wrapper of Marco Attene’s wonderful, award-winning MeshFix software.

  • tetgen: Python Interface to Hang Si’s C++ TetGen Library

Authors

Please take a look at the contributors page and the active list of authors to learn more about the developers of PyVista.

Contributing

Contributor Covenant Code Triage

We absolutely welcome contributions and we hope that our Contributing Guide will facilitate your ability to make PyVista better. PyVista is mostly maintained on a volunteer basis and thus we need to foster a community that can support user questions and develop new features to make this software a useful tool for all users while encouraging every member of the commutinity to share their ideas. To learn more about contributing to PyVista, please see the Contributing Guide and our Code of Conduct.

Citing PyVista

There is a paper about PyVista!

If you are using PyVista in your scientific research, please help our scientific visibility by citing our work!

Sullivan and Kaszynski, (2019). PyVista: 3D plotting and mesh analysis through a streamlined interface for the Visualization Toolkit (VTK). Journal of Open Source Software, 4(37), 1450, https://doi.org/10.21105/joss.01450

BibTex:

@article{sullivan2019pyvista,
  doi = {10.21105/joss.01450},
  url = {https://doi.org/10.21105/joss.01450},
  year = {2019},
  month = {May},
  publisher = {The Open Journal},
  volume = {4},
  number = {37},
  pages = {1450},
  author = {C. Bane Sullivan and Alexander Kaszynski},
  title = {{PyVista}: {3D} plotting and mesh analysis through a streamlined interface for the {Visualization Toolkit} ({VTK})},
  journal = {Journal of Open Source Software}
}

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyvista-0.33.2.tar.gz (1.4 MB view details)

Uploaded Source

Built Distribution

pyvista-0.33.2-py3-none-any.whl (1.4 MB view details)

Uploaded Python 3

File details

Details for the file pyvista-0.33.2.tar.gz.

File metadata

  • Download URL: pyvista-0.33.2.tar.gz
  • Upload date:
  • Size: 1.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

File hashes

Hashes for pyvista-0.33.2.tar.gz
Algorithm Hash digest
SHA256 e0b70180ff6d943c015ff2cdf2fd85550ae941e9e68162d1f54219458707d5e2
MD5 828b0c793f7f7acd34e6b5a046b5622f
BLAKE2b-256 9d062a5721dd7adedc6b839b89214968339a9e726893834abfa259970b136b67

See more details on using hashes here.

File details

Details for the file pyvista-0.33.2-py3-none-any.whl.

File metadata

  • Download URL: pyvista-0.33.2-py3-none-any.whl
  • Upload date:
  • Size: 1.4 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.9

File hashes

Hashes for pyvista-0.33.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5405428f4e9024263067924ec1163b3ba7bdb45cf1a802f217a55402d85df019
MD5 30bcd5a6ea87bce5c7d1f79a36d26477
BLAKE2b-256 c5f13e67be32ebd90deeb2b9f2206f5bf107ece71b83ec1887d9e5d7f22a9c7b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page