debim v1.1.0 — Urban Scale GIS Ingestion & ISO 19650 IFC4.3 Civil Infrastructure

debim v1.1.0 — Urban Scale GIS Ingestion & ISO 19650 IFC4.3 Civil Infrastructure

We are proud to release debim v1.1.0, expanding the declarative Building-as-Code engine from standalone buildings to macro-urban scale digital twins and civil infrastructure compliant with buildingSMART ISO 19650 IFC4.3!

---

🏙️ What's New in v1.1.0

1. Open GIS to .debim Ingestion Pipeline (debim urban ingest)

• OSM Overpass Ingestion: Ingest entire city bounding boxes directly from OpenStreetMap Overpass API into native .debim AST.
• GeoJSON Feature Collection: Automatic translation of 2D polygon footprints into 3D extruded IfcBuildingElementProxy and 2D linestrings into swept IfcRoad entities.
• Pure Python WGS84-to-UTM Projector: Lossless translation between spherical GPS coordinates (WGS84) and metric Cartesian coordinates (EPSG:32647) with zero external C-dependencies.

2. ISO 19650 & buildingSMART IFC4.3 Infrastructure Entities

• Real-World Geo-Referencing: Automatic compilation of IfcProjectedCRS and IfcMapConversion anchors ensuring geospatial BIM alignment in GIS viewers, BlenderBIM, and Civil 3D.
• Linear Infrastructure Spatial Hierarchy: Support for IfcFacility, IfcRoad, and IfcFacilityPart (ROADWAY, SIDEWALK, SHOULDER).
• Corridor Sweeper: Geometry generation using IfcSectionedSolidHorizontal swept solids along road alignments.
• Civil & Utility Entities: Native support for IfcPavement (layered asphalt & sub-base), IfcKerb (precast concrete curbs), and IfcPipeSegment (drainage culverts).

3. High-Performance Kaggle Urban Benchmark Lab

• Stress Tested at 10,000 Elements: Proven end-to-end ingestion, resolving, and compilation throughput on Kaggle (pridatakon/debim-urban-gis-benchmark).
• Storage Efficiency: Proven 1.7x - 1.8x storage compactness of .debim compared to verbose ISO 10303-21 STEP IFC4.3 files.
• Fast Iterations: Ingestion & resolving in seconds, enabling fast design iterations before emitting final IFC artifacts.

4. Autonomous Agent Workflow (Jules Watchdog)

• Coordinated multi-stage feature delivery with Jules AI and jules_watchdog orchestrator, passing 100% of unit tests and regression suites across all milestones.

---

📦 Installation & Upgrade

pip install -U debim

Verify version:

debim --version
# debim, version 1.1.0

debim v1.0.0 — The Pure Algorithmic Architecture Release

debim v1.0.0 — The Pure Algorithmic Architecture Release 🏛️✨

Official General Availability (GA) release of debim.

Highlights:

• Pure Algorithmic Architecture Engine: Multi-level \POLYGONAL_LOFT, \HYPERBOLIC_LOFT, Chaikin corner fillets, and freeform swept surfaces.
• Complex Structural Generators: 28 Swept Curved Columns (3D spline directrix), full-height Storey Diagrid X-Bracing, Horizontal Ring Beams, and Roof Compression Crown Radial Truss.
• Conformal Hexagonal Tessellation: Double-curved surface discretization with uniform reveal gaps and WebGL InstancedMesh rendering at 60 FPS.
• Flagship Landmark Benchmark: Full declarative model of Museo Soumaya (Fernando Romero / Ove Arup).
• Model Context Protocol (MCP): Officially recognized and approved in \�wesome-mcp-servers.

v0.9.0: Spatial Programming, 2D Fit Solver, 5-Layer Audit Matrix & Auto-Framing Engine

What's Changed in debim v0.9.0

