例

例#

PyVistaには，様々な内蔵デモやダウンロード可能なサンプルデータがあります． 例えば，以下のようなものがあります．

内蔵された丘のデータセットをプロットします

>>> from pyvista import examples
>>> hills = examples.load_random_hills()
>>> hills.plot()
../../_images/index-1_00_00.png

多くのデータセットはサイズが大きすぎて，PyVistaに含めることはできませんが，ダウンロードしてローカルにキャッシュすることができます． これらのデータセットは，ダウンロードして使用することができます．

タービンブレードのメッシュをプロットします．

>>> from pyvista import examples
>>> blade_mesh = examples.download_turbine_blade()
>>> blade_mesh.plot()
../../_images/index-2_00_003.png

最後に，PyVistaにはいくつかのデモが用意されており，機能をすぐに試すことができます．

方向づけ立方体プロッターの作成と表示

>>> from pyvista import demos
>>> plotter = demos.orientation_plotter()
>>> plotter.show()
../../_images/index-3_00_001.png

APIリファレンス#

examples.examples

PyVistaに同梱されていて，ダウンロードする必要のない内蔵サンプル．

examples.downloads

様々なソースから集められたダウンロード可能なデータセット．

examples.planets

3D天体のデータセットがダウンロードできます．

examples.vrml

Contains vrml examples.

examples.download_3ds

Contains 3ds examples.

examples.gltf

Contains glTF examples.

demos.demos

PyVistaの機能を紹介するデモです．

使用上の注意点#

警告

