Skip to main content
Ctrl+K
PyVista 0.45.dev0 ドキュメント - Home
  • GitHub
  • Slack Community
  • Support
  • Contributing
  • The Paper
  • はじめに
    • なぜPyVistaなのか?
    • 著者と引用
    • インストール
    • 接続
    • 外部の例
  • ユーザーガイド
    • メッシュとは?
    • APIの基本的な使用方法
    • PyVistaデータモデル
    • VTKからPyVistaへの移行
    • プロットテーマ
    • Jupyterノートブックプロット
      • PyVista用Jupyterバックエンドをtrame化する
    • オプションの依存関係
  • Tags
    • filter (45)
      • ブール演算
      • セルの中心を抽出
      • 平面とボックスでクリップします
      • サーフェスを使用したクリップ
      • 衝突
      • 表面の法線を計算します
      • ボリューム分析
      • 連結度
      • コンタリング
      • 間引き
      • 2つのサーフェス間の距離
      • サーフェス内のセルを抽出
      • エッジを抽出
      • 表面を抽出
      • 押し出し回転
      • 押し出しトリム
      • マーチングキューブ
      • Gaussianスムージング
      • 測地パス
      • 字形のプロット (ベクトルかPolyData)
      • 字形表
      • フィールドの勾配を計算する
      • 高速Fourier変換
      • Perlinノイズによる高速フーリエ変換
      • 画像データの表現
      • データの積分
      • 詳細な補間点
      • 補間/サンプリング法の比較
      • メッシュ品質の計算
      • レイトレーシング
      • 平面に投影
      • メッシュを反射
      • 詳細なリサンプリング
      • 回転
      • サンプル関数:2DでのPerlinノイズ
      • サンプル関数:3DでのPerlinノイズ
      • スライシング
      • 流線
      • 2D流線
      • セルの細分化
      • サーフェスの再構築
      • サーフェイススムージング
      • 共通フィルタの使用
      • サーフェスメッシュをボクセル化する
      • ベクトルによるワープ
    • lights (7)
      • Lightアクター
      • 減衰
      • ビーム形状
      • 光源タイプ
      • メッシュライティングの無効化
      • プロッタ照明システム
      • シャドウ
    • load (29)
      • 明示的な構造グリッドの作成
      • ジオメトリオブジェクト
      • Kochanekスプラインの作成
      • パラメトリックジオメトリオブジェクト
      • ALIEN MONSTERSのピクセルアート
      • プラトン立体
      • 点群を作成
      • PointSetの作成
      • PolyDataを作成
      • トライアングル ストリップ
      • 多面体による非構造化グリッド
      • Create Sphere Mesh Multiple Ways
      • スプラインの作成
      • 構造化サーフェスを作成する
      • 線分から2 Dサーフェスをまとう
      • 3角形サーフェスを作成
      • 円柱を用いたトラス状のFEAソリューションのプロット
      • 統合グリッドを作成
      • 非構造化グリッドの作成
      • 線形セル
      • glTFファイルの取り扱いについて
      • VRMLファイルの取り扱いについて
      • FEniCS/Dolfinメッシュを確認.
      • ファイルからロードおよびプロットする
      • イメージファイルの読み込み
      • 並列フィルタ
      • リーダーによるデータの読み込み
      • メッシュ後の地形
      • ​他のオブジェクトのラップ
    • plot (57)
      • アンチエイリアシング
      • バックフェイスプロパティの設定
      • 背景イメージ
      • ぼかし
      • 境界のプロット
      • チャートの基本
      • チャートのオーバーレイ
      • メッシュまたはプロット全体の消去
      • カラーマップの選択肢
      • カラーサイクリング
      • Compositeピッキング
      • 被写界深度のプロット
      • Depth Peeling
      • 線上の距離に応じたラベル
      • 距離を測る
      • エッジを表示
      • Eye Dome Lighting
      • メッシュの要素をピックする
      • 床を使用してプロットする
      • ゴーストを使用してセルを非表示にする
      • GIFムービーの作成
      • デプスイメージをレンダーする
      • マッピング前に補間
      • 等値移動
      • ラベルポイント
      • 凡例とグリフ
      • 照明プロパティ
      • サブプロットのリンクビュー
      • ルックアップテーブル
      • メッシュのピッキング
      • MP 4ムービーを作成する
      • グリフを使ったムービーの保存
      • カラーマップが移動する静止物体のGIFムービーを作成します
      • マルチウィンドウプロット
      • 不透明度を指定してプロット
      • オービット
      • 直交スライス
      • 物理ベースのレンダリング
      • 円形円弧上にスカラーをプロットします
      • 線上のプロット
      • ポイントセルスカラー
      • 点群のプロット
      • メッシュ上の点の選択
      • スケーリングされたガウスポイント
      • スカラーバーをカスタマイズ
      • スクリーンショットを保存する
      • シェーディングのタイプ
      • シルエットハイライト
      • 球座標でデータをプロットする
      • Surface Space Ambient Occlusion
      • メッシュの表面上の点をピックします
      • テクスチャを適用する
      • グローバルおよびローカルプロットテーマの制御
      • 地形図
      • プロットベクトルコンポーネント
      • 可視頂点
      • ボリュームレンダリング
    • widgets (10)
      • アニメーション
      • ボックスウィジェット
      • チェックボックスウィジェット
      • クリップボリュームウィジェット
      • 線ウィジェット
      • 複数のスライダウィジェット
      • 平面ウィジェット
      • スライダバーウィジェット
      • 球体ウィジェット
      • スプラインウィジェット
  • 例
    • メッシュ作成
      • 明示的な構造グリッドの作成
      • ジオメトリオブジェクト
      • Kochanekスプラインの作成
      • パラメトリックジオメトリオブジェクト
      • ALIEN MONSTERSのピクセルアート
      • プラトン立体
      • 点群を作成
      • PointSetの作成
      • PolyDataを作成
      • トライアングル ストリップ
      • 多面体による非構造化グリッド
      • Create Sphere Mesh Multiple Ways
      • スプラインの作成
      • 構造化サーフェスを作成する
      • 線分から2 Dサーフェスをまとう
      • 3角形サーフェスを作成
      • 円柱を用いたトラス状のFEAソリューションのプロット
      • 統合グリッドを作成
      • 非構造化グリッドの作成
      • 線形セル
      • glTFファイルの取り扱いについて
      • VRMLファイルの取り扱いについて
      • FEniCS/Dolfinメッシュを確認.
      • ファイルからロードおよびプロットする
      • イメージファイルの読み込み
      • 並列フィルタ
      • リーダーによるデータの読み込み
      • メッシュ後の地形
      • ​他のオブジェクトのラップ
    • フィルタリング
      • ブール演算
      • セルの中心を抽出
      • 平面とボックスでクリップします
      • サーフェスを使用したクリップ
      • 衝突
      • 表面の法線を計算します
      • ボリューム分析
      • 連結度
      • コンタリング
      • 間引き
      • 2つのサーフェス間の距離
      • サーフェス内のセルを抽出
      • エッジを抽出
      • 表面を抽出
      • 押し出し回転
      • 押し出しトリム
      • マーチングキューブ
      • Gaussianスムージング
      • 測地パス
      • 字形のプロット (ベクトルかPolyData)
      • 字形表
      • フィールドの勾配を計算する
      • 高速Fourier変換
      • Perlinノイズによる高速フーリエ変換
      • 画像データの表現
      • データの積分
      • 詳細な補間点
      • 補間/サンプリング法の比較
      • メッシュ品質の計算
      • レイトレーシング
      • 平面に投影
      • メッシュを反射
      • 詳細なリサンプリング
      • 回転
      • サンプル関数:2DでのPerlinノイズ
      • サンプル関数:3DでのPerlinノイズ
      • スライシング
      • 流線
      • 2D流線
      • セルの細分化
      • サーフェスの再構築
      • サーフェイススムージング
      • 共通フィルタの使用
      • サーフェスメッシュをボクセル化する
      • ベクトルによるワープ
    • プロット
      • アンチエイリアシング
      • バックフェイスプロパティの設定
      • 背景イメージ
      • ぼかし
      • 境界のプロット
      • チャートの基本
      • チャートのオーバーレイ
      • メッシュまたはプロット全体の消去
      • カラーマップの選択肢
      • カラーサイクリング
      • Compositeピッキング
      • 被写界深度のプロット
      • Depth Peeling
      • 線上の距離に応じたラベル
      • 距離を測る
      • エッジを表示
      • Eye Dome Lighting
      • メッシュの要素をピックする
      • 床を使用してプロットする
      • ゴーストを使用してセルを非表示にする
      • GIFムービーの作成
      • デプスイメージをレンダーする
      • マッピング前に補間
      • 等値移動
      • ラベルポイント
      • 凡例とグリフ
      • 照明プロパティ
      • サブプロットのリンクビュー
      • ルックアップテーブル
      • メッシュのピッキング
      • MP 4ムービーを作成する
      • グリフを使ったムービーの保存
      • カラーマップが移動する静止物体のGIFムービーを作成します
      • マルチウィンドウプロット
      • 不透明度を指定してプロット
      • オービット
      • 直交スライス
      • 物理ベースのレンダリング
      • 円形円弧上にスカラーをプロットします
      • 線上のプロット
      • ポイントセルスカラー
      • 点群のプロット
      • メッシュ上の点の選択
      • スケーリングされたガウスポイント
      • スカラーバーをカスタマイズ
      • スクリーンショットを保存する
      • シェーディングのタイプ
      • シルエットハイライト
      • 球座標でデータをプロットする
      • Surface Space Ambient Occlusion
      • メッシュの表面上の点をピックします
      • テクスチャを適用する
      • グローバルおよびローカルプロットテーマの制御
      • 地形図
      • プロットベクトルコンポーネント
      • 可視頂点
      • ボリュームレンダリング
    • ウィジェット
      • アニメーション
      • ボックスウィジェット
      • チェックボックスウィジェット
      • クリップボリュームウィジェット
      • 線ウィジェット
      • 複数のスライダウィジェット
      • 平面ウィジェット
      • スライダバーウィジェット
      • 球体ウィジェット
      • スプラインウィジェット
    • 照明
      • Lightアクター
      • 減衰
      • ビーム形状
      • 光源タイプ
      • メッシュライティングの無効化
      • プロッタ照明システム
      • シャドウ
    • 共通
      • ポイントを平面に投影して平面充填します.
    • 詳細設定
      • 新しいギャラリーを追加する例
      • Visualize Anatomical Groups
      • メッシュ領域間でフィールドを比較
      • 原子軌道のプロット
      • Trameツールバーのカスタマイズ
      • PyVistaの拡張
      • Hertの接触応力を可視化する
      • 磁場をプロットする
      • 電子機器の冷却CFD
      • OpenFOAMデータのプロット
      • CFDデータをプロットする
      • 3D地球と天体
      • VTKアルゴリズムでプロットする
      • ポンプブラケットのモーダル解析の可視化
      • Moeller-Trumboreアルゴリズムの可視化
      • 球体を裏返す
      • 振動の固有振動モードを表示します
  • APIリファレンス
    • コアAPI
      • データオブジェクト
      • データセット
      • ポイントセット
      • グリッドデータ
      • 複合データセット
      • フィルタ
      • カメラ
      • ライト
      • セル
      • ヘルパー
      • その他
      • タイピング
      • パーティショニングされたデータセット
      • Validation
    • プロット
      • プロット
      • PyVistaとPyQt
      • テーマ
      • Trame
      • pyvista.Actor
      • pyvista.Axes
      • pyvista.AxesActor
      • pyvista.AxesAssembly
      • pyvista.AxesAssemblySymmetric
      • pyvista.CameraPosition
      • pyvista.CornerAnnotation
      • pyvista.CubeAxesActor
      • pyvista.DataSetMapper
      • pyvista.Label
      • pyvista.LookupTable
      • pyvista.PlanesAssembly
      • pyvista.Plotter
      • pyvista.Prop3D
      • pyvista.Property
      • pyvista.Renderer
      • pyvista.RenderWindowInteractor
      • pyvista.Text
      • pyvista.TextProperty
      • pyvista.Timer
      • pyvista.plotting.mapper._BaseMapper
      • pyvista.plotting.opts.InterpolationType
      • pyvista.plotting.opts.RepresentationType
      • pyvista.plotting.opts.ElementType
      • pyvista.plotting.volume.Volume
      • pyvista.plotting.volume_property.VolumeProperty
      • pyvista.CompositePolyDataMapper
      • pyvista.CompositeAttributes
      • pyvista.BlockAttributes
      • チャート
      • pyvista.plotting.widgets.WidgetHelper
      • pyvista.plotting.widgets.AffineWidget3D
      • pyvista.plotting.picking.PickingHelper
      • 便利な機能
    • ユーティリティ
      • ジオメトリー
      • Image
      • パラメトリックオブジェクト
      • 一般ユーティリティ
    • リーダー
      • pyvista.get_reader
      • pyvista.AVSucdReader
      • pyvista.BMPReader
      • pyvista.BYUReader
      • pyvista.BinaryMarchingCubesReader
      • pyvista.CGNSReader
      • pyvista.DEMReader
      • pyvista.DICOMReader
      • pyvista.EnSightReader
      • pyvista.ExodusIIBlockSet
      • pyvista.ExodusIIReader
      • pyvista.FacetReader
      • pyvista.FLUENTCFFReader
      • pyvista.FluentReader
      • pyvista.GambitReader
      • pyvista.GaussianCubeReader
      • pyvista.GESignaReader
      • pyvista.GIFReader
      • pyvista.GLTFReader
      • pyvista.HDFReader
      • pyvista.HDRReader
      • pyvista.JPEGReader
      • pyvista.MFIXReader
      • pyvista.MetaImageReader
      • pyvista.MINCImageReader
      • pyvista.MultiBlockPlot3DReader
      • pyvista.Nek5000Reader
      • pyvista.NIFTIReader
      • pyvista.NRRDReader
      • pyvista.OBJReader
      • pyvista.OpenFOAMReader
      • pyvista.ParticleReader
      • pyvista.PDBReader
      • pyvista.PLYReader
      • pyvista.PNGReader
      • pyvista.PNMReader
      • pyvista.POpenFOAMReader
      • pyvista.PTSReader
      • pyvista.PVDReader
      • pyvista.Plot3DMetaReader
      • pyvista.ProStarReader
      • pyvista.SLCReader
      • pyvista.STLReader
      • pyvista.SegYReader
      • pyvista.TIFFReader
      • pyvista.TecplotReader
      • pyvista.VTKDataSetReader
      • pyvista.VTKPDataSetReader
      • pyvista.XMLImageDataReader
      • pyvista.XMLMultiBlockDataReader
      • pyvista.XMLPImageDataReader
      • pyvista.XMLPRectilinearGridReader
      • pyvista.XMLPUnstructuredGridReader
      • pyvista.XMLPartitionedDataSetReader
      • pyvista.XMLPolyDataReader
      • pyvista.XMLRectilinearGridReader
      • pyvista.XMLStructuredGridReader
      • pyvista.XMLUnstructuredGridReader
      • pyvista.XdmfReader
      • pyvista.BaseReader
      • pyvista.PointCellDataSelection
      • pyvista.TimeReader
      • リーダー列挙型
    • 例
      • データセットギャラリー
      • pyvista.examples.examples
      • pyvista.examples.downloads
      • pyvista.examples.planets
      • pyvista.examples.vrml
      • pyvista.examples.download_3ds
      • pyvista.examples.gltf
      • pyvista.demos.demos
      • pyvista.examples.cells.plot_cell
      • pyvista.examples.cells.Empty
      • pyvista.examples.cells.Vertex
      • pyvista.examples.cells.PolyVertex
      • pyvista.examples.cells.Line
      • pyvista.examples.cells.PolyLine
      • pyvista.examples.cells.Triangle
      • pyvista.examples.cells.TriangleStrip
      • pyvista.examples.cells.Polygon
      • pyvista.examples.cells.Pixel
      • pyvista.examples.cells.Quadrilateral
      • pyvista.examples.cells.Tetrahedron
      • pyvista.examples.cells.Voxel
      • pyvista.examples.cells.Hexahedron
      • pyvista.examples.cells.Wedge
      • pyvista.examples.cells.Pyramid
      • pyvista.examples.cells.PentagonalPrism
      • pyvista.examples.cells.HexagonalPrism
      • pyvista.examples.cells.QuadraticEdge
      • pyvista.examples.cells.QuadraticTriangle
      • pyvista.examples.cells.QuadraticQuadrilateral
      • pyvista.examples.cells.QuadraticPolygon
      • pyvista.examples.cells.QuadraticTetrahedron
      • pyvista.examples.cells.QuadraticHexahedron
      • pyvista.examples.cells.QuadraticWedge
      • pyvista.examples.cells.QuadraticPyramid
      • pyvista.examples.cells.BiQuadraticQuadrilateral
      • pyvista.examples.cells.TriQuadraticHexahedron
      • pyvista.examples.cells.TriQuadraticPyramid
      • pyvista.examples.cells.QuadraticLinearQuadrilateral
      • pyvista.examples.cells.QuadraticLinearWedge
      • pyvista.examples.cells.BiQuadraticQuadraticWedge
      • pyvista.examples.cells.BiQuadraticQuadraticHexahedron
      • pyvista.examples.cells.BiQuadraticTriangle
      • pyvista.examples.cells.CubicLine
      • pyvista.examples.cells.Polyhedron
  • その他
    • VTKの構築
    • Dockerコンテナ内のPyVista
    • PyInstallerを使用したPyVistaのフリーズ
    • 貢献
    • Sphinx PyVista Plot ディレクティブ
    • PyVista pytest プラグイン
    • ローカルVTKデータの使用
    • PyVistaの拡張
  • .rst

