.. DO NOT EDIT. .. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY. .. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE: .. "tutorial/01_basic/a_lesson_basic.py" .. LINE NUMBERS ARE GIVEN BELOW. .. only:: html .. note:: :class: sphx-glr-download-link-note :ref:`Go to the end ` to download the full example code. or to run this example in your browser via Binder .. rst-class:: sphx-glr-example-title .. _sphx_glr_tutorial_01_basic_a_lesson_basic.py: .. _basic_lesson: Basic Usage Lesson ================== This section demonstrates how to use PyVista to read and plot 3D data using the `pyvista.examples.downloads `_ module and external files. .. GENERATED FROM PYTHON SOURCE LINES 12-20 .. code-block:: Python import pyvista as pv from pyvista import examples # Set the default plot theme to the "document" theme. # pv.set_plot_theme('document') .. GENERATED FROM PYTHON SOURCE LINES 21-27 Using Existing Data ~~~~~~~~~~~~~~~~~~~ There are two main ways of getting data into PyVista: creating it yourself from scratch or loading the dataset from any one of the `compatible file formats `_. Since we're just starting out, let's load a file. .. GENERATED FROM PYTHON SOURCE LINES 27-38 .. code-block:: Python # If you have a dataset handy, like a surface model, point cloud, or VTK file, # you can use that. If you don't have something immediately available, PyVista # has a variety of files you can download in its `pyvista.examples.downloads # `_ # dataset = examples.download_saddle_surface() dataset .. raw:: html
PolyDataInformation
N Cells5131
N Points2669
N Strips0
X Bounds-2.001e+01, 2.000e+01
Y Bounds-6.480e-01, 4.024e+01
Z Bounds-6.093e-01, 1.513e+01
N Arrays0


.. GENERATED FROM PYTHON SOURCE LINES 39-41 Note how this is a :class:`pyvista.PolyData`, which is effectively a surface dataset containing points, lines, and/or faces. We can immediately plot this with: .. GENERATED FROM PYTHON SOURCE LINES 41-44 .. code-block:: Python dataset.plot() .. tab-set:: .. tab-item:: Static Scene .. image-sg:: /tutorial/01_basic/images/sphx_glr_a_lesson_basic_001.png :alt: a lesson basic :srcset: /tutorial/01_basic/images/sphx_glr_a_lesson_basic_001.png :class: sphx-glr-single-img .. tab-item:: Interactive Scene .. offlineviewer:: /home/runner/work/pyvista-tutorial-ja/pyvista-tutorial-ja/pyvista-tutorial-translations/pyvista-tutorial/doc/source/tutorial/01_basic/images/sphx_glr_a_lesson_basic_001.vtksz .. GENERATED FROM PYTHON SOURCE LINES 45-50 This is a fairly basic plot. You can change how its plotted by adding parameters as ``show_edges=True`` or changing the color by setting ``color`` to a different value. All of this is described in PyVista's API documentation in :func:`pyvista.plot`, but for now let's take a look at another dataset. This one is a volumetric dataset. .. GENERATED FROM PYTHON SOURCE LINES 50-54 .. code-block:: Python dataset = examples.download_frog() dataset .. raw:: html
HeaderData Arrays
ImageDataInformation
N Cells31594185
N Points31960000
X Bounds0.000e+00, 4.990e+02
Y Bounds0.000e+00, 4.690e+02
Z Bounds0.000e+00, 2.025e+02
Dimensions500, 470, 136
Spacing1.000e+00, 1.000e+00, 1.500e+00
N Arrays1
NameFieldTypeN CompMinMax
MetaImagePointsuint810.000e+002.540e+02


.. GENERATED FROM PYTHON SOURCE LINES 55-59 This is a :class:`pyvista.ImageData`, which is a dataset containing a uniform set of points with consistent spacing. When we plot this dataset, we have the option of enabling volumetric plotting, which plots individual cells based on the content of the data associated with those cells. .. GENERATED FROM PYTHON SOURCE LINES 59-63 .. code-block:: Python dataset.plot(volume=True) .. tab-set:: .. tab-item:: Static Scene .. image-sg:: /tutorial/01_basic/images/sphx_glr_a_lesson_basic_002.png :alt: a lesson basic :srcset: /tutorial/01_basic/images/sphx_glr_a_lesson_basic_002.png :class: sphx-glr-single-img .. tab-item:: Interactive Scene .. offlineviewer:: /home/runner/work/pyvista-tutorial-ja/pyvista-tutorial-ja/pyvista-tutorial-translations/pyvista-tutorial/doc/source/tutorial/01_basic/images/sphx_glr_a_lesson_basic_002.vtksz .. GENERATED FROM PYTHON SOURCE LINES 64-74 Read from a file ~~~~~~~~~~~~~~~~ You can read datasets directly from a file if you have access to it on your environment. This can be one of the many file formats that VTK supports, and many more that it doesn't as PyVista can rely on libraries like `meshio `_. In the following example, we load VTK's iron protein dataset `ironProt.vtk `_ from a file using :func:`pyvista.read`. .. GENERATED FROM PYTHON SOURCE LINES 74-78 .. code-block:: Python dataset = pv.read("ironProt.vtk") dataset .. raw:: html
HeaderData Arrays
ImageDataInformation
N Cells300763
N Points314432
X Bounds0.000e+00, 6.700e+01
Y Bounds0.000e+00, 6.700e+01
Z Bounds0.000e+00, 6.700e+01
Dimensions68, 68, 68
Spacing1.000e+00, 1.000e+00, 1.000e+00
N Arrays1
NameFieldTypeN CompMinMax
scalarsPointsuint810.000e+002.550e+02


.. GENERATED FROM PYTHON SOURCE LINES 79-81 This is again a :class:`pyvista.ImageData` and we can plot it volumetrically with: .. GENERATED FROM PYTHON SOURCE LINES 81-84 .. code-block:: Python dataset.plot(volume=True) .. tab-set:: .. tab-item:: Static Scene .. image-sg:: /tutorial/01_basic/images/sphx_glr_a_lesson_basic_003.png :alt: a lesson basic :srcset: /tutorial/01_basic/images/sphx_glr_a_lesson_basic_003.png :class: sphx-glr-single-img .. tab-item:: Interactive Scene .. offlineviewer:: /home/runner/work/pyvista-tutorial-ja/pyvista-tutorial-ja/pyvista-tutorial-translations/pyvista-tutorial/doc/source/tutorial/01_basic/images/sphx_glr_a_lesson_basic_003.vtksz .. GENERATED FROM PYTHON SOURCE LINES 85-92 .. raw:: html
Open In Colab
.. rst-class:: sphx-glr-timing **Total running time of the script:** (0 minutes 5.472 seconds) .. _sphx_glr_download_tutorial_01_basic_a_lesson_basic.py: .. only:: html .. container:: sphx-glr-footer sphx-glr-footer-example .. container:: binder-badge .. image:: images/binder_badge_logo.svg :target: https://mybinder.org/v2/gh/pyvista/pyvista-tutorial/gh-pages?urlpath=lab/tree/notebooks/tutorial/01_basic/a_lesson_basic.ipynb :alt: Launch binder :width: 150 px .. container:: sphx-glr-download sphx-glr-download-jupyter :download:`Download Jupyter notebook: a_lesson_basic.ipynb ` .. container:: sphx-glr-download sphx-glr-download-python :download:`Download Python source code: a_lesson_basic.py ` .. container:: sphx-glr-download sphx-glr-download-zip :download:`Download zipped: a_lesson_basic.zip ` .. only:: html .. rst-class:: sphx-glr-signature `Gallery generated by Sphinx-Gallery `_