BRepGraph_Validate Class Reference

Structural invariant checker for BRepGraph. More...

#include <BRepGraph_Validate.hxx>

Data Structures
struct	Issue
	A single structural issue found in the graph. More...
struct	Options
	Validation options. More...
struct	Result
	Aggregated validation result. More...

Public Types
enum class	Severity { Warning , Error }
	Severity level for reported issues. More...
enum class	Mode { Lightweight , Audit }
	Validation mode controlling check depth/performance trade-off. More...

Static Public Member Functions
static Result	Perform (const BRepGraph &theGraph)
	Run default lightweight structural checks on a built graph. Uses Mode::Lightweight; for full structural audit use Perform(theGraph, Mode::Audit).
static Result	Perform (const BRepGraph &theGraph, const Mode theMode)
	Run structural checks on a built graph with explicit mode.
static Result	Perform (const BRepGraph &theGraph, const Options &theOptions)
	Run structural checks on a built graph with explicit options.

Detailed Description

Structural invariant checker for BRepGraph.

Read-only algorithm that verifies the graph's internal consistency: cross-reference bounds, reverse index symmetry, incidence ref consistency, geometry reference validity, removed-node isolation, and wire connectivity.

Distinct from BRepGraphCheck (geometric shape validity). This class checks the graph data structure itself.

Validation Mode Check Matrix

Check	Lightweight	Audit
Active entity count boundary	YES	YES
Cross-reference bounds	-	YES
Reverse-index consistency	-	YES
Face-count cache consistency	-	YES
Incidence ref consistency	-	YES
Geometry representation refs	-	YES
Removed-node isolation	-	YES
Wire edge connectivity	-	YES
Entity ID positional integrity	-	YES
UID round-trip integrity	-	YES
Assembly DAG cycle detection	-	YES

Mode Guidance

Mode	What it checks	Cost	Recommended use
Lightweight	Active entity count boundary only	Low	Hot-path release builds when the
graph structure is already trusted		Audit	Full structural audit from cross-reference

bounds through assembly DAG cycle detection | Higher | Default validation mode for production pipelines, test gates, and API-boundary verification |

For production pipelines, prefer Mode::Audit; Mode::Lightweight is intended for hot-path release builds where the graph structure is already trusted.

Member Enumeration Documentation

Mode

enum class BRepGraph_Validate::Mode

strong

Validation mode controlling check depth/performance trade-off.

Enumerator
Lightweight	Fast boundary-oriented checks for frequent validation points.
Audit	Full structural audit (superset of Lightweight).

Severity

enum class BRepGraph_Validate::Severity

strong

Severity level for reported issues.

Enumerator
Warning
Error

Member Function Documentation

Perform() [1/3]

static Result BRepGraph_Validate::Perform ( const BRepGraph & theGraph )

static

Run default lightweight structural checks on a built graph. Uses Mode::Lightweight; for full structural audit use Perform(theGraph, Mode::Audit).

Parameters

[in]

theGraph

graph to validate (const, read-only)

Returns

validation result with all detected issues

Perform() [2/3]

static Result BRepGraph_Validate::Perform ( const BRepGraph & theGraph, const Mode theMode )

static

Run structural checks on a built graph with explicit mode.

Parameters

[in]	theGraph	graph to validate (const, read-only)
[in]	theMode	validation mode

Returns

validation result with all detected issues

Perform() [3/3]

static Result BRepGraph_Validate::Perform ( const BRepGraph & theGraph, const Options & theOptions )

static

Run structural checks on a built graph with explicit options.

Parameters

[in]	theGraph	graph to validate (const, read-only)
[in]	theOptions	validation profile/options

Returns

validation result with all detected issues

---

The documentation for this class was generated from the following file:

• BRepGraph_Validate.hxx