新しいギャラリーを追加する例

目次

  • セクションタイトル
  • プロットと画像
  • 注意事項 - プロッターは1セル内にあること.
  • このセルではプロッタを動作させることができない
  • アニメーション
  • サンプルファイルの追加
  • ラッピング例の追加

注釈

Go to the end to download the full example code.

新しいギャラリーを追加する例#

このサンプルは,新しいPyVistaの Sphinx Gallery のサンプルを追加する方法を示していると同時に,それらの作成に使用することができるテンプレートでもあります.

各例は,フォームに参照タグ/キーを持つ必要があります:

.. _<example_name>_example:

.. _ は必要です.この後に続くものはすべて参照タグで,docstringの中で使用できる可能性があります.慣習として,すべての参照タグは snake_case で統一しています.

このセクションでは,その事例が何について,および/または,何を示しているのかについて,簡単な概要を説明します. タイトルは,あなたの例がカバーするトピックを反映するように変更する必要があります.

新しい例は,pythonスクリプトとして以下に追加する必要があります:

examples/<index>-<directory-name>/<some_example>.py

注釈

絶対に必要でない限り,新しいディレクトリを作らないようにしましょう.もし,新しいフォルダを作らなければならない場合は, README.txt を必ず追加して,参照先,タイトル,フォルダの説明を一文で記述してください.そうしないと,新しいフォルダはSphinxによって無視されます.

