PVGeo 1.1.19

Geoscientific visualization tools for VTK and ParaView

PVGeo

The PVGeo python package 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.

Demonstrations of PVGeo

For a quick overview of how PVGeo can be used in a Python environment or directly within ParaView, please checkout the code snippets and videos on the About Examples Page

Also, check out the demo page for a synopsis of the project and some visualization examples. Then check out the rest of the full website to explore the technical aspects of the project and to find use examples.

Report Issues and Contribute

Please feel free to post features you would like to see from this package on the issues page as a feature request. If you stumble across any bugs or crashes while using code distributed here, please report it in the issues section so we can promptly address it. For other questions please join the PVGeo community on Slack.

About the Authors

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 would like to contact us, please inquire with [e-mail].

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.

Getting Started

To begin using the PVGeo python package, create a new Python virtual environment and install PVGeo through pip.

# Highly recommend using Python 2.7
$ conda create -n PVGeoEnv27 python=2.7

$ conda activate PVGeoEnv27
(PVGeoEnv27) $ pip install PVGeo

Now you must install VTK to your virtual environment. For Linux and Mac users, simply install VTK through pip:

# Now install VTK
(PVGeoEnv27) $ pip install vtk

Windows Users

PVGeo on Windows can be quite (VERY) tricky to setup, so please reference previous issues with the installation label and join the PVGeo community on Slack for guidance.

Unfortunately, Windows users cannot run PVGeo in a standalone Python 2.x environment but are required to make another Python 3.6 environment to perform processing routines. The Windows Python 2.7 environment is required to properly link PVGeo to ParaView but cannot handle PVGeo without ParaView's build of VTK.

If you'd like to use PVGeo in your Python scripts, jupyter notebooks, etc., please create a Python 3.6 virtual environment:

$ conda create -n PVGeoEnv36 python=3.6

$ conda activate PVGeoEnv36
(PVGeoEnv36) $ pip install PVGeo

# Now install VTK>=8.1.0
(PVGeoEnv36) $ pip install vtk

Linking PVGeo to ParaView

Now PVGeo is ready for use in your standard Python environment. To use the PVGeo library as plugins in ParaView, please see the detailed explanation here.