Loading...
Searching...
No Matches
constraintaudit.h
Go to the documentation of this file.
1// SPDX-License-Identifier: Apache-2.0
2#pragma once
4namespace mesh
5{
6struct MeshResult;
15 QVector<QPointF> protectedPoints;
18 std::function<bool()> cancelled;
22 quint64 workBudget = 0;
25 quint64 maximumWorkspaceBytes = quint64(1) << 30;
29};
30
44 int segment = -1;
45};
46
62 bool ok = false, complete = false, cancelled = false, resourceLimited = false;
65 QString error;
100 QVector<ConstraintAuditExample> examples;
101};
102// Independent read-only checks: no calls into the simplifier's acceptance or
103// triangulator's constraint-recovery code. Source mappings are validated before
104// use. Work/memory exhaustion is incomplete, never a successful certificate.
124 const QVector<SimplificationFeature> &original,
125 const ConstraintSimplificationResult &candidate,
126 const ConstraintAuditOptions &options = {});
127// Checks required domain/hole/line paths against delivered, incident cell edges
128// after all mesh edits/reordering. It is a constraint-coverage/side audit, not a
129// general proof that arbitrary cells do not overlap. Coordinate roundoff is
130// explicitly measured; simplification tolerances never excuse missing edges.
148ConstraintAuditReport auditMeshConstraints(const QVector<SimplificationFeature> &constraints,
149 const MeshResult &mesh,
150 const ConstraintAuditOptions &options = {});
151}
The Qt-facing MeshKit API (meshkit::core_qt, meshkit::model_qt, meshkit::io_qt): mesh value types and...
ConstraintAuditReport auditConstraintSimplification(const QVector< SimplificationFeature > &original, const ConstraintSimplificationResult &candidate, const ConstraintAuditOptions &options={})
Qt facade of meshkit::plan::auditConstraintSimplification(): converts the arguments to native copies,...
Definition constraintaudit.cpp:6
ConstraintAuditReport auditMeshConstraints(const QVector< SimplificationFeature > &constraints, const MeshResult &mesh, const ConstraintAuditOptions &options={})
Qt facade of meshkit::plan::auditMeshConstraints(): features and options are converted to native copi...
Definition constraintaudit.cpp:7
Qt form of meshkit::plan::ConstraintAuditExample: one recorded audit violation.
Definition constraintaudit.h:33
QString featureId
Id of the offending feature, or "pin", "graph" or "mesh" for violations not tied to one feature.
Definition constraintaudit.h:41
int segment
Index of the related vertex, segment, pin or delivered edge record (meaning depends on the message); ...
Definition constraintaudit.h:44
QString message
English description of the violation.
Definition constraintaudit.h:41
Qt form of meshkit::plan::ConstraintAuditOptions: pins, cancellation and resource limits for the cons...
Definition constraintaudit.h:11
std::function< bool()> cancelled
Optional; polled before work starts and every 4096 work units.
Definition constraintaudit.h:18
QVector< QPointF > protectedPoints
XY pins that simplified shortcuts must not cross, sweep over or (with the feature's minimumClearance)...
Definition constraintaudit.h:15
quint64 workBudget
Work units allowed; 0 selects 256 per input item plus 100,000 (items: original and candidate vertices...
Definition constraintaudit.h:22
int maximumExamples
Violations kept in ConstraintAuditReport::examples, clamped to [0, 1000]; all are still counted.
Definition constraintaudit.h:28
quint64 maximumWorkspaceBytes
Estimated workspace limit in bytes (default 1 GiB); exceeding it sets resourceLimited.
Definition constraintaudit.h:25
Qt form of meshkit::plan::ConstraintAuditReport: result of auditConstraintSimplification() or auditMe...
Definition constraintaudit.h:50
double coordinateRoundoff
Largest XY matching tolerance used, 32 machine epsilons times the segment's coordinate scale; mesh au...
Definition constraintaudit.h:98
quint64 violations
Total violations found, including those beyond maximumExamples.
Definition constraintaudit.h:81
quint64 segmentsChecked
Output segments (simplification audit) or required source segments (mesh audit) examined.
Definition constraintaudit.h:80
QString error
Empty when no violation was found and the audit finished; otherwise "<id>: <message>" of the first vi...
Definition constraintaudit.h:65
bool ok
complete and no violations: the only state that certifies the input.
Definition constraintaudit.h:62
quint64 featuresChecked
Features examined (simplification audit), or required features examined (mesh audit).
Definition constraintaudit.h:80
double maximumXYDeviation
Largest XY distance found: of a removed vertex from its output shortcut (simplification audit),...
Definition constraintaudit.h:97
double maximumZDeviation
Largest Z difference found, in Z units: of a removed vertex from linear interpolation,...
Definition constraintaudit.h:97
bool cancelled
ConstraintAuditOptions::cancelled stopped the audit.
Definition constraintaudit.h:62
quint64 workUsed
Work units consumed.
Definition constraintaudit.h:81
bool complete
Not cancelled and not resource-limited.
Definition constraintaudit.h:62
double maximumAreaChange
Largest absolute ring area change in squared XY units; simplification audit only.
Definition constraintaudit.h:97
QVector< ConstraintAuditExample > examples
First violations, at most maximumExamples (clamped to [0, 1000]).
Definition constraintaudit.h:100
quint64 cellsChecked
Delivered cells visited; mesh audit only.
Definition constraintaudit.h:80
bool resourceLimited
The work budget or workspace estimate ran out.
Definition constraintaudit.h:62
Output of simplifyConstraints(); features and changes are parallel to the input.
Definition constraintsimplifier.h:186
Result of MeshGenerator::generate.
Definition meshresult.h:203