Example file names should be underscore-separated snake case:

some_example.py

このプリアンブルが完了すると,最初のコードブロックが始まります.ここは一般的にインポートを設定する場所です.

注釈

By default, the documentation scrapper will generate both a static image and an interactive widget for each plot. If you want to turn this feature off define at the top of your file:

# sphinx_gallery_start_ignore

PYVISTA_GALLERY_FORCE_STATIC_IN_DOCUMENT = True

# sphinx_gallery_end_ignore

静止画像をプロットの一部にのみ使用したい場合.静止画像にしたい画像を生成する plot/show コマンドの前に PYVISTA_GALLERY_FORCE_STATIC を定義してください.

...
pl.show()  # this will be interactive plot

...
pl.show()  # this will be static plot
from __future__ import annotations

import pyvista as pv
from pyvista import examples

セクションタイトル#

コードブロックは,テキスト "sections" で分割することができ,これは再構築されたテキストとして解釈されます.

これは,生成されたjupyterノートブックやHTMLページでもマークダウンのセルに変換されます.

セクションには,ステップバイステップのコメントやモチベーションに関するメモなど,例題に関するあらゆる情報を含めることができます.

Jupyterノートブックと同様に,コードブロックの最後にステートメントが未アサインである場合,その __repr__ メソッドに従って出力が生成され,画面に表示されます. それ以外の場合は, print() を使用してテキストを出力することができます.

