Files
cad-building-showcase/references/campus_workflow.md

54 lines
2.8 KiB
Markdown

# Campus and Multi-Building Workflow
## Contents
1. Branch selection
2. Placement evidence
3. Site outlines and missing buildings
4. Assembly gates
5. Site context
## Branch Selection
Treat folders such as `1#厂房 / 2#厂房 / 3#辅房 / 总图` as a campus, not floors of one building. Produce one frame-detection run, config, spec, and model per delivered building drawing set. Keep site plans in their own units.
Building plans are usually millimeters; total/site plans may be meters at surveying coordinates. Never combine both in one extraction config. Convert everything to site-local meters before GLB export; raw coordinates hundreds of kilometers from origin lose float32 precision.
## Placement Evidence
Prefer anchors in this order:
1. coordinate callouts;
2. wall lines;
3. envelope rectangles whose dimensions equal the model wall bbox;
4. registered site outlines.
Use wall evidence, not roof/eave envelopes. Derive rotation from a matched edge and resolve the 180-degree ambiguity with an asymmetric feature such as entrances, machine rooms, or basement ramps. Save the source and reasoning in `site_manifest.json`.
For irregular outlines use `register_site_outlines.py`. Constrain the angle window when the building is visibly axis-aligned. Treat residuals roughly as: 0.06m excellent, 0.5-1m plausible with balconies, above 2m likely wrong outline/floors.
## Site Outlines and Missing Buildings
If a building has no delivered drawings but has a site outline and storey label, use `massing_from_outline.py`. Label every such floor/model as total-plan outline massing. Never silently fabricate detailed walls/windows.
Use multiple floor footprints for registration when upper wings/overhangs explain the site outline better than one floor.
## Assembly Gates
Use `assemble_campus.py` with per-building `rotation_deg` where needed. Require:
- no unexplained negative wall-envelope gaps;
- 0.15-0.30m joints corroborated as expansion joints;
- several-meter separations checked against fire/site evidence;
- all buildings inside the red line;
- a top-view overlay or render showing each model inside its site outline;
- numeric envelope dimensions and neighbour gaps in the notes/evidence.
`--allow-overlap` is for a documented shared structure or verified interlocking geometry, not a shortcut around placement bugs.
## Site Context
Use `site_context_from_dump.py` to generate ground/red-line footprints, roads, parking, fences, trees, and low-confidence context massings from one selected site-plan copy. Supply the correct per-dump unit scale, region window, origin, and exclusion quad for real modeled buildings.
Keep site context in every presentation variant. Replace context massings with real models when drawing sets exist. A campus with only boundary sticks is incomplete presentation, but visual completeness never permits fake buildings.