"""Fine-grained control of reading data files.""" from __future__ import annotations from abc import ABC from abc import abstractmethod from dataclasses import dataclass import enum import json import os from pathlib import Path from typing import TYPE_CHECKING from typing import Any from typing import ClassVar from typing import Generic from typing import Literal from typing import TypeVar from typing import cast from typing import get_args import weakref from xml.etree import ElementTree as ET import numpy as np import pyvista as pv from pyvista import _vtk from pyvista._deprecate_positional_args import _deprecate_positional_args from pyvista._warn_external import warn_external from pyvista.core._vtk_utilities import VersionInfo from pyvista.core.errors import InvalidMeshWarning from ._frd import _FRDParser from .fileio import _FileIOBase from .fileio import _get_ext_force from .fileio import _lazy_vtk_import from .fileio import _process_filename from .helpers import wrap from .misc import _NoNewAttrMixin from .misc import abstract_class if TYPE_CHECKING: from collections.abc import Callable # These are referenced as string forward references in ``BaseReader`` # generic parameterization on subclasses (e.g. ``BaseReader['PolyData']``) # and in the ``_T_Output_co`` TypeVar bound. Static type checkers # (mypy, pyright) resolve those strings against this module's namespace, # so the imports are required at type-check time even though Ruff # cannot see the reference inside a string literal. from pyvista import DataObject from pyvista import DataSet # noqa: F401 from pyvista import ImageData # noqa: F401 from pyvista import MultiBlock # noqa: F401 from pyvista import PartitionedDataSet # noqa: F401 from pyvista import PolyData # noqa: F401 from pyvista import RectilinearGrid # noqa: F401 from pyvista import StructuredGrid # noqa: F401 from pyvista import UnstructuredGrid # noqa: F401 from ._frd import _FRDData HDF_HELP = 'https://docs.vtk.org/en/latest/vtk_file_formats/index.html#vtkhdf' CLASS_READERS: dict[str, type[BaseReader[Any]]] = {} # Covariant TypeVar for :class:`BaseReader`'s output type. Covariant is # correct because ``BaseReader`` only *produces* values of ``T_Output`` # (via :meth:`BaseReader.read`); it never accepts them as input. _T_Output_co = TypeVar('_T_Output_co', bound='DataObject', covariant=True) _mesh_types = Literal[ 'UnstructuredGrid', 'ImageData', 'PolyData', 'MultiBlock', 'RectilinearGrid', 'StructuredGrid', 'PointSet', 'PartitionedDataSet', ] _legacy_dataset_types = Literal[ # no PointSet 'UnstructuredGrid', 'ImageData', 'PolyData', 'RectilinearGrid', 'StructuredGrid', ] def get_reader(filename, force_ext=None): """Get a reader for fine-grained control of reading data files. Supported file types and Readers: .. include:: /api/readers/readers_table.rst Parameters ---------- filename : str, Path The string path to the file to read. force_ext : str, optional An extension to force a specific reader to be chosen. Returns ------- pyvista.BaseReader A subclass of :class:`pyvista.BaseReader` is returned based on file type. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_human(load=False) >>> Path(filename).name 'Human.vtp' >>> reader = pv.get_reader(filename) >>> reader XMLPolyDataReader('...Human.vtp') >>> mesh = reader.read() >>> mesh PolyData ... >>> mesh.plot(color='lightblue') """ ext = _get_ext_force(filename, force_ext) try: Reader = CLASS_READERS[ext] except KeyError: if Path(filename).is_dir(): if len(files := os.listdir(filename)) > 0 and all( # noqa: PTH208 Path(f).suffix == '.dcm' for f in files ): Reader = DICOMReader else: msg = ( f'`pyvista.get_reader` does not support reading from directory:\n\t{filename}' ) raise ValueError(msg) else: msg = f'`pyvista.get_reader` does not support a file with the {ext} extension' raise ValueError(msg) return Reader(filename) class BaseVTKReader(ABC): """Simulate a VTK reader.""" def __init__(self: BaseVTKReader) -> None: self._data_object: pv.DataObject | None = None self._observers: list[int | Callable[[Any], Any]] = [] def SetFileName(self, filename) -> None: """Set file name.""" self._filename = filename @abstractmethod def UpdateInformation(self): """Update Information from file.""" def AddObserver(self, event_type, callback) -> None: """Add Observer that can be triggered during Update.""" self._observers.append([event_type, callback]) # type: ignore[arg-type] def RemoveObservers(self, *args) -> None: # noqa: ARG002 """Remove Observer.""" self._observers = [] def GetProgress(self): """GetProgress.""" return 0.0 if self._data_object is None else 1.0 def UpdateObservers(self, event_type) -> None: """Call matching observer.""" for event_type_allowed, observer in self._observers: # type: ignore[misc] if event_type_allowed == event_type: observer(self, event_type) @abstractmethod def Update(self): """Update Reader from file and store data internally. Set self._data_object. """ def GetOutputDataObject(self, *args): # noqa: ARG002 """Return stored data.""" return self._data_object @abstract_class class BaseReader(_FileIOBase, Generic[_T_Output_co]): """The Base Reader class. The base functionality includes reading data from a file, and allowing access to the underlying vtk reader. See :func:`pyvista.get_reader` for an example using a built-in subclass. Subclasses parameterize ``BaseReader`` with the concrete :class:`~pyvista.DataObject` subclass they produce, e.g. :class:`XMLPolyDataReader` is declared as ``class XMLPolyDataReader(BaseReader[PolyData], ...)`` so :meth:`read` returns :class:`~pyvista.PolyData` under static analysis without each subclass needing its own ``read`` override. Parameters ---------- path : str, Path Path of the file to read. """ _class_reader: Any = None # Override on subclasses whose VTK reader can emit more than one # concrete :class:`~pyvista.DataObject` subclass. The ``BaseReader[X]`` # generic parameter on such a class is the narrowest common supertype # the VTK format allows (e.g. ``BaseReader['DataSet']``), so docs and # tests that need the exact list consult this attribute. _output_types: ClassVar[tuple[_mesh_types, ...] | None] = None def __init__(self, path) -> None: """Initialize Reader by setting path.""" if cls := self._vtk_class: self._reader = cls() else: # edge case where some class customization is needed on instantiation self._reader = self._class_reader() self._filename: str | None = None self._progress_bar = False self._progress_msg = None self.__directory = None self._set_defaults() self.path = str(path) self._set_defaults_post() def __repr__(self) -> str: """Representation of a Reader object.""" return f"{self.__class__.__name__}('{self.path}')" @classmethod def _get_extension_mappings(cls) -> list[dict[str, type]]: return [CLASS_READERS] def show_progress(self, msg=None) -> None: """Show a progress bar when loading the file. Parameters ---------- msg : str, optional Progress bar message. Defaults to ``"Reading "``. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.show_progress() """ self._progress_bar = True if msg is None: msg = f'Reading {Path(self.path).name}' self._progress_msg = msg def hide_progress(self) -> None: """Hide the progress bar when loading the file. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.hide_progress() """ self._progress_bar = False @property def reader(self): """Return the vtk Reader object. Returns ------- pyvista.BaseReader An instance of the Reader object. """ if self._reader is None: # pragma: no cover raise NotImplementedError return self._reader @property def path(self) -> str: """Return or set the filename or directory of the reader. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_human(load=False) >>> reader = pv.XMLPolyDataReader(filename) >>> reader.path # doctest:+SKIP '/home/user/.local/share/pyvista/examples/Human.vtp' """ if self._filename is not None: return self._filename return self.__directory # type: ignore[return-value] @path.setter def path(self, path: str | Path): if Path(path).is_dir(): self._set_directory(path) elif Path(path).is_file(): self._set_filename(path) else: msg = f"Path '{path}' is invalid or does not exist." raise FileNotFoundError(msg) def _set_directory(self, directory) -> None: """Set directory and update reader.""" self._filename = None self.__directory = directory self.reader.SetDirectoryName(directory) self._update_information() def _set_filename(self, filename) -> None: """Set filename and update reader.""" # Private method since changing file type requires a # different subclass. self.__directory = None self._filename = filename self.reader.SetFileName(filename) self._update_information() def read(self, *, validate: bool | None = None) -> _T_Output_co: # numpydoc ignore=RT01 """Read data in file. Parameters ---------- validate : bool, optional Forwarded to :func:`pyvista.wrap` as the ``validate`` keyword. When ``True``, perform a cheap array-length sanity check on the read dataset and emit a :class:`~pyvista.InvalidMeshWarning` on a mismatch. When ``False``, skip the check entirely. When ``None`` (the default), honor :attr:`pyvista.core.config.Config.validate_on_wrap`. .. versionadded:: 0.48 Returns ------- pyvista.DataObject PyVista dataset. The concrete subclass is determined by the specific ``*Reader`` used; for example, :class:`~pyvista.XMLUnstructuredGridReader` produces an :class:`~pyvista.UnstructuredGrid`. """ from pyvista.core.filters import _update_alg # avoid circular import # noqa: PLC0415 _update_alg(self.reader, progress_bar=self._progress_bar, message=self._progress_msg) data = wrap(self.reader.GetOutputDataObject(0), validate=validate) if data is None: # pragma: no cover msg = 'File reader failed to read and/or produced no output.' raise RuntimeError(msg) data._post_file_load_processing() # check for any pyvista metadata data._restore_metadata() return cast('_T_Output_co', data) def _update_information(self) -> None: self.reader.UpdateInformation() def _set_defaults(self) -> None: """Set defaults on reader, if needed.""" def _set_defaults_post(self) -> None: """Set defaults on reader post setting file, if needed.""" class PointCellDataSelection(_NoNewAttrMixin): """Mixin for readers that support data array selections. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_backward_facing_step(load=False) >>> Path(filename).name 'foam_case_0_0_0_0.case' >>> reader = pv.get_reader(filename) >>> reader EnSightReader('.../foam_case_0_0_0_0.case') >>> reader.cell_array_names ['v2', 'nut', 'k', 'nuTilda', 'p', 'omega', 'f', 'epsilon', 'U'] >>> reader.point_array_names [] >>> reader.all_cell_arrays_status # doctest: +NORMALIZE_WHITESPACE {'v2': True, 'nut': True, 'k': True, 'nuTilda': True, 'p': True, 'omega': True, 'f': True, 'epsilon': True, 'U': True} >>> reader.disable_all_cell_arrays() >>> reader.enable_cell_array('U') >>> mesh = reader.read() # MultiBlock mesh >>> mesh[0].array_names ['U'] """ @property def number_point_arrays(self): """Return the number of point arrays. Returns ------- int Number of point arrays. """ return self.reader.GetNumberOfPointArrays() # type: ignore[attr-defined] @property def point_array_names(self): """Return the list of all point array names. Returns ------- list[str] List of all point array names. """ return [self.reader.GetPointArrayName(i) for i in range(self.number_point_arrays)] # type: ignore[attr-defined] def enable_point_array(self, name) -> None: """Enable point array with name. Parameters ---------- name : str Point array name. """ self.reader.SetPointArrayStatus(name, 1) # type: ignore[attr-defined] def disable_point_array(self, name) -> None: """Disable point array with name. Parameters ---------- name : str Point array name. """ self.reader.SetPointArrayStatus(name, 0) # type: ignore[attr-defined] def point_array_status(self, name): """Get status of point array with name. Parameters ---------- name : str Point array name. Returns ------- bool Whether reading the cell array is enabled. """ return bool(self.reader.GetPointArrayStatus(name)) # type: ignore[attr-defined] def enable_all_point_arrays(self) -> None: """Enable all point arrays.""" for name in self.point_array_names: self.enable_point_array(name) def disable_all_point_arrays(self) -> None: """Disable all point arrays.""" for name in self.point_array_names: self.disable_point_array(name) @property def all_point_arrays_status(self): """Return the status of all point arrays. Returns ------- dict[str, bool] Status of all point arrays. """ return {name: self.point_array_status(name) for name in self.point_array_names} @property def number_cell_arrays(self): """Return the number of cell arrays. Returns ------- int Number of cell arrays. """ return self.reader.GetNumberOfCellArrays() # type: ignore[attr-defined] @property def cell_array_names(self): """Return the list of all cell array names. Returns ------- list[str] List of all cell array names. """ return [self.reader.GetCellArrayName(i) for i in range(self.number_cell_arrays)] # type: ignore[attr-defined] def enable_cell_array(self, name) -> None: """Enable cell array with name. Parameters ---------- name : str Cell array name. """ self.reader.SetCellArrayStatus(name, 1) # type: ignore[attr-defined] def disable_cell_array(self, name) -> None: """Disable cell array with name. Parameters ---------- name : str Cell array name. """ self.reader.SetCellArrayStatus(name, 0) # type: ignore[attr-defined] def cell_array_status(self, name): """Get status of cell array with name. Parameters ---------- name : str Cell array name. Returns ------- bool Whether reading the cell array is enabled. """ return bool(self.reader.GetCellArrayStatus(name)) # type: ignore[attr-defined] def enable_all_cell_arrays(self) -> None: """Enable all cell arrays.""" for name in self.cell_array_names: self.enable_cell_array(name) def disable_all_cell_arrays(self) -> None: """Disable all cell arrays.""" for name in self.cell_array_names: self.disable_cell_array(name) @property def all_cell_arrays_status(self): """Return the status of all cell arrays. Returns ------- dict[str, bool] Name and if the cell array is available. """ return {name: self.cell_array_status(name) for name in self.cell_array_names} class TimeReader(ABC): """Abstract class for readers supporting time.""" @property @abstractmethod def number_time_points(self): """Return number of time points or iterations available to read. Returns ------- int """ @abstractmethod def time_point_value(self, time_point): """Value of time point or iteration by index. Parameters ---------- time_point : int Time point index. Returns ------- float """ @property def time_values(self): """All time or iteration values. Returns ------- list[float] """ return [self.time_point_value(idx) for idx in range(self.number_time_points)] @property @abstractmethod def active_time_value(self): """Active time or iteration value. Returns ------- float """ @abstractmethod def set_active_time_value(self, time_value): """Set active time or iteration value. Parameters ---------- time_value : float Time or iteration value to set as active. """ @abstractmethod def set_active_time_point(self, time_point): """Set active time or iteration by index. Parameters ---------- time_point : int Time or iteration point index for setting active time. """ class XMLImageDataReader(BaseReader['ImageData'], PointCellDataSelection): """XML Image Data Reader for .vti files. Wraps :vtk:`vtkXMLImageDataReader`. """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLImageDataReader' class XMLPImageDataReader(BaseReader['ImageData'], PointCellDataSelection): """Parallel XML Image Data Reader for .pvti files. Wraps :vtk:`vtkXMLPImageDataReader`. """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLPImageDataReader' class XMLRectilinearGridReader(BaseReader['RectilinearGrid'], PointCellDataSelection): """XML RectilinearGrid Reader for .vtr files. Wraps :vtk:`vtkXMLRectilinearGridReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_rectilinear_grid(load=False) >>> Path(filename).name 'RectilinearGrid.vtr' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> sliced_mesh = mesh.slice('y') >>> sliced_mesh.plot( ... scalars='Void Volume Fraction', ... cpos='xz', ... show_scalar_bar=False, ... ) """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLRectilinearGridReader' class XMLPRectilinearGridReader(BaseReader['RectilinearGrid'], PointCellDataSelection): """Parallel XML RectilinearGrid Reader for .pvtr files. Wraps :vtk:`vtkXMLPRectilinearGridReader`. """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLPRectilinearGridReader' class XMLUnstructuredGridReader(BaseReader['UnstructuredGrid'], PointCellDataSelection): """XML UnstructuredGrid Reader for .vtu files. Wraps :vtk:`vtkXMLUnstructuredGridReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_notch_displacement(load=False) >>> Path(filename).name 'notch_disp.vtu' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot( ... scalars='Nodal Displacement', ... component=0, ... cpos='xy', ... show_scalar_bar=False, ... ) """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLUnstructuredGridReader' class XMLPUnstructuredGridReader(BaseReader['UnstructuredGrid'], PointCellDataSelection): """Parallel XML UnstructuredGrid Reader for .pvtu files. Wraps :vtk:`vtkXMLPUnstructuredGridReader`. """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLPUnstructuredGridReader' class XMLPolyDataReader(BaseReader['PolyData'], PointCellDataSelection): """XML PolyData Reader for .vtp files. Wraps :vtk:`vtkXMLPolyDataReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_cow_head(load=False) >>> Path(filename).name 'cowHead.vtp' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> cpos = pv.CameraPosition( ... position=(12, 3.5, -4.5), focal_point=(4.5, 1.6, 0), viewup=(0, 1, 0.3) ... ) >>> mesh.plot( ... cpos=cpos, ... clim=[0, 100], ... show_scalar_bar=False, ... ) """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLPolyDataReader' class XMLStructuredGridReader(BaseReader['StructuredGrid'], PointCellDataSelection): """XML StructuredGrid Reader for .vts files. Wraps :vtk:`vtkXMLStructuredGridReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_structured_grid(load=False) >>> Path(filename).name 'StructuredGrid.vts' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(style='wireframe', line_width=4, show_scalar_bar=False) """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLStructuredGridReader' class XMLMultiBlockDataReader(BaseReader['MultiBlock'], PointCellDataSelection): """XML MultiBlock Data Reader for .vtm or .vtmb files. Wraps :vtk:`vtkXMLMultiBlockDataReader`. """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLMultiBlockDataReader' class EnSightReader(BaseReader['MultiBlock'], PointCellDataSelection, TimeReader): """EnSight Reader for .case files. Wraps :vtk:`vtkGenericEnSightReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_cylinder_crossflow(load=False) >>> Path(filename).name 'cylinder_Re35.case' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot( ... scalars='velocity', ... component=1, ... clim=[-20, 20], ... cpos='xy', ... cmap='RdBu', ... show_scalar_bar=False, ... ) """ _vtk_module_name = 'vtkIOEnSight' _vtk_class_name = 'vtkGenericEnSightReader' def _set_filename(self, filename) -> None: """Set filename and update reader.""" # Private method since changing file type requires a # different subclass. self._filename = filename self.reader.SetCaseFileName(filename) self._update_information() self._active_time_set = 0 @property def number_time_points(self): # noqa: D102 item = self.reader.GetTimeSets().GetItem(self.active_time_set) if item is None: return 0 return ( item.GetSize() if pv.vtk_version_info < (9, 6, 99) # < (9, 7, 0) else item.GetCapacity() ) def time_point_value(self, time_point): # noqa: D102 return self.reader.GetTimeSets().GetItem(self.active_time_set).GetValue(time_point) @property def active_time_value(self): # noqa: D102 return self.reader.GetTimeValue() def set_active_time_value(self, time_value): # noqa: D102 if time_value not in self.time_values: msg = f'Not a valid time {time_value} from available time values: {self.time_values}' raise ValueError(msg) self.reader.SetTimeValue(time_value) def set_active_time_point(self, time_point) -> None: # noqa: D102 self.reader.SetTimeValue(self.time_point_value(time_point)) @property def active_time_set(self) -> int: """Return the index of the active time set of the reader. Returns ------- int Index of the active time set. """ return self._active_time_set def set_active_time_set(self, time_set): """Set the active time set by index. Parameters ---------- time_set : int Index of the desired time set. Raises ------ IndexError If the desired time set does not exist. """ number_time_sets = self.reader.GetTimeSets().GetNumberOfItems() if time_set in range(number_time_sets): self._active_time_set = time_set else: msg = f'Time set index {time_set} not in {range(number_time_sets)}' raise IndexError(msg) class OpenFOAMReader(BaseReader['MultiBlock'], PointCellDataSelection, TimeReader): """OpenFOAM Reader for .foam files. By default, pyvista enables all patch arrays. This is a deviation from the vtk default. Wraps :vtk:`vtkOpenFOAMReader`. """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkOpenFOAMReader' def _set_defaults_post(self) -> None: self.enable_all_patch_arrays() @property def number_time_points(self): # noqa: D102 return self.reader.GetTimeValues().GetNumberOfValues() def time_point_value(self, time_point): # noqa: D102 return self.reader.GetTimeValues().GetValue(time_point) @property def active_time_value(self): # noqa: D102 try: value = self.reader.GetTimeValue() except AttributeError as err: # pragma: no cover msg = 'Inspecting active time value only supported for vtk versions >9.1.0' raise AttributeError(msg) from err return value def set_active_time_value(self, time_value): # noqa: D102 if time_value not in self.time_values: msg = f'Not a valid time {time_value} from available time values: {self.time_values}' raise ValueError(msg) self.reader.UpdateTimeStep(time_value) def set_active_time_point(self, time_point) -> None: # noqa: D102 self.reader.UpdateTimeStep(self.time_point_value(time_point)) @property def decompose_polyhedra(self): """Whether polyhedra are to be decomposed when read. .. warning:: Support for polyhedral decomposition has been deprecated deprecated in VTK 9.3 and has been removed prior to VTK 9.4 Returns ------- bool If ``True``, decompose polyhedra into tetrahedra and pyramids. """ return bool(self.reader.GetDecomposePolyhedra()) @decompose_polyhedra.setter def decompose_polyhedra(self, value) -> None: self.reader.SetDecomposePolyhedra(value) @property def skip_zero_time(self): """Indicate whether or not to ignore the '/0' time directory. Returns ------- bool If ``True``, ignore the '/0' time directory. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.skip_zero_time = False >>> reader.skip_zero_time False """ return bool(self.reader.GetSkipZeroTime()) @skip_zero_time.setter def skip_zero_time(self, value) -> None: self.reader.SetSkipZeroTime(value) self._update_information() self.reader.SetRefresh() @property def cell_to_point_creation(self): """Whether cell data is translated to point data when read. Returns ------- bool If ``True``, translate cell data to point data. Warnings -------- When ``True``, cell and point data arrays will have duplicate names. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.cell_to_point_creation = False >>> reader.cell_to_point_creation False """ return bool(self.reader.GetCreateCellToPoint()) @cell_to_point_creation.setter def cell_to_point_creation(self, value) -> None: self.reader.SetCreateCellToPoint(value) @property def number_patch_arrays(self): """Return number of patch arrays in dataset. Returns ------- int Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.number_patch_arrays 4 """ return self.reader.GetNumberOfPatchArrays() @property def patch_array_names(self): """Names of patch arrays in a list. Returns ------- list[str] Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.patch_array_names ['internalMesh', 'patch/movingWall', 'patch/fixedWalls', 'patch/frontAndBack'] """ return [self.reader.GetPatchArrayName(i) for i in range(self.number_patch_arrays)] def enable_patch_array(self, name) -> None: """Enable reading of patch array. Parameters ---------- name : str Which patch array to enable. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.enable_patch_array('patch/movingWall') >>> reader.patch_array_status('patch/movingWall') True """ self.reader.SetPatchArrayStatus(name, 1) def disable_patch_array(self, name) -> None: """Disable reading of patch array. Parameters ---------- name : str Which patch array to disable. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.disable_patch_array('internalMesh') >>> reader.patch_array_status('internalMesh') False """ self.reader.SetPatchArrayStatus(name, 0) def patch_array_status(self, name): """Return status of reading patch array. Parameters ---------- name : str Which patch array to report status. Returns ------- bool Whether the patch with the given name is to be read. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.enable_patch_array('patch/movingWall') >>> reader.patch_array_status('patch/movingWall') True """ return bool(self.reader.GetPatchArrayStatus(name)) def enable_all_patch_arrays(self) -> None: """Enable reading of all patch arrays. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.enable_all_patch_arrays() >>> assert reader.patch_array_status('patch/movingWall') >>> assert reader.patch_array_status('patch/fixedWalls') """ self.reader.EnableAllPatchArrays() def disable_all_patch_arrays(self) -> None: """Disable reading of all patch arrays. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.disable_all_patch_arrays() >>> assert not reader.patch_array_status('patch.movingWall') >>> assert not reader.patch_array_status('internalMesh') """ self.reader.DisableAllPatchArrays() @property def all_patch_arrays_status(self): """Status of reading all patch arrays. Returns ------- dict[str, bool] dict key is the patch name and the value is whether it will be read. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.OpenFOAMReader(filename) >>> reader.all_patch_arrays_status # doctest: +NORMALIZE_WHITESPACE {'internalMesh': True, 'patch/movingWall': True, 'patch/fixedWalls': True, 'patch/frontAndBack': True} """ return {name: self.patch_array_status(name) for name in self.patch_array_names} class POpenFOAMReader(OpenFOAMReader): """Parallel OpenFOAM Reader for .foam files. Wraps :vtk:`vtkPOpenFOAMReader`. Can read parallel-decomposed mesh information and time dependent data. This reader can be used for serial generated data, parallel reconstructed data, and decomposed data. """ _vtk_module_name = 'vtkIOParallel' _vtk_class_name = 'vtkPOpenFOAMReader' @property def case_type(self): """Indicate whether decomposed mesh or reconstructed mesh should be read. Returns ------- str If ``'reconstructed'``, reconstructed mesh should be read. If ``'decomposed'``, decomposed mesh should be read. Raises ------ ValueError If the value is not in ['reconstructed', 'decomposed'] Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cavity(load=False) >>> reader = pv.POpenFOAMReader(filename) >>> reader.case_type = 'reconstructed' >>> reader.case_type 'reconstructed' """ return 'reconstructed' if self.reader.GetCaseType() else 'decomposed' @case_type.setter def case_type(self, value): if value == 'reconstructed': self.reader.SetCaseType(1) elif value == 'decomposed': self.reader.SetCaseType(0) else: msg = f"Unknown case type '{value}'." raise ValueError(msg) self._update_information() class PLYReader(BaseReader['PolyData']): """PLY Reader for reading .ply files. Wraps :vtk:`vtkPLYReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_lobster(load=False) >>> Path(filename).name 'lobster.ply' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOPLY' _vtk_class_name = 'vtkPLYReader' class OBJReader(BaseReader['PolyData']): """OBJ Reader for reading .obj files. Wraps :vtk:`vtkOBJReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_trumpet(load=False) >>> Path(filename).name 'trumpet.obj' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(cpos='yz', show_scalar_bar=False) """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkOBJReader' class STLReader(BaseReader['PolyData']): """STL Reader for .stl files. Wraps :vtk:`vtkSTLReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_cad_model(load=False) >>> Path(filename).name '42400-IDGH.stl' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkSTLReader' class TecplotReader(BaseReader['MultiBlock']): """Tecplot Reader for ascii .dat files. Wraps :vtk:`vtkTecplotReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_tecplot_ascii(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh[0].plot() """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkTecplotReader' class VTKDataSetReader(BaseReader['DataSet']): """VTK Data Set Reader for .vtk files. Wraps :vtk:`vtkDataSetReader`. Notes ----- This reader calls ``ReadAllScalarsOn``, ``ReadAllColorScalarsOn``, ``ReadAllNormalsOn``, ``ReadAllTCoordsOn``, ``ReadAllVectorsOn``, and ``ReadAllFieldsOn`` on the underlying :vtk:`vtkDataSetReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_brain(load=False) >>> Path(filename).name 'brain.vtk' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> sliced_mesh = mesh.slice('x') >>> sliced_mesh.plot(cpos='yz', show_scalar_bar=False) """ _vtk_module_name = 'vtkIOLegacy' _vtk_class_name = 'vtkDataSetReader' _output_types = get_args(_legacy_dataset_types) def _set_defaults_post(self) -> None: self.reader.ReadAllScalarsOn() self.reader.ReadAllColorScalarsOn() self.reader.ReadAllNormalsOn() self.reader.ReadAllTCoordsOn() self.reader.ReadAllVectorsOn() self.reader.ReadAllFieldsOn() self.reader.ReadAllTensorsOn() class VTKPDataSetReader(BaseReader['DataSet']): """Parallel VTK Data Set Reader for .pvtk files. Wraps :vtk:`vtkPDataSetReader`. """ _vtk_module_name = 'vtkIOParallel' _vtk_class_name = 'vtkPDataSetReader' _output_types = get_args(_legacy_dataset_types) class BYUReader(BaseReader['PolyData']): """BYU Reader for .g files. Wraps :vtk:`vtkBYUReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_teapot(load=False) >>> Path(filename).name 'teapot.g' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(cpos='xy', show_scalar_bar=False) """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkBYUReader' class FacetReader(BaseReader['PolyData']): """Facet Reader for .facet files. Wraps :vtk:`vtkFacetReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_clown(load=False) >>> Path(filename).name 'clown.facet' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(color='red') """ _vtk_module_name = 'vtkFiltersHybrid' _vtk_class_name = 'vtkFacetReader' class Plot3DMetaReader(BaseReader['MultiBlock']): """Plot3DMeta Reader for .p3d files. Wraps :vtk:`vtkPlot3DMetaReader`. """ _vtk_module_name = 'vtkIOParallel' _vtk_class_name = 'vtkPlot3DMetaReader' class Plot3DFunctionEnum(enum.IntEnum): """An enumeration for the functions used in :class:`MultiBlockPlot3DReader`.""" DENSITY = 100 PRESSURE = 110 PRESSURE_COEFFICIENT = 111 MACH = 112 SPEED_OF_SOUND = 113 TEMPERATURE = 120 ENTHALPY = 130 INTERNAL_ENERGY = 140 KINETIC_ENERGY = 144 VELOCITY_MAGNITUDE = 153 STAGNATION_ENERGY = 163 ENTROPY = 170 SWIRL = 184 VELOCITY = 200 VORTICITY = 201 MOMENTUM = 202 PRESSURE_GRADIENT = 210 STRAIN_RATE = 212 VORTICITY_MAGNITUDE = 211 class MultiBlockPlot3DReader(BaseReader['MultiBlock']): """MultiBlock Plot3D Reader. Wraps :vtk:`vtkMultiBlockPLOT3DReader`. The methods :meth:`add_function()` and :meth:`remove_function()` accept values from :class:`Plot3DFunctionEnum`. For convenience, the values of that enumeration are available as class variables, as shown below. - ``MultiBlockPlot3DReader.DENSITY = Plot3DFunctionEnum.DENSITY`` - ``MultiBlockPlot3DReader.PRESSURE = Plot3DFunctionEnum.PRESSURE`` - ``MultiBlockPlot3DReader.PRESSURE_COEFFICIENT = Plot3DFunctionEnum.PRESSURE_COEFFICIENT`` - ``MultiBlockPlot3DReader.MACH = Plot3DFunctionEnum.MACH`` - ``MultiBlockPlot3DReader.SPEED_OF_SOUND = Plot3DFunctionEnum.SPEED_OF_SOUND`` - ``MultiBlockPlot3DReader.TEMPERATURE = Plot3DFunctionEnum.TEMPERATURE`` - ``MultiBlockPlot3DReader.ENTHALPY = Plot3DFunctionEnum.ENTHALPY`` - ``MultiBlockPlot3DReader.INTERNAL_ENERGY = Plot3DFunctionEnum.INTERNAL_ENERGY`` - ``MultiBlockPlot3DReader.KINETIC_ENERGY = Plot3DFunctionEnum.KINETIC_ENERGY`` - ``MultiBlockPlot3DReader.VELOCITY_MAGNITUDE = Plot3DFunctionEnum.VELOCITY_MAGNITUDE`` - ``MultiBlockPlot3DReader.STAGNATION_ENERGY = Plot3DFunctionEnum.STAGNATION_ENERGY`` - ``MultiBlockPlot3DReader.ENTROPY = Plot3DFunctionEnum.ENTROPY`` - ``MultiBlockPlot3DReader.SWIRL = Plot3DFunctionEnum.SWIRL`` - ``MultiBlockPlot3DReader.VELOCITY = Plot3DFunctionEnum.VELOCITY`` - ``MultiBlockPlot3DReader.VORTICITY = Plot3DFunctionEnum.VORTICITY`` - ``MultiBlockPlot3DReader.MOMENTUM = Plot3DFunctionEnum.MOMENTUM`` - ``MultiBlockPlot3DReader.PRESSURE_GRADIENT = Plot3DFunctionEnum.PRESSURE_GRADIENT`` - ``MultiBlockPlot3DReader.STRAIN_RATE = Plot3DFunctionEnum.STRAIN_RATE`` - ``MultiBlockPlot3DReader.VORTICITY_MAGNITUDE = Plot3DFunctionEnum.VORTICITY_MAGNITUDE`` """ _vtk_module_name = 'vtkIOParallel' _vtk_class_name = 'vtkMultiBlockPLOT3DReader' # pull in function name enum values as class constants DENSITY = Plot3DFunctionEnum.DENSITY PRESSURE = Plot3DFunctionEnum.PRESSURE PRESSURE_COEFFICIENT = Plot3DFunctionEnum.PRESSURE_COEFFICIENT MACH = Plot3DFunctionEnum.MACH SPEED_OF_SOUND = Plot3DFunctionEnum.SPEED_OF_SOUND TEMPERATURE = Plot3DFunctionEnum.TEMPERATURE ENTHALPY = Plot3DFunctionEnum.ENTHALPY INTERNAL_ENERGY = Plot3DFunctionEnum.INTERNAL_ENERGY KINETIC_ENERGY = Plot3DFunctionEnum.KINETIC_ENERGY VELOCITY_MAGNITUDE = Plot3DFunctionEnum.VELOCITY_MAGNITUDE STAGNATION_ENERGY = Plot3DFunctionEnum.STAGNATION_ENERGY ENTROPY = Plot3DFunctionEnum.ENTROPY SWIRL = Plot3DFunctionEnum.SWIRL VELOCITY = Plot3DFunctionEnum.VELOCITY VORTICITY = Plot3DFunctionEnum.VORTICITY MOMENTUM = Plot3DFunctionEnum.MOMENTUM PRESSURE_GRADIENT = Plot3DFunctionEnum.PRESSURE_GRADIENT STRAIN_RATE = Plot3DFunctionEnum.STRAIN_RATE VORTICITY_MAGNITUDE = Plot3DFunctionEnum.VORTICITY_MAGNITUDE def _set_defaults(self) -> None: self.auto_detect_format = True def add_q_files(self, files) -> None: """Add q file(s). Parameters ---------- files : str | sequence[str] Solution file or files to add. """ # files may be a list or a single filename if files and isinstance(files, (str, Path)): files = [files] files = [_process_filename(f) for f in files] # AddFileName supports reading multiple q files for q_filename in files: self.reader.AddFileName(q_filename) @property def auto_detect_format(self): """Whether to try to automatically detect format such as byte order, etc.""" return bool(self.reader.GetAutoDetectFormat()) @auto_detect_format.setter def auto_detect_format(self, value) -> None: self.reader.SetAutoDetectFormat(value) def add_function(self, value: int | Plot3DFunctionEnum) -> None: """Specify additional functions to compute. The available functions are enumerated in :class:`Plot3DFunctionEnum`. The members of this enumeration are most easily accessed by their aliases as class variables. Multiple functions may be requested by calling this method multiple times. Parameters ---------- value : int | Plot3DFunctionEnum The function to add. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_file('multi-bin.xyz') >>> reader = pv.reader.MultiBlockPlot3DReader(filename) >>> reader.add_function(112) # add a function by its integer value >>> reader.add_function( ... reader.PRESSURE_COEFFICIENT ... ) # add a function by enumeration via class variable alias """ if isinstance(value, enum.Enum): value = value.value self.reader.AddFunction(value) def remove_function(self, value: int | Plot3DFunctionEnum) -> None: """Remove one function from list of functions to compute. For details on the types of accepted values, see :meth:``add_function``. Parameters ---------- value : int | Plot3DFunctionEnum The function to remove. """ if isinstance(value, enum.Enum): value = value.value self.reader.RemoveFunction(value) def remove_all_functions(self) -> None: """Remove all functions from list of functions to compute.""" self.reader.RemoveAllFunctions() @property def preserve_intermediate_functions(self): """When ``True`` (default), intermediate computed quantities will be preserved. For example, if ``VelocityMagnitude`` is enabled, but not ``Velocity``, the reader still needs to compute ``Velocity``. If `preserve_intermediate_functions` is ``False``, then the output will not have ``Velocity`` array, only the requested ``VelocityMagnitude``. This is useful to avoid using up memory for arrays that are not relevant for the analysis. """ return self.reader.GetPreserveIntermediateFunctions() @preserve_intermediate_functions.setter def preserve_intermediate_functions(self, val) -> None: self.reader.SetPreserveIntermediateFunctions(val) @property def gamma(self): """Ratio of specific heats.""" return self.reader.GetGamma() @gamma.setter def gamma(self, val) -> None: self.reader.SetGamma(val) @property def r_gas_constant(self): """Gas constant.""" return self.reader.GetR() @r_gas_constant.setter def r_gas_constant(self, val) -> None: self.reader.SetR(val) class CGNSReader(BaseReader['MultiBlock'], PointCellDataSelection): """CGNS Reader for .cgns files. Creates a multi-block dataset and reads unstructured grids and structured meshes from binary files stored in CGNS file format, with data stored at the nodes, cells or faces. By default, all point and cell arrays are loaded as well as the boundary patch. This varies from VTK's defaults. For more details, see :vtk:`vtkCGNSReader`. Examples -------- Load a CGNS file. All arrays are loaded by default. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.load_boundary_patch = False >>> ds = reader.read() >>> ds[0][0].cell_data pyvista DataSetAttributes Association : CELL Active Scalars : None Active Vectors : Momentum Active Texture : None Active Normals : None Contains arrays : Density float64 (2928,) Momentum float64 (2928, 3) VECTORS EnergyStagnationDensity float64 (2928,) ViscosityEddy float64 (2928,) TurbulentDistance float64 (2928,) TurbulentSANuTilde float64 (2928,) """ _vtk_module_name = 'vtkIOCGNSReader' _vtk_class_name = 'vtkCGNSReader' def _set_defaults_post(self) -> None: self.enable_all_point_arrays() self.enable_all_cell_arrays() self.load_boundary_patch = True @property def distribute_blocks(self) -> bool: """Distribute each block in each zone across ranks. To make the reader disregard the piece request and read all blocks in the zone, set this to ``False``. The default is ``True``. Returns ------- bool If ``True``, distribute each block in each zone across ranks. Examples -------- Disable distributing blocks. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.distribute_blocks = False >>> reader.distribute_blocks False """ return bool(self._reader.GetDistributeBlocks()) @distribute_blocks.setter def distribute_blocks(self, value: str) -> None: self._reader.SetDistributeBlocks(value) def base_array_status(self, name: str) -> bool: """Get status of base array with name. Parameters ---------- name : str Base array name. Returns ------- bool Whether reading the base array is enabled. """ return bool(self.reader.GetBaseArrayStatus(name)) @property def base_array_names(self): """Return the list of all base array names. Returns ------- list[int] """ return [self.reader.GetBaseArrayName(i) for i in range(self.number_base_arrays)] @property def number_base_arrays(self) -> int: """Return the number of base arrays. Returns ------- int """ return self.reader.GetNumberOfBaseArrays() def enable_all_bases(self) -> None: """Enable reading all bases. By default only the 0th base is read. Examples -------- Read all bases. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.enable_all_bases() """ self._reader.EnableAllBases() def disable_all_bases(self) -> None: """Disable reading all bases. By default only the 0th base is read. Examples -------- Disable reading all bases. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.disable_all_bases() """ self._reader.DisableAllBases() def family_array_status(self, name) -> bool: """Get status of family array with name. Parameters ---------- name : str Family array name. Returns ------- bool Whether reading the family array is enabled. """ return bool(self.reader.GetFamilyArrayStatus(name)) @property def family_array_names(self) -> list[str]: """Return the list of all family array names. Returns ------- list[str] """ return [self.reader.GetFamilyArrayName(i) for i in range(self.number_family_arrays)] @property def number_family_arrays(self) -> int: """Return the number of face arrays. Returns ------- int """ return self.reader.GetNumberOfFamilyArrays() def enable_all_families(self) -> None: """Enable reading all families. By default only the 0th family is read. Examples -------- Read all bases. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.enable_all_families() """ self._reader.EnableAllFamilies() def disable_all_families(self) -> None: """Disable reading all families. Examples -------- Disable reading all bases. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.disable_all_families() """ self._reader.DisableAllFamilies() @property def unsteady_pattern(self) -> bool: """Return or set using an unsteady pattern. When set to ``True`` (default is ``False``), the reader will try to determine FlowSolution_t nodes to read with a pattern matching This can be useful for unsteady solutions when FlowSolutionPointers are not reliable. Examples -------- Set reading the unsteady pattern to ``True``. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.unsteady_pattern = True >>> reader.unsteady_pattern True """ return self._reader.GetUseUnsteadyPattern() @unsteady_pattern.setter def unsteady_pattern(self, enabled: bool) -> None: self._reader.SetUseUnsteadyPattern(bool(enabled)) @property def vector_3d(self) -> bool: """Return or set adding an empty dimension to vectors in case of 2D solutions. Examples -------- Set adding an empty physical dimension to vectors to ``True``. >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.vector_3d = True >>> reader.vector_3d True """ return self._reader.GetUse3DVector() @vector_3d.setter def vector_3d(self, enabled: bool) -> None: self._reader.SetUse3DVector(bool(enabled)) @property def load_boundary_patch(self) -> bool: """Return or set loading boundary patches. Notes ----- VTK default is ``False``, but PyVista uses ``True``. Examples -------- Enable loading boundary patches . >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_cgns_multi(load=False) >>> reader = pv.CGNSReader(filename) >>> reader.load_boundary_patch = True >>> reader.load_boundary_patch True """ return self._reader.GetLoadBndPatch() @load_boundary_patch.setter def load_boundary_patch(self, enabled: bool) -> None: self._reader.SetLoadBndPatch(bool(enabled)) class BinaryMarchingCubesReader(BaseReader['PolyData']): """BinaryMarchingCubes Reader for .tri files. Wraps :vtk:`vtkMCubesReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_pine_roots(load=False) >>> Path(filename).name 'pine_root.tri' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(color='brown') """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkMCubesReader' @dataclass(order=True) class PVDDataSet(_NoNewAttrMixin): """Class for storing dataset info from PVD file.""" time: float part: int path: str group: str class _PVDReader(BaseVTKReader): """Simulate a VTK reader for PVD files.""" def __init__(self) -> None: super().__init__() self._directory: str | None = None self._datasets: list[PVDDataSet] | None = None self._active_datasets: list[PVDDataSet] | None = None self._time_values: list[float] | None = None def SetFileName(self, filename) -> None: """Set filename and update reader.""" self._filename = str(filename) self._directory = str(Path(filename).parent) def UpdateInformation(self): """Parse PVD file.""" if self._filename is None: msg = 'Filename must be set' raise ValueError(msg) tree = ET.parse(self._filename) root = tree.getroot() dataset_elements = root[0].findall('DataSet') datasets: list[PVDDataSet] = [] for element in dataset_elements: element_attrib = element.attrib datasets.append( PVDDataSet( float(element_attrib.get('timestep', 0)), int(element_attrib.get('part', 0)), element_attrib['file'], element_attrib.get('group'), # type: ignore[arg-type] ), ) self._datasets = sorted(datasets) self._time_values = sorted({dataset.time for dataset in self._datasets}) self._time_mapping: dict[float, list[PVDDataSet]] = { time: [] for time in self._time_values } for dataset in self._datasets: self._time_mapping[dataset.time].append(dataset) self._SetActiveTime(self._time_values[0]) def Update(self) -> None: """Read data and store it.""" self._data_object = pv.MultiBlock([reader.read() for reader in self._active_readers]) def _SetActiveTime(self, time_value) -> None: """Set active time.""" self._active_datasets = self._time_mapping[time_value] self._active_readers = [ get_reader(Path(self._directory) / dataset.path) # type: ignore[arg-type] for dataset in self._active_datasets ] class PVDReader(BaseReader['MultiBlock'], TimeReader): """PVD Reader for .pvd files. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_wavy(load=False) >>> Path(filename).name 'wavy.pvd' >>> reader = pv.get_reader(filename) >>> reader.time_values [0.0, 1.0, 2.0, 3.0, ... 12.0, 13.0, 14.0] >>> reader.set_active_time_point(5) >>> reader.active_time_value 5.0 >>> mesh = reader.read()[0] # MultiBlock mesh with only 1 block >>> mesh.plot(scalars='z') """ _class_reader = _PVDReader @property def active_readers(self): """Return the active readers. Returns ------- list[pyvista.BaseReader] """ return self.reader._active_readers @property def datasets(self): """Return all datasets. Returns ------- list[pyvista.PVDDataSet] """ return self.reader._datasets @property def active_datasets(self): """Return all active datasets. Returns ------- list[pyvista.PVDDataSet] """ return self.reader._active_datasets @property def time_values(self): # noqa: D102 return self.reader._time_values @property def number_time_points(self): # noqa: D102 return len(self.reader._time_values) def time_point_value(self, time_point): # noqa: D102 return self.reader._time_values[time_point] @property def active_time_value(self): # noqa: D102 # all active datasets have the same time return self.reader._active_datasets[0].time def set_active_time_value(self, time_value) -> None: # noqa: D102 self.reader._SetActiveTime(time_value) def set_active_time_point(self, time_point) -> None: # noqa: D102 self.set_active_time_value(self.time_values[time_point]) class Nek5000Reader(BaseReader['UnstructuredGrid'], PointCellDataSelection, TimeReader): """Class for reading .nek5000 files produced by Nek5000 and NekRS. Wraps :vtk:`vtkNek5000Reader`. .. versionadded:: 0.45.0 .. note:: This reader requires vtk version >=9.3.0. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_nek5000(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(scalars='Velocity', cpos='xy') """ _vtk_module_name = 'vtkIOParallel' _vtk_class_name = 'vtkNek5000Reader' def __init__(self, path): # nek5000 reader requires vtk >= 9.3 if pv.vtk_version_info < (9, 3): msg = 'Nek5000Reader is only available for vtk>=9.3' raise pv.VTKVersionError(msg) super().__init__(path) def _set_defaults_post(self) -> None: self.set_active_time_point(0) def enable_merge_points(self): """Enable merging coincident GLL points from different spectral elements on read.""" self.reader.CleanGridOn() def disable_merge_points(self): """Disable merging coincident GLL points from different spectral elements on read.""" self.reader.CleanGridOff() def enable_spectral_element_ids(self): """Enable spectral element IDs to be shown as cell data.""" self.reader.SpectralElementIdsOn() def disable_spectral_element_ids(self): """Disable spectral element IDs to be shown as cell data.""" self.reader.SpectralElementIdsOff() @property def number_time_points(self): """Return number of time points or iterations available to read. Returns ------- int """ return self.reader.GetNumberOfTimeSteps() @property def time_values(self): """All time or iteration values. Returns ------- list[float] """ vtkStreaming = _lazy_vtk_import( 'vtkCommonExecutionModel', 'vtkStreamingDemandDrivenPipeline' )() key = vtkStreaming.TIME_STEPS() vtkinfo = self.reader.GetOutputInformation(0) return [vtkinfo.Get(key, i) for i in range(self.number_time_points)] def time_point_value(self, time_point): """Value of time point or iteration by index. Parameters ---------- time_point : int Time point index. Returns ------- float """ return self.time_values[time_point] @property def active_time_value(self): """Active time or iteration value. Returns ------- float """ vtkStreaming = _lazy_vtk_import( 'vtkCommonExecutionModel', 'vtkStreamingDemandDrivenPipeline' )() key = vtkStreaming.UPDATE_TIME_STEP() vtkinfo = self.reader.GetOutputInformation(0) return vtkinfo.Get(key) @property def active_time_point(self): """Active time point. Returns ------- int """ return self.time_values.index(self.active_time_value) def set_active_time_value(self, time_value): """Set active time or iteration value. Parameters ---------- time_value : float Time or iteration value to set as active. """ vtkStreaming = _lazy_vtk_import( 'vtkCommonExecutionModel', 'vtkStreamingDemandDrivenPipeline' )() key = vtkStreaming.UPDATE_TIME_STEP() vtkinfo = self.reader.GetOutputInformation(0) vtkinfo.Set(key, time_value) def set_active_time_point(self, time_point): """Set active time or iteration by index. Parameters ---------- time_point : int Time or iteration point index for setting active time. """ if time_point < 0 or time_point >= self.number_time_points: msg = f'Time point ({time_point}) out of range [0, {self.number_time_points - 1}]' raise ValueError(msg) self.set_active_time_value(self.time_values[time_point]) _cell_attr_err_msg = 'Nek5000 data does not contain cell arrays, this method cannot be used' @property def number_cell_arrays(self): # noqa: D102 raise AttributeError(self._cell_attr_err_msg) @property def cell_array_names(self): # noqa: D102 raise AttributeError(self._cell_attr_err_msg) def enable_cell_array(self, name) -> None: # noqa: ARG002, D102 raise AttributeError(self._cell_attr_err_msg) def disable_cell_array(self, name) -> None: # noqa: ARG002, D102 raise AttributeError(self._cell_attr_err_msg) def cell_array_status(self, name): # noqa: ARG002, D102 raise AttributeError(self._cell_attr_err_msg) def enable_all_cell_arrays(self) -> None: # noqa: D102 raise AttributeError(self._cell_attr_err_msg) def disable_all_cell_arrays(self) -> None: # noqa: D102 raise AttributeError(self._cell_attr_err_msg) class DICOMReader(BaseReader['ImageData']): """DICOM Reader for reading ``.dcm`` files. Wraps :vtk:`vtkDICOMImageReader`. This reader reads a single file or a path containing a several ``.dcm`` files (DICOM stack). Parameters ---------- path : str Path to the single DICOM (``.dcm``) file to be opened or the directory containing a stack of DICOM files. Examples -------- Read a DICOM stack. >>> import pyvista as pv >>> from pyvista import examples >>> path = examples.download_dicom_stack(load=False) >>> reader = pv.DICOMReader(path) >>> dataset = reader.read() >>> dataset.plot(volume=True, zoom=3, show_scalar_bar=False) .. note:: The example dataset is the CPTAC-SAR collection from The Cancer Imaging Archive, distributed under CC BY 3.0 and subject to the TCIA Data Usage Policy. See :func:`~pyvista.examples.downloads.download_dicom_stack` for the required attribution and usage terms. """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkDICOMImageReader' class BMPReader(BaseReader['ImageData']): """BMP Reader for .bmp files. Wraps :vtk:`vtkBMPReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_masonry_texture(load=False) >>> Path(filename).name 'masonry.bmp' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkBMPReader' class DEMReader(BaseReader['ImageData']): """DEM Reader for .dem files. Wraps :vtk:`vtkDEMReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_st_helens(load=False) >>> Path(filename).name 'SainteHelens.dem' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkDEMReader' class JPEGReader(BaseReader['ImageData']): """JPEG Reader for .jpeg and .jpg files. Wraps :vtk:`vtkJPEGReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_bird(load=False) >>> Path(filename).name 'Pileated.jpg' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkJPEGReader' class MetaImageReader(BaseReader['ImageData']): """Meta Image Reader for .mha and .mhd files. Wraps :vtk:`vtkMetaImageReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_chest(load=False) >>> Path(filename).name 'ChestCT-SHORT.mha' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkMetaImageReader' class NIFTIReader(BaseReader['ImageData']): """NIFTI Reader for .nii and .nii.gz files. Wraps :vtk:`vtkNIFTIImageReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_brain_atlas_with_sides(load=False) >>> Path(filename).name 'avg152T1_RL_nifti.nii.gz' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkNIFTIImageReader' class NRRDReader(BaseReader['ImageData']): """NRRDReader for .nrrd and .nhdr files. Wraps :vtk:`vtkNrrdReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_beach(load=False) >>> Path(filename).name 'beach.nrrd' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkNrrdReader' class PNGReader(BaseReader['ImageData']): """PNGReader for .png files. Wraps :vtk:`vtkPNGReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_vtk_logo(load=False) >>> Path(filename).name 'vtk.png' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkPNGReader' class PNMReader(BaseReader['ImageData']): """PNMReader for .pnm files. Wraps :vtk:`vtkPNMReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_gourds_pnm(load=False) >>> Path(filename).name 'Gourds.pnm' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkPNMReader' class SLCReader(BaseReader['ImageData']): """SLCReader for .slc files. Wraps :vtk:`vtkSLCReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_knee_full(load=False) >>> Path(filename).name 'vw_knee.slc' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkSLCReader' class TIFFReader(BaseReader['ImageData']): """TIFFReader for .tif and .tiff files. Wraps :vtk:`vtkTIFFReader`. Examples -------- .. pyvista-plot:: :force_static: >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_crater_imagery(load=False) >>> Path(filename).name 'BJ34_GeoTifv1-04_crater_clip.tif' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkTIFFReader' def _set_defaults_post(self) -> None: """Set defaults on reader post setting file, if needed.""" # Fix bug with default TIFF orientation https://gitlab.kitware.com/vtk/vtk/-/issues/19587 ORIENTATION_BOTLEFT = 4 self.reader.SetOrientationType(ORIENTATION_BOTLEFT) class HDRReader(BaseReader['ImageData']): """HDRReader for .hdr files. Wraps :vtk:`vtkHDRReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_parched_canal_4k(load=False) >>> Path(filename).name 'parched_canal_4k.hdr' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh ImageData (...) N Cells: 8382465 N Points: 8388608 X Bounds: 0.000e+00, 4.095e+03 Y Bounds: 0.000e+00, 2.047e+03 Z Bounds: 0.000e+00, 0.000e+00 Dimensions: 4096, 2048, 1 Spacing: 1.000e+00, 1.000e+00, 1.000e+00 N Arrays: 1 """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkHDRReader' class PTSReader(BaseReader['PolyData']): """PTSReader for .pts files. Wraps :vtk:`vtkPTSReader`. """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkPTSReader' class AVSucdReader(BaseReader['UnstructuredGrid']): """AVSucdReader for .inp files. Wraps :vtk:`vtkAVSucdReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_cells_nd(load=False) >>> Path(filename).name 'cellsnd.ascii.inp' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(cpos='xy') """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkAVSucdReader' class HDFReader(BaseReader['DataObject']): """HDFReader for .hdf files. Wraps :vtk:`vtkHDFReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_can_crushed_hdf(load=False) >>> Path(filename).name 'can-vtu.hdf' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOHDF' _vtk_class_name = 'vtkHDFReader' _output_types = ( 'ImageData', 'PolyData', 'UnstructuredGrid', 'PartitionedDataSet', 'MultiBlock', ) class GLTFReader(BaseReader['MultiBlock']): """GLTFeader for .gltf and .glb files. Wraps :vtk:`vtkGLTFReader`. """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkGLTFReader' class FluentReader(BaseReader['UnstructuredGrid']): """FluentReader for .cas files. Wraps :vtk:`vtkFLUENTReader`. """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkFLUENTReader' class MFIXReader(BaseReader['UnstructuredGrid']): """MFIXReader for .res files. Wraps :vtk:`vtkMFIXReader`. """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkMFIXReader' class SegYReader(BaseReader['DataSet']): """SegYReader for .sgy and .segy files. Wraps :vtk:`vtkSegYReader`. """ _vtk_module_name = 'vtkIOSegY' _vtk_class_name = 'vtkSegYReader' _output_types = ('StructuredGrid', 'ImageData') class _GIFReader(BaseVTKReader): """Simulate a VTK reader for GIF files.""" def __init__(self) -> None: super().__init__() self._n_frames = 0 self._current_frame = 0 def UpdateInformation(self) -> None: """Update Information from file.""" def GetProgress(self): return self._current_frame / self._n_frames def Update(self) -> None: """Read the GIF and store internally to `_data_object`.""" from PIL import Image # noqa: PLC0415 from PIL import ImageSequence # noqa: PLC0415 from PIL import __version__ as pillow_version # noqa: PLC0415 PILLOW_VERSION_INFO = VersionInfo( major=int(pillow_version.split('.')[0]), minor=int(pillow_version.split('.')[1]), micro=int(pillow_version.split('.')[2]), ) img = Image.open(self._filename) self._data_object = pv.ImageData(dimensions=(img.size[0], img.size[1], 1)) # load each frame to the grid (RGB since gifs do not support transparency self._n_frames = img.n_frames # type: ignore[attr-defined] pillow_get_data = ( Image.Image.get_flattened_data if PILLOW_VERSION_INFO >= (12, 1) else Image.Image.getdata ) for i, frame in enumerate(ImageSequence.Iterator(img)): self._current_frame = i data = np.array(pillow_get_data(frame.convert('RGB')), dtype=np.uint8) self._data_object.point_data.set_array(data, f'frame{i}') self.UpdateObservers(6) if 'frame0' in self._data_object.point_data: self._data_object.point_data.active_scalars_name = 'frame0' img.close() class GIFReader(BaseReader['ImageData']): """GIFReader for .gif files. Parameters ---------- path : str Path of the GIF to read. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_gif_simple(load=False) >>> Path(filename).name 'sample.gif' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot(rgba=True, zoom='tight', border=True, border_width=2) """ _class_reader = _GIFReader class XdmfReader(BaseReader['DataObject'], PointCellDataSelection, TimeReader): """XdmfReader for .xdmf files. Wraps :vtk:`vtkXdmfReader`. Parameters ---------- path : str Path of the XDMF file to read. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_meshio_xdmf(load=False) >>> reader = pv.get_reader(filename) >>> Path(filename).name 'out.xdmf' >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOXdmf2' _vtk_class_name = 'vtkXdmfReader' _output_types = ('MultiBlock', 'UnstructuredGrid', 'StructuredGrid', 'RectilinearGrid') @property def number_grids(self): """Return the number of grids that can be read by the reader. Returns ------- int The number of grids to be read. """ return self.reader.GetNumberOfGrids() def set_active_time_value(self, time_value): # noqa: D102 if time_value not in self.time_values: msg = f'Not a valid time {time_value} from available time values: {self.time_values}' raise ValueError(msg) self._active_time_value = time_value self.reader.UpdateTimeStep(time_value) @property def number_time_points(self): # noqa: D102 return len(self.time_values) def time_point_value(self, time_point): # noqa: D102 return self.time_values[time_point] @property def time_values(self): # noqa: D102 info = self.reader.GetOutputInformation(0) return list(info.Get(_vtk.vtkCompositeDataPipeline.TIME_STEPS())) @property def active_time_value(self): # noqa: D102 return self._active_time_value def set_active_time_point(self, time_point) -> None: # noqa: D102 self.set_active_time_value(self.time_values[time_point]) def _set_defaults_post(self) -> None: self._active_time_value = self.time_values[0] self.set_active_time_value(self._active_time_value) class XMLPartitionedDataSetReader(BaseReader['PartitionedDataSet']): """XML PartitionedDataSet Reader for reading .vtpd files. Wraps :vtk:`vtkXMLPartitionedDataSetReader`. Examples -------- >>> import pyvista as pv >>> partitions = pv.PartitionedDataSet( ... [ ... pv.Wavelet(extent=(0, 10, 0, 10, 0, 5)), ... pv.Wavelet(extent=(0, 10, 0, 10, 5, 10)), ... ] ... ) >>> partitions.save('my_partitions.vtpd') >>> _ = pv.read('my_partitions.vtpd') """ _vtk_module_name = 'vtkIOXML' _vtk_class_name = 'vtkXMLPartitionedDataSetReader' class FLUENTCFFReader(BaseReader['MultiBlock']): """FLUENTCFFReader for .h5 files. Wraps :vtk:`vtkFLUENTCFFReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_room_cff(load=False) >>> reader = pv.get_reader(filename) >>> blocks = reader.read() >>> mesh = blocks[0] >>> mesh.plot(cpos='xy', scalars='SV_T') """ _vtk_module_name = 'vtkIOFLUENTCFF' _vtk_class_name = 'vtkFLUENTCFFReader' class GambitReader(BaseReader['UnstructuredGrid']): """GambitReader for .neu files. Wraps :vtk:`vtkGAMBITReader`. .. versionadded:: 0.44.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_prism(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkGAMBITReader' class GaussianCubeReader(BaseReader['DataSet']): """GaussianCubeReader for .cube files. Wraps :vtk:`vtkGaussianCubeReader`. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_m4_total_density(load=False) >>> Path(filename).name 'm4_TotalDensity.cube' """ _vtk_module_name = 'vtkIOChemistry' _vtk_class_name = 'vtkGaussianCubeReader' _output_types = ('ImageData', 'PolyData') @_deprecate_positional_args def read( self, grid: bool = True, # noqa: FBT001, FBT002 *, validate: bool | None = None, ) -> pv.DataSet: """Read the file and return the output. Parameters ---------- grid : bool, default: False Output as a grid if ``True``, otherwise return the polydata. validate : bool, optional Forwarded to :func:`pyvista.wrap`. See :meth:`BaseReader.read`. .. versionadded:: 0.48 Returns ------- pyvista.DataSet PyVista dataset read from the file. """ from pyvista.core.filters import _update_alg # avoid circular import # noqa: PLC0415 _update_alg(self.reader, progress_bar=self._progress_bar, message=self._progress_msg) data = ( wrap(self.reader.GetGridOutput(), validate=validate) if grid else wrap(self.reader.GetOutputDataObject(0), validate=validate) ) if data is None: # pragma: no cover msg = 'File reader failed to read and/or produced no output.' raise RuntimeError(msg) data._post_file_load_processing() # check for any pyvista metadata data._restore_metadata() return data @property def hb_scale(self) -> float: """Get the scaling factor to compute bonds with hydrogen atoms. Returns ------- float The scaling factor to compute bonds with hydrogen atoms. """ return self.reader.GetHBScale() @hb_scale.setter def hb_scale(self, hb_scale: float) -> None: """Set the scaling factor to compute bonds with hydrogen atoms. Parameters ---------- hb_scale : float The scaling factor to compute bonds with hydrogen atoms. """ self.reader.SetHBScale(hb_scale) @property def b_scale(self) -> float: """Get the scaling factor to compute bonds between non-hydrogen atoms. Returns ------- float The scaling factor to compute bonds between non-hydrogen atoms. """ return self.reader.GetBScale() @b_scale.setter def b_scale(self, b_scale: float) -> None: """Set the scaling factor to compute bonds between non-hydrogen atoms. Parameters ---------- b_scale : float The scaling factor to compute bonds between non-hydrogen atoms. """ self.reader.SetBScale(b_scale) class MINCImageReader(BaseReader['ImageData']): """MINCImageReader for .mnc files. Wraps :vtk:`vtkMINCImageReader`. .. versionadded:: 0.44.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_t3_grid_0(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOMINC' _vtk_class_name = 'vtkMINCImageReader' class PDBReader(BaseReader['PolyData']): """PDBReader for .pdb files. Wraps :vtk:`vtkPDBReader`. .. versionadded:: 0.44.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_caffeine(load=False) >>> Path(filename).name 'caffeine.pdb' """ _vtk_module_name = 'vtkIOChemistry' _vtk_class_name = 'vtkPDBReader' class GESignaReader(BaseReader['ImageData']): """GESignaReader for .MR files. Wraps :vtk:`vtkGESignaReader`. .. versionadded:: 0.44.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_e07733s002i009(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOImage' _vtk_class_name = 'vtkGESignaReader' class ParticleReader(BaseReader['PolyData']): """ParticleReader for .raw files. Wraps :vtk:`vtkParticleReader`. .. versionadded:: 0.44.0 Warnings -------- If the byte order is not set correctly, the reader will fail to read the file. Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_particles(load=False) >>> reader = pv.get_reader(filename) >>> reader.endian = 'BigEndian' >>> Path(filename).name 'Particles.raw' >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkParticleReader' @property def endian(self) -> str: """Get the byte order of the data. Returns ------- str The byte order of the data. 'BigEndian' or 'LittleEndian'. """ return self.reader.GetDataByteOrderAsString() @endian.setter def endian(self, endian: str): """Set the byte order of the data. Parameters ---------- endian : str The byte order of the data. 'BigEndian' or 'LittleEndian'. """ if endian == 'BigEndian': self.reader.SetDataByteOrderToBigEndian() elif endian == 'LittleEndian': self.reader.SetDataByteOrderToLittleEndian() else: msg = f'Invalid endian: {endian}.' raise ValueError(msg) self.reader.Update() class ProStarReader(BaseReader['UnstructuredGrid']): """ProStarReader for .vrt files. Wraps :vtk:`vtkProStarReader`. Reads geometry in proSTAR (STARCD) file format. .. versionadded:: 0.44.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_prostar(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOGeometry' _vtk_class_name = 'vtkProStarReader' class ExodusIIReader(BaseReader['MultiBlock'], PointCellDataSelection, TimeReader): """ExodusIIReader for .e and .exo files. Reads Exodus II files. Wraps :vtk:`vtkExodusIIReader`. .. versionadded:: 0.45.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> filename = examples.download_mug(load=False) >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _vtk_module_name = 'vtkIOExodus' _vtk_class_name = 'vtkExodusIIReader' def _set_defaults_post(self): self._element_blocks = ExodusIIBlockSet(self, self._reader.ELEM_BLOCK) self._face_blocks = ExodusIIBlockSet(self, self._reader.FACE_BLOCK) self._edge_blocks = ExodusIIBlockSet(self, self._reader.EDGE_BLOCK) self._elem_sets = ExodusIIBlockSet(self, self._reader.ELEM_SET) self._face_sets = ExodusIIBlockSet(self, self._reader.FACE_SET) self._side_sets = ExodusIIBlockSet(self, self._reader.SIDE_SET) self._node_sets = ExodusIIBlockSet(self, self._reader.NODE_SET) self.enable_all_cell_arrays() self.enable_all_point_arrays() def read_global(self) -> pv.Table: """Read enabled global data. Returns ------- Table Global data from Exodus II file """ global_extractor = _lazy_vtk_import( 'vtkFiltersExtraction', 'vtkExtractExodusGlobalTemporalVariables' )() global_extractor.SetInputConnection(self.reader.GetOutputPort()) global_extractor.Update() return wrap(global_extractor.GetOutputDataObject(0)) @property def element_blocks(self): """Returns an ExodusIIBlockSet object for the element blocks. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the element blocks. """ return self._element_blocks @property def face_blocks(self): """Returns an ExodusIIBlockSet object for the face blocks. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the face blocks. """ return self._face_blocks @property def edge_blocks(self): """Returns an ExodusIIBlockSet object for the edge blocks. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the edge blocks. """ return self._edge_blocks @property def side_sets(self): """Returns an ExodusIIBlockSet object for the side sets. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the side sets. """ return self._side_sets @property def node_sets(self): """Returns an ExodusIIBlockSet object for the node sets. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the node sets. """ return self._node_sets @property def element_sets(self): """Returns an ExodusIIBlockSet object for the element sets. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the element sets. """ return self._elem_sets @property def face_sets(self): """Returns an ExodusIIBlockSet object for the face sets. Returns ------- ExodusIIBlockSet Convenience object for accessing information about the face sets. """ return self._face_sets @property def number_time_points(self): """Return number of time points or iterations available to read. Returns ------- int """ return self.reader.GetNumberOfTimeSteps() def enable_displacements(self, displacement_magnitude=1.0): """Nodal positions are 'displaced' by the standard exodus displacement vector. Parameters ---------- displacement_magnitude : float, optional Magnitude of displacement, default 1.0. """ self.reader.SetApplyDisplacements(True) self.reader.SetDisplacementMagnitude(displacement_magnitude) def disable_displacements(self): """Nodal positions are not 'displaced'.""" self.reader.SetApplyDisplacements(False) @property def number_point_arrays(self): """Return the number of point arrays. Returns ------- int Number of point arrays. """ return self.reader.GetNumberOfPointResultArrays() @property def point_array_names(self): """Return the list of all point array names. Returns ------- list[str] List of all point array names. """ return [self.reader.GetPointResultArrayName(i) for i in range(self.number_point_arrays)] def enable_point_array(self, name): """Enable point array with name. Parameters ---------- name : str Point array name. """ self.reader.SetPointResultArrayStatus(name, 1) def disable_point_array(self, name): """Disable point array with name. Parameters ---------- name : str Point array name. """ self.reader.SetPointResultArrayStatus(name, 0) def point_array_status(self, name): """Get status of point array with name. Parameters ---------- name : str Point array name. Returns ------- bool Whether reading the cell array is enabled. """ return bool(self.reader.GetPointResultArrayStatus(name)) @property def number_cell_arrays(self): """Return the number of point arrays. Returns ------- int Number of point arrays. """ return self.reader.GetNumberOfElementResultArrays() @property def cell_array_names(self): """Return the list of all cell array names. Returns ------- list[str] List of all cell array names. """ return [self.reader.GetElementResultArrayName(i) for i in range(self.number_cell_arrays)] def enable_cell_array(self, name): """Enable cell array with name. Parameters ---------- name : str Cell array name. """ self.reader.SetElementResultArrayStatus(name, 1) def disable_cell_array(self, name): """Disable cell array with name. Parameters ---------- name : str Cell array name. """ self.reader.SetElementResultArrayStatus(name, 0) def cell_array_status(self, name): """Get status of cell array with name. Parameters ---------- name : str Cell array name. Returns ------- bool Whether reading the cell array is enabled. """ return bool(self.reader.GetElementResultArrayStatus(name)) @property def number_global_arrays(self): """Return the number of point arrays. Returns ------- int Number of point arrays. """ return self.reader.GetNumberOfGlobalResultArrays() @property def global_array_names(self): """Return the list of all global array names. Returns ------- list[str] List of all global array names. """ return [self.reader.GetGlobalResultArrayName(i) for i in range(self.number_cell_arrays)] def enable_global_array(self, name): """Enable global array with name. Parameters ---------- name : str global array name. """ self.reader.SetGlobalResultArrayStatus(name, 1) def disable_global_array(self, name): """Disable global array with name. Parameters ---------- name : str global array name. """ self.reader.SetGlobalResultArrayStatus(name, 0) def global_array_status(self, name): """Get status of global array with name. Parameters ---------- name : str global array name. Returns ------- bool Whether reading the global array is enabled. """ return bool(self.reader.GetGlobalResultArrayStatus(name)) def enable_all_global_arrays(self) -> None: """Enable all global arrays.""" for name in self.global_array_names: self.enable_global_array(name) def disable_all_global_arrays(self) -> None: """Disable all global arrays.""" for name in self.global_array_names: self.disable_global_array(name) @property def time_values(self): """All time or iteration values. Returns ------- list[float] """ vtkStreaming = _lazy_vtk_import( 'vtkCommonExecutionModel', 'vtkStreamingDemandDrivenPipeline' )() key = vtkStreaming.TIME_STEPS() vtkinfo = self.reader.GetOutputInformation(0) return [vtkinfo.Get(key, i) for i in range(self.number_time_points)] def time_point_value(self, time_point): """Value of time point or iteration by index. Parameters ---------- time_point : int Time point index. Returns ------- float """ return self.time_values[time_point] @property def active_time_value(self): """Active time or iteration value. Returns ------- float """ return self.time_values[self.reader.GetTimeStep()] def set_active_time_value(self, time_value): """Set active time or iteration value. Parameters ---------- time_value : float Time or iteration value to set as active. """ try: index = self.time_values.index(time_value) except ValueError: msg = f'Time {time_value} not present. Available times are {self.time_values}' raise ValueError(msg) from None self.set_active_time_point(index) def set_active_time_point(self, time_point): """Set active time or iteration by index. Parameters ---------- time_point : int Time or iteration point index for setting active time. """ self.reader.SetTimeStep(time_point) class _FRDReader(BaseVTKReader): """VTK-style reader for CalculiX FRD files using FRDParser.""" def __init__(self) -> None: super().__init__() self._frd_data: _FRDData | None = None self._time_steps: list[float] = [] self._active_time_point: int = 0 def UpdateInformation(self) -> None: parser = _FRDParser(self._filename) self._frd_data = parser.parse() MAX_N_LINES = 3 def _warn_invalid(invalid_elements, desc): n = len(invalid_elements) s = 's' if n > 1 else '' msg = f'{n} cell{s} with {desc}:' for elem in invalid_elements[:MAX_N_LINES]: msg += '\n ' + str(elem) warn_external(msg, InvalidMeshWarning) if invalid_elements := self._frd_data._has_too_many_points: _warn_invalid(invalid_elements, 'too many points detected') if invalid_elements := self._frd_data._has_too_few_points: _warn_invalid(invalid_elements, 'too few points detected. These elements are skipped') if invalid_elements := self._frd_data._has_unsupported_element: _warn_invalid( invalid_elements, 'unknown element type encountered. These elements are skipped.' ) self._time_steps = sorted(self._frd_data.results_by_step.keys()) def Update(self) -> None: """Construct the mesh for the currently active time step.""" if self._frd_data is None: return step_time = self._time_steps[self._active_time_point] if self._time_steps else None step_data = ( self._frd_data.results_by_step.get(step_time, {}) if step_time is not None else {} ) self._data_object = _FRDParser._build_grid(self._frd_data, step_data) class FRDReader(BaseReader['UnstructuredGrid'], TimeReader): """Reader for CalculiX FRD ASCII result files (``.frd``). Supported element types include: HE8, PE6, PE15, TE4, HE20, TE10, TR3, TR6, QU4, QU8, BE2, BE3. For datasets containing 6-component tensors (e.g. STRESS or STRAIN), this reader automatically pre-computes and appends the following derived scalar arrays to the output mesh: - ``_Mises``: equivalent von Mises magnitude. - ``_sgMises``: signed von Mises magnitude. - ``_PS1``, ``_PS2``, ``_PS3``: principal components. .. versionadded:: 0.48 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_frd(load=False) >>> Path(filename).name 'mesh.frd' >>> reader = pv.get_reader(filename) >>> mesh = reader.read() >>> mesh.plot() """ _class_reader = _FRDReader @property def number_time_points(self) -> int: """Return the total number of time points.""" return len(self.reader._time_steps) def time_point_value(self, time_point: int) -> float: """Return the time value associated with the given time point.""" return self.reader._time_steps[time_point] @property def time_values(self) -> list[float]: """Return the list of available time values.""" return list(self.reader._time_steps) def set_active_time_point(self, time_point: int) -> None: """Set the active time point.""" n = self.number_time_points if not 0 <= time_point < n: msg = f'time_point {time_point} is out of range (file has {n} time point(s)).' raise IndexError(msg) self.reader._active_time_point = time_point def set_active_time_value(self, time_value: float) -> None: """Set the active time value.""" steps = self.reader._time_steps if not steps: msg = 'No time steps found in the FRD file.' raise RuntimeError(msg) # Changed logic - exact match is required if time_value not in steps: msg = f'Not a valid time {time_value} from available time values: {steps}' raise ValueError(msg) self.reader._active_time_point = steps.index(time_value) @property def active_time_value(self) -> float: """Return the active time value.""" steps = self.reader._time_steps if not steps: return 0.0 return steps[self.reader._active_time_point] @active_time_value.setter def active_time_value(self, value: float) -> None: """Set the active time value.""" self.set_active_time_value(value) class ExodusIIBlockSet(_NoNewAttrMixin): """Class for enabling and disabling blocks, sets, and block/set arrays in Exodus II files.""" def __init__(self, exodus_reader: ExodusIIReader, object_type): if not exodus_reader.reader.GetObjectTypeName(object_type): msg = 'object_type is invalid' raise ValueError(msg) self._reader = weakref.proxy(exodus_reader.reader) self._object_type = object_type @property def number(self): """Return the number of blocks or sets in object. Returns ------- int Number of block or sets in object. """ return self._reader.GetNumberOfObjects(self._object_type) @property def names(self): """Returns the list of the names of the sets or blocks in object. Returns ------- list[str] List of all names of blocks/sets in object. """ return [self._reader.GetObjectName(self._object_type, i) for i in range(self.number)] def enable(self, name): """Enable the block/set with name. Parameters ---------- name: str name of set/block to be enabled. """ self._reader.SetObjectStatus(self._object_type, name, 1) def enable_all(self): """Enable all names in block/set.""" for name in self.names: self.enable(name) def disable(self, name): """Disable the block/set with name. Parameters ---------- name: str name of set/block to be disabled. """ self._reader.SetObjectStatus(self._object_type, name, 0) def disable_all(self): """Disable all names in block/set.""" for name in self.names: self.disable(name) def status(self, name): """Get the status of the block/set with name. Parameters ---------- name: str name of set/block to be disabled. Returns ------- bool Whether the block/set is enabled. """ return bool(self._reader.GetObjectStatus(self._object_type, name)) def _construct_result_method(self, prefix, suffix): """Construct result array methods from the object type enum.""" # Get object name objectname = self._reader.GetObjectTypeName(self._object_type).title().replace(' ', '') # Construct result array method name with prefix/suffix method_name = prefix + objectname + 'ResultArray' + suffix # Get method from reader return getattr(self._reader, method_name) @property def number_arrays(self): """Return the number of block/set arrays in object. Returns ------- int Number of block/set arrays in object. """ method = self._construct_result_method('GetNumberOf', 's') return method() @property def array_names(self): """Returns the list of the names of the block/set arrays in object. Returns ------- list[str] List of all names of block/set arrays in object. """ name_method = self._construct_result_method('Get', 'Name') return [name_method(i) for i in range(self.number_arrays)] def enable_array(self, name): """Enable the block/set array with name. Parameters ---------- name: str name of set/block array to be enabled. """ enable_method = self._construct_result_method('Set', 'Status') enable_method(name, 1) def enable_all_arrays(self): """Enable all arrays in block/set.""" for name in self.array_names: self.enable_array(name) def disable_array(self, name): """Disable the block/set array with name. Parameters ---------- name: str name of set/block array to be disabled. """ disable_method = self._construct_result_method('Set', 'Status') disable_method(name, 0) def disable_all_arrays(self): """Disable all arrays in block/set.""" for name in self.array_names: self.disable_array(name) def array_status(self, name): """Get the status of the block/set array with name. Parameters ---------- name: str name of set/block array to be disabled. Returns ------- bool Whether the block/set array is enabled. """ status_method = self._construct_result_method('Get', 'Status') return status_method(name) @dataclass(order=True) class SeriesDataSet(_NoNewAttrMixin): """Class for storing dataset info from series file.""" name: str time: float _SeriesEachReader = TypeVar('_SeriesEachReader', bound='BaseReader[Any]') class _SeriesReader(BaseVTKReader, Generic[_SeriesEachReader]): """Simulate a VTK reader for series file.""" def __init__(self) -> None: super().__init__() self._filename: str | None = None self._directory: str | None = None self._datasets: list[SeriesDataSet] | None = None self._active_dataset: SeriesDataSet | None = None self._time_values: list[float] | None = None self._reader_type: type[_SeriesEachReader] | None = None self._active_reader: _SeriesEachReader | None = None def SetFileName(self, filename) -> None: """Set filename and update reader.""" self._filename = str(filename) self._directory = str(Path(filename).parent) def _deterimine_reader_type(self) -> type[_SeriesEachReader]: """Determine reader type from first dataset in series.""" if self._datasets is None or len(self._datasets) == 0: msg = 'No datasets found in series file to determine reader type.' raise ValueError(msg) self._filename = cast('str', self._filename) parent_ext = Path(self._filename.removesuffix('.series')).suffix child_exts = {Path(dataset.name).suffix for dataset in self._datasets} if len(child_exts) != 1: msg = 'Datasets in series file have multiple extensions, cannot determine reader type.' raise ValueError(msg) child_ext = child_exts.pop() if parent_ext != child_ext: msg = ( f'Dataset extension {child_ext} does not match series file parent extension ' f'{parent_ext}, cannot determine reader type.' ) raise ValueError(msg) return cast('type[_SeriesEachReader]', CLASS_READERS[child_ext]) def UpdateInformation(self): """Parse series file.""" if self._filename is None: msg = 'Filename must be set' raise ValueError(msg) with Path(self._filename).open() as fr: content = json.load(fr) if 'files' not in content: msg = 'Invalid series file: missing "files" entry' raise ValueError(msg) datasets = [ SeriesDataSet(element['name'], element['time']) for element in content['files'] ] self._datasets = sorted(datasets) self._reader_type = self._deterimine_reader_type() self._time_values = sorted({dataset.time for dataset in self._datasets}) self._time_mapping: dict[float, SeriesDataSet] = { dataset.time: dataset for dataset in self._datasets } self._SetActiveTime(self._time_values[0]) def Update(self) -> None: """Read data and store it.""" self._active_reader = cast('_SeriesEachReader', self._active_reader) self._data_object = self._active_reader.read() def _SetActiveTime(self, time_value) -> None: """Set active time.""" self._active_dataset = self._time_mapping[time_value] self._reader_type = cast('type[_SeriesEachReader]', self._reader_type) self._active_reader = ( self._reader_type(Path(self._directory) / self._active_dataset.name) # type: ignore[arg-type] ) class SeriesReader(BaseReader['DataObject'], TimeReader, Generic[_SeriesEachReader]): """Class for reading .series file supported by Paraview. .. versionadded:: 0.47.0 Examples -------- >>> import pyvista as pv >>> from pyvista import examples >>> from pathlib import Path >>> filename = examples.download_file('vtu_series/wavy.zip') >>> Path(filename[0]).name 'mesh.vtu.series' >>> reader = pv.get_reader(filename[0]) >>> reader.time_values [0.0, 1.0, 2.0, 3.0, ... 12.0, 13.0, 14.0] >>> reader.set_active_time_point(5) >>> reader.active_time_value 5.0 >>> mesh = reader.read() >>> mesh.plot(scalars='z') """ _class_reader: type[_SeriesReader[_SeriesEachReader]] = _SeriesReader[_SeriesEachReader] _output_types = get_args(_mesh_types) @property def active_reader(self): """Return the active reader. Returns ------- pyvista.BaseReader """ return self.reader._active_reader @property def datasets(self): """Return all datasets. Returns ------- list[pyvista.SeriesDataSet] """ return self.reader._datasets @property def active_dataset(self): """Return all active datasets. Returns ------- pyvista.SeriesDataSet """ return self.reader._active_dataset @property def time_values(self): # noqa: D102 return self.reader._time_values @property def number_time_points(self): # noqa: D102 return len(self.reader._time_values) def time_point_value(self, time_point): # noqa: D102 return self.reader._time_values[time_point] @property def active_time_value(self): # noqa: D102 return self.reader._active_dataset.time def set_active_time_value(self, time_value) -> None: # noqa: D102 self.reader._SetActiveTime(time_value) def set_active_time_point(self, time_point) -> None: # noqa: D102 self.set_active_time_value(self.time_values[time_point]) CLASS_READERS = { # Standard dataset readers: '.bmp': BMPReader, '.cas': FluentReader, '.case': EnSightReader, '.cgns': CGNSReader, '.cube': GaussianCubeReader, '.dat': TecplotReader, '.dcm': DICOMReader, '.dem': DEMReader, '.e': ExodusIIReader, '.ex2': ExodusIIReader, '.exo': ExodusIIReader, '.exii': ExodusIIReader, '.facet': FacetReader, '.foam': POpenFOAMReader, '.frd': FRDReader, '.g': BYUReader, '.gif': GIFReader, '.glb': GLTFReader, '.gltf': GLTFReader, '.h5': FLUENTCFFReader, '.hdf': HDFReader, '.hdr': HDRReader, '.img': DICOMReader, '.inp': AVSucdReader, '.jpeg': JPEGReader, '.jpg': JPEGReader, '.mha': MetaImageReader, '.mhd': MetaImageReader, '.mnc': MINCImageReader, '.mr': GESignaReader, '.nek5000': Nek5000Reader, '.neu': GambitReader, '.nhdr': NRRDReader, '.nii': NIFTIReader, '.nii.gz': NIFTIReader, '.nrrd': NRRDReader, '.obj': OBJReader, '.p3d': Plot3DMetaReader, '.pdb': PDBReader, '.ply': PLYReader, '.png': PNGReader, '.pnm': PNMReader, '.pts': PTSReader, '.pvd': PVDReader, '.pvti': XMLPImageDataReader, '.pvtk': VTKPDataSetReader, '.pvtr': XMLPRectilinearGridReader, '.pvtu': XMLPUnstructuredGridReader, '.raw': ParticleReader, '.res': MFIXReader, '.segy': SegYReader, '.sgy': SegYReader, '.slc': SLCReader, '.stl': STLReader, '.tif': TIFFReader, '.tiff': TIFFReader, '.tri': BinaryMarchingCubesReader, '.vrt': ProStarReader, '.vti': XMLImageDataReader, '.vtk': VTKDataSetReader, '.vtkhdf': HDFReader, '.vtm': XMLMultiBlockDataReader, '.vtmb': XMLMultiBlockDataReader, '.vtp': XMLPolyDataReader, '.vtpd': XMLPartitionedDataSetReader, '.vtr': XMLRectilinearGridReader, '.vts': XMLStructuredGridReader, '.vtu': XMLUnstructuredGridReader, '.series': SeriesReader, '.xdmf': XdmfReader, } def _extract_base_reader_generic_arg(cls: type[BaseReader[Any]]) -> str | None: """Return the forward-reference name from a ``BaseReader[X]`` base. Walks ``cls.__orig_bases__`` looking for a ``BaseReader[X]`` base and returns ``X`` as a string (the forward-reference text, or a real class's ``__name__``). Returns ``None`` when the class is not a parameterized :class:`BaseReader` subclass. """ import typing as _typing # noqa: PLC0415 for base in getattr(cls, '__orig_bases__', ()): origin = _typing.get_origin(base) if origin is None or not (isinstance(origin, type) and issubclass(origin, BaseReader)): continue args = _typing.get_args(base) if not args: continue arg = args[0] if isinstance(arg, _typing.ForwardRef): return arg.__forward_arg__ if isinstance(arg, type): return arg.__name__ return None def _derive_reader_output_types( cls: type[BaseReader[Any]], ) -> _mesh_types | tuple[_mesh_types, ...]: """Return the output type(s) declared by a reader class. Uses the ``_output_types`` class attribute when a reader's ``BaseReader[X]`` generic parameter is a widened common supertype (multi-output readers); otherwise returns the generic parameter as a ``_mesh_types`` literal. Raises :class:`TypeError` if neither source supplies a type. """ override = getattr(cls, '_output_types', None) if override is not None: return override name = _extract_base_reader_generic_arg(cls) if name is None: msg = ( f'Cannot derive output type for reader {cls.__name__!r}: ' f'it does not parameterize BaseReader[X] and does not define ' f'an `_output_types` class attribute.' ) raise TypeError(msg) return cast('_mesh_types', name) # Define reader output types. Primarily used for testing and documentation. # The mapping is derived from each reader's ``BaseReader[X]`` parameterization # (with a per-class ``_output_types`` attribute on multi-output readers), so # adding a new reader automatically produces the right entry here. We seed the # iteration from :data:`CLASS_READERS` (every reader registered to a file # extension) — readers not registered to an extension stay out by design. _CLASS_READER_RETURN_TYPE: dict[type[BaseReader[Any]], _mesh_types | tuple[_mesh_types, ...]] = { cls: _derive_reader_output_types(cls) for cls in set(CLASS_READERS.values()) }