このリポジトリをご覧になり，3Dモデルやレンジデータセットをどのようにお使いになるかをお考えになる際には，これらの人工物の中には，宗教的または文化的に重要な意味を持つものがあることを覚えておいてください．何億人もの人々に崇拝されている宗教的なシンボルである仏陀とは別に，龍は中国文化のシンボルであり，タイの像はヒンズー教徒にとって宗教的に重要な要素を含んでおり，ルーシーはキリスト教の天使であり，イタリアの教会には彼女のような像がよく見られます．ルーシーはキリスト教の天使で，イタリアの教会によく見られる像です．これらのモデルのレンダリングやその他の使用は，趣味の良いものにしてください．アニメートやモーフィング，ブーリアン演算子の適用，(壊れたり爆発したり溶けたりするような)不快な現象のシミュレーションなどは行わないでください．この種の実験には別のモデルを選んでください．(Stanford大学のウサギやアルマジロには何をしてもいいです）．

ダウンロードキャッシュとデータソース#

インターネット接続と通常のユーザーアカウントがあれば，PyVistaは問題なくサンプルをダウンロードしてキャッシュすることができるはずです．次の2つのセクションでは，PyVistaがサンプルをダウンロードする方法をカスタマイズしたい人について説明します．

キャッシュ#

PyVistaは， pooch を使ってサンプルファイルをダウンロードし，ローカルキャッシュに保存します．このキャッシュの場所は，実行時に次のようにして決定できます．

>>> from pyvista import examples
>>> # Get the local examples path on Linux
>>> examples.PATH
'/home/user/.cache/pyvista_3'

必要なら examples.delete_downloads() でローカルキャッシュをクリアすることができます．

このローカルキャッシュのパスを上書きしたい場合は， PYVISTA_USERDATA_PATH 環境変数を設定します．このパスは書き込み可能である必要があります．

データソース#

PyVistaは，サンプルデータの主なソースとして PyVista/vtk-data を使用します．インターネットに接続できない場合や，ローカルディレクトリやネットワークディレクトリを使いたい場合は，環境変数 VTK_DATA_PATH でこのソースをオーバーライドすることができます．

次の例では，まず git リポジトリをクローンし，そのディレクトリを VTK_DATA_PATH 経由で PyVista にエクスポートしています．パスが 'Data' で終わっていることに注意してください．これは， pooch のためにデータの正確なディレクトリを指定する必要があるためです．

git clone https://github.com/pyvista/vtk-data.git
export VTK_DATA_PATH=/home/alex/python/vtk-data/Data

セル#

PyVistaには，VTKのセルタイプについて学習するために使用できる，単一セルの pyvista.UnstructuredGrid オブジェクトを作成する関数がいくつか用意されています．

plot_cell(grid[, cpos])

セルのインデックスを表示しながら， pyvista.UnstructuredGrid をプロットします．

Empty()

1つの空のセルを含む pyvista.UnstructuredGrid を作成します．

Vertex()

1つの頂点を含む pyvista.UnstructuredGrid を作成します．

PolyVertex()

1つの多頂点を含む pyvista.UnstructuredGrid を作成します．

Line()

1つの線を含む pyvista.UnstructuredGrid を作成します．

PolyLine()

1つの折れ線を含む pyvista.UnstructuredGrid を作成します．

Triangle()

1つの3角形を含む pyvista.UnstructuredGrid を作成します．

TriangleStrip()

1つの3角形のストリップを含む pyvista.UnstructuredGrid を作成します．

Polygon()

1つの多頂点を含む pyvista.UnstructuredGrid を作成します．

Pixel()

Create a pyvista.UnstructuredGrid containing a single pixel.

Quadrilateral()

1つの4角形を含む pyvista.UnstructuredGrid を作成します．

Tetrahedron()

1つの4面体を含む pyvista.UnstructuredGrid を作成します．

Voxel()

1つのボクセルを含む pyvista.UnstructuredGrid を作成します．

Hexahedron()

1つの6面体を含む pyvista.UnstructuredGrid を作成します．

Wedge()

1つの楔を含む pyvista.UnstructuredGrid を作成します．

Pyramid()

1つのピラミッドを含む pyvista.UnstructuredGrid を作成します．

PentagonalPrism()

1つの5角形のプリズムを含む pyvista.UnstructuredGrid を作成します．

HexagonalPrism()

1つの6角形のプリズムを含む pyvista.UnstructuredGrid を作成します．

QuadraticEdge()

Create a pyvista.UnstructuredGrid containing a single quadratic edge.

QuadraticTriangle()

Create a pyvista.UnstructuredGrid containing a single quadratic triangle.

QuadraticQuadrilateral()

Create a pyvista.UnstructuredGrid containing a single quadratic quadrilateral.

QuadraticPolygon()

Create a pyvista.UnstructuredGrid containing a single quadratic polygon.

QuadraticTetrahedron()

Create a pyvista.UnstructuredGrid containing a single quadratic tetrahedron.

QuadraticHexahedron()

Create a pyvista.UnstructuredGrid containing a single quadratic hexahedron.

QuadraticWedge()

Create a pyvista.UnstructuredGrid containing a single quadratic wedge.

QuadraticPyramid()

Create a pyvista.UnstructuredGrid containing a single quadratic pyramid.

BiQuadraticQuadrilateral()

Create a pyvista.UnstructuredGrid containing a single biquadratic quadrilateral.

TriQuadraticHexahedron()

Create a pyvista.UnstructuredGrid containing a single triquadratic hexahedron.

TriQuadraticPyramid()

Create a pyvista.UnstructuredGrid containing a single triquadratic pyramid.

QuadraticLinearQuadrilateral()

Create a pyvista.UnstructuredGrid containing a single quadratic linear quadrilateral.

QuadraticLinearWedge()

Create a pyvista.UnstructuredGrid containing a single quadratic linear wedge.

BiQuadraticQuadraticWedge()

Create a pyvista.UnstructuredGrid containing a single biquadratic quadratic wedge.

BiQuadraticQuadraticHexahedron()

Create a pyvista.UnstructuredGrid containing a single biquadratic quadratic hexahedron.

BiQuadraticTriangle()

Create a pyvista.UnstructuredGrid containing a single biquadratic triangle.

CubicLine()

Create a pyvista.UnstructuredGrid containing a single cubic line.

Polyhedron()

Create a pyvista.UnstructuredGrid containing a single polyhedron.
目次