Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

9.9 KB
Raw Blame

Firmament Example Pack

This directory contains small canonical Firmament examples for the current v1 surface. Placement examples use canonical place.on_face for semantic anchors; place.centered_on remains accepted as a compatibility alias but is normalized by formatter output.

These examples represent the currently supported boolean subset. Other combinations may fail and are intentionally not supported yet.

  • box_basic.firmament — minimal single-box golden-path example; helper export path: testdata/step242/golden/firmament-v1/box_basic.step.
  • cylinder_basic.firmament — minimal single-cylinder export example; helper export path: testdata/step242/golden/firmament-v1/cylinder_basic.step.
  • cone_frustum_basic.firmament — minimal single frustum-cone export example using the v1 cone primitive; helper export path: testdata/step242/golden/firmament-v1/cone_frustum_basic.step.
  • cone_pointed_top_zero.firmament — minimal single pointed-cone export example using the same v1 cone primitive with top_radius: 0; helper export path: testdata/step242/golden/firmament-v1/cone_pointed_top_zero.step.
  • sphere_basic.firmament — minimal single-sphere export example; helper export path: testdata/step242/golden/firmament-v1/sphere_basic.step.
  • torus_basic.firmament — minimal single-torus export example using the canonical major_radius / minor_radius surface; helper export paths: testdata/step242/golden/firmament-v1/torus_basic.step and the milestone proof artifact testdata/step242/golden/firmament-v1/m10g2-torus.step.
  • straight_slot_basic.firmament — minimal single straight-slot export example; helper export path: testdata/step242/golden/firmament-v1/straight_slot_basic.step.
  • rounded_corner_box_basic.firmament — minimal single rounded-corner-box export example using Forge-backed rounded-rectangle atomics under StandardLibrary; helper export path: testdata/step242/golden/firmament-v1/rounded_corner_box_basic.step.
  • slot_cut_basic.firmament — minimal single slot-cut export example using the same Forge rounded-rectangle atomic seam under StandardLibrary; helper export path: testdata/step242/golden/firmament-v1/slot_cut_basic.step.
  • library_part_cube_with_hole_basic.firmament — connector-routed standard library reusable part example for standard_library/cube_with_cylindrical_hole; helper export path: testdata/step242/golden/firmament-v1/library_part_cube_with_hole_basic.step.
  • mcmaster_91180a151_threadless_hex_bolt.firmament — canonical V2 Record/Static/Template instance routed through the generic StandardPart record to StandardLibrary.HexBolt, with an exact conical head treatment, hyperbolic cone/hex trims, semantic thread region, and no modeled threads or markings.
  • composed_part_with_slot.firmament — bounded composability probe combining connector part import (standard_library/cube_with_cylindrical_hole) and lane-routed slot_cut subtract in one model; currently documents a real bounded-safe-composition blocker rather than a successful export.
  • box_add_basic.firmament — minimal supported box-plus-box boolean add example; helper export path: testdata/step242/golden/firmament-v1/box_add_basic.step.
  • boolean_add_basic.firmament — canonical proven boolean add example for the current box/box single-box subset; helper export path: testdata/step242/golden/firmament-v1/boolean_add_basic.step.
  • ribbed_support_f1.firmament — bounded F1 connected orthogonal add family example for rib/wall-like parts; helper export path: testdata/step242/golden/firmament-v1/ribbed_support_f1.step.
  • boolean_subtract_basic.firmament — canonical proven boolean subtract example for the current box/box single-box subset; helper export path: testdata/step242/golden/firmament-v1/boolean_subtract_basic.step.
  • boolean_intersect_basic.firmament — canonical proven boolean intersect example for the current box/box single-box subset; helper export path: testdata/step242/golden/firmament-v1/boolean_intersect_basic.step.
  • boolean_box_cylinder_hole.firmament — the only supported box+cylinder boolean case: subtracting a Z-aligned cylinder that cleanly spans the full box height to form a single box-with-through-hole solid; helper export path: testdata/step242/golden/firmament-v1/boolean_box_cylinder_hole.step.
  • boolean_box_cone_throughhole_basic.firmament — the narrow supported box+cone boolean case: subtracting a Z-aligned cone that cleanly spans the full box height, keeps both boundary circles strictly inside the box footprint, and reconstructs as one box-with-conical-through-hole solid; helper export path: testdata/step242/golden/firmament-v1/boolean_box_cone_throughhole_basic.step.
  • boolean_two_cylinder_holes_basic.firmament — canonical sequential safe composition case for box → subtract cylinder → subtract cylinder; helper export path: testdata/step242/golden/firmament-v1/boolean_two_cylinder_holes_basic.step.
  • boolean_cylinder_cone_holes_basic.firmament — canonical sequential safe composition case for box → subtract cylinder → subtract cone; helper export path: testdata/step242/golden/firmament-v1/boolean_cylinder_cone_holes_basic.step.
  • boolean_box_sphere_cavity_basic.firmament — narrow supported subtract(box, sphere) cavity case only: the sphere must remain strictly contained and non-tangent so the result can be reconstructed as one outer shell plus one inner spherical shell; helper export path: testdata/step242/golden/firmament-v1/boolean_box_sphere_cavity_basic.step.
  • placed_primitive.firmament — selector-based placement using place.on and offset[3]; helper export path: testdata/step242/golden/firmament-v1/placed_primitive.step.
  • p1_blind_hole_on_face_semantic.firmament — minimal semantic placement subset example using place.on_face for a blind-hole tool placement.
  • p1_flange_radial_hole_semantic.firmament — minimal semantic placement subset example using place.around_axis + place.radial_offset for flange radial hole placement.
  • p1_bracket_rib_on_face_semantic.firmament — minimal semantic placement subset example using place.on_face for bracket rib authoring ergonomics.
  • w2_cylinder_root_blind_bore_semantic.firmament — Wave 2.1 canonical cylinder-root blind-bore example (subtract(cylinder_root, cylinder) with top-entry coaxial blind bore) authored with semantic place.on_face; helper export path: testdata/step242/golden/firmament-v1/w2_cylinder_root_blind_bore_semantic.step.
  • w2_box_sphere_exterior_opening_pocket_semantic.firmament — Wave 2.1 canonical exterior-opening spherical pocket example (subtract(box, sphere) with one-sided opening at top_face) authored with semantic place.on_face; helper export path: testdata/step242/golden/firmament-v1/w2_box_sphere_exterior_opening_pocket_semantic.step.
  • p2_linear_hole_row.firmament — minimal built-in pattern_linear example for repeated hole rows.
  • p2_flange_bolt_circle_pattern.firmament — minimal built-in pattern_circular bolt-circle example for flange holes.
  • p2_mirror_hole_pair.firmament — bounded pattern_mirror example for principal-plane mirrored hole placement.
  • schema_box_basic.firmament — minimal schema-present export example showing schema presence without changing export body semantics; helper export path: testdata/step242/golden/firmament-v1/schema_box_basic.step.

