Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

9.5 KB
Raw Blame

Guitar as a multi-file assembly

The body crown, pickups and bridge now use Concept-directed Fixed seating against the shared hardware-layout.firmament deck. The bridge's former 4mm gap is removed.

The pickup construction has since been consolidated into one functional part, placed twice. The qualification table below records the earlier organization-only snapshot; current counts are 91 visible parts and 53 geometry definitions.

The preferred entry is guitar.firmasm. It contains only Include declarations and five top-level subassembly occurrences. The old guitar-x0.firmament entry is a small compatibility composition root.

guitar.firmasm
├─ hardware-definitions.firmament   shared exact part templates and HardwareSite
├─ body-assembly.firmament          back, binding and carved top
│  └─ MahoganyBack / IvoryBinding / CarvedMaple.firmament  SectionChain sources
│     └─ body-outline.firmament  Shared boundary for nine Concept placements
├─ neck-assembly.firmament          neck, board, frets, inlays, nut and headstock
│  ├─ Neck.firmament                exact six-section neck and published ports
│  └─ tuners-assembly.firmament     local bass row and mirrored treble row
│     └─ tuner.firmament           complete washer/post/button component
├─ electronics-assembly.firmament   knobs, selector and decorative covers
│  ├─ knob.firmament               reusable complete control knob
│  ├─ selector.firmament           reusable complete pickup selector
│  └─ pickups-assembly.firmament    two complete pickup occurrences
│     └─ pickup.firmament          housing, coil functions and pole feature pattern
├─ bridge-assembly.firmament        bridge, stop tailpiece and keyed saddles
└─ strings-assembly.firmament       WireForm template and six formed routes

These are real reusable Subassembly definitions, not text fragments or imported STEP packages. Tuners are a nested occurrence under Neck; Pickups nest under Electronics. The root retains five readable placements. Each module owns its local layout; moving a root occurrence moves its already-solved children. Knobs, selector and tuners now publish component Mount frames. Tuners use headstock-local linear/reflected site recipes and one shared component definition; the group seats on the headstock front plus veneer thickness. See Components and mounting sites. Remaining explicit control seat coordinates describe module-local layout.

Neck exposes only NutMount, HeelMount and HeadFront. Its NutWorld/HeadTilt frames and Fixed VeneerSeat remain private to that definition. The parent cannot reach private part ports through the neck boundary. The local fixed relationship is recorded in the solved neck definition; it is not recreated as a root joint.

The compiler now publishes concrete authored part ports before reusable local assembly solving. Template ports use the existing typed specialization frontend; section ports use the existing SectionChain binder with materialization disabled. Actual geometry is still materialized once per shared part definition, which replaces early publication values with the materialized definition's ports without creating duplicates. Declaration collection retains geometry templates and finite data from all included modules, rather than stopping at the first subassembly declaration.

The immutable project-snapshot path resolves included modules and the four SectionChain resources from supplied documents. Its dependency report includes 19 used source documents, each with a hash. Existing include checks and private semantic boundaries remain in force. Source-row offsets still refer to the expanded source; this change does not add per-file editor source maps.

Reproduce:

python scripts/create-guitar-x0.py
dotnet Aetheris.CLI/bin/Release/net10.0/aetheris.dll asm inspect fixtures/Canonical/AssemblyInterfaces/GuitarX0/guitar.firmasm --json --profile
./scripts/qualify-guitar-x0.ps1 -OutDir artifacts/local/guitar-subassemblies -Viewport

The existing generator preserves the directly authored component and electronics/ tuner modules and writes the remaining generated modules reproducibly. Profile interpolation, fret formulas and string-route calculations remain its current responsibilities; Authoring D is not part of this reorganization. Downstream sunburst shading also remains unchanged. Generated exports and evidence belong under artifacts/local.

Component ownership refinement

The current model has 10 reusable assembly definitions, four named knobs, one selector, and six occurrences of one tuner definition. The tuners form a 36mm bass-side row and a reflected treble-side row, both seated on the headstock veneer through its published frame. The treble row clocks the same tuner 180deg to turn its button outward. See the implemented site syntax.