🏛️ 1. Human Scale Furniture Variables & Clearance Envelopes (Wave 1 - #468)

• Declare standard architectural furniture dimensions and human activity clearance envelopes under variables:.
• Supports CLEARANCE_BED, CLEARANCE_DESK, CLEARANCE_DINING, CLEARANCE_WARDROBE, and sanitary units.

📐 2. Programmatic Space Scopes & Auto-Sizing (Wave 2 - #470)

• IfcSpace consumes declared variable references (contains: [ref: ...]).
• Automatically computes minimum net required area using the architect formula:
  $$\text{Required Area} = \left(\sum \text{Footprint of Contained Items}\right) \times 1.30$$

⚡ 3. Pre-flight 2D Geometric Furniture Fit Solver (Wave 3 - #472)

• Exposes CLI command debim fit -m <project.debim> with instant (< 0.01s) Pass/Fail verification.
• Pure-Python / NumPy 2D Bounding Box packing and Separating Axis Theorem (SAT) collision checking.
• Verifies walkway connectivity (min 0.60m corridor) between space entrance and functional envelopes.

🛡️ 4. 5-Layer Architectural & Engineering Audit Matrix & Flight Recorder (Wave 4 - #474)

• Exposes CLI command debim audit -m <project.debim> [--fix].
• 5 Verification Layers:
  1. Spatial & Functional: Net area compliance, non-overlapping furniture clearance, 2.60m clear head-room.
  2. Legal & Life Safety: Thai Building Act MR 55 (ventilation >= 10%, bathroom drop <= -0.10m, stair treads/risers).
  3. Structural Load Continuity: Column continuous vertical stack, beam supporting walls, roof-to-foundation load path.
  4. MEP Flow & Gravity: Sanitary drain slope >= 1:100, vent stacks to exterior, zero MEP-structural collisions.
  5. Constructability & Clashes: Zero hard clashes between Arch, Struct, and MEP.
• Actionable Structured Remediation proposals with automated fix suggestions.
• Telemetry Flight Recorder exporting audit_log.json and human-readable audit_report.md.

🧩 5. Touching Spaces Relative Syntax & Auto-Derivation Engine (Wave 5 - #476)

• Model buildings simply by declaring how spaces touch each other: touching: { target: str, side: NORTH|SOUTH|EAST|WEST, align: LEFT|RIGHT|CENTER|TOP|BOTTOM }.
• Exposes CLI command debim derive -m <floorplan.debim> -o <project.debim>.
• Automatically derives:
  • Shared touching boundary -> internal IfcWall
  • Exterior boundary -> exterior IfcWall + IfcWindow
  • Must-connect spaces -> centered IfcDoor
  • Touching corner vertices -> IfcColumn
  • Wall baselines -> IfcBeam and IfcSlab

v0.8.0 — Engineering Productivity, Framing Macros & High-Fidelity 3D

Overview

debim v0.8.0 incorporates key technical feedback from real-world residential modeling ('บ้านครอบครัวไทยเป็นสุข ๘' - 214 BIM Elements). This release introduces dual Pydantic compatibility for air-gapped sandboxes, single-point offsets, framing array macros, interactive 3D storey isolation, and net wall opening deductions.

1. Pydantic v1 & v2 Dual-Compatibility Shim

• Seamless execution in older Google Colab and Linux environments without RootModel ImportError.

2. Point Offsets & Grid Arithmetic on Columns, Footings, and Walls

• Direct offset_x & offset_y on ColumnPlacement, FootingPlacement, and WallPlacement.
• Support for arithmetic grid coordinates: grid: ['3 + 1.00', 'ข - 0.50'].

3. Structural Framing Array Macros (ColumnGrid & BeamBay)

• Eliminate repetitive line-by-line coding: automatically expand 2D grid matrices into distinct IfcColumn and IfcBeam entities.

4. Smart 3D Floor Isolation & Net Wall Area Deductions

• Interactive storey filter buttons in Three.js WebGL viewer to isolate and inspect interior framing.
• Precise net masonry and plaster deductions for host-wall window/door openings in QTO and Thai CGD ว480 BOQ.

v0.7.0 — Contemporary Thai Architecture, Local Offsets, Composite Hip Roofs & Host Openings

Overview

debim v0.7.0 introduces deep geometric and architectural parametric enhancements derived from modeling complex real-world residential architecture ('บ้านร่วมสมัย ๙' - 168 BIM Elements). This release eliminates auxiliary dummy grid workarounds, handles non-convex roofs with automatic valley/hip ridge solvers, simplifies recessed/sunken slabs, enables host-wall window/door auto-punching, and supports multi-flight dog-leg stair scheduling.

1. Local Grid Expressions & Arithmetic Boundary Offsets

• Eliminates auxiliary virtual grids for cantilevers, balconies, and wet areas.
• Arithmetic expressions: ['1 - 0.60', 'B + 1.20'] inside boundary and voids.
• Recessed/sunken slabs via elevation_offset on IfcSlab.

2. L-Shaped Composite Hip Roof with 3D Valley & Hip Solver

• Solves 3D bisector intersections to generate hips (สันตะเข้) and valleys (ตะเข้ราง) automatically.
• Supports multi-level eaves and non-convex roof footprints.

3. Host-Wall Auto-Punching & Multi-Storey Openings

• host_wall: TAG automatically punches boolean cutouts through wall geometry.
• span_storeys: ['L1', 'L2'] allows tall stairwell windows across multiple floors.

4. Multi-Flight Dog-Leg Stairs Scheduling & Landing Elevation

• Explicit flight step distribution: flight_steps: [11, 6].
• Explicit landing elevation datum: landing_elevation: 2.20.
• Exact monolithic RC waist and landing QTO.

5. Documentation, Skills & AI Context Updates

• Updated SKILL.md, llms.txt, and README.md with v0.7.0 declarative schemas.

v0.6.0 — Production-Grade Commercial Architecture & Official Thai CGD ว480 BOQ Engine

🏛️ debim v0.6.0: Production-Grade Commercial Architecture & Official Thai CGD ว480 BOQ Engine

"Scale from simple pavilions to full multi-bay commercial complexes and vernacular architecture with zero-dependency declarative building-as-code and deterministic Thai government cost estimation."

---

Highlights & Major Features

1. Multi-Bay Modular Architecture & AST Expansion (modules:, instances: replicate:)

• AST Preprocessor: Declarative definition of reusable spatial blocks via modules: and automatic replication via instances: replicate:.
• Dynamic Grid Remapping: Multi-axis grid translations (along: grid_x, along: grid_y) with per-unit prefix patterns (e.g. U{index}_).
• Party Wall Deduplication: Automated structural detection and deduplication of party walls between adjoining units, avoiding double-counting in geometry and BOQ.
• Real-World DPT Validation: Proven against the official Department of Public Works and Town & Country Planning (กรมโยธาธิการและผังเมือง) 4-bay 3-storey shophouse (shophouse_isan_3fl.debim, 371 elements), reducing manifest length by over 75%.

2. Slab Voids & Double-Volume Cutouts (IfcSlab.voids)

• Inner Boundary Loops: Native support for slab voids (voids:) for stairwells, light shafts, and double-volume atriums.
• Accurate QTO Deductions: Concrete volumes and formwork surface areas automatically deduct interior cutouts via Shoelace polygon math.

3. Parametric Roof Generator (IfcRoof)

• Vernacular & Modern Typologies: Built-in geometric generators for GABLE_HIP (Manila / ทรงจั่วผสมปั้นหยา), HIP (ปั้นหยา), GABLE (จั่ว), and SHED (เพิงหมาแหงน).
• Pitch Angle Geometry (pitch_deg): Direct degree-based pitch inputs eliminating complex manual trigonometric offsets.
• Automated Framing: Generates structural framing elements (rafters, purlins, steel weight per m²) for exact structural costing.

4. Monolithic RC Dog-Leg Stairs Engine (IfcStair: DOG_LEG)

• Engineering-Grade Stairs: Generates full reinforced concrete dog-leg stairs with intermediate landings, flights, risers, treads, and waist thickness.
• Zero-Dependency 3D Mesh: Procedural step-and-landing solid geometry rendered in the standalone HTML viewer and compiled to standard OpenBIM IFC4.

5. Official Thai Comptroller General's Department CGD ว480 BOQ Engine (debim boq --rules cg-v480)

• Standard Public Works Sheets: Generates official government tender documents:
  • แบบ ปร.4: Detailed quantity take-off, material unit costs, and labor rates.
  • แบบ ปร.4(พ): Reinforcement steel schedules (RB6, RB9, DB12, DB16, DB20, DB25) and formwork summary.
  • แบบ ปร.5: Direct cost summary, official Factor F table with linear interpolation, and VAT 7%.
• Provincial Price Index Multipliers (--province <name>): Built-in material price indexes across all 77 Thai provinces.
• Excel Export (--export-excel): Professional multi-sheet Excel workbook export (.xlsx).

6. Structural Continuity & Bounding-Box Clash Detection (debim validate)

• Vertical Continuity Checks: Verifies that upper-floor columns rest on lower-floor structural columns or transfer beams.
• 3D Clash Detection: Fast Axis-Aligned Bounding Box (AABB) collision detection flags physical structural intersections before compilation.

7. Ecosystem & AI Agent Skills

• Antigravity & Workspace Skills: Official skills pre-configured under .agents/skills/debim and skills/debim for instant agent progressive disclosure.
• Live Ministry of Commerce Prices (thai_construction_material_prices): Bundled live material price searcher querying official TPSO data via yotathai.com.

---

CLI Command Reference (v0.6.0)

# Validate structural continuity and collision clashes
debim validate -m shophouse_isan_3fl.debim

# Generate official Thai CGD ว480 BOQ for Nakhon Ratchasima province
debim boq --rules cg-v480 --province nakhon_ratchasima -m shophouse_isan_3fl.debim --export-excel boq_shophouse.xlsx

# Interactive 3D visualization in browser
debim view -m shophouse_isan_3fl.debim

---

debim is proudly developed and maintained by Prida Takon (@PRIDA-TAKON). Special thanks to Google Antigravity and Jules AI for pair programming and autonomous execution!

v0.5.0 — The Mermaid.js of BIM (Zero-Dependency & Standalone .debim Architecture)

🏛️ debim v0.5.0: The Mermaid.js of BIM

"A zero-dependency, pure-Python declarative BIM engine designed for AI Agents, LLM Code Interpreters, and air-gapped sandboxes."

---

Highlights & Major Changes

1. Zero-Dependency Core Architecture

• Standard Library CLI: Eliminated typer and rich dependencies in favor of Python's standard library argparse and high-performance pure-terminal ANSI styling (#279).
• Divergence Theorem Volume Math: Eliminated trimesh dependency by computing 3D watertight mesh volumes directly via divergence theorem vector arithmetic and NumPy array slicing (#277).
• Pure-Python 2D Geometry Engine (geometry2d.py): Replaced shapely with zero-dependency Shoelace area, perimeter, point-in-polygon, and polygon insetting algorithms (#281).

2. Deterministic Anchor Points & Spatial Orientation Rules

• Rigorously enforced coordinate anchor positions across all element classes to eliminate AI ambiguity:
  • IfcWall: BOTTOM-START-CENTERLINE ([thickness, height])
  • IfcColumn: BOTTOM-CENTER ([width, depth])
  • IfcBeam: TOP-CENTERLINE ([width, depth])
  • IfcSlab: TOP-FINISH ([thickness])
  • IfcSpace: BOTTOM-PERIMETER ([height])
  • IfcFurniture: BOTTOM-CENTER ([width, depth, height])
• Enforced standard Z-up Euler angles in radians [rx, ry, rz] (#283).

3. Official .debim File Format & Standalone Loader

• Full support for the native .debim file extension across all CLI and API commands (#285).
• Added built-in pure-Python fallback YAML parser (_pure_yaml_parse) capable of parsing debim manifests in bare Python sandboxes without requiring external packages.

4. Complete IfcSpace Support (Room Boundary Volumes)

• Grid-offset expressions (e.g. GX_1 + 0.10), polygon boundary points, and automated wall insetting.
• Automated room usable floor area, perimeter, and HVAC air volume QTO calculations (#275).

5. Modular Ecosystem Packaging

• Core package installable with zero external bloat.
• Optional compiler plugins organized under extras: debim[ifc], debim[cad], debim[mcp], debim[all] (#287).

---

Thank you to all contributors and autonomous AI agents for making declarative Building-as-Code a reality!

v0.4.0 — 3D Procedural IFC Encyclopedia & Spatial Calibration Engine

🌟 What's New in v0.4.0

debim v0.4.0 marks a monumental milestone: 100% Procedural 3D Geometry Coverage across all 143 IFC4 / IFC4.3 Element Classes and the debut of the Interactive 3D Transform & Sizing Calibration Engine!

---

🎨 1. 100% Procedural 3D Geometries (143/143 IFC Classes)

• Zero Generic Boxes Remaining: Every single IFC element class now renders with dedicated, realistic procedural parametric geometries.
• 73 Unique Specialized Shapes spanning all 4 core disciplines:
  • 🏗️ Structure: RC Columns & Beams with rebars, Footings, Slabs, Deep Foundations, Tendons, Structural Accessories.
  • 🏢 Architecture: Monolithic RC Stairs, Timber/Steel Stringer Flight Stairs, Ramp Slopes, Curtains Walls, Windows, Railings, Doors, Roofs.
  • ⚡ MEP (Mechanical, Electrical, Plumbing): Pumps, Boilers, Chillers, Air Terminals, Packaged Rooftop RTUs, Distribution Chambers, Flow Instruments, Cable Trays, Ducts, Transformers, Circuit Breakers, Solar PV Panels, Interceptors.
  • 🌉 Civil & Infrastructure (IFC4.3): Culverts, Breakwaters, Bridges, Revetments, Railway Tracks, Marine Mooring Hardware.

---

📐 2. Interactive 3D Spatial Transform & Sizing Control Panel

• Floating Transform Toolbar: Real-time manipulation of selected elements:
  • Coordinates: $X, Y, Z$ Position sliders with Elevation Ground Alignment.
  • Rotation: Yaw, Pitch, Roll ($0^\circ - 360^\circ$) with centroid preservation.
  • Parametric Sizing: Dynamic Scale Width, Depth, Height ($0.2\times - 3.0\times$) with bottom ground-anchoring.
• SketchUp-Style Crisp Edges: Slate-900 sharp vector outlines superimposed on WebGL meshes.
• Inspection Tools: X-Ray rebar cage toggle, Wireframe mode, and Bounding Box helpers.

---

🧪 3. Automated Spatial Transforms Benchmark (100.0% PASS)

• Built-in Playwright automated headless benchmark (tools/benchmark_spatial_transforms.py):
  • Ground Rest Alignment ($Y=0$): 143/143 (100.0% Pass)
  • Elevation Offset (+2.0m, $X, Z$ stability): 143/143 (100.0% Pass)
  • Yaw Rotation Invariance ($90^\circ$): 143/143 (100.0% Pass)
  • Parametric Sizing Fidelity: 143/143 (100.0% Pass)

---

📦 4. Zero-Dependency Distribution

• Single Standalone HTML: dist/class_directory.html requires 0 npm/node packages and runs offline in any modern browser.
• Documentation Suite: dist/docs/index.html with bSDD Property Set definitions, IFC Type hierarchies, and real-time Thai Construction Material pricing integration.

v0.3.1 — Solid Block Terminal Banner & Developer Branding

🚀 debim v0.3.1 — Solid Block Terminal Banner & Developer Branding

We are pleased to release debim v0.3.1, bringing a refreshed high-impact terminal CLI aesthetic and developer branding.

✨ What's New in v0.3.1

1. 💻 Solid Block Terminal Banner (>_ DEBIM)

• Redesigned the CLI launch banner to feature a solid block prompt chevron (>) and cursor (_) aligned perfectly in 3D block shadow typography.
• Creates a powerful, monolithic visual balance that reflects the robust Building-as-Code & OpenBIM architectural engine.

2. 👨‍💻 Developer Branding & Identity

• Added developer credit directly into the terminal CLI banner and --version\ output:
  \Declarative BIM Compiler v0.3.1 | Developer: Prida Takon (@PRIDA-TAKON)\
• Synchronized release manifests across PyPI and Windows Package Manager (WinGet).

---

Full Changelog: v0.3.0...v0.3.1

v0.3.0 — 2D Blueprints, MEP & IFC4.3 Infrastructure Engine

??? debim v0.3.0 ? The Unified Architecture & Infrastructure Release

We are excited to announce debim v0.3.0, a major evolution expanding debim beyond structural modeling into complete 2D architectural blueprint drafting, full MEP distribution topology, civil infrastructure (IFC4.3), and automated MasterFormat architectural specification compilation.

? What's New in v0.3.0

1. ?? 2D Architectural Blueprint & DXF Export Engine

• Horizontal & Vertical Section Slicing: Cut-plane slicing for floor plans and building sections (debim draw view).
• 4-Direction Elevations: Automated North, South, East, and West architectural projections.
• Standalone 2D Viewer: Interactive SVG blueprint viewer (�iewer_2d.html) with pan-zoom and measurement ruler.
• AutoCAD DXF Export: Direct export into standard CAD layers (A-WALL, S-COLS, A-GRID, A-DOOR, A-WIND) via ezdxf (debim draw export-dxf).
• Flexible Title Blocks: Configurable metadata, responsive typography, and Thai font support.

2. ? Full MEP Distribution Systems

• HVAC, Plumbing & Electrical Fixtures: Full IFC4 coverage for air terminals, dampers, sanitary ware, lighting fixtures, and distribution boards.
• Port-based Topology: Explicit port connectivity (IfcDistributionPort) and network graphs for MEP flow calculations.

3. ??? Civil Infrastructure & IFC4.3 Support

• Alignments & Roads: 3D alignment curve sweeping, road profiles, and bridge structures (IfcAlignment, IfcRoad, IfcBridge).
• Earthworks & Retaining Walls: Cut and fill soil volume take-offs and retaining wall calculations.

4. ?? Declarative Specification Book Engine

• MasterFormat Compiler: Automated compilation of architectural specifications (debim spec build).
• MS Word (.docx) Export: Native DOCX export with project organization, architect, engineer, and approval sheets.
• Open Registry & Discrepancy Auditor: Detect discrepancies between 3D BIM elements and written specifications (debim spec audit).

5. ?? bSDD Validation & Universal Schema Registry

• Automated Pset Validation: Integration with buildingSMART Data Dictionary (bSDD) for standardized property set compliance.
• Universal Declarative Proxy: Fallback engine supporting extended IFC entity subtrees.

6. ?? Packaging & Distribution

• PyPI Release: Available via pip install -U debim
• Windows Package Manager (WinGet): Automated packaging for standalone Windows binary (winget install debim).
• Full Test Suite: 454 deterministic unit tests passing (100% pass rate).

---

Full Changelog: v0.2.2...v0.3.0