VTKHDF-backend

VTKHDF-backend#

Relies on MPI compatible h5py, similar to the H5PY backend. See that backend for detailed installation instructions.

Module that can read the VTKHDF format using h5py.

io4dolfinx.backends.vtkhdf.backend.find_all_unique_cell_types(comm, cell_types, num_nodes)[source]#

Given a set of cell types and number of nodes per cell, find all unique cell types across all ranks.

Parameters:

  • comm – MPI communicator

  • cell_types – Local cell types

  • num_nodes – Number of nodes per cell

Returns:

A 2D array where each row corresponds to a cell type (vtk int) and the number of nodes.

io4dolfinx.backends.vtkhdf.backend.get_default_backend_args(arguments: dict[str, Any] | None) → dict[str, Any][source]#

Get default backend arguments given a set of input arguments.

Parameters:

arguments – Input backend arguments

Returns:

Updated backend arguments

io4dolfinx.backends.vtkhdf.backend.read_function_names(filename: Path | str, comm: Intracomm, backend_args: dict[str, Any] | None) → list[str][source]#

Read all function names from a file.

Parameters:

  • filename – Path to file

  • comm – MPI communicator to launch IO on.

  • backend_args – Arguments to backend

Returns:

A list of function names.

io4dolfinx.backends.vtkhdf.backend.read_mesh_data(filename: Path | str, comm: Intracomm, time: str | float | None, read_from_partition: bool, backend_args: dict[str, Any] | None) → ReadMeshData[source]#

Read mesh data from file.

Parameters:

  • filename – Path to file to read from

  • comm – MPI communicator used in storage

  • time – Time stamp associated with the mesh to read

  • read_from_partition – Whether to read partition information

  • backend_args – Arguments to backend

Returns:

Internal data structure for the mesh data read from file

io4dolfinx.backends.vtkhdf.backend.read_point_data(filename: Path | str, name: str, comm: Intracomm, time: float | str | None, backend_args: dict[str, Any] | None) → tuple[ndarray, int][source]#

Read data from the nodes of a mesh.

Parameters:

  • filename – Path to file

  • name – Name of point data

  • comm – Communicator to launch IO on.

  • time – The time stamp

  • backend_args – The backend arguments

Returns:

Data local to process (contiguous, no mpi comm) and local start range

io4dolfinx.backends.vtkhdf.backend.write_data(filename: Path | str, array_data: ArrayData, comm: Intracomm, time: str | float | None, mode: FileMode, backend_args: dict[str, Any] | None)[source]#

Write function to file by interpolating into geometry nodes.

Parameters:

  • filename – Path to file

  • array_data – Data to write to file

  • time – Time stamp

  • mode – Append or write

  • backend_args – The backend arguments