# Create a dataset and exercise it's repr method
dataset = pv.Sphere()
dataset
HeaderData Arrays
PolyDataInformation
N Cells1680
N Points842
N Strips0
X Bounds-4.993e-01, 4.993e-01
Y Bounds-4.965e-01, 4.965e-01
Z Bounds-5.000e-01, 5.000e-01
N Arrays1
NameFieldTypeN CompMinMax
NormalsPointsfloat323-1.000e+001.000e+00


プロットと画像#

画像を出力するもの(例えば pyvista.Plotter.show() ) を使用すると,結果の画像は出力のHTML内にレンダリングされることになります.

注釈

サンプルスクリプトの先頭に sphinx_gallery_thumbnail_number = <int> が含まれていない限り,ギャラリーのサムネイル画像には最初の図(この図)が使用されます.

また,この画像番号は1ベースインデックスを使用していることに注意してください.

dataset.plot(text='Example Figure')
add example

注意事項 - プロッターは1セル内にあること.#

複数のセルにまたがる単一の pyvista.Plotter オブジェクトを使用することはできません.なぜなら,これらのオブジェクトはセルの終了時に自動的にクローズアウトされるからです.

ここでは,同じセルにプロッタを表示せずにインスタンス化する理由を示すために, pyvista.Actor repr を演習しています.

