注釈
完全なサンプルコードをダウンロードしたり、Binderを使ってブラウザでこのサンプルを実行するには、 最後に進んでください 。
基本的な使い方のレッスン#
このセクションでは， pyvista.examples.downloads モジュールと外部ファイルを使用して，PyVistaで3Dデータを読み取り，プロットする方法を説明します．
import pyvista as pv
from pyvista import examples
# Set the default plot theme to the "document" theme.
# pv.set_plot_theme('document')
既存データの活用#
PyVistaにデータを取り込む方法は主に2つあります．ゼロから自分で作成するか， 互換性のあるファイルフォーマット のいずれかからデータセットを読み込むかです．これから始めるので，ファイルをロードしてみましょう．
# 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
# <https://docs.pyvista.org/api/examples/_autosummary/pyvista.examples.downloads.html>`_
#
dataset = examples.download_saddle_surface()
dataset
これは pyvista.PolyData であり，事実上，点，線，面を含むサーフェスデータセットであることに注意してください．このデータセットを使って，すぐにプロットすることができます．
これはかなり基本的なプロットです． show_edges=True などのパラメータを追加したり， color を別の値に設定して色を変更することで，プロット方法を変更することができます．これらのことは，PyVistaのAPIドキュメントである pyvista.plot() に記載されていますが，ここでは別のデータセットを見てみましょう．これは体積のデータセットです．
これは pyvista.ImageData で，一貫した間隔を持つ一様な点の集合を含むデータセットです．このデータセットをプロットするとき，個々のセルを，そのセルに関連するデータの内容に基づいてプロットする，volumetric plottingを有効にするオプションがあります．
dataset.plot(volume=True)
ファイルから読み込む#
あなたの環境にアクセスできるのであれば，ファイルから直接データセットを読み込むことができます．これは，VTKがサポートしている多くのファイルフォーマットの1つであり，PyVistaが meshio のようなライブラリに依存できるように，サポートしていない多くのファイルフォーマットでもあり得ます．
以下の例では，VTKの鉄タンパク質データセット ironProt.vtk を pyvista.read() を使ってファイルからロードしています．
これもまた pyvista.ImageData で，ボリューム的にプロットすることができます．
dataset.plot(volume=True)
Total running time of the script: (0 minutes 5.472 seconds)
