pyvista.read

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.

ImageData File Formats

File Format	File Extension(s)	`read()`	`save()`
BMP	`.bmp`
DEM	`.dem`
DICOM	`.dcm`, `.img`
GaussianCube	`.cube`
GESigna	`.mr`
GIF	`.gif`
HDF	`.hdf`, `.vtkhdf`
HDR	`.hdr`
JPEG	`.jpeg`, `.jpg`
Meta	`.mha`, `.mhd`
MINC	`.mnc`
NIFTI	`.nii`, `.nii.gz`
NRRD	`.nhdr`, `.nrrd`
PNG	`.png`
PNM	`.pnm`
SegY	`.segy`, `.sgy`
Series	`.series`
SLC	`.slc`
TIFF	`.tif`, `.tiff`
VTK	`.vtk`
VTKP	`.pvtk`
XML	`.vti`
XMLP	`.pvti`

PolyData File Formats

File Format	File Extension(s)	`read()`	`save()`
BinaryMarchingCubes	`.tri`
BYU	`.g`
Facet	`.facet`
GaussianCube	`.cube`
HDF	`.hdf`, `.vtkhdf`
OBJ	`.obj`
Particle	`.raw`
PDB	`.pdb`
PLY	`.ply`
PTS	`.pts`
Series	`.series`
STL	`.stl`
VTK	`.vtk`
VTKP	`.pvtk`
XML	`.vtp`
Houdini	`.geo`
IV	`.iv`

UnstructuredGrid File Formats

File Format	File Extension(s)	`read()`	`save()`
AVSucd	`.inp`
Fluent	`.cas`
Gambit	`.neu`
HDF	`.hdf`, `.vtkhdf`
MFIX	`.res`
Nek5000	`.nek5000`
ProStar	`.vrt`
Series	`.series`
VTK	`.vtk`
VTKP	`.pvtk`
Xdmf	`.xdmf`
XMLP	`.pvtu`
XML	`.vtu`

MultiBlock File Formats

File Format	File Extension(s)	`read()`	`save()`
CGNS	`.cgns`
EnSight	`.case`
ExodusII	`.e`, `.ex2`, `.exii`, `.exo`
FLUENTCFF	`.h5`
GLTF	`.glb`, `.gltf`
HDF	`.hdf`, `.vtkhdf`
Plot3DMeta	`.p3d`
POpenFOAM	`.foam`
PVD	`.pvd`
Series	`.series`
Tecplot	`.dat`
Xdmf	`.xdmf`
XML	`.vtm`, `.vtmb`

注釈

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')

スタティックシーン

../../../_images/pyvista-read-bee4a09c48e26d34_00_00.png

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

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

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

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

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

Load a pickled mesh file.

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

pyvista.read

目次

pyvista.read#