pyvista.read

read(

filename: PathStrSeq,

force_ext: str | None = None,

file_format: str | None = None,

progress_bar: bool = False,

) → DataObject

vtk や meshio でサポートされている任意のファイルタイプを読み込みます．

Automatically determines the correct reader to use then wraps the corresponding mesh as a pyvista object. Attempts native vtk readers first then tries to use meshio. Pickled meshes ('.pkl' or '.pickle') are also supported.

See pyvista.get_reader() for list of vtk formats supported.

注釈

meshio がサポートするフォーマットについては nschloe/meshio を参照してください． meshio を使用したい場合は，必ず pip install meshio でインストールしてください．

Added in version 0.45: Support reading pickled meshes.

警告

The pickle module is not secure. Only read pickled mesh files ('.pkl' or '.pickle') you trust. See pickle for details.

パラメータ:

filenamestr, Path, Sequence[str | Path]

読み込むファイルへの文字列パス．ファイルのリストが与えられた場合， pyvista.MultiBlock データセットが返され，各ファイルはデータセット内の個別のブロックです．

force_extstr, optional

指定した場合，リーダーは実際の拡張とは異なる拡張によって選択されます．たとえば， '.vts' ， '.vtu' などです．

file_formatstr, optional

meshioで読み込むファイルのフォーマット．

progress_barbool, default: False

オプションでプログレスバーを表示します． meshio を使用している場合は無視されます．

戻り値:

pyvista.DataSet

ラップされたPyVistaデータセット．

参考

pyvista.DataObject.save

Save a mesh to file.

例

サンプルメッシュをロードします．

>>> import pyvista as pv
>>> from pyvista import examples
>>> mesh = pv.read(examples.antfile)
>>> mesh.plot(cpos='xz')

スタティックシーン

インタラクティブなシーン

vtkファイルをロードします．

>>> mesh = pv.read('my_mesh.vtk')  

meshioファイルをロードします．

>>> mesh = pv.read('mesh.obj')  

Load a pickled mesh file.

>>> mesh = pv.read('mesh.pkl')