pl = pv.Plotter()
actor = pl.add_mesh(dataset)
actor
add example
Actor (0x7f6fee2097e0)
  Center:                     (0.0, 0.0, 0.0)
  Pickable:                   True
  Position:                   (0.0, 0.0, 0.0)
  Scale:                      (1.0, 1.0, 1.0)
  Visible:                    True
  X Bounds                    -4.993E-01, 4.993E-01
  Y Bounds                    -4.965E-01, 4.965E-01
  Z Bounds                    -5.000E-01, 5.000E-01
  User matrix:                Identity
  Has mapper:                 True

Property (0x7f7036427100)
  Ambient:                     0.0
  Ambient color:               Color(name='lightblue', hex='#add8e6ff', opacity=255)
  Anisotropy:                  0.0
  Color:                       Color(name='lightblue', hex='#add8e6ff', opacity=255)
  Culling:                     "none"
  Diffuse:                     1.0
  Diffuse color:               Color(name='lightblue', hex='#add8e6ff', opacity=255)
  Edge color:                  Color(name='black', hex='#000000ff', opacity=255)
  Edge opacity:                1.0
  Interpolation:               InterpolationType.FLAT
  Lighting:                    True
  Line width:                  1.0
  Metallic:                    0.0
  Opacity:                     1.0
  Point size:                  5.0
  Render lines as tubes:       False
  Render points as spheres:    False
  Roughness:                   0.5
  Show edges:                  False
  Specular:                    0.0
  Specular color:              Color(name='lightblue', hex='#add8e6ff', opacity=255)
  Specular power:              100.0
  Style:                       "Surface"

