Files
make-cad/test/test_surface_api.py
T
2026-08-15 20:04:29 +08:00

450 lines
19 KiB
Python

from __future__ import annotations
import json
import math
import unittest
from copy import deepcopy
import simplecadapi as scad
from OCP.BRepAdaptor import BRepAdaptor_Surface
from OCP.GeomAbs import GeomAbs_Cylinder
class TestSurfaceApi(unittest.TestCase):
@staticmethod
def _line_wire(start, end):
return scad.make_wire_from_edges_rwire([scad.make_line_redge(start, end)])
def test_public_surface_namespace_and_basic_faces(self):
self.assertIs(scad.surface.make_bezier_surface_rface, scad.make_bezier_surface_rface)
self.assertIs(
scad.surface.make_cylindrical_surface_rface,
scad.make_cylindrical_surface_rface,
)
self.assertIs(
scad.surface.make_solid_from_shell_rsolid,
scad.make_solid_from_shell_rsolid,
)
self.assertIs(scad.surface.SurfaceBoundary, scad.SurfaceBoundary)
bezier = scad.make_bezier_surface_rface(
[[(0, 0, 0), (0, 1, 0)], [(1, 0, 0), (1, 1, 0)]]
)
fitted = scad.fit_point_grid_rface(
[[(0, 0, 0), (0, 1, 0)], [(1, 0, 0), (1, 1, 0)]],
degree_min=1,
degree_max=3,
)
self.assertIsInstance(bezier, scad.Face)
self.assertIsInstance(fitted, scad.Face)
self.assertAlmostEqual(bezier.get_area(), 1.0, places=6)
self.assertAlmostEqual(fitted.get_area(), 1.0, places=6)
def test_cylindrical_surface_periodic_trim_and_replay(self):
def point(angle, z):
return (2.0 * math.cos(angle), 2.0 * math.sin(angle), z)
with scad.GraphSession() as session:
carrier = scad.make_cylindrical_surface_rface(
2.0,
(0.0, 2.0 * math.pi),
(0.0, 2.0),
tag_prefix="carrier",
)
edges = [
scad.make_three_point_arc_redge(
point(0.5, 0.0), point(1.5, 0.0), point(2.5, 0.0)
),
scad.make_line_redge(point(2.5, 0.0), point(2.5, 2.0)),
scad.make_three_point_arc_redge(
point(2.5, 2.0), point(1.5, 2.0), point(0.5, 2.0)
),
scad.make_line_redge(point(0.5, 2.0), point(0.5, 0.0)),
]
outer = scad.make_wire_from_edges_rwire(edges)
trimmed = scad.trim_surface_rface(carrier, outer, tag_prefix="trimmed")
replayed = scad.replay_model_json(scad.export_model_json(session))[0]
self.assertEqual(BRepAdaptor_Surface(carrier.wrapped).GetType(), GeomAbs_Cylinder)
self.assertEqual(BRepAdaptor_Surface(trimmed.wrapped).GetType(), GeomAbs_Cylinder)
self.assertAlmostEqual(carrier.get_area(), 8.0 * math.pi, places=6)
self.assertAlmostEqual(trimmed.get_area(), 8.0, places=5)
self.assertAlmostEqual(replayed.get_area(), trimmed.get_area(), places=7)
self.assertIn("trimmed.face", scad.list_tags(replayed))
def test_cylindrical_surface_rejects_kernel_degenerate_spans(self):
with self.assertRaisesRegex(scad.SimpleCADError, "u_range"):
scad.make_cylindrical_surface_rface(
2.0,
(0.0, 1.0001e-12),
(0.0, 2.0),
)
with self.assertRaisesRegex(scad.SimpleCADError, "v_range"):
scad.make_cylindrical_surface_rface(
2.0,
(0.0, 1.0),
(0.0, 1.0e-8),
)
def test_periodic_trim_rejects_wire_outside_partial_carrier(self):
def point(angle, z):
return (2.0 * math.cos(angle), 2.0 * math.sin(angle), z)
carrier = scad.make_cylindrical_surface_rface(
2.0,
(0.0, 1.0),
(0.0, 2.0),
)
outer = scad.make_wire_from_edges_rwire(
[
scad.make_three_point_arc_redge(
point(2.0, 0.0), point(2.25, 0.0), point(2.5, 0.0)
),
scad.make_line_redge(point(2.5, 0.0), point(2.5, 2.0)),
scad.make_three_point_arc_redge(
point(2.5, 2.0), point(2.25, 2.0), point(2.0, 2.0)
),
scad.make_line_redge(point(2.0, 2.0), point(2.0, 0.0)),
]
)
with self.assertRaisesRegex(scad.SimpleCADError, "bounded carrier"):
scad.trim_surface_rface(carrier, outer)
def test_periodic_trim_rejects_holes_explicitly(self):
carrier = scad.make_cylindrical_surface_rface(
2.0,
(0.0, 2.0 * math.pi),
(0.0, 2.0),
)
outer = scad.make_rectangle_rwire(1.0, 1.0, center=(2.0, 0.0, 1.0))
hole = scad.make_rectangle_rwire(0.25, 0.25, center=(2.0, 0.0, 1.0))
with self.assertRaisesRegex(scad.SimpleCADError, "holes is not supported"):
scad.trim_surface_rface(carrier, outer, holes=[hole])
def test_periodic_trim_converts_linear_tolerance_to_angular_tolerance(self):
def point(angle, z):
return (100.0 * math.cos(angle), 100.0 * math.sin(angle), z)
carrier = scad.make_cylindrical_surface_rface(
100.0,
(0.0, 1.0),
(0.0, 2.0),
)
outer = scad.make_wire_from_edges_rwire(
[
scad.make_three_point_arc_redge(
point(1.05, 0.0), point(1.075, 0.0), point(1.10, 0.0)
),
scad.make_line_redge(point(1.10, 0.0), point(1.10, 2.0)),
scad.make_three_point_arc_redge(
point(1.10, 2.0), point(1.075, 2.0), point(1.05, 2.0)
),
scad.make_line_redge(point(1.05, 2.0), point(1.05, 0.0)),
]
)
with self.assertRaisesRegex(scad.SimpleCADError, "bounded carrier"):
scad.trim_surface_rface(carrier, outer, tolerance=0.2)
def test_solid_from_closed_shell_replays(self):
with scad.GraphSession() as session:
box = scad.make_box_rsolid(1.0, 2.0, 3.0)
shell = scad.sew_faces_rshell(box.get_faces())
shell = scad.apply_tag_rselection(
shell,
scad.ql.faces(),
"role.preserved_face",
)
source_face_tags = {face.topo_id for face in shell.get_faces()}
solid = scad.make_solid_from_shell_rsolid(shell, tag_prefix="body")
replayed = scad.replay_model_json(scad.export_model_json(session))[0]
self.assertIsInstance(solid, scad.Solid)
self.assertAlmostEqual(solid.get_volume(), 6.0, places=6)
self.assertAlmostEqual(replayed.get_volume(), solid.get_volume(), places=7)
self.assertIn("body.solid", scad.list_tags(replayed))
self.assertEqual(
solid._get_runtime("semantic.lineage.coverage"), "partial"
)
self.assertTrue(
all(
face.topo_id in source_face_tags
and "role.preserved_face" in scad.list_tags(face)
for face in solid.get_faces()
)
)
self.assertTrue(
all(
"role.preserved_face" in scad.list_tags(face)
for face in replayed.get_faces()
)
)
def test_trim_replays_with_semantically_tagged_inputs(self):
with scad.GraphSession() as session:
carrier = scad.make_bezier_surface_rface(
[[(-3, -3, 0), (-3, 3, 0)], [(3, -3, 0), (3, 3, 0)]]
)
outer = scad.make_rectangle_rwire(4.0, 4.0)
carrier = scad.apply_tag(carrier, "role.trim_carrier")
outer = scad.apply_tag(outer, "role.trim_outer")
trimmed = scad.trim_surface_rface(carrier, outer)
replayed = scad.replay_model_json(scad.export_model_json(session))[0]
self.assertAlmostEqual(replayed.get_area(), trimmed.get_area(), places=7)
for result in (trimmed, replayed):
self.assertEqual(
sorted(witness.binding.tag for witness in result._tag_lineage),
["role.trim_carrier", "role.trim_outer"],
)
self.assertTrue(
all(witness.coverage == "partial" for witness in result._tag_lineage)
)
self.assertEqual(
result._get_runtime("semantic.lineage.coverage"), "partial"
)
def test_solid_from_shell_rejects_open_shell(self):
face = scad.make_bezier_surface_rface(
[[(0, 0, 0), (0, 1, 0)], [(1, 0, 0), (1, 1, 0)]]
)
shell = scad.sew_faces_rshell([face])
with self.assertRaisesRegex(scad.SimpleCADError, "closed shell"):
scad.make_solid_from_shell_rsolid(shell)
def test_shell_scoped_face_tag_replays(self):
with scad.GraphSession() as session:
box = scad.make_box_rsolid(1.0, 2.0, 3.0)
shell = scad.sew_faces_rshell(box.get_faces())
tagged_face = scad.apply_tag(
shell.get_faces(0),
"role.shell_face",
)
scad.capture_result(value=tagged_face)
replayed = scad.replay_model_json(scad.export_model_json(session))[0]
self.assertIsInstance(replayed, scad.Face)
self.assertIn("role.shell_face", scad.list_tags(replayed))
def test_workplane_bezier_model_replay_preserves_geometry_and_tag(self):
with scad.GraphSession() as session:
with scad.Workplane(
origin=(10.0, 20.0, 30.0),
normal=(0.0, 1.0, 0.0),
x_dir=(1.0, 0.0, 0.0),
):
original = scad.make_bezier_surface_rface(
[[(0, 0, 0), (0, 1, 0)], [(1, 0, 0), (1, 1, 1)]],
tag_prefix="skin",
)
replayed = scad.replay_model_json(scad.export_model_json(session))[0]
original_center = original.get_center()
replayed_center = replayed.get_center()
self.assertIsInstance(replayed, scad.Face)
self.assertAlmostEqual(replayed.get_area(), original.get_area(), places=8)
self.assertAlmostEqual(replayed_center.x, original_center.x, places=8)
self.assertAlmostEqual(replayed_center.y, original_center.y, places=8)
self.assertAlmostEqual(replayed_center.z, original_center.z, places=8)
self.assertIn("skin.face", scad.list_tags(replayed))
def test_derived_surface_builders_and_replay(self):
with scad.GraphSession() as session:
profile_edges = [
scad.make_line_redge((0, 0, 0), (1, 0, 0)),
scad.make_line_redge((0, 1, 0), (1, 1, 0)),
]
guide_edges = [
scad.make_line_redge((0, 0, 0), (0, 1, 0)),
scad.make_line_redge((1, 0, 0), (1, 1, 0)),
]
gordon = scad.make_gordon_surface_rface(profile_edges, guide_edges)
points = [(0, 0, 1), (2, 0, 1), (2, 2, 1), (0, 2, 1)]
edges = [
scad.make_line_redge(points[index], points[(index + 1) % 4])
for index in range(4)
]
patch = scad.make_surface_patch_rface(
[scad.SurfaceBoundary(edge) for edge in edges],
tag_prefix="patch",
)
scad.capture_result(value=[gordon, patch])
replayed = scad.replay_model_json(scad.export_model_json(session))
self.assertEqual(len(replayed), 2)
self.assertAlmostEqual(replayed[0].get_area(), gordon.get_area(), places=7)
self.assertAlmostEqual(replayed[1].get_area(), patch.get_area(), places=7)
self.assertEqual(len(replayed[1].get_edges()), 4)
self.assertIn("patch.face", scad.list_tags(replayed[1]))
def test_trim_surface_with_hole_and_replay(self):
with scad.GraphSession() as session:
carrier = scad.make_bezier_surface_rface(
[[(-3, -3, 0), (-3, 3, 0)], [(3, -3, 0), (3, 3, 0)]]
)
outer = scad.make_rectangle_rwire(4.0, 4.0)
hole = scad.make_rectangle_rwire(1.0, 1.0)
trimmed = scad.trim_surface_rface(
carrier,
outer,
holes=[hole],
tag_prefix="trimmed",
)
replayed = scad.replay_model_json(scad.export_model_json(session))[0]
self.assertIsInstance(trimmed, scad.Face)
self.assertAlmostEqual(trimmed.get_area(), 15.0, places=6)
self.assertAlmostEqual(replayed.get_area(), trimmed.get_area(), places=7)
self.assertEqual(len(trimmed.get_wires()), 2)
self.assertIn("trimmed.face", scad.list_tags(replayed))
def test_trim_surface_rejects_off_carrier_wire(self):
carrier = scad.make_bezier_surface_rface(
[[(-3, -3, 0), (-3, 3, 0)], [(3, -3, 0), (3, 3, 0)]]
)
outer = scad.make_rectangle_rwire(4.0, 4.0, center=(0, 0, 1))
with self.assertRaisesRegex(scad.SimpleCADError, "trim"):
scad.trim_surface_rface(carrier, outer)
def test_shell_loft_roles_names_point_profiles_and_replay(self):
with scad.GraphSession() as session:
lower = scad.make_circle_rwire((0, 0, 0), 2.0)
upper = scad.make_circle_rwire((0, 0, 2), 1.0)
open_shell = scad.loft_rshell(
[lower, upper],
tag_prefix="skin",
result_tag="part.skin",
start_wire_tag="anchor.inlet",
end_wire_tag="anchor.outlet",
side_faces_tag="group.side",
)
scad.capture_result(value=open_shell)
replayed = scad.replay_model_json(scad.export_model_json(session), strict=True)[0]
self.assertIsInstance(replayed, scad.Shell)
self.assertFalse(replayed.is_closed())
self.assertEqual(len(replayed.get_wires()), 2)
self.assertEqual(
len(scad.ql.wires().where(scad.ql.tag("anchor.inlet")).resolve(replayed)),
1,
)
self.assertEqual(
len(scad.ql.wires().where(scad.ql.tag("anchor.outlet")).resolve(replayed)),
1,
)
self.assertEqual(
len(scad.ql.faces().where(scad.ql.tag("group.side")).resolve(replayed)),
1,
)
self.assertIn("part.skin", scad.list_tags(replayed))
self.assertIn("skin.shell", scad.list_tags(replayed))
point = scad.make_point_rvertex(0, 0, 4)
pointed = scad.loft_rshell([upper, point], start_wire_tag="anchor.base")
self.assertEqual(len(pointed.get_wires()), 1)
self.assertEqual(
len(scad.ql.wires().where(scad.ql.tag("anchor.base")).resolve(pointed)),
1,
)
def test_sew_and_free_boundary_multi_output_replay(self):
with scad.GraphSession() as session:
face = scad.make_bezier_surface_rface(
[[(0, 0, 0), (0, 1, 0)], [(1, 0, 0), (1, 1, 0)]]
)
shell = scad.sew_faces_rshell([face])
boundaries = scad.free_boundaries_rwirelist(shell)
scad.capture_result(value=boundaries)
replayed = scad.replay_model_json(scad.export_model_json(session))
self.assertEqual(len(boundaries), 1)
self.assertEqual(len(replayed), 1)
original_length = sum(edge.get_length() for edge in boundaries[0].get_edges())
replayed_length = sum(edge.get_length() for edge in replayed[0].get_edges())
self.assertAlmostEqual(replayed_length, original_length, places=8)
def test_sew_shell_faces_replays_selected_face_inputs(self):
with scad.GraphSession() as session:
lower = scad.make_circle_rwire((0, 0, 0), 1.0)
upper = scad.make_circle_rwire((0, 0, 2), 1.0)
lofted = scad.loft_rshell([lower, upper])
resewn = scad.sew_faces_rshell(lofted.get_faces())
scad.capture_result(value=resewn)
payload = scad.export_model_json(session)
sew_node = next(
node
for node in json.loads(payload)["graph"]["nodes"]
if node["op"] == "sew_faces_rshell"
)
self.assertEqual(len(sew_node["params"]["input_refs"]), 1)
replayed = scad.replay_model_json(payload, strict=True)
self.assertEqual(len(replayed), 1)
self.assertIsInstance(replayed[0], scad.Shell)
self.assertEqual(len(replayed[0].get_faces()), len(resewn.get_faces()))
self.assertAlmostEqual(replayed[0].get_area(), resewn.get_area(), places=8)
def test_closed_shell_free_boundaries_records_zero_outputs(self):
with scad.GraphSession() as session:
lower = scad.make_circle_rwire((0, 0, 0), 1.0)
upper = scad.make_circle_rwire((0, 0, 2), 1.0)
closed_shell = scad.fill_holes_rshell(scad.loft_rshell([lower, upper]))
boundaries = scad.free_boundaries_rwirelist(closed_shell)
node = session.graph.leaf_nodes()[0]
self.assertEqual(boundaries, [])
self.assertEqual(node.op, "free_boundaries_rwirelist")
self.assertEqual(node.output_count, 0)
self.assertEqual(scad.replay_model_json(scad.export_model_json(session)), [])
def test_loft_rejects_middle_points_and_missing_endpoint_topology(self):
lower = scad.make_circle_rwire((0, 0, 0), 2.0)
middle = scad.make_point_rvertex(0, 0, 2)
upper = scad.make_circle_rwire((0, 0, 4), 1.0)
with self.assertRaisesRegex(scad.SimpleCADError, "only at the start or end"):
scad.loft_rshell([lower, middle, upper])
with self.assertRaisesRegex(scad.SimpleCADError, "end_wire_tag requires"):
scad.loft_rshell([lower, middle], end_wire_tag="anchor.end")
with self.assertRaisesRegex(scad.SimpleCADError, "end_face_tag requires"):
scad.loft_rsolid([lower, middle], end_face_tag="anchor.end")
def test_strict_replay_rejects_ordered_input_ref_tampering(self):
with scad.GraphSession() as session:
edge_a = scad.make_line_redge((0, 0, 0), (1, 0, 0))
edge_b = scad.make_line_redge((0, 0, 1), (1, 0, 1))
scad.make_ruled_surface_rface(edge_a, edge_b)
payload = json.loads(scad.export_model_json(session))
damaged = deepcopy(payload)
ruled_node = next(
node
for node in damaged["graph"]["nodes"]
if node["op"] == "make_ruled_surface_rface"
)
ruled_node["params"]["input_refs"][0]["output_slot"] = 99
with self.assertRaisesRegex(scad.SimpleCADError, "missing output slot 99"):
scad.replay_model_json(json.dumps(damaged), strict=True)
def test_invalid_surface_inputs_use_public_error_contract(self):
with self.assertRaisesRegex(scad.SimpleCADError, "rectangular finite grid"):
scad.make_bezier_surface_rface([[(0, 0, 0)]])
with self.assertRaisesRegex(scad.SimpleCADError, "positive tolerance"):
scad.fit_point_grid_rface(
[[(0, 0, 0), (0, 1, 0)], [(1, 0, 0), (1, 1, 0)]],
tolerance=0.0,
)
if __name__ == "__main__":
unittest.main()