Struct CadAuthoredGraph 

pub struct CadAuthoredGraph { /* private fields */ }

Common immutable owner of the admitted authored-CAD operation histories.

Persisted v1 and v2 schemas remain closed private variants. Existing v1 bytes and digests are reproduced exactly while callers use one feature- neutral Rust surface before Python and Studio projection.

Implementations

§

impl CadAuthoredGraph

Signature links:CadAuthoredGraph

pub fn new( sketch: ConstrainedRectangleV1, extrusion_depth_m: f64, requested_modeling_tolerance_m: f64, ) -> Result<CadAuthoredGraph, Diagnostic>

Signature links:newConstrainedRectangleV1f64f64ResultCadAuthoredGraphDiagnostic

Construct the frozen rectangle → face → positive-z extrusion history.

The requested modeling tolerance is identity-only. It is never used as a coordinate offset, classification tolerance, or repair policy.

Errors

Returns EQ0901 for a non-positive/non-finite depth or tolerance, a non-finite derived extent, or unexpected canonical serialization.

pub fn circular_through_cut( &self, center_m: [f64; 2], radius_m: f64, requested_boolean_tolerance_m: f64, ) -> Result<CadAuthoredGraph, Diagnostic>

Signature links:circular_through_cutf642f64f64ResultCadAuthoredGraphDiagnostic

Append the one admitted circular through-all difference operation.

The cut starts on the predecessor end cap and proceeds through all in negative z. Signed inward side clearance must exceed the requested Boolean tolerance; no tolerance substitution or healing is available.

Errors

Returns EQ0901 unless the predecessor is the closed v1 history and the finite positive circle lies strictly inside every rectangle side by more than the requested Boolean tolerance.

pub fn through_cut( &self, sketch: &CadAuthoredSketch, requested_boolean_tolerance_m: f64, ) -> Result<CadAuthoredGraph, Diagnostic>

Signature links:through_cutCadAuthoredSketchf64ResultCadAuthoredGraphDiagnostic

Apply the one admitted circular through-cut to its exact predecessor.

Errors

Returns EQ0901 unless this is a v1 rectangle-extrusion graph, the sketch is a circle bound to this graph’s canonical end-cap, and the existing finite positive tolerance and strict signed-clearance predicates are satisfied.

pub fn planar_circular_section( &self, classification_tolerance_m: f64, region: &str, x_lower: &str, x_upper: &str, y_lower: &str, y_upper: &str, hole: &str, ) -> Result<CanonicalGeometryV1, Diagnostic>

Signature links:planar_circular_sectionf64strstrstrstrstrstrResultCanonicalGeometryV1Diagnostic

Derive one exact planar section from the admitted through-cut history.

The section is the rectangle-minus-circle profile shared by every transverse plane of the through-cut body. Extrusion depth, sketch-plane placement, and modeling tolerance therefore do not enter its exact planar identity. Geometry classification tolerance remains a separate caller-owned value and is revalidated by the existing exact planar owner rather than copied from either authored CAD tolerance.

Errors

Returns EQ0901 unless this graph contains the admitted circular through-cut, or when the independently supplied planar tolerance or semantic role names fail exact Geometry admission.

pub fn decode_canonical(bytes: &[u8]) -> Result<CadAuthoredGraph, Diagnostic>

Signature links:decode_canonicalu8ResultCadAuthoredGraphDiagnostic

Decode either closed schema and reconstruct its one canonical byte form.

Object-member order and equivalent numeric spellings are nonsemantic; duplicate/unknown members and unsupported dependencies reject.

Errors

Returns EQ0901 for excess bytes or a malformed/unsupported graph.

pub const fn sketch(&self) -> ConstrainedRectangleV1

Signature links:sketchConstrainedRectangleV1

Fully constrained rectangle owned by the graph.

pub const fn extrusion_depth_m(&self) -> f64

Signature links:extrusion_depth_mf64

Positive-z extrusion depth in metres.

pub const fn requested_modeling_tolerance_m(&self) -> f64

Signature links:requested_modeling_tolerance_mf64

Identity-bearing base modeling tolerance in metres.

pub const fn requested_boolean_tolerance_m(&self) -> Option<f64>

Signature links:requested_boolean_tolerance_mOptionf64

Requested Boolean tolerance, absent from the rectangle-only history.

pub const fn cut_center_m(&self) -> Option<[f64; 2]>

Signature links:cut_center_mOptionf642

Circular cut centre, absent from the rectangle-only history.

pub const fn cut_radius_m(&self) -> Option<f64>

Signature links:cut_radius_mOptionf64

Circular cut radius, absent from the rectangle-only history.

pub const fn output(&self) -> AxisAlignedBox3

Signature links:outputAxisAlignedBox3

Exact outer analytic bounds; the through-cut does not change them.

pub const fn repair_disposition(&self) -> CadRepairDispositionV1

Signature links:repair_dispositionCadRepairDispositionV1

Neither admitted history performs healing or topology repair.

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

Signature links:canonical_bytesu8