DataSetMapper (0x7f7036427100)
  Scalar visibility:           False
  Scalar range:                (0.0, 1.0)
  Interpolate before mapping:  True
  Scalar map mode:             default
  Color mode:                  direct

Attached dataset:
PolyData (0x7f6feddb78e0)
  N Cells:    1680
  N Points:   842
  N Strips:   0
  X Bounds:   -4.993e-01, 4.993e-01
  Y Bounds:   -4.965e-01, 4.965e-01
  Z Bounds:   -5.000e-01, 5.000e-01
  N Arrays:   1

このセルではプロッタを動作させることができない#

プロッターは sphinx_gallery によってすでに閉じられています.

# This cannot be run here because the plotter is already closed and would raise
# an error:
# >>> pl.show()

# You can, however, close out the plotter or access other attributes.
pl.close()

アニメーション#

アニメーションを作成することもできます.完全な例は MP 4ムービーを作成する にありますが,このセルは一つのセルの中でアニメーションを作成する方法を説明しています.

ここでは,単純な球体を爆発させます.

pl = pv.Plotter(off_screen=True)

# optimize for size
pl.open_gif('example_movie.gif', palettesize=16)

sphere = pv.Sphere(theta_resolution=10, phi_resolution=10)

# Add initial mesh to setup the camera
actor = pl.add_mesh(sphere)
pl.background_color = 'w'

