Struct VtuWriter 

pub struct VtuWriter { /* private fields */ }

Builder-style writer for VTK XML unstructured grid (.vtu) files.

Add points, cells, and optional point data; then call VtuWriter::to_xml or VtuWriter::write_to_file.

Implementations

impl VtuWriter

pub fn new() -> Self

Create an empty VTU writer.

pub fn add_point(&mut self, p: [f64; 3]) -> usize

Add a point and return its index.

pub fn add_points(&mut self, pts: &[[f64; 3]]) -> usize

Add multiple points at once and return the index of the first added point.

pub fn num_points(&self) -> usize

Return the number of points currently stored.

pub fn num_cells(&self) -> usize

Return the number of cells currently stored.

pub fn add_cell(&mut self, connectivity: Vec<usize>, cell_type_id: u8)

Add a cell defined by its connectivity (0-based point indices) and VTK cell type.

pub fn add_triangle(&mut self, i0: usize, i1: usize, i2: usize)

Add a triangle cell from three point indices.

pub fn add_quad(&mut self, i0: usize, i1: usize, i2: usize, i3: usize)

Add a quad cell from four point indices.

pub fn add_tet(&mut self, i0: usize, i1: usize, i2: usize, i3: usize)

Add a tetrahedron cell from four point indices.

pub fn add_hex( &mut self, i0: usize, i1: usize, i2: usize, i3: usize, i4: usize, i5: usize, i6: usize, i7: usize, )

Add a hexahedron cell from eight point indices.

pub fn add_point_data_scalar(&mut self, name: &str, values: &[f64])

Attach a named scalar field on points.

pub fn add_point_data_vector(&mut self, name: &str, vectors: &[[f64; 3]])

Attach a named vector field on points.

pub fn write_cell_data_tensor(name: &str, tensors: &[[f64; 6]]) -> String

Write symmetric tensor cell data as a VTK XML snippet.

Each cell supplies 6 components (Voigt notation): xx, yy, zz, xy, xz, yz. Returns an XML DataArray` element string ready to embed in CellData`.

pub fn write_pvtu_parallel( piece_files: &[&str], point_data_names: &[&str], cell_data_names: &[&str], ) -> String

Generate a parallel VTU master file (.pvtu) referencing the given piece files.

piece_files is a slice of relative paths to the individual .vtu pieces. Returns the pvtu XML string.

pub fn add_cell_data_scalar(&mut self, name: &str, values: &[f64])

Attach a named scalar field on cells.

pub fn add_cell_data_vector(&mut self, name: &str, vectors: &[[f64; 3]])

Attach a named vector field on cells.

pub fn bounding_box(&self) -> Option<([f64; 3], [f64; 3])>

Compute the bounding box of all points. Returns (min, max) or None if there are no points.

pub fn to_xml(&self) -> String

Generate the complete VTU XML as a String.

pub fn write_to_file(&self, path: &str) -> Result<()>

Write the VTU XML to a file.

pub fn validate(&self) -> Result<()>

Validate the writer state: check that cell connectivity references only existing point indices and that data arrays have correct length.

pub fn points(&self) -> &[[f64; 3]]

Return the point positions slice.

pub fn cell_types(&self) -> &[u8]

Return the cell types slice.

pub fn cells_per_cell(&self) -> &[Vec<usize>]

Return the per-cell connectivity (each entry is a Vec of point indices).

pub fn cells_flat(&self) -> Vec<usize>

Return a flat connectivity array (concatenation of all cell index lists).

Trait Implementations

impl Default for VtuWriter

fn default() -> Self

Returns the “default value” for a type.