Struct PolyData 

pub struct PolyData {
    pub points: Points<f64>,
    pub verts: CellArray,
    pub lines: CellArray,
    pub polys: CellArray,
    pub strips: CellArray,
    /* private fields */
}

Polygonal mesh consisting of vertices, lines, polygons, and triangle strips.

Analogous to VTK’s vtkPolyData. Points are stored explicitly, with four separate CellArrays for the four cell categories.

Examples

use crate::data::PolyData;

// Create a triangle mesh
let pd = PolyData::from_triangles(
    vec![[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [0.0, 1.0, 0.0]],
    vec![[0, 1, 2]],
);
assert_eq!(pd.points.len(), 3);
assert_eq!(pd.polys.num_cells(), 1);

Fields

points: Points<f64>

verts: CellArray

lines: CellArray

polys: CellArray

strips: CellArray

Implementations

impl PolyData

pub fn new() -> Self

pub fn from_triangles(points: Vec<[f64; 3]>, triangles: Vec<[i64; 3]>) -> Self

Create a PolyData from points and triangle connectivity.

Each element of triangles is [i0, i1, i2] indexing into points.

pub fn from_polygons(points: Vec<[f64; 3]>, cells: Vec<Vec<i64>>) -> Self

Create a PolyData from points and generic polygon cells.

Each element of cells is a Vec of point indices for one polygon. Supports mixed triangle/quad/polygon meshes.

pub fn from_quads(points: Vec<[f64; 3]>, quads: Vec<[i64; 4]>) -> Self

Create a PolyData from points and quad connectivity.

Each element of quads is [i0, i1, i2, i3] indexing into points.

pub fn from_lines(points: Vec<[f64; 3]>, segments: Vec<[i64; 2]>) -> Self

Create a PolyData with line cells.

Each element of segments is [i0, i1] indexing into points.

pub fn from_flat_arrays(coords: &[f64], indices: &[i64]) -> Self

Create a PolyData from flat coordinate and index arrays.

coords is [x0,y0,z0, x1,y1,z1, ...] (length must be divisible by 3). indices is [i0,i1,i2, i3,i4,i5, ...] (length must be divisible by 3, triangles).

This is the most common format when receiving data from other libraries, GPU buffers, or numpy arrays.

use crate::data::PolyData;

let pd = PolyData::from_flat_arrays(
    &[0.0,0.0,0.0, 1.0,0.0,0.0, 0.0,1.0,0.0],
    &[0, 1, 2],
);
assert_eq!(pd.points.len(), 3);
assert_eq!(pd.polys.num_cells(), 1);

pub fn from_points(points: Vec<[f64; 3]>) -> Self

Create a PolyData with points only (no cells).

Useful for point clouds that will later have cells added.

pub fn from_vertices(points: Vec<[f64; 3]>) -> Self

Create a PolyData with vertex cells (one vertex per point).

pub fn from_polyline(points: Vec<[f64; 3]>) -> Self

Create a PolyData with a single polyline through all points.

pub fn push_point(&mut self, point: [f64; 3]) -> i64

Push a single point and return its index.

pub fn push_triangle(&mut self, i0: i64, i1: i64, i2: i64)

Push a triangle cell from 3 point indices.

pub fn push_quad(&mut self, i0: i64, i1: i64, i2: i64, i3: i64)

Push a quad cell from 4 point indices.

pub fn push_line(&mut self, i0: i64, i1: i64)

Push a line cell from 2 point indices.

pub fn total_cells(&self) -> usize

Total number of cells across all four categories.

pub fn point_data(&self) -> &DataSetAttributes

pub fn point_data_mut(&mut self) -> &mut DataSetAttributes

pub fn cell_data(&self) -> &DataSetAttributes

pub fn cell_data_mut(&mut self) -> &mut DataSetAttributes

pub fn field_data(&self) -> &FieldData

Access field data directly (convenience, same as DataObject::field_data).

pub fn field_data_mut(&mut self) -> &mut FieldData

Mutable access to field data.

pub fn reverse_cells(&mut self)

Reverse the winding order of all polygon cells.

Useful for flipping normals direction.

pub fn with_point_array(self, array: AnyDataArray) -> Self

Builder: add a point data array.

pub fn with_cell_array(self, array: AnyDataArray) -> Self

Builder: add a cell data array.

pub fn with_active_scalars(self, name: &str) -> Self

Builder: set active scalars by name.

pub fn from_xyz_arrays( x: &[f64], y: &[f64], z: &[f64], triangles: &[[i64; 3]], ) -> Self

Create from separate X, Y, Z coordinate arrays and triangle indices.

pub fn append(&mut self, other: &PolyData)

Append another PolyData in-place (mutates self).

pub fn num_polys(&self) -> usize

Number of polygon faces.

pub fn num_triangles(&self) -> usize

Count actual triangles (cells with exactly 3 points).

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

Compute the centroid (average position of all points).

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

Compute a bounding sphere: (center, radius).

pub fn is_all_triangles(&self) -> bool

Whether all polygon cells are triangles.

pub fn num_lines(&self) -> usize

Number of line cells.

pub fn num_verts(&self) -> usize

Number of vertex cells.

pub fn num_edges(&self) -> usize

Count unique edges in the polygon mesh.

pub fn add_scalars(&mut self, name: &str, values: Vec<f64>)

Add a scalar (1-component f64) point data array and set it as active scalars.

use crate::data::PolyData;

let mut pd = PolyData::from_triangles(
    vec![[0.0, 0.0, 0.0], [1.0, 0.0, 0.0], [0.0, 1.0, 0.0]],
    vec![[0, 1, 2]],
);
pd.add_scalars("temperature", vec![10.0, 20.0, 30.0]);
assert_eq!(pd.get_scalars("temperature"), Some(vec![10.0, 20.0, 30.0]));

pub fn add_vectors(&mut self, name: &str, values: Vec<[f64; 3]>)

Add a vector (3-component f64) point data array.

pub fn get_scalars(&self, name: &str) -> Option<Vec<f64>>

Get scalar values by name as Vec<f64>. Returns None if array not found.

pub fn get_vectors(&self, name: &str) -> Option<Vec<[f64; 3]>>

Get vector values by name. Returns None if array not found.

pub fn summary(&self) -> String

Human-readable summary of the PolyData.

pub fn to_table(&self) -> Table

Convert point coordinates and point data to a Table.

Creates columns “x”, “y”, “z” from point coordinates, plus one column per point data array.

pub fn approx_eq(&self, other: &PolyData, tolerance: f64) -> bool

Check approximate equality with another PolyData (for testing).

Trait Implementations

impl Clone for PolyData

fn clone(&self) -> PolyData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl DataObject for PolyData

fn field_data(&self) -> &FieldData

fn field_data_mut(&mut self) -> &mut FieldData

impl DataSet for PolyData

fn num_points(&self) -> usize

fn num_cells(&self) -> usize

fn point(&self, idx: usize) -> [f64; 3]

fn bounds(&self) -> BoundingBox

fn point_data(&self) -> &DataSetAttributes

fn point_data_mut(&mut self) -> &mut DataSetAttributes

fn cell_data(&self) -> &DataSetAttributes

fn cell_data_mut(&mut self) -> &mut DataSetAttributes

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

Center of the bounding box.

fn diagonal(&self) -> f64

Diagonal length of the bounding box.

fn is_empty(&self) -> bool

Whether the dataset has no points.

fn num_point_arrays(&self) -> usize

Number of point data arrays.

fn num_cell_arrays(&self) -> usize

Number of cell data arrays.

impl Debug for PolyData

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for PolyData

fn default() -> PolyData

Returns the “default value” for a type.

impl Display for PolyData

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<PolyData> for AnyDataSet

fn from(d: PolyData) -> Self

Converts to this type from the input type.

impl From<PolyData> for Block

fn from(pd: PolyData) -> Self

Converts to this type from the input type.

impl PartialEq for PolyData

fn eq(&self, other: &PolyData) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for PolyData