# clear and overwrite the mesh on each frame
n_frames = 20
for i in range(n_frames):
    exploded = sphere.explode(factor=i / (n_frames * 2)).extract_surface()
    actor.mapper.dataset.copy_from(exploded)
    pl.camera.reset_clipping_range()
    pl.write_frame()  # Write this frame

# Be sure to close the plotter when finished
pl.close()
add example

サンプルファイルの追加#

PyVistaには様々なサンプルファイルがあり,すべて pyvista/vtk_data に格納されているので,そこの指示に従ってファイルを追加することができます.

PyVistaの内部では, pooch を使用しており, pyvista.examples.downloads.download_file() で追加したファイルに簡単にアクセスすることができます.

filename = examples.download_file('bunny.ply')
filename
'/home/runner/.cache/pyvista_3/bunny.ply'

ラッピング例の追加#

While it's possible to simply download a file and then read it in, it's better for you to write a wrapped download_<example_dataset>() within /pyvista/examples/downloads.py. For example download_bunny() downloads and reads with pyvista.read().

もし,サンプルファイルを追加するつもりなら, downloads.py に新しい関数を追加して,ユーザーが簡単にサンプルファイルを追加できるようにする必要があります.

dataset = examples.download_bunny()
dataset


# Making a Pull Request
# ~~~~~~~~~~~~~~~~~~~~~
# Once your example is complete and you've verified it builds locally, you can
# make a pull request (PR).
#
# Branches containing examples should be prefixed with `docs/` as per the branch
# naming conventions found in out `Contributing Guidelines
# <https://github.com/pyvista/pyvista/blob/main/CONTRIBUTING.rst>`_.
#
# .. note::
#    You only need to create the Python source example (``*.py``).  The jupyter
#    notebook and the example HTML will be auto-generated via `sphinx-gallery
#    <https://sphinx-gallery.github.io/>`_.
PolyDataInformation
N Cells69451
N Points35947
N Strips0
X Bounds-9.469e-02, 6.101e-02
Y Bounds3.299e-02, 1.873e-01
Z Bounds-6.187e-02, 5.880e-02
N Arrays0


Total running time of the script: (0 minutes 2.405 seconds)

Download Jupyter notebook: add_example.ipynb

Download Python source code: add_example.py

Download zipped: add_example.zip

Sphinx-Galleryによるギャラリー

目次
  • セクションタイトル
  • プロットと画像
  • 注意事項 - プロッターは1セル内にあること.
  • このセルではプロッタを動作させることができない
  • アニメーション
  • サンプルファイルの追加
  • ラッピング例の追加

著者 Alex Kaszynski and Bane Sullivan

© Copyright 2017-2025, The PyVista Developers.