Exact compact canonical JSON bytes for the graph’s closed wire variant.

pub const fn digest_bytes(&self) -> [u8; 32]

Signature links:digest_bytesu832

Complete domain-separated authored-graph identity.

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

Signature links:vertices_mf6438

Outer rectangle-extrusion corners in lower-then-upper order.

pub const fn vertex_count(&self) -> Option<usize>

Signature links:vertex_countOptionusize

Exact vertex count only where the analytic representation is closed.

pub const fn edge_count(&self) -> Option<usize>

Signature links:edge_countOptionusize

Exact edge count only where the analytic representation is closed.

pub const fn face_count(&self) -> usize

Signature links:face_countusize

Exact face count.

pub const fn closed_shell_count(&self) -> usize

Signature links:closed_shell_countusize

Number of connected closed shells.

pub const fn body_count(&self) -> usize

Signature links:body_countusize

Number of solid bodies.

pub const fn genus(&self) -> usize

Signature links:genususize

Exact body genus.

pub fn volume_m3(&self) -> f64

Signature links:volume_m3f64

Exact analytic body volume in cubic metres.

pub fn surface_area_m2(&self) -> f64

Signature links:surface_area_m2f64

Exact analytic total surface area in square metres.

pub fn face_handles(&self) -> Result<Vec<CadAuthoredFaceHandle>, Diagnostic>

Signature links:face_handlesResultVecCadAuthoredFaceHandleDiagnostic

Every admitted graph-bound face handle in canonical provenance order.

Errors

Returns EQ0901 only for an unexpected canonical handle serialization failure.

pub fn face_handle( &self, provenance_key: &str, ) -> Result<CadAuthoredFaceHandle, Diagnostic>

Signature links:face_handlestrResultCadAuthoredFaceHandleDiagnostic

Bind one stable provenance key to this exact graph identity.

Errors

Returns EQ0901 for an unknown or inadmissible provenance key or an unexpected canonical handle serialization failure.

pub fn resolve_face( &self, handle: &CadAuthoredFaceHandle, ) -> Result<&'static str, Diagnostic>

Signature links:resolve_faceCadAuthoredFaceHandleResultstrDiagnostic

Validate one graph-bound handle, then reveal its stable provenance key.

Errors

Returns EQ0901 before lookup for any foreign/stale graph digest or handle schema, then rejects a face outside this graph inventory.

pub fn face_area_m2( &self, handle: &CadAuthoredFaceHandle, ) -> Result<f64, Diagnostic>

Signature links:face_area_m2CadAuthoredFaceHandleResultf64Diagnostic

Exact face area after validating the graph-bound handle.

pub fn face_boundary_loop_count( &self, handle: &CadAuthoredFaceHandle, ) -> Result<usize, Diagnostic>

Signature links:face_boundary_loop_countCadAuthoredFaceHandleResultusizeDiagnostic

Exact number of analytic boundary loops on the selected face.

pub fn rectangular_face_vertices_m( &self, handle: &CadAuthoredFaceHandle, ) -> Result<Option<[[f64; 3]; 4]>, Diagnostic>

Signature links:rectangular_face_vertices_mCadAuthoredFaceHandleResultOptionf6434Diagnostic

Four outward-oriented vertices for a rectangular face, when applicable.

pub fn rectangular_face_centroid_m( &self, handle: &CadAuthoredFaceHandle, ) -> Result<Option<[f64; 3]>, Diagnostic>

Signature links:rectangular_face_centroid_mCadAuthoredFaceHandleResultOptionf643Diagnostic

Centroid of a rectangular selected face, when applicable.

pub fn planar_face_outward_normal( &self, handle: &CadAuthoredFaceHandle, ) -> Result<Option<[f64; 3]>, Diagnostic>

Signature links:planar_face_outward_normalCadAuthoredFaceHandleResultOptionf643Diagnostic

Constant outward unit normal for a planar selected face.

pub fn build_analytic(&self) -> Result<CadAuthoredBuild, Diagnostic>

Signature links:build_analyticResultCadAuthoredBuildDiagnostic

Execute the bounded built-in analytic profile and close its receipt.

Errors

Returns EQ0901 only if graph-bound lineage handles cannot be formed.

Trait Implementations

§

impl Clone for CadAuthoredGraph

Signature links:CloneCadAuthoredGraph

§

fn clone(&self) -> CadAuthoredGraph

Signature links:cloneCadAuthoredGraph

Returns a duplicate of the value.

§

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

Signature links:unstableSourceclone_from

Performs copy-assignment from source.

§

impl Debug for CadAuthoredGraph

Signature links:DebugCadAuthoredGraph

§

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

Signature links:fmtFormatterResult()Error

Formats the value using the given formatter.

§

impl PartialEq for CadAuthoredGraph

Signature links:PartialEqCadAuthoredGraph

§

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

Signature links:eqCadAuthoredGraphbool

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

§

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

Signature links:unstableSourcene&Rhsbool

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

impl StructuralPartialEq for CadAuthoredGraph