450 lines
19 KiB
Python
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()
|