Unsupported boolean requests are tracked as fixtures/tests, not presented in this working example pack. The supported safe subtract family remains narrow and explicit: subtract(box, cylinder) and subtract(box, cone) still require a Z-aligned tool, full span through the current box shell, non-degenerate boundary circles for cones, and strict in-bounds clearance with no tangent/grazing contact. Forge-style polygonal extrusions (for example rounded-corner boxes / slot-cut solids) now also have a bounded safe-root path for prismatic through-cut subtract continuation, so these roots are no longer immediate left-operand dead ends; containment for that family uses the true polygon footprint, not only the root AABB. Sequential composition is still bounded: analytic follow-on subtracts are pre-validated as safe-hole composition, while non-analytic follow-on tools are now passed through to kernel bounded-family routing for final admissibility/reconstruction diagnostics rather than being rejected by an upstream tool-kind gate. This is not general multi-feature boolean support. The composability probe composed_part_with_slot.firmament is now a successful routed case (subtract(library_part, slot_cut)) and remains useful as a regression check that follow-on prismatic routing reaches kernel execution. Box+cylinder add, box+cylinder intersect, rotated cylinders, partial-depth cuts, tangent/grazing cases, outside-footprint cuts, interfering multi-hole layouts, and unsupported subtract orderings remain unsupported. Box+cone add, box+cone intersect, tilted cones, partial-depth cone cuts, tangent/grazing cone cuts, apex-inside cases, outside-footprint cone cuts, and unsupported mixed-ordering requests remain unsupported. Box+sphere support is still narrow and truth-first: only subtract(box, sphere) with a strictly contained, non-tangent, fully enclosed cavity is supported, reconstructed via one outer shell plus one inner spherical shell. add(box, sphere), intersect(box, sphere), tangent cavity requests, and partially outside sphere requests remain unsupported. Box+torus booleans are currently unsupported in every audited form: subtract(box, torus), add(box, torus), and intersect(box, torus) all fail the real kernel boundary for centered, offset, fully contained, face-intersecting, and outside-footprint torus placements, so no box+torus example is included here. These files are intended to stay minimal, readable, and aligned with the implemented language surface. Export artifacts are kept separately under testdata/step242/golden/firmament-v1/ so examples remain source-only and demo outputs stay easy to find.