Skip to content


Vimeo Documentation Status PyPI Build Status AppVeyor Codacy Badge codecov

PVGeo is a Python package that contains VTK powered tools for data visualization in geophysics which are wrapped for direct use within the application ParaView by Kitware. These tools are tailored to data visualization in the geosciences with a heavy focus on structured data sets like 2D or 3D time-varying grids.

On this website, we provide several examples and tutorials of how to use PVGeo in a python environment as well as how to use the ParaView plugins delivered along side the python package for common tasks in the visualization of geoscientific data.

Feel free to join the PVGeo community on Slack to keep up with new features and for any help using the code library and follow us on Twitter to keep up:


If you have an idea for a file reader, data filter, ParaView plugin, or would like to see how we would address a geoscientific visualization problem with ParaView, please post your thoughts on the issues page or become involved with the PVGeo community discussions on Slack.

How to use PVGeo

To download and use the PVGeo code library, follow the installation instructions on the Getting Started Page. If you are interested in development, all code is published on the GitHub repository PVGeo linked to this page. Click the ‘PVGeo on GitHub’ link on the right side of the menu bar at the top to find all of the code or you can follow this link. Also take a look at the Development Guide

How to explore this documentation

On a Desktop: There are six main sections to this website shown in the navigation tab at the top of the page. Use these tabs to explore the different aspects of the project! Use the sidebar to the right to explore the contents of the current page and use the sidebar to the left to find all the different pages for this active section/tab. Here is a list of the available sections:

  • Overview: An introduction to the project with installation details on how to get started.
  • Examples: A guide to all of the plugins we have implemented for use directly in ParaView. This section has all the information you will need to understand how to use our plugins and how we group them together into what we call suites. This section has high level explanations and examples while the docs website has the code documentation.
  • Docs: This tab will forward you to the code docs website
  • PV Macros: A guide on how to use all of the macros developed in the pvmacros module.
  • Resources: A conglomerate of additional resources that are helpful when using ParaView and VTK for geoscientific applications.
  • Development Guide: This is an all encompassing guid on how to start making your own plugins as well as how to contribute to the PVGeo repository.
Web renderings not working?

If the web renderings like the one below in the demo section of this page are not working, then please make sure to enable javascript in your web browser.


Check out the Demo Page to see video demos and interactive demos like the scene below. This is an example of three data sets visually integrated using our framework within ParaView then exported to a shareable format. Go ahead, click it and move it around!

About the Authors GitHub contributors Open Source

The PVGeo code library is managed by Bane Sullivan, graduate student in the Hydrological Science and Engineering interdisciplinary program at the Colorado School of Mines under Whitney Trainor-Guitton. If you have questions please inquire with or join the PVGeo community on Slack:

Thank you to our contributors!

It is important to note the project is open source and that many features in this repository were made possible by contributors volunteering their time. Please take a look at the Contributors Page to learn more about the developers of PVGeo.