Loading...
Searching...
No Matches
terrainpolicy.hpp
Go to the documentation of this file.
1// SPDX-License-Identifier: Apache-2.0
2#pragma once
3#include <algorithm>
4#include <cmath>
5#include <limits>
6
7namespace meshkit
8{
24
25// Immutable physical policy. Reference size and h share an XY unit; tolerances share a Z unit. h is the smallest prescribed
26// target over the entire affected footprint. Zero h means unbounded size.
27// Missing/invalid values return NaN, never an implicit relaxed tolerance.
41 double referenceSize = 10;
43 double minimumTolerance = 0;
46 double maximumTolerance = 0; // Zero inherits the resolved reference tolerance.
47
53 bool valid() const
54 {
57 std::isfinite(referenceSize) && referenceSize > 0 &&
58 std::isfinite(minimumTolerance) && minimumTolerance >= 0 &&
59 std::isfinite(maximumTolerance) && maximumTolerance >= 0 &&
61 }
62
71 double tolerance(double referenceTolerance, double h) const
72 {
73 const double unknown = std::numeric_limits<double>::quiet_NaN();
74 if (!valid() || !(referenceTolerance > 0) || !std::isfinite(referenceTolerance) ||
75 !std::isfinite(h) || h < 0)
76 return unknown;
78 return referenceTolerance;
79 const double cap = maximumTolerance > 0 ? maximumTolerance : referenceTolerance;
80 if (minimumTolerance > cap)
81 return unknown;
82 if (h == 0)
83 return cap;
84 const long double scaled = static_cast<long double>(referenceTolerance) * h / referenceSize;
85 return double(std::clamp(scaled, static_cast<long double>(minimumTolerance),
86 static_cast<long double>(cap)));
87 }
88};
89
90// Ordering heuristic only: maximum normal departure weighted by sampling scale
91// relative to the immutable target. All removal gates remain separate.
101inline double resolutionRemovalImportance(double flatness, double actualSize, double targetSize)
102{
103 if (!std::isfinite(flatness) || !(actualSize > 0) || !std::isfinite(actualSize) ||
104 !(targetSize > 0) || !std::isfinite(targetSize))
105 return std::numeric_limits<double>::infinity();
106 return std::sqrt(std::max(0., 2 * (1 - std::clamp(flatness, -1., 1.)))) *
107 (actualSize / targetSize);
108}
109}
The Qt-free MeshKit library: job events and progress (meshkit::runtime), the neutral mesh model,...
double resolutionRemovalImportance(double flatness, double actualSize, double targetSize)
Rank a vertex for resolution-aware coarsening; lower values are tried first.
Definition terrainpolicy.hpp:101
CoarseningOrder
Order in which terrain coarsening tries to remove free vertices.
Definition terrainpolicy.hpp:10
@ LegacyFlatness
Flattest vertex star first (smallest facet-normal spread), tile by tile in spatial (Morton) order.
Definition terrainpolicy.hpp:10
@ ResolutionAware
Lowest resolutionRemovalImportance() first, then lowest actual/target size ratio, tile by tile; the r...
Definition terrainpolicy.hpp:10
TerrainToleranceMode
How TerrainTolerancePolicy::tolerance() derives a footprint's terrain tolerance.
Definition terrainpolicy.hpp:19
@ TargetSize
Scale the reference tolerance linearly with the footprint's target size h.
Definition terrainpolicy.hpp:19
@ Constant
Use the reference tolerance everywhere.
Definition terrainpolicy.hpp:19
Maps a reference terrain tolerance and a footprint target size to the tolerance used there.
Definition terrainpolicy.hpp:36
bool valid() const
Check the mode and the finite, nonnegative and ordered numeric fields.
Definition terrainpolicy.hpp:53
double tolerance(double referenceTolerance, double h) const
Resolve the terrain tolerance for one footprint.
Definition terrainpolicy.hpp:71
double minimumTolerance
Lower clamp, in Z units, for TargetSize mode; finite and >= 0 (0 = no floor).
Definition terrainpolicy.hpp:43
TerrainToleranceMode mode
Tolerance mode; Constant (the default) ignores the other fields except for validation.
Definition terrainpolicy.hpp:38
double referenceSize
Target size, in XY units, at which the scaled tolerance equals the reference tolerance; must be posit...
Definition terrainpolicy.hpp:41
double maximumTolerance
Upper clamp, in Z units, for TargetSize mode; finite and >= 0, and >= minimumTolerance unless 0.
Definition terrainpolicy.hpp:46