Loading...
Searching...
No Matches
meshcellstats.h
Go to the documentation of this file.
1
14
15#ifndef OPENSWMMVIS_MESH_MESHCELLSTATS_H
16#define OPENSWMMVIS_MESH_MESHCELLSTATS_H
17
18#include "meshresult.h"
19
20#include <QHash>
21#include <QPair>
22
23namespace mesh
24{
25
28 double min = 0.0;
29 double max = 0.0;
30 double mean = 0.0;
31 double median = 0.0;
32 int count = 0;
33};
34
54[[nodiscard]] double triangleArea(const MeshResult &mesh, int tri);
55
67[[nodiscard]] QPointF cellCentroid(const MeshResult &mesh, int cell);
68
71struct QuadStats {
72 int count = 0;
73 double minAngleDeg = 360.0;
74 double maxAngleDeg = 0.0;
78 double maxNonPlanarity = 0.0;
79 // QUAD_MESHING_REDESIGN_PLAN_2026-09-06.md §5 — shape metrics
80 // (mesh::quadQuality). All 0 when count == 0.
81 double minScaledJacobian = 1.0;
82 double medianRectangularity = 0.0;
83 double maxAspect = 1.0;
84 int nonConvex = 0;
86 0;
88 int sjHistogram[10] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
89};
90
103[[nodiscard]] QuadStats computeQuadStats(const MeshResult &mesh);
104
119[[nodiscard]] CellAreaStats computeCellAreaStats(const MeshResult &mesh);
120
122using EdgeVertexPair = QPair<int, int>;
123
140[[nodiscard]] QHash<EdgeVertexPair, QVector<int>> buildEdgeTriangles(const MeshResult &mesh);
141
167struct CflStats {
168 double min = 0.0;
171 double p10 = 0.0;
172 double p50 = 0.0;
173 double p90 = 0.0;
174 double max = 0.0;
175 double ratio = 0.0;
176
180
188 double ltsWork = 0.0;
189
190 int count = 0;
195};
196
213[[nodiscard]] QVector<double> computeCellLchar(const MeshResult &mesh);
214
230[[nodiscard]] CflStats computeCflStats(const MeshResult &mesh, int ltsTiers = 4);
231
242 int faces = 0;
243 double ratioMax = 1.0;
244 double ratioP50 = 1.0;
245 double ratioP95 = 1.0;
247 int ratioHistogram[6] = {0, 0, 0, 0, 0, 0};
250 double orthoMedianDeg = 0.0;
251 double orthoMaxDeg = 0.0;
252 double minAngleDeg = 180.0;
258 int triangles = 0, quads = 0;
259};
260
272[[nodiscard]] GradingStats computeGradingStats(const MeshResult &mesh);
273
274} // namespace mesh
275
276#endif // OPENSWMMVIS_MESH_MESHCELLSTATS_H
value types for the 2D mesh generator.
The Qt-facing MeshKit API (meshkit::core_qt, meshkit::model_qt, meshkit::io_qt): mesh value types and...
CellAreaStats computeCellAreaStats(const MeshResult &mesh)
Summarize unsigned fan areas of all index-valid triangle and quad rows.
Definition meshcellstats.cpp:172
QPointF cellCentroid(const MeshResult &mesh, int cell)
Compute the planar area centroid using the shared cell fan geometry.
Definition meshcellstats.cpp:66
GradingStats computeGradingStats(const MeshResult &mesh)
Summarize adjacent-cell size ratios, face orthogonality and minimum cell corner angles.
Definition meshcellstats.cpp:400
double triangleArea(const MeshResult &mesh, int tri)
Measure positive fan area for a triangle or quadrilateral cell.
Definition meshcellstats.cpp:54
QuadStats computeQuadStats(const MeshResult &mesh)
Summarize quad angles, quality, bed twist and interior quad-only vertex valence.
Definition meshcellstats.cpp:76
QVector< double > computeCellLchar(const MeshResult &mesh)
Estimate the engine-style CFL characteristic length from cell geometry and interior faces.
Definition meshcellstats.cpp:259
QPair< int, int > EdgeVertexPair
Undirected mesh edge, as (min, max) vertex indices.
Definition meshcellstats.h:122
QHash< EdgeVertexPair, QVector< int > > buildEdgeTriangles(const MeshResult &mesh)
Build an owned undirected edge-to-incident-cell adjacency map.
Definition meshcellstats.cpp:243
CflStats computeCflStats(const MeshResult &mesh, int ltsTiers=4)
Summarize positive geometric CFL lengths and a uniform-depth local-timestep work proxy.
Definition meshcellstats.cpp:337
Min / max / mean / median of cell areas, triangles and quads (project CRS units²).
Definition meshcellstats.h:27
double mean
Arithmetic mean of the measured cell areas; 0 when count == 0.
Definition meshcellstats.h:30
double median
Median area; even counts average the two middle values.
Definition meshcellstats.h:31
int count
Cells measured (triangles and quads); 0 = stats invalid.
Definition meshcellstats.h:32
double min
Smallest measured cell area (triangles and quads); 0 when count == 0.
Definition meshcellstats.h:28
double max
Largest measured cell area; 0 when count == 0.
Definition meshcellstats.h:29
The 2D marcher's CFL characteristic length, per cell and summarised.
Definition meshcellstats.h:167
int impliedTiers
Tiers local timestepping would need to cover the spread, versus the project's LTS_TIERS (default 4,...
Definition meshcellstats.h:179
double p50
Median L_char by the same nearest-index rule (not averaged).
Definition meshcellstats.h:172
double p10
10th percentile of the positive L_char samples: the sorted sample at index round(0....
Definition meshcellstats.h:171
double max
Largest positive L_char.
Definition meshcellstats.h:174
double ratio
p50 / min. Reportable, not a gate — see ltsWork.
Definition meshcellstats.h:175
int count
Cells measured; 0 = stats invalid.
Definition meshcellstats.h:190
int isolatedCells
No interior face; used the 2A/xi_max fallback.
Definition meshcellstats.h:194
int interiorFaces
Edges shared by exactly two index-valid cells (boundary and non-manifold edges excluded); left 0 when...
Definition meshcellstats.h:193
double p90
90th percentile L_char by the same nearest-index rule.
Definition meshcellstats.h:173
double min
The cell that sets dt0.
Definition meshcellstats.h:168
double ltsWork
Work proxy: relative marcher cost per unit simulated time at uniform depth, (1/min) * SUM_t 2^-tier(t...
Definition meshcellstats.h:188
Size-grading and shape gates (workplans/MESH_OVERHAUL_PLAN_2026-09-29.md §6).
Definition meshcellstats.h:241
int triangles
Three-vertex cells measured (valid indices, positive area and longest edge).
Definition meshcellstats.h:258
double ratioP50
Median ratio: sorted element at index faces / 2 (upper middle).
Definition meshcellstats.h:244
int quads
Four-vertex cells measured under the same validity rule.
Definition meshcellstats.h:258
int ratioHistogram[6]
Faces with ratio in (1.25·k-ish) bands: <=1.25, <=1.5, <=2, <=3, <=4, >4.
Definition meshcellstats.h:247
double ratioP95
Sorted element at floor(0.95 * faces), capped at the last.
Definition meshcellstats.h:245
double ratioMax
Largest longest-edge ratio (>= 1) across an interior face.
Definition meshcellstats.h:243
double orthoMaxDeg
Largest non-orthogonality (degrees); 0 when none sampled.
Definition meshcellstats.h:251
int faces
Interior faces measured; 0 = stats invalid.
Definition meshcellstats.h:242
double minAngleDeg
Over triangles and quads (180 when no cell).
Definition meshcellstats.h:252
double orthoMedianDeg
Median non-orthogonality (degrees, upper middle) over faces whose edge and centroid connector both ha...
Definition meshcellstats.h:250
int cellsBelow10Deg
Cells with a corner under 10°.
Definition meshcellstats.h:253
Result of MeshGenerator::generate.
Definition meshresult.h:203
Quadrilateral-cell statistics (workplans/TRI_QUAD_MESHING_PLAN §5): count, interior-angle range and b...
Definition meshcellstats.h:71
int nonConvex
Quads failing the convexity test.
Definition meshcellstats.h:84
double maxAspect
max over quads of opposite-side-mean ratio.
Definition meshcellstats.h:83
double minAngleDeg
Smallest interior corner angle (0 when count == 0).
Definition meshcellstats.h:73
int count
Quads with valid vertex ids.
Definition meshcellstats.h:72
double maxNonPlanarity
Largest bed twist |z0 - z1 + z2 - z3| / 4 over the quads — the residual of the least-squares plane th...
Definition meshcellstats.h:78
int irregularVertices
Interior vertices (not on a boundaryEdge) touched only by quads with valence != 4.
Definition meshcellstats.h:85
double medianRectangularity
median of 1 - max|theta-90|/90.
Definition meshcellstats.h:82
int sjHistogram[10]
Histogram of scaled Jacobian in 10 bins over [0,1] (bin 9 = [0.9,1]).
Definition meshcellstats.h:88
double minScaledJacobian
min over quads of min_i sin(theta_i).
Definition meshcellstats.h:81
double maxAngleDeg
Largest interior corner angle.
Definition meshcellstats.h:74