The controls preserve their previous placements within numerical roundoff; all 52 other parts with unchanged identities, excluding updated strings, preserve their world-transform matrices exactly. Surface, pickup and WireForm display checks have no unmatched edges or inward normal triangles. The fresh Cycles hero uses the exported 91 product meshes without changing their topology.

This dogfood case also exposed an AP242 shared-child bug: reconstructing local transforms independently from posed world occurrences produced tiny numerical differences, and STEP reimport expanded 197 bodies instead of 91. The exporter now consumes the existing solved definition-local transforms. The corrected reimport has 53 geometry definitions, 91 bodies, 38 subassembly occurrences, 129 total occurrences and hierarchy depth 6. Both the mounting-row fixture and the guitar have regression assertions for exact part occurrence counts.

Current artifacts are under ignored artifacts/local/component-authoring/: guitar.step, guitar.usda, beauty/hero.png, beauty/guitar-studio.blend, after.json, placement-check.json, mesh-check.json, generator-check.json and step-reimport-final.log. Earlier failing STEP evidence is retained under explicit before-fix names/logs. Camera interaction was not remeasured in this refinement; the original viewer evidence below remains historical.

Release solution build passed. The core fast lane passed 1,004 tests; 36 focused foundation/site/guitar tests and 20 focused site/guitar/AP242 tests passed. The final full solution gate, with projects and xUnit collections serialized, passed 4,108 tests with seven existing skips across 20 projects. The first default full run had one unchanged core tessellation deadline failure and one old dependency count assertion (16 versus the new 19 files). The count assertion was corrected; the core test passed in isolation and both controlled full runs passed. No tessellation budget or assertion was relaxed. See full.log, core-timeout-isolated.log, full-final-serial.log and test-summary.json in the artifact directory for the distinct results.

Original modularization qualification (historical)

The modular witness was qualified through the real CLI, immutable project snapshot, AP242 exporter/importer and OpenUSD viewer:

Evidence Result
Composition 5 root groups, 7 reusable assembly definitions, 7 keyed patterns
Geometry 55 shared exact part definitions, 107 visible parts
Display hierarchy 164 nodes, including the 7 new groups
Baseline comparison All position/normal/index buffers identical; all 107 world transforms identical
AP242 reimport 107 bodies, hierarchy depth 5; source assembly hierarchy retained
Cold compilation 10.455 s
Warm recompilation 4.873 s
Display preparation, cold / warm 0.489 / 0.392 s
OpenUSD No composition errors; maximum world-transform error 1.23e-15
36 usdview camera rotations 0 compile calls, 0 rebuilds, 0 stage changes; mean orbit/readback 26.18 ms

Cold includes first-use JIT/library initialization. Warm recompiles the source in the same process without a persistent model cache. Neither includes process startup or dotnet build. Camera evidence is from the standalone exported USD viewer, which has no compiler connection.

Release solution build passed, the core fast lane passed 1,005 tests, and 36 focused foundation/guitar/project tests passed. The default full solution gate reported 4,034 passed and one unrelated posed-slider display timeout at its six-second tessellation budget. That test passed in 0.78 s in isolation. A controlled full solution gate with xUnit collections serialized passed all 4,035 tests; budgets and assertions were unchanged. This supports contention as the explanation, without claiming the default gate was green.

Fresh exports and evidence are in artifacts/local/guitar-subassemblies/: guitar.step, guitar.usda, inspection.json, timings.json, baseline-comparison.json, step-assembly-analysis.json, usd-validation.json and viewport/viewer.json. Test logs are in artifacts/local/guitar-foundation/subassembly-*.log.

The existing Cycles hero images remain applicable because geometry buffers and world placements are identical. No new beauty render was required for this organization change; the fresh shaded viewport was visually checked. The presentation witness is preserved while its authored structure is easier to navigate. Remaining module-local coordinate layout and Python-generated profile and route data are explicitly deferred refinements.