cutrail 0.1.1

Material removal simulation core for machining: mesh-based stock, robust booleans, 3- and 5-axis sweeps, STEP/mesh I/O
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! Comparison against a design model: the difference between the machined stock and the design as volumes and region meshes.

use crate::geom::Aabb;
use crate::mesh::TriMesh;

/// Result of comparing against a design model.
///
/// `excess` is material left outside the design (undercut); `gouge` is the region removed inside the design (overcut).
/// With a `tolerance`, the differences are taken against the design offset outward and inward by that distance,
/// so deviations within the tolerance are ignored.
#[derive(Clone, Debug, PartialEq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct DesignComparison {
    /// Tolerance used (mm)
    pub tolerance: f64,
    /// Volume of excess material (mm³)
    pub excess_volume: f64,
    /// Volume of gouges (mm³)
    pub gouge_volume: f64,
    /// Region of excess material (no triangles if none)
    pub excess: TriMesh,
    /// Region of gouges (no triangles if none)
    pub gouge: TriMesh,
    /// Bounding box of the excess material
    pub excess_bounds: Option<Aabb>,
    /// Bounding box of the gouges
    pub gouge_bounds: Option<Aabb>,
}

impl DesignComparison {
    /// Whether there is neither excess material nor a gouge.
    pub fn is_within_tolerance(&self) -> bool {
        self.excess_volume <= 0.0 && self.gouge_volume <= 0.0
    }
}