Map IRCSS French Houses system structure
This commit is contained in:
parent
488b207c5c
commit
216fe77589
7 changed files with 320 additions and 3 deletions
|
|
@ -258,6 +258,7 @@ Completed Blender raycast minigame foothold:
|
|||
Completed IRCSS French Houses foothold:
|
||||
|
||||
- `docs/research/translations/ircss-french-houses.md`
|
||||
- File-level map: `docs/research/translations/ircss-french-houses-system-map.md`
|
||||
- Source groups: `MakeSpiral`, `PointyGothicCone`
|
||||
- Verification: spiral output curve converted to points matches source with
|
||||
ordered max vertex delta `0.0`; plain and ornamented gothic cone cases match
|
||||
|
|
|
|||
307
docs/research/translations/ircss-french-houses-system-map.md
Normal file
307
docs/research/translations/ircss-french-houses-system-map.md
Normal file
|
|
@ -0,0 +1,307 @@
|
|||
# IRCSS French Houses System Map
|
||||
|
||||
## Scope
|
||||
|
||||
Source file:
|
||||
`experiments/source-blends/ircss-french-houses.blend`
|
||||
|
||||
Inspection cache:
|
||||
`experiments/inspection/ircss-french-houses-node-groups.json`
|
||||
|
||||
Generated with Blender 5.1.1 after extending
|
||||
`tools/inspect_blend_node_groups.py` to record nested `GeometryNodeGroup`
|
||||
`node_tree` references.
|
||||
|
||||
## High-Level Shape
|
||||
|
||||
This `.blend` is a procedural town kit, not one scene graph. The file contains:
|
||||
|
||||
- 108 geometry node groups, 107 unique names.
|
||||
- One duplicate group name: `Is Edge Manifold`.
|
||||
- 63 distinct modifier root groups used by scene objects.
|
||||
- 62 groups that call at least one nested group.
|
||||
- 163 distinct group dependency edges.
|
||||
|
||||
The useful mental split:
|
||||
|
||||
- **Composers** create recognizable buildings and scene pieces: houses, towers,
|
||||
church fronts, gates, walls, windmills, bridges, stalls, terrain, and roads.
|
||||
- **Organs** make reusable architectural parts: arcs, windows, doors, roof caps,
|
||||
stairs, beams, rails, columns, banners, terraces, and covers.
|
||||
- **Utilities** carry field logic, edge tests, ranges, auto-smoothing, wrapping,
|
||||
curve facts, random seeding, and geometry selection.
|
||||
|
||||
Metaphor in use: the town is not poured from one mold. It is an assembly yard.
|
||||
Composers bolt together organs; organs lean on utilities; utilities are the
|
||||
measuring jigs and clamps.
|
||||
|
||||
## Modifier Entrypoints
|
||||
|
||||
Most reused scene roots:
|
||||
|
||||
| Modifier root | Scene users | Dependency closure |
|
||||
| --- | ---: | ---: |
|
||||
| `GenerateHouse` | 5 | 9 |
|
||||
| `Generate Cliff Type 2` | 3 | 2 |
|
||||
| `MakeStallCover` | 3 | 0 |
|
||||
| `GenerateDoorsWithAlcove` | 2 | 2 |
|
||||
| `Tree On Geo Points` | 2 | 5 |
|
||||
| `GenerateCover` | 2 | 1 |
|
||||
| `GenerateStairCase` | 2 | 9 |
|
||||
| `Generate Tower` | 2 | 10 |
|
||||
| `GenerateAlcoveWindows` | 2 | 6 |
|
||||
|
||||
Large single-root systems:
|
||||
|
||||
| Modifier root | Dependency closure | Role |
|
||||
| --- | ---: | --- |
|
||||
| `Geometry Nodes.002` | 28 | cathedral root |
|
||||
| `GenerateChurchBuildingB` | 22 | church side/body composer |
|
||||
| `ChurchA-Front` | 20 | church front facade composer |
|
||||
| `CreateGate` | 18 | gate composer |
|
||||
| `HousesOnCurves` | 13 | curve-distributed houses |
|
||||
| `DomaTower` | 12 | domed tower composer |
|
||||
| `ChurchFrontTowers` | 11 | church tower front system |
|
||||
| `Generate Tower` | 10 | tower composer |
|
||||
| `TownWall` | 10 | wall composer |
|
||||
| `WindMill` | 10 | windmill composer |
|
||||
|
||||
## Major Composer Wiring
|
||||
|
||||
`GenerateHouse` depends on:
|
||||
|
||||
- `GetPositionBasedSeed`
|
||||
- `Switch On Roof Type`
|
||||
- `Generate Windows`
|
||||
- `Curve Info`
|
||||
- `CreateDiagonalBeams`
|
||||
- `WindowBeams`
|
||||
- `Is Edge Manifold`
|
||||
|
||||
Interpretation: houses are facade assemblers. They choose roof type, place
|
||||
windows, derive local curve facts, add diagonal beams, and use edge-manifold
|
||||
tests as selection guards.
|
||||
|
||||
`GenerateStairCase` depends on:
|
||||
|
||||
- `MakeSpiral`
|
||||
- `MakeStairs`
|
||||
- `GenerateTerrace`
|
||||
|
||||
Interpretation: this is the cleanest staircase chain. `MakeSpiral` provides the
|
||||
spine, `MakeStairs` hangs tread geometry on the spine, and `GenerateTerrace`
|
||||
builds the surrounding rail/ground system.
|
||||
|
||||
`DomaTower` depends on:
|
||||
|
||||
- `PointWindowsFromEdges`
|
||||
- `PointyGothicCone`
|
||||
- `WindowWalls`
|
||||
- `Generate Gothic Square Tower`
|
||||
|
||||
Interpretation: domed towers are edge/window systems with gothic cone ornament.
|
||||
The accepted `PointyGothicCone` translation is not isolated trivia; it is a
|
||||
reused ornament organ in this tower family.
|
||||
|
||||
`GenerateChurchBuildingB` depends on:
|
||||
|
||||
- `Switch On Roof Type`
|
||||
- `DistancingType`
|
||||
- `ResampleEdgesAndSpawnWindowedWalld`
|
||||
- `Is Edge Manifold`
|
||||
- `Gothic SupportColumn From EDge`
|
||||
- `GenerateWindowsFromEdges`
|
||||
- `ChurchA-Front`
|
||||
- `WindowWalls`
|
||||
|
||||
Interpretation: church bodies are facade/edge pipelines. They resample edges,
|
||||
spawn windowed walls, add gothic supports, and reuse the church front.
|
||||
|
||||
`CreateGate` depends on:
|
||||
|
||||
- `DoorTileFromArc`
|
||||
- `Is Edge Manifold`
|
||||
- `Spawn Normals on faces`
|
||||
- `GenerateUpperWindowWithAlcove`
|
||||
- `GetSteppeddirectionFrom position`
|
||||
- `StonesOnSurface`
|
||||
- `GenerateMedialAxisRectangleTopology`
|
||||
|
||||
Interpretation: gates are topology-first structures. A medial-axis rectangle
|
||||
topology lays out the plan; arcs and upper windows turn that skeleton into
|
||||
visible architecture; stones finish surfaces.
|
||||
|
||||
## Dependency Hubs
|
||||
|
||||
Most reused groups:
|
||||
|
||||
| Group | Callers | Role |
|
||||
| --- | ---: | --- |
|
||||
| `Is Edge Manifold` | 9 | edge-validity guard |
|
||||
| `Switch On Roof Type` | 9 | roof/menu router |
|
||||
| `Curve Info` | 7 | curve endpoint/root/tip facts |
|
||||
| `Gothic SupportColumn From EDge` | 6 | gothic column organ |
|
||||
| `Select Original Geometry After Edge Extrude` | 6 | post-extrude selection utility |
|
||||
| `SetAutoSmooth` | 6 | surface finishing utility |
|
||||
| `StonesOnSurface` | 6 | stone scatter/finish organ |
|
||||
| `Generate Windows` | 5 | reusable window generator |
|
||||
| `Curve Tip` | 4 | curve endpoint helper |
|
||||
| `GenerateUpperWindowWithAlcove` | 4 | upper window organ |
|
||||
| `GetPositionBasedSeed` | 4 | deterministic spatial seed helper |
|
||||
| `RailsFromEdge` | 4 | rail organ |
|
||||
| `Random Rotation` | 4 | randomized orientation helper |
|
||||
| `WindowWalls` | 4 | window-wall organ |
|
||||
|
||||
These hubs define the file's real language. Translating one thousand-node
|
||||
composer before these hubs are mapped would be pure ceremony.
|
||||
|
||||
## Feature Pressure
|
||||
|
||||
Node-feature counts across groups:
|
||||
|
||||
| Feature | Groups | Translation meaning |
|
||||
| --- | ---: | --- |
|
||||
| repeat zones | 35 | major blocker for accumulators and iterative topology |
|
||||
| geometry-node gizmos | 31 | authoring/UI blocker, often mixed into large systems |
|
||||
| foreach zones | 9 | blocker for element-wise geometry workflows |
|
||||
| closures | 7 | Blender 5 closure/menu workflows need careful converter handling |
|
||||
| menu switches | 17 | control-surface and socket-default pressure |
|
||||
| capture attributes | 66 | attribute survival is central |
|
||||
| store named attributes | 61 | named field/attribute contracts are central |
|
||||
|
||||
Captures and stored attributes are not blockers; they are the bloodstream of the
|
||||
file. Repeat, foreach, gizmo, and closure nodes are the hard toolchain pressure.
|
||||
|
||||
## Materials And Assets
|
||||
|
||||
The file has:
|
||||
|
||||
- 502 objects.
|
||||
- 56 materials.
|
||||
- 23 collections.
|
||||
- 16 `Collection Info` nodes.
|
||||
- 45 `Object Info` nodes.
|
||||
- 14 material interface sockets.
|
||||
- 81 color interface sockets.
|
||||
- 257 material assignment or material-selection nodes.
|
||||
|
||||
Material usage is concentrated around a small palette:
|
||||
|
||||
| Material | Node references | Role |
|
||||
| --- | ---: | --- |
|
||||
| `GroundFloorWalls` | 86 | dominant wall/base material |
|
||||
| `Roof` | 42 | roof surfaces |
|
||||
| `Beam` | 30 | timber and rail pieces |
|
||||
| `UpperFloorsPaint` | 13 | painted alcove/window systems |
|
||||
| `Greenery` | 9 | vegetation |
|
||||
| `RoundWindwos` | 7 | round/gothic windows |
|
||||
| `Copper` | 6 | domes and metal roof accents |
|
||||
| `FakeRoof` | 6 | alternate roof material |
|
||||
| `WindowGlass` | 4 | glass |
|
||||
| `Rock` | 4 | stones/terrain |
|
||||
|
||||
Important material sockets:
|
||||
|
||||
- `DomaTower.DomeMaterial -> Copper`
|
||||
- `Geometry Nodes.002.DomeMaterial -> FakeRoof`
|
||||
- `GenerateAlcoveWindows.AlcoveMaterial -> UpperFloorsPaint`
|
||||
- `GenerateDoorsWithAlcove.AlcoveMaterial -> UpperFloorsPaint`
|
||||
- `GenerateUpperWindowWithAlcove.AlcoveMaterial -> UpperFloorsPaint`
|
||||
- `Wooden Bridge.Material -> Beam`
|
||||
- `Fence Type A.Material -> Beam`
|
||||
- `Generate Cliff Type 2.Walls Material -> Cliff2Walls`
|
||||
- `Generate Cliff Type 2.Top Ground Materials -> Cliff2Top`
|
||||
|
||||
Collection dependencies:
|
||||
|
||||
| Collection | Used by | Meaning |
|
||||
| --- | --- | --- |
|
||||
| `Bricks` | `MakeStairs`, `StonesOnSurface` | instanced brick/stone assets |
|
||||
| `BouldersSet` | `Geometry Nodes.001` | landscape scatter assets |
|
||||
| `Paths` | `Geometry Nodes.001` | landscape/path interaction |
|
||||
| `Plants` | `Generate Cliff Type 2` | cliff vegetation scatter |
|
||||
| `RiverBank` | `Make River` | riverbank geometry |
|
||||
|
||||
Most `Object Info` nodes have no default object set. The one explicit object
|
||||
reference observed is `DoorTileFromArc`, used by an object-info node as an
|
||||
asset handle.
|
||||
|
||||
Interpretation: material and collection state is part of the procedural
|
||||
contract. A translation that matches vertices while dropping materials,
|
||||
collections, or color sockets may preserve shape but not the authored city kit.
|
||||
|
||||
## Accepted Footholds
|
||||
|
||||
`MakeSpiral -> VG Make Spiral`
|
||||
|
||||
- Role: architectural spine.
|
||||
- Verified with 200 ordered curve points at max delta `0.0`.
|
||||
- Used by `GenerateStairCase`.
|
||||
|
||||
`PointyGothicCone -> VG Pointy Gothic Cone`
|
||||
|
||||
- Role: roof/gothic ornament grown from an input point host.
|
||||
- Verified with plain and detailed cases at sorted max delta `0.0`.
|
||||
- Used by `DomaTower`, `Gothic SupportColumn From EDge`, and
|
||||
`PointWindowsFromEdges`.
|
||||
|
||||
## Current Toolchain State
|
||||
|
||||
The Geometry Script fork now emits compiling `nodes_to_script` drafts for these
|
||||
IRCSS targets:
|
||||
|
||||
- `MakeSpiral`
|
||||
- `PointyGothicCone`
|
||||
- `GenerateArc`
|
||||
- `MakeStairs`
|
||||
- `GenerateStairCase`
|
||||
- `GenerateBricks`
|
||||
- `GenerateMedialAxisRectangleTopology`
|
||||
- `GenerateWindowsFromEdges`
|
||||
- `Pole`
|
||||
- `Round Bottom`
|
||||
- `WindowBeams`
|
||||
|
||||
This only proves the converter can produce syntactically valid drafts. It does
|
||||
not prove runtime graph construction or behavioral equivalence. The drafts are
|
||||
source probes, not house style.
|
||||
|
||||
## Translation Strategy
|
||||
|
||||
The next useful city-organ translations should come from dependency hubs or
|
||||
clean chains, not top-level composers.
|
||||
|
||||
Best next candidates:
|
||||
|
||||
| Candidate | Why it matters | Risk |
|
||||
| --- | --- | --- |
|
||||
| `GenerateArc` | core arch primitive for gates, doors, and gothic systems | large but non-zone |
|
||||
| `MakeStairs` | direct child of `GenerateStairCase`; now has compiling draft | closures and collection asset dependency |
|
||||
| `GenerateStairCase` | clean chain proving spine -> treads -> terrace | depends on `MakeStairs` and `GenerateTerrace` |
|
||||
| `Switch On Roof Type` | tiny, heavily reused roof router | menu contract must be preserved |
|
||||
| `Is Edge Manifold` | tiny, heavily reused guard | duplicate source names need disambiguation |
|
||||
| `GenerateUpperWindowWithAlcove` | reused by towers, gates, alcove windows | 128 nodes, nested dependencies |
|
||||
| `Generate Windows` | reused facade organ | 188 nodes but no zone blocker |
|
||||
|
||||
Avoid as first next targets:
|
||||
|
||||
- `CreateGate`, `GenerateHouse`, `GenerateChurchBuildingB`, `Generate Tower`,
|
||||
`Generate Square Tower`, `ChurchFrontTowers`, `WindMill`: too much composer
|
||||
surface before their organs are mapped.
|
||||
- Repeat/foreach/gizmo-heavy systems unless the explicit goal is toolchain
|
||||
support.
|
||||
- Empty-output harnesses such as the rejected `WindowBeams` case.
|
||||
|
||||
## What Is Still Not Understood
|
||||
|
||||
- Exact visual appearance of every modifier root under render lighting.
|
||||
- Runtime behavior of all converter drafts; compile success is only the first
|
||||
gate.
|
||||
- Repeat-zone state semantics for topology accumulators.
|
||||
- Foreach-zone semantics for edge/window/wall systems.
|
||||
- Geometry-node gizmo behavior as editable authoring controls.
|
||||
- How unset object/collection inputs are meant to be supplied by modifier users
|
||||
in every root object.
|
||||
|
||||
This is enough understanding to choose translation targets intelligently. It is
|
||||
not enough to claim the whole town can be regenerated from script.
|
||||
|
|
@ -10,6 +10,8 @@
|
|||
- `PointyGothicCone`
|
||||
- Geometry Script recreation:
|
||||
`examples/geometry_script/ircss_french_houses.py`
|
||||
- File-level system map:
|
||||
`docs/research/translations/ircss-french-houses-system-map.md`
|
||||
|
||||
## Why This File
|
||||
|
||||
|
|
|
|||
|
|
@ -49,7 +49,8 @@ repeat-zone feedback state, repeat `Top` boolean outputs, foreach zones, gizmo
|
|||
nodes, and a rejected empty-output harness for `WindowBeams`. The previous
|
||||
`nodes_to_script` duplicate-key failure around axes-to-rotation is fixed in the
|
||||
Geometry Script fork, so `GenerateArc` and `MakeStairs` now have compiling
|
||||
converter drafts.
|
||||
converter drafts. The file-level dependency map lives at
|
||||
`docs/research/translations/ircss-french-houses-system-map.md`.
|
||||
|
||||
Current authoring prior: use the full Python stack. Python structures intent,
|
||||
tables, loops, variants, cleanup, validation, docs, and scene/render
|
||||
|
|
|
|||
|
|
@ -30,3 +30,4 @@
|
|||
{"ts": "2026-05-04T18:01:03+00:00", "type": "maintenance", "status": "accepted", "note": "Distilled persistent state: handoff now points to corpus docs instead of duplicating completed graph lists; implementation plan reflects post-corpus contract and IRCSS frontier; compaction helper warns on bloated handoff and stale first-corpus planning."}
|
||||
{"ts": "2026-05-04T19:01:27+00:00", "type": "verification", "status": "accepted", "note": "Added IRCSS PointyGothicCone translation as VG Pointy Gothic Cone; plain and ornamented harness cases match source evaluated geometry with sorted max vertex delta 0.0, proving ornament can be grown from captured structural ribs after instancing."}
|
||||
{"ts": "2026-05-04T19:05:41+00:00", "type": "tooling", "status": "accepted", "note": "Patched Geometry Script nodes_to_script on branch vibegeometry/blender-5-nodes-to-script to drop duplicate property keywords when a same-named input socket exists; GenerateArc and MakeStairs now compile from converter drafts, and expanded IRCSS smoke passes for 11 target groups."}
|
||||
{"ts": "2026-05-04T22:03:08+00:00", "type": "research", "status": "accepted", "note": "Mapped IRCSS French Houses at file level: 108 node groups, 63 modifier roots, 163 dependency edges, composer/organ/utility hierarchy, dependency hubs, blocker feature counts, and next target candidates. Inspector now records nested GeometryNodeGroup node_tree references."}
|
||||
|
|
|
|||
|
|
@ -68,6 +68,7 @@ current_artifacts:
|
|||
- docs/architecture/pipeline-overview.md
|
||||
- docs/research/procedural-doctrine.md
|
||||
- docs/research/geometry-script-fork-notes.md
|
||||
- docs/research/translations/ircss-french-houses-system-map.md
|
||||
tools:
|
||||
- tools/vibegeometry_state.py
|
||||
- tools/vibegeometry_prepare_compaction.py
|
||||
|
|
@ -91,7 +92,7 @@ data_flow:
|
|||
- If state grows faster than understanding, cut it back.
|
||||
|
||||
current_status:
|
||||
summary: VibeGeometry has an initial persistence scaffold plus verified Geometry Script translations for local math/utility samples, a first official Blender demo tranche, and two IRCSS French Houses city-scale footholds. The IRCSS pass verified MakeSpiral as an architectural spine and PointyGothicCone as ornament grown from a structural host, while mapping blockers in larger systems: repeat-zone feedback, repeat Top outputs, foreach zones, and gizmo nodes. The repo-local Geometry Script fork includes a Blender 5.1 nodes_to_script converter port plus nested-group, menu-socket, and duplicate-key fixes needed by these translations.
|
||||
summary: VibeGeometry has an initial persistence scaffold plus verified Geometry Script translations for local math/utility samples, a first official Blender demo tranche, and two IRCSS French Houses city-scale footholds. The IRCSS pass verified MakeSpiral as an architectural spine and PointyGothicCone as ornament grown from a structural host, and now includes a file-level dependency map of the 108-group town kit. The remaining large-system blockers are repeat-zone feedback, repeat Top outputs, foreach zones, and gizmo nodes. The repo-local Geometry Script fork includes a Blender 5.1 nodes_to_script converter port plus nested-group, menu-socket, and duplicate-key fixes needed by these translations.
|
||||
next_action: Continue IRCSS French Houses by using the newly compiling GenerateArc/MakeStairs converter drafts as candidates for the next city-organ translation, or select another non-zone architectural helper with a non-empty behavioral harness.
|
||||
remotes:
|
||||
vibegeometry: https://github.com/GameCult/VibeGeometry
|
||||
|
|
|
|||
|
|
@ -95,7 +95,7 @@ def _node_summary(node: Any) -> dict[str, Any]:
|
|||
continue
|
||||
if value is None or isinstance(value, (str, int, float, bool)):
|
||||
properties[prop.identifier] = value
|
||||
return {
|
||||
summary = {
|
||||
"name": node.name,
|
||||
"label": node.label,
|
||||
"bl_idname": node.bl_idname,
|
||||
|
|
@ -105,6 +105,10 @@ def _node_summary(node: Any) -> dict[str, Any]:
|
|||
"inputs": [_socket_summary(socket) for socket in node.inputs],
|
||||
"outputs": [_socket_summary(socket) for socket in node.outputs],
|
||||
}
|
||||
node_tree = getattr(node, "node_tree", None)
|
||||
if node_tree is not None:
|
||||
summary["node_tree"] = getattr(node_tree, "name", "")
|
||||
return summary
|
||||
|
||||
|
||||
def _link_summary(link: Any) -> dict[str, str]:
|
||||
|
|
|
|||
Loading…
Reference in a new issue