Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
using Aetheris.Kernel.Core.Geometry;
using Aetheris.Kernel.Core.Geometry.Curves;
using Aetheris.Kernel.Core.Geometry.Surfaces;
using Aetheris.Kernel.Core.Math;
using Aetheris.Kernel.Core.Results;
using Aetheris.Kernel.Core.Topology;
namespace Aetheris.Kernel.Core.Brep.Features;
/// <summary>
/// Bounded materializer for the composition of the existing rectangular top-boundary
/// chamfer or constant-radius fillet family and disjoint, world-Z through-hole cylinders. It is deliberately
/// a final-plan consumer: callers must have already admitted the host, hole, and
/// semantic finish selections. It performs no topology search or feature recovery.
/// </summary>
public sealed record CombinedTopBoundaryEdgeFinishThroughHole(
string FeatureId,
double CenterX,
double CenterY,
double Radius,
double? CounterboreRadius = null,
double? CounterboreDepth = null,
double? CountersinkRadius = null,
double? CountersinkAngleDegrees = null)
{
public bool IsCounterbore => CounterboreRadius is not null;
public bool IsCountersink => CountersinkRadius is not null;
public double EntryRadius => CountersinkRadius ?? CounterboreRadius ?? Radius;
public double? ReliefDepth => CounterboreDepth ?? (CountersinkRadius is { } radius && CountersinkAngleDegrees is { } angle
? (radius - Radius) / System.Math.Tan(angle * System.Math.PI / 360d) : null);
public double RemovedVolume(double height) => System.Math.PI * Radius * Radius * height
+ (IsCounterbore ? System.Math.PI * (EntryRadius * EntryRadius - Radius * Radius) * ReliefDepth!.Value : 0d)
+ (IsCountersink ? System.Math.PI / 3d * (EntryRadius - Radius) * (EntryRadius + 2d * Radius) * ReliefDepth!.Value : 0d);
}
public enum TopBoundaryEdgeFinishKind { Chamfer, Fillet, None }
public sealed record CombinedTopBoundaryEdgeFinishThroughHolePlan(
string PlanId,
string? ParentHostPlanId,
IReadOnlyList<string> AppliedFeatureIds,
double Width,
double Depth,
double ZMin,
double ZMax,
double FinishSize,
IReadOnlyList<CombinedTopBoundaryEdgeFinishThroughHole> Holes,
TopBoundaryEdgeFinishKind FinishKind = TopBoundaryEdgeFinishKind.Chamfer)
{
public double AnalyticVolume
{
get
{
var height = ZMax - ZMin;
var bottomArea = Width * Depth;
// Integrate (Width-2t)(Depth-2t). Rectangular offsets are not
// homothetic pyramids unless Width == Depth.
var finishedHost = bottomArea * height - (Width + Depth) * FinishSize * FinishSize
+ 4d / 3d * FinishSize * FinishSize * FinishSize;
if (FinishKind == TopBoundaryEdgeFinishKind.Fillet)
{
// Integrate the retained rectangle (W-2s)(D-2s), where
// s(z)=r-sqrt(r*r-z*z) over the top r of the stock.
// The four equal-radius cylinder junctions use exact ellipse seams.
var r = FinishSize;
var section = r * r * (1d - System.Math.PI / 4d);
var overlap = r * r * r * (5d / 3d - System.Math.PI / 2d);
finishedHost = bottomArea * height - 2d * (Width + Depth) * section + 4d * overlap;
}
var removed = Holes.Sum(h => h.RemovedVolume(height));
return finishedHost - removed;
}
}
}
public static class CombinedTopBoundaryEdgeFinishThroughHoleBuilder
{
private const double Tol = 1e-9;
public static KernelResult<BrepBody> Build(CombinedTopBoundaryEdgeFinishThroughHolePlan plan)
{
ArgumentNullException.ThrowIfNull(plan);
var validation = Validate(plan);
if (!validation.IsSuccess)
{
return KernelResult<BrepBody>.Failure(validation.Diagnostics);
}
var z0 = plan.ZMin;
var z1 = plan.ZMax - plan.FinishSize;
var z2 = plan.ZMax;
var x0 = -plan.Width / 2d;
var x1 = plan.Width / 2d;
var y0 = -plan.Depth / 2d;
var y1 = plan.Depth / 2d;
var d = plan.FinishSize;
var bottom = new[] { new Point3D(x0, y0, z0), new Point3D(x1, y0, z0), new Point3D(x1, y1, z0), new Point3D(x0, y1, z0) };
var shoulder = new[] { new Point3D(x0, y0, z1), new Point3D(x1, y0, z1), new Point3D(x1, y1, z1), new Point3D(x0, y1, z1) };
var top = new[] { new Point3D(x0 + d, y0 + d, z2), new Point3D(x1 - d, y0 + d, z2), new Point3D(x1 - d, y1 - d, z2), new Point3D(x0 + d, y1 - d, z2) };
return BuildWithHoleTopology(plan, bottom, shoulder, top);
}
private static KernelResult<BrepBody> BuildWithHoleTopology(
CombinedTopBoundaryEdgeFinishThroughHolePlan plan,
Point3D[] bottom,
Point3D[] shoulder,
Point3D[] top)
{
var b = new TopologyBuilder();
var unfinished = plan.FinishKind == TopBoundaryEdgeFinishKind.None;
var vertices = Enumerable.Range(0, unfinished ? 8 : 12).Select(_ => b.AddVertex()).ToArray();
var bottomEdges = Ring(b, vertices, 0);
var shoulderEdges = Ring(b, vertices, 4);
var topEdges = unfinished ? shoulderEdges : Ring(b, vertices, 8);
var lowerEdges = Enumerable.Range(0, 4).Select(i => b.AddEdge(vertices[i], vertices[4 + i])).ToArray();
var finishEdges = Enumerable.Range(0, unfinished ? 0 : 4).Select(i => b.AddEdge(vertices[4 + i], vertices[8 + i])).ToArray();
var holes = plan.Holes.Select(h =>
{
// The periodic circle and its longitudinal seam share endpoint identities.
// Coincident but distinct seam/circle vertices produce invalid STEP wires.
var seamTop = b.AddVertex(); var seamBottom = b.AddVertex();
if (h.IsCountersink)
{
// The cone and shaft share one throat circle and seam endpoint.
var throat = b.AddVertex(); var throatCircle = b.AddEdge(throat, throat);
return new HoleTopology(h, seamTop, seamBottom, throat, throat,
b.AddEdge(seamTop, seamTop), b.AddEdge(seamBottom, seamBottom), throatCircle, throatCircle,
b.AddEdge(seamTop, throat), b.AddEdge(throat, seamBottom));
}
if (!h.IsCounterbore)
return new HoleTopology(h, seamTop, seamBottom, null, null,
b.AddEdge(seamTop, seamTop), b.AddEdge(seamBottom, seamBottom), null, null, b.AddEdge(seamTop, seamBottom), null);
var shoulderOuter = b.AddVertex(); var shoulderInner = b.AddVertex();
return new HoleTopology(h, seamTop, seamBottom, shoulderOuter, shoulderInner,
b.AddEdge(seamTop, seamTop), b.AddEdge(seamBottom, seamBottom),
b.AddEdge(shoulderOuter, shoulderOuter), b.AddEdge(shoulderInner, shoulderInner),
b.AddEdge(seamTop, shoulderOuter), b.AddEdge(shoulderInner, seamBottom));
}).ToArray();
var bottomLoops = new List<LoopId> { AddLoop(b, bottomEdges.Select(Forward).ToArray()) };
var topLoops = new List<LoopId> { AddLoop(b, topEdges.Select(Forward).ToArray()) };
foreach (var hole in holes)
{
bottomLoops.Add(AddLoop(b, [Reversed(hole.BottomCircle)]));
topLoops.Add(AddLoop(b, [Forward(hole.TopCircle)]));
}
var bottomFace = b.AddFace(bottomLoops);
var topFace = b.AddFace(topLoops);
var lowerFaces = new FaceId[4];
var finishFaces = new FaceId[unfinished ? 0 : 4];
for (var i = 0; i < 4; i++)
{
var next = (i + 1) % 4;
lowerFaces[i] = b.AddFace([AddLoop(b, [Forward(bottomEdges[i]), Forward(lowerEdges[next]), Reversed(shoulderEdges[i]), Reversed(lowerEdges[i])])]);
if (!unfinished) finishFaces[i] = b.AddFace([AddLoop(b, [Forward(shoulderEdges[i]), Forward(finishEdges[next]), Reversed(topEdges[i]), Reversed(finishEdges[i])])]);
}
var holeFaces = new List<(HoleTopology Hole, FaceId Face, double Radius, double ZMin, double ZMax, bool Cone)>();
var shoulderFaces = new List<(HoleTopology Hole, FaceId Face)>();
foreach (var hole in holes)
{
if (hole.Hole.IsCountersink)
{
var throatZ = plan.ZMax - hole.Hole.ReliefDepth!.Value;
var cone = b.AddFace([AddLoop(b, [Forward(hole.UpperSeam), Forward(hole.ShoulderInnerCircle!.Value), Reversed(hole.UpperSeam), Reversed(hole.TopCircle)])]);
var shaft = b.AddFace([AddLoop(b, [Forward(hole.LowerSeam!.Value), Forward(hole.BottomCircle), Reversed(hole.LowerSeam.Value), Reversed(hole.ShoulderInnerCircle.Value)])]);
holeFaces.Add((hole, cone, hole.Hole.Radius, throatZ, plan.ZMax, true));
holeFaces.Add((hole, shaft, hole.Hole.Radius, plan.ZMin, throatZ, false));
continue;
}
if (!hole.Hole.IsCounterbore)
{
var face=b.AddFace([AddLoop(b, [Forward(hole.UpperSeam), Forward(hole.BottomCircle), Reversed(hole.UpperSeam), Reversed(hole.TopCircle)])]);
holeFaces.Add((hole,face,hole.Hole.Radius,plan.ZMin,plan.ZMax,false));
continue;
}
var shoulderZ=plan.ZMax-hole.Hole.CounterboreDepth!.Value;
var boreFace=b.AddFace([AddLoop(b,[Forward(hole.UpperSeam),Forward(hole.ShoulderOuterCircle!.Value),Reversed(hole.UpperSeam),Reversed(hole.TopCircle)])]);
var shoulderFace=b.AddFace([AddLoop(b,[Reversed(hole.ShoulderOuterCircle.Value)]),AddLoop(b,[Forward(hole.ShoulderInnerCircle!.Value)])]);
var shaftFace=b.AddFace([AddLoop(b,[Forward(hole.LowerSeam!.Value),Forward(hole.BottomCircle),Reversed(hole.LowerSeam.Value),Reversed(hole.ShoulderInnerCircle.Value)])]);
holeFaces.Add((hole,boreFace,hole.Hole.CounterboreRadius!.Value,shoulderZ,plan.ZMax,false));
shoulderFaces.Add((hole,shoulderFace));
holeFaces.Add((hole,shaftFace,hole.Hole.Radius,plan.ZMin,shoulderZ,false));
}
var shell = b.AddShell([bottomFace, topFace, .. lowerFaces, .. finishFaces, .. holeFaces.Select(x=>x.Face), .. shoulderFaces.Select(x=>x.Face)]);
b.AddBody([shell]);
var geometry = new BrepGeometryStore();
var bindings = new BrepBindingModel();
var points = (unfinished ? bottom.Concat(shoulder) : bottom.Concat(shoulder).Concat(top)).ToArray();
var vertexPoints = vertices.Select((id, index) => new KeyValuePair<VertexId, Point3D>(id, points[index])).ToDictionary(x => x.Key, x => x.Value);
var edgeCurve = 1;
foreach (var edge in bottomEdges.Concat(shoulderEdges).Concat(topEdges).Concat(lowerEdges).Concat(finishEdges).Distinct())
{
var start = vertexPoints[b.Model.Edges.Single(e => e.Id == edge).StartVertexId];
var end = vertexPoints[b.Model.Edges.Single(e => e.Id == edge).EndVertexId];
var vector = end - start;
var id = new CurveGeometryId(edgeCurve++);
var corner = Array.IndexOf(finishEdges, edge);
if (plan.FinishKind == TopBoundaryEdgeFinishKind.Fillet && corner >= 0)
{
var r = plan.FinishSize;
var sx = System.Math.Sign(shoulder[corner].X);
var sy = System.Math.Sign(shoulder[corner].Y);
var center = new Point3D(top[corner].X, top[corner].Y, shoulder[corner].Z);
var diagonal = Direction3D.Create(new Vector3D(sx, sy, 0));
// normal x diagonal = +Z, so [0,pi/2] runs shoulder -> top.
var normal = Direction3D.Create(new Vector3D(sy, -sx, 0));
geometry.AddCurve(id, CurveGeometry.FromEllipse(new Ellipse3Curve(center, normal, r * System.Math.Sqrt(2d), r, diagonal)));
bindings.AddEdgeBinding(new EdgeGeometryBinding(edge, id, new ParameterInterval(0d, System.Math.PI / 2d)));
}
else
{
geometry.AddCurve(id, CurveGeometry.FromLine(new Line3Curve(start, Direction3D.Create(vector))));
bindings.AddEdgeBinding(new EdgeGeometryBinding(edge, id, new ParameterInterval(0d, vector.Length)));
}
}
var zAxis = Direction3D.Create(new Vector3D(0d, 0d, 1d));
var xAxis = Direction3D.Create(new Vector3D(1d, 0d, 0d));
var surface = 1;
BindPlane(bottomFace, bottom[0], new Vector3D(0d, 1d, 0d), new Vector3D(1d, 0d, 0d));
BindPlane(topFace, top[0], new Vector3D(1d, 0d, 0d), new Vector3D(0d, 1d, 0d));
for (var i = 0; i < 4; i++)
{
var next = (i + 1) % 4;
BindPlane(lowerFaces[i], bottom[i], bottom[next] - bottom[i], shoulder[i] - bottom[i]);
if (unfinished) continue;
if (plan.FinishKind == TopBoundaryEdgeFinishKind.Chamfer)
BindPlane(finishFaces[i], shoulder[i], shoulder[next] - shoulder[i], top[i] - shoulder[i]);
else
{
var tangent = Direction3D.Create(shoulder[next] - shoulder[i]);
var outward = Direction3D.Create(tangent.ToVector().Cross(new Vector3D(0, 0, 1)));
var center = new Point3D(top[i].X, top[i].Y, shoulder[i].Z);
var id = new SurfaceGeometryId(surface++);
geometry.AddSurface(id, SurfaceGeometry.FromCylinder(new CylinderSurface(center, tangent, plan.FinishSize, outward)));
bindings.AddFaceBinding(new FaceGeometryBinding(finishFaces[i], id));
}
}
foreach (var hole in holes)
{
var topCurve = new CurveGeometryId(edgeCurve++); var bottomCurve = new CurveGeometryId(edgeCurve++); var seamCurve = new CurveGeometryId(edgeCurve++);
var centerTop = new Point3D(hole.Hole.CenterX, hole.Hole.CenterY, plan.ZMax);
var centerBottom = new Point3D(hole.Hole.CenterX, hole.Hole.CenterY, plan.ZMin);
geometry.AddCurve(topCurve, CurveGeometry.FromCircle(new Circle3Curve(centerTop, zAxis, hole.Hole.EntryRadius, xAxis)));
geometry.AddCurve(bottomCurve, CurveGeometry.FromCircle(new Circle3Curve(centerBottom, zAxis, hole.Hole.Radius, xAxis)));
var upperZMin=hole.Hole.ReliefDepth is { } reliefDepth ? plan.ZMax-reliefDepth : plan.ZMin;
var seamStart = new Point3D(hole.Hole.CenterX + (hole.Hole.IsCountersink ? hole.Hole.Radius : hole.Hole.EntryRadius), hole.Hole.CenterY, upperZMin);
var seamVector = new Vector3D(hole.Hole.IsCountersink ? hole.Hole.EntryRadius-hole.Hole.Radius : 0d, 0d, plan.ZMax-upperZMin);
geometry.AddCurve(seamCurve, CurveGeometry.FromLine(new Line3Curve(seamStart, hole.Hole.IsCountersink ? Direction3D.Create(seamVector) : zAxis)));
bindings.AddEdgeBinding(new EdgeGeometryBinding(hole.TopCircle, topCurve, new ParameterInterval(0d, 2d * System.Math.PI)));
bindings.AddEdgeBinding(new EdgeGeometryBinding(hole.BottomCircle, bottomCurve, new ParameterInterval(0d, 2d * System.Math.PI)));
bindings.AddEdgeBinding(new EdgeGeometryBinding(hole.UpperSeam, seamCurve, new ParameterInterval(0d, hole.Hole.IsCountersink ? seamVector.Length : plan.ZMax-upperZMin), OrientedEdgeSense: false));
vertexPoints[hole.SeamTopVertex] = new Point3D(hole.Hole.CenterX + hole.Hole.EntryRadius, hole.Hole.CenterY, plan.ZMax);
vertexPoints[hole.SeamBottomVertex] = new Point3D(hole.Hole.CenterX + hole.Hole.Radius, hole.Hole.CenterY, plan.ZMin);
if (hole.Hole.IsCountersink)
{
var throatCurve = new CurveGeometryId(edgeCurve++); var lowerSeamCurve = new CurveGeometryId(edgeCurve++);
geometry.AddCurve(throatCurve, CurveGeometry.FromCircle(new Circle3Curve(new(hole.Hole.CenterX, hole.Hole.CenterY, upperZMin), zAxis, hole.Hole.Radius, xAxis)));
geometry.AddCurve(lowerSeamCurve, CurveGeometry.FromLine(new Line3Curve(new(hole.Hole.CenterX+hole.Hole.Radius, hole.Hole.CenterY, plan.ZMin), zAxis)));
bindings.AddEdgeBinding(new(hole.ShoulderInnerCircle!.Value, throatCurve, new(0d, 2d*System.Math.PI)));
bindings.AddEdgeBinding(new(hole.LowerSeam!.Value, lowerSeamCurve, new(0d, upperZMin-plan.ZMin), OrientedEdgeSense: false));
vertexPoints[hole.ShoulderInnerVertex!.Value] = new(hole.Hole.CenterX+hole.Hole.Radius, hole.Hole.CenterY, upperZMin);
}
if (hole.Hole.IsCounterbore)
{
var shoulderZ=upperZMin;
var outerCurve=new CurveGeometryId(edgeCurve++);var innerCurve=new CurveGeometryId(edgeCurve++);var lowerSeamCurve=new CurveGeometryId(edgeCurve++);
geometry.AddCurve(outerCurve,CurveGeometry.FromCircle(new Circle3Curve(new(hole.Hole.CenterX,hole.Hole.CenterY,shoulderZ),zAxis,hole.Hole.CounterboreRadius!.Value,xAxis)));
geometry.AddCurve(innerCurve,CurveGeometry.FromCircle(new Circle3Curve(new(hole.Hole.CenterX,hole.Hole.CenterY,shoulderZ),zAxis,hole.Hole.Radius,xAxis)));
geometry.AddCurve(lowerSeamCurve,CurveGeometry.FromLine(new Line3Curve(new(hole.Hole.CenterX+hole.Hole.Radius,hole.Hole.CenterY,plan.ZMin),zAxis)));
bindings.AddEdgeBinding(new(hole.ShoulderOuterCircle!.Value,outerCurve,new(0,2d*System.Math.PI)));
bindings.AddEdgeBinding(new(hole.ShoulderInnerCircle!.Value,innerCurve,new(0,2d*System.Math.PI)));
bindings.AddEdgeBinding(new(hole.LowerSeam!.Value,lowerSeamCurve,new(0,shoulderZ-plan.ZMin), OrientedEdgeSense: false));
vertexPoints[hole.ShoulderOuterVertex!.Value]=new(hole.Hole.CenterX+hole.Hole.CounterboreRadius.Value,hole.Hole.CenterY,shoulderZ);
vertexPoints[hole.ShoulderInnerVertex!.Value]=new(hole.Hole.CenterX+hole.Hole.Radius,hole.Hole.CenterY,shoulderZ);
}
}
foreach(var wall in holeFaces)
{
var sid = new SurfaceGeometryId(surface++);
var origin = new Point3D(wall.Hole.Hole.CenterX, wall.Hole.Hole.CenterY, wall.ZMin);
geometry.AddSurface(sid, wall.Cone
? SurfaceGeometry.FromCone(new ConeSurface(origin, zAxis, wall.Radius, wall.Hole.Hole.CountersinkAngleDegrees!.Value * System.Math.PI / 360d, xAxis))
: SurfaceGeometry.FromCylinder(new CylinderSurface(origin, zAxis, wall.Radius, xAxis)));
bindings.AddFaceBinding(new(wall.Face,sid,IsAlignedWithSurface:false));
}
foreach(var shoulderBinding in shoulderFaces)BindPlane(shoulderBinding.Face,new(shoulderBinding.Hole.Hole.CenterX,shoulderBinding.Hole.Hole.CenterY,plan.ZMax-shoulderBinding.Hole.Hole.CounterboreDepth!.Value),new Vector3D(1,0,0),new Vector3D(0,1,0));
var body = new BrepBody(b.Model, geometry, bindings, vertexPoints);
var brepValidation = BrepBindingValidator.Validate(body, requireAllEdgeAndFaceBindings: true);
return brepValidation.IsSuccess ? KernelResult<BrepBody>.Success(body, brepValidation.Diagnostics) : KernelResult<BrepBody>.Failure(brepValidation.Diagnostics);
void BindPlane(FaceId face, Point3D origin, Vector3D u, Vector3D v)
{
var normal = Direction3D.Create(u.Cross(v));
var uAxis = Direction3D.Create(u);
var id = new SurfaceGeometryId(surface++);
geometry.AddSurface(id, SurfaceGeometry.FromPlane(new PlaneSurface(origin, normal, uAxis)));
bindings.AddFaceBinding(new FaceGeometryBinding(face, id));
}
}
private static KernelResult<bool> Validate(CombinedTopBoundaryEdgeFinishThroughHolePlan plan)
{
if (!Enum.IsDefined(plan.FinishKind)) return Failure("CombinedFeaturePlanChainInvalid: unknown top-boundary finish kind.");
if (!double.IsFinite(plan.Width) || !double.IsFinite(plan.Depth) || !double.IsFinite(plan.ZMin) || !double.IsFinite(plan.ZMax) || !double.IsFinite(plan.FinishSize)
|| plan.Width <= Tol || plan.Depth <= Tol || plan.ZMax - plan.ZMin <= Tol || (plan.FinishKind == TopBoundaryEdgeFinishKind.None ? plan.FinishSize != 0 : plan.FinishSize <= Tol)
|| 2d * plan.FinishSize >= plan.Width - Tol || 2d * plan.FinishSize >= plan.Depth - Tol || plan.FinishSize >= plan.ZMax - plan.ZMin - Tol)
return Failure("CombinedFeaturePlanChainInvalid: bounded top-boundary finish size must be positive, smaller than the stock height and smaller than half its width and depth.");
foreach (var hole in plan.Holes)
{
if ((hole.CounterboreRadius is null) != (hole.CounterboreDepth is null))
return Failure($"CombinedFeaturePlanChainInvalid: counterbore '{hole.FeatureId}' requires both radius and depth.");
if ((hole.CountersinkRadius is null) != (hole.CountersinkAngleDegrees is null) || hole.IsCounterbore && hole.IsCountersink)
return Failure($"CombinedFeaturePlanChainInvalid: countersink '{hole.FeatureId}' requires one entry radius and included angle, without counterbore fields.");
if (!double.IsFinite(hole.CenterX) || !double.IsFinite(hole.CenterY) || !double.IsFinite(hole.Radius) || hole.Radius <= Tol)
return Failure($"CombinedFeaturePlanChainInvalid: hole '{hole.FeatureId}' has invalid cylinder data.");
if (hole.IsCounterbore && (hole.CounterboreRadius is not { } cr || !double.IsFinite(cr) || hole.CounterboreDepth is not { } cd || !double.IsFinite(cd) || cr <= hole.Radius + Tol || cd <= Tol || hole.CounterboreDepth >= plan.ZMax-plan.ZMin-Tol))
return Failure($"CombinedFeaturePlanChainInvalid: counterbore '{hole.FeatureId}' has invalid relief dimensions.");
if (hole.IsCountersink && (hole.CountersinkRadius is not { } sr || !double.IsFinite(sr) || sr <= hole.Radius + Tol
|| hole.CountersinkAngleDegrees is not { } angle || !double.IsFinite(angle) || angle <= 0d || angle >= 180d
|| hole.ReliefDepth is not { } depth || !double.IsFinite(depth) || depth <= Tol || depth >= plan.ZMax-plan.ZMin-Tol))
return Failure($"CombinedFeaturePlanChainInvalid: countersink '{hole.FeatureId}' must have a finite relief entirely above a positive shaft span.");
if (System.Math.Abs(hole.CenterX) + hole.EntryRadius >= plan.Width / 2d - plan.FinishSize - Tol || System.Math.Abs(hole.CenterY) + hole.EntryRadius >= plan.Depth / 2d - plan.FinishSize - Tol)
return Failure($"CombinedFeatureInteractionUnsupported: hole '{hole.FeatureId}' intersects or splits the selected outer top-boundary finish band; move the hole inward or reduce its entry radius or the finish size.");
}
for (var i = 0; i < plan.Holes.Count; i++)
for (var j = i + 1; j < plan.Holes.Count; j++)
{
var a = plan.Holes[i]; var b = plan.Holes[j];
if (System.Math.Sqrt(System.Math.Pow(a.CenterX - b.CenterX, 2d) + System.Math.Pow(a.CenterY - b.CenterY, 2d)) <= a.EntryRadius + b.EntryRadius + Tol)
return Failure($"CombinedFeatureInteractionUnsupported: holes '{a.FeatureId}' and '{b.FeatureId}' overlap.");
}
return KernelResult<bool>.Success(true);
static KernelResult<bool> Failure(string message) => KernelResult<bool>.Failure([new Aetheris.Kernel.Core.Diagnostics.KernelDiagnostic(Aetheris.Kernel.Core.Diagnostics.KernelDiagnosticCode.ValidationFailed, Aetheris.Kernel.Core.Diagnostics.KernelDiagnosticSeverity.Error, message, "CombinedTopBoundaryEdgeFinishThroughHole")]);
}
private static EdgeId[] Ring(TopologyBuilder builder, VertexId[] vertices, int offset) => Enumerable.Range(0, 4).Select(i => builder.AddEdge(vertices[offset + i], vertices[offset + ((i + 1) % 4)])).ToArray();
private static LoopId AddLoop(TopologyBuilder builder, IReadOnlyList<Use> uses)
{
var loop = builder.AllocateLoopId(); var coedges = new CoedgeId[uses.Count];
for (var i = 0; i < uses.Count; i++) coedges[i] = builder.AllocateCoedgeId();
for (var i = 0; i < uses.Count; i++) builder.AddCoedge(new Coedge(coedges[i], uses[i].Edge, loop, coedges[(i + 1) % uses.Count], coedges[(i + uses.Count - 1) % uses.Count], uses[i].Reversed));
builder.AddLoop(new Loop(loop, coedges)); return loop;
}
private static Use Forward(EdgeId edge) => new(edge, false);
private static Use Reversed(EdgeId edge) => new(edge, true);
private readonly record struct Use(EdgeId Edge, bool Reversed);
private sealed record HoleTopology(CombinedTopBoundaryEdgeFinishThroughHole Hole, VertexId SeamTopVertex, VertexId SeamBottomVertex,
VertexId? ShoulderOuterVertex,VertexId? ShoulderInnerVertex,EdgeId TopCircle,EdgeId BottomCircle,
EdgeId? ShoulderOuterCircle,EdgeId? ShoulderInnerCircle,EdgeId UpperSeam,EdgeId? LowerSeam);
}