FLOOR-PLAN COMPILER Version 10.0

FLOOR-PLAN COMPILER

Version 10.0

Wickerson Studios

https://www.wickersonstudios.com

====================================

README.txt

====================================

Overview

--------

The Floor-Plan Compiler v10.0 is a two-stage pipeline for converting raster

floor plan images (PNG/JPG/PDF) into structured vector geometry and downstream

3D-ready building elements.

The system is designed for:

- Scanned architectural plans

- Low-contrast or noisy PNGs

- AI-assisted vectorization with deterministic post-processing

- Grasshopper + Rhino workflows

This release focuses on:

- Higher accuracy on raster inputs

- Reduced runtime and payload size

- Stricter topology validation

- Cleaner wall, opening, and room extraction

------------------------------------

SCRIPT ARCHITECTURE

------------------------------------

The compiler consists of two primary scripts:

1) Script_01 – Raster → PlanVec (Analysis & Extraction)

2) Script_02 – PlanVec → Geometry (Rhino / Grasshopper)

They are designed to be run sequentially.

------------------------------------

SCRIPT_01 : VECTOR EXTRACTION

------------------------------------

Purpose:

- Accepts PNG/JPG/PDF floor plan input

- Performs preprocessing (upscale, binarize, edge detect)

- Generates targeted image crops

- Sends image payloads to the model

- Produces a PlanVec JSON structure

Key Outputs:

- Walls (segments, chains)

- Doors and windows

- Corners and joins

- Spaces / rooms

- Confidence metadata

- Updated PlanVec JSON

Major Features (v10.0):

- Reduced crop grid for faster inference

- High-value center + edge crops only

- Stricter opening confidence filtering

- Improved snapping and chain continuity

- Deterministic ordering (optional)

------------------------------------

SCRIPT_02 : GEOMETRY BUILDER

------------------------------------

Purpose:

- Consumes PlanVec JSON

- Builds Rhino geometry:

 - Wall breps and curves

 - Door and window cutters

 - Optional booleans

 - Room outlines and slabs

 - Adjacency visualization

- Outputs clean, stable geometry for downstream use

Key Outputs:

- Wall Breps / Curves

- Door & Window Geometry

- Room Curves / Breps

- Adjacency Curves

- Overlay Diagnostics

- Updated PlanVec JSON

Major Features (v10.0):

- Chain-based wall extrusion

- Robust fallback logic

- Strict opening-on-wall enforcement

- Faster union and boolean safety

- Deterministic geometry ordering

------------------------------------

MASTER CFG (CONFIGURATION)

------------------------------------

Both scripts are driven by a shared text-based configuration (CFG).

The CFG controls:

- Image preprocessing resolution

- Crop count and size

- Geometry tolerances

- Opening confidence thresholds

- Room extraction behavior

- Performance vs accuracy tradeoffs

Version 10.0 introduces:

- Optimized defaults for PNG input

- Significantly reduced runtime

- Higher wall and opening accuracy

- Lower hallucination rate

See the provided example CFG for recommended defaults.

------------------------------------

PERFORMANCE EXPECTATIONS

------------------------------------

Typical runtimes (single floor, PNG):

- Small / clean plan:

 ~2–4 minutes total

- Medium complexity plan:

 ~4–7 minutes total

- Large or noisy scans:

 ~7–10 minutes total

If runtime exceeds 10 minutes:

- Reduce cropGridN

- Reduce cropMaxSidePx

- Disable deterministic IDs

- Verify PNG resolution is reasonable

------------------------------------

INPUT IMAGE GUIDELINES

------------------------------------

Best results are achieved with:

- Grayscale or black-and-white plans

- Clear wall thickness

- Minimal furniture / fixtures

- Resolution between 1500–3000 px max side

Avoid:

- Heavy textures

- Color-coded plans

- Excessive annotations

- Perspective distortion

------------------------------------

OUTPUT DATA

------------------------------------

Primary data format:

- PlanVec JSON (versioned, extensible)

The PlanVec structure includes:

- Walls, segments, chains

- Doors and windows with confidence

- Spaces and rooms

- Adjacency metadata

- Fit and scaling information

PlanVec is designed for:

- Rehydration into geometry

- Export to CAD/BIM

- Downstream AI or rule-based processing

------------------------------------

KNOWN LIMITATIONS

------------------------------------

- Curved walls are approximated as polylines

- Very low-resolution scans may lose openings

- Complex multi-story logic is not inferred

- Furniture is intentionally ignored

------------------------------------

VERSION HISTORY

------------------------------------

v10.0

- Major performance optimizations

- Improved PNG accuracy

- Reduced hallucinations

- Cleaner geometry output

- Stable CFG-driven behavior

------------------------------------

LICENSE / USAGE

------------------------------------

© Wickerson Studios

All rights reserved.

This software is provided for internal, licensed, or evaluation use only.

Contact Wickerson Studios for commercial licensing and integrations.

------------------------------------

CONTACT

------------------------------------

Wickerson Studios

https://www.wickersonstudios.com