Loading...
Searching...
No Matches
sizefield.h
Go to the documentation of this file.
1
46
47#ifndef OPENSWMMVIS_MESH_SIZEFIELD_H
48#define OPENSWMMVIS_MESH_SIZEFIELD_H
49
50#include "mesh/meshgenerator.h"
51
52#include <QRectF>
53#include "meshkit/sizefield.hpp"
54#include <QVector>
55
56namespace mesh
57{
58
62 bool footprintBounds = false;
66 double nearSize = 0.0;
67
73 double gradation = 0.25;
74
78 double areaFloor = 0.0;
79
83 qint64 maxGridCells = 4'000'000;
84
85 // ── Overhaul additions (MESH_OVERHAUL_PLAN_2026-09-29.md §3 Stage 2) ──
88 double maxSize = 0.0;
93 std::function<double(double, double)> terrainSizeAt;
95 struct Region {
98 QPolygonF ring;
101 double h = 0.0;
102 };
103
105 QVector<Region> regions;
106 QVector<Region> terrainRegions;
107
116 QVector<QVector<QPointF>> steps;
117};
118
127{
128public:
142 // Conservative bound on every bilinear target over this rectangle. Zero
143 // means unbounded/invalid field. Includes all interpolation support nodes.
144 double minimumSizeInBox(const QRectF &) const;
145 double minimumTerrainSizeInBox(const QRectF &) const;
146
180 bool build(const QRectF &bbox, const QVector<ConstraintSegment> &segs,
181 const QVector<QVector<QPointF>> &rings, const QVector<SteinerPoint> &pts,
182 const SizeFieldOptions &opt);
183
199 [[nodiscard]] double targetAreaAt(double x, double y) const;
217 [[nodiscard]] double sizeAt(double x, double y) const;
225 [[nodiscard]] bool isValid() const { return m_native.isValid(); }
233 [[nodiscard]] bool hasSizeBound() const { return m_native.hasSizeBound(); }
240 [[nodiscard]] double pitch() const { return m_native.pitch(); }
246 [[nodiscard]] int cols() const { return m_native.cols(); }
252 [[nodiscard]] int rows() const { return m_native.rows(); }
253
267 [[nodiscard]] double distanceAt(double x, double y) const;
268
269private:
271};
272}
273#endif
Distance-to-feature field sampled as a max-area function.
Definition sizefield.h:127
double pitch() const
Read the background grid spacing retained by the latest layout attempt.
Definition sizefield.h:240
bool build(const QRectF &bbox, const QVector< ConstraintSegment > &segs, const QVector< QVector< QPointF > > &rings, const QVector< SteinerPoint > &pts, const SizeFieldOptions &opt)
Replace this field with sampled feature-distance, terrain and region size bounds.
Definition sizefield.cpp:6
int cols() const
Read the number of grid columns.
Definition sizefield.h:246
double distanceAt(double x, double y) const
Bilinearly read the approximate chamfer distance-to-feature grid.
Definition sizefield.cpp:11
double sizeAt(double x, double y) const
Bilinearly read the combined gradation-relaxed target edge length.
Definition sizefield.cpp:10
double targetAreaAt(double x, double y) const
Read the sampled equilateral-triangle area cap at a mesh coordinate.
Definition sizefield.cpp:9
double minimumTerrainSizeInBox(const QRectF &) const
Includes finer directional source bounds without changing nominal sizing.
Definition sizefield.cpp:8
double minimumSizeInBox(const QRectF &) const
Smallest target edge length any point of a rectangle can read, for footprint (verified) sizing.
Definition sizefield.cpp:7
bool isValid() const
Check whether stored grid dimensions are positive.
Definition sizefield.h:225
int rows() const
Read the number of grid rows.
Definition sizefield.h:252
bool hasSizeBound() const
Check whether the valid field reports a positive size at its first grid-center coordinate.
Definition sizefield.h:233
Distance-to-feature field sampled as a max-area function.
Definition sizefield.hpp:126
2D mesh generator (workplans/MESH_TRIANGLE_ENGINE_PLAN_2026-09-30.md): a constrained Delaunay triangu...
The Qt-facing MeshKit API (meshkit::core_qt, meshkit::model_qt, meshkit::io_qt): mesh value types and...
Graded element sizing for Delaunay refinement (MESH_MINSIZE_ENFORCEMENT_V2_AND_GRADING_PLAN_2026-09-0...
Polygon overrides: inside ring the size is min'd with h.
Definition sizefield.h:95
double h
Size cap in mesh units.
Definition sizefield.h:101
QPolygonF ring
Implicitly closed polygon.
Definition sizefield.h:98
Policy for SizeField::build().
Definition sizefield.h:61
std::function< double(double, double)> terrainSizeAt
Terrain-error size bound in mesh units at a mesh coordinate (mesh::TerrainSizeField through the worke...
Definition sizefield.h:93
QVector< QVector< QPointF > > steps
Terrain break lines (mesh coordinates) that the generator lays mesh edges along (MESH_TRIANGLE_ENGINE...
Definition sizefield.h:116
qint64 maxGridCells
Nominal background-grid cell budget.
Definition sizefield.h:83
double maxSize
Upper clamp on the size (h_max, map units); 0 = unbounded.
Definition sizefield.h:88
double nearSize
Element size (edge length, map units) AT a feature.
Definition sizefield.h:66
double gradation
Lipschitz slope g: how fast the target size may grow per unit of distance from a feature.
Definition sizefield.h:73
double areaFloor
Refinement floor A_min (map units², from MinSizePolicy).
Definition sizefield.h:78
QVector< Region > regions
Size caps applied at grid centres inside each ring, and by bounding box in SizeField::minimumSizeInBo...
Definition sizefield.h:105
QVector< Region > terrainRegions
Finer prescribed directional scales; footprint terrain queries only.
Definition sizefield.h:106
bool footprintBounds
Build a compact min pyramid for verified sizing.
Definition sizefield.h:62