Architecture and BIM · Pathway

From an IFC file to checked information.

Five katas on one small, openly licensed building model. Each step has a real file you can open and a check result that CI computes on every pipeline.

01 / The files

One wall, one opening, one window

The model is buildingSMART’s wall-with-opening-and-window test file: schema IFC4, lengths in millimetre. It is tiny on purpose, so every entity can be read and every check can be followed by hand. It is a test file, not a building.

Mesh is not BIM. The 3D room scan is a surface you can look at; this model is data with types, properties and relationships you can query and check.

02 / What is in the model

3 elements in one storey

Elements, from the CI inspection of the original file
EntityClassNameGlobalId
#45IfcWallWall for Test Example3ZYW59sxj8lei475l7EhLU
#80IfcOpeningElementOpening Element for Test Example2bJiss68D6hvLKV8O1xmqJ
#102IfcWindowWindow for Test Example0tA4DSHd50le6Ov9Yu0I9X

The opening #80 voids the wall #45, and the window #102 fills the opening #80. Full inspection (JSON) · property sets (JSON).

03 / The steps

Five katas, in order

Each kata has a brief, prompts, checks and the evidence for the checks the Dojo has run. They are drafts: the Dojo built the example and CI checks it, and no learner has run them yet. Do the foundations first: Compare AI instructions and Spot a context trap. If you have not read an IFC file before, Find the story in a building model walks through the same sample by hand.

  1. BIM-001 Inspect an IFC model

    Schema, units, the spatial tree, every element and how the opening and window relate to the wall.

  2. BIM-002 Read the property sets

    Every property on the wall and window, with its type, and the ones that are empty.

  3. BIM-003 Check the model against IDS requirements

    Run six practice requirements with IfcTester and explain the one that fails.

  4. BIM-004 Change the model and check it again

    One scoped edit, every GlobalId kept, then IDS, schema and geometry checks rerun on the copy.

  5. BIM-R01 BIM Randori: an unseen requirement change

    A partner reveals one new requirement after you start; meet it without breaking the others.

04 / The checks

Three separate outcomes, no combined score

Information, schema and geometry answer different questions. A model can pass one and fail another, so each is reported on its own. These results come from CI: the pipeline reruns /examples/bim-pathway/tools/bim_pathway.py and fails if any output differs from the published files.

Information: IDS requirements

Practice IDS results: original sample and edited copy
RequirementOriginalEdited
REQ-01 Walls say whether they are externalPassPass
REQ-02 Walls say whether they are load bearingPassPass
REQ-03 Walls carry a fire rating label in the practice formatFailPass
REQ-04 Windows have an overall width and heightPassPass
REQ-05 Walls and windows are placed in a building storeyPassPass
REQ-06 Windows state their thermal transmittancePassPass

Original: 5 passed, 1 failed. Edited: 6 passed, 0 failed. REQ-03 failed on the original because the wall’s FireRating is an empty label; IfcTester reports an empty value as a missing property.

The change (BIM-004)

#45 Pset_WallCommon.FireRating: “” to “REI 60”. 24 of 24 GlobalIds kept, 0 added. “REI 60” is a practice placeholder that meets the practice pattern; it is not a fire rating. Change record (JSON).

Schema

IFC4 schema check with ifcopenshell.validate (EXPRESS rules off): original 0 issues, edited 0 issues. Result (JSON).

Geometry

Shapes built with ifcopenshell.geom, openings cut, in metres
ElementBuilt (original, edited)Volume m³Bounding box
#45 IfcWallyes, yes1.50, 0, 0 to 3, 0.3, 2
#80 IfcOpeningElementyes, yes0.31, 0, 0.5 to 2, 0.3, 1.5
#102 IfcWindowyes, yes0.21, 0.05, 0.5 to 2, 0.25, 1.5

The wall is 3 × 0.3 × 2 m less the 1 × 0.3 × 1 m opening: 1.5 m³. Building a shape shows it can be processed; it is not a clash, tolerance or constructability check.

Randori cards

Checked against the edited copy: CARD-A fail, CARD-B pass, CARD-C pass. The cards (IDS) are for the partner; see BIM-R01.

05 / The tools

Open tools, pinned versions

What the checks use, from each publisher’s own pages (checked 21 November 2026)
Tool or standardVersionLicenceSource
IfcOpenShell0.9.0.post1LGPL-3.0-or-laterPyPI, validation, geometry
IfcTester0.9.0LGPL-3.0-or-laterPyPI, documentation
Python3.12PSFCI image python:3.12-slim
IDS (buildingSMART)1.0Open standardrepository, schema
IFC (buildingSMART)IFC4 (as the sample declares)Open standardDeclared in the file’s FILE_SCHEMA

The Armory lists IfcOpenShell and IfcTester with their smoke tests, and the stack recipe IfcOpenShell, IfcTester and Python.

06 / What is checked

Verified, and not verified

Verified

  • The model is the pinned buildingSMART file, unchanged (SHA-256 73b0e45d931d…, checked by the site’s tests).
  • Both IDS files open with XML schema validation on, as IDS 1.0.
  • On every pipeline, CI installs the pinned packages by hash, reruns the inspection, property, IDS, schema and geometry checks on the original and the edited copy and the Randori cards, rebuilds the edited file, and fails if any output differs from the files on this page. (evidence)
  • The edit changes one property and keeps every GlobalId. (evidence)

Not verified

  • Any real building, design value or project requirement. The requirements are invented for practice, and the sample is a test file.
  • EXPRESS where-rules and buildingSMART’s own validation service: the schema check ran with EXPRESS rules off.
  • Clash detection, tolerances, quantities for cost, or construction sequence.
  • Opening the files in a BIM authoring tool or a web IFC viewer, and round trips through other tools.
  • Use by real learners: no learner has run these katas yet.

Professional review: None. Nothing here has professional, regulatory or construction approval of any kind, and a real project needs the qualified reviewers its contract and jurisdiction name.

07 / Credits

Credits and terms

  • Model: wall-with-opening-and-window.ifc, © buildingSMART International Ltd., from the Certification-datasets repository at a pinned commit, licensed CC BY 4.0. The edited copy is an adaptation: one property changed and the file header rewritten by the Dojo.
  • The IDS files, the pathway script and its outputs: Developer Dojo, MIT licence.
  • IfcOpenShell and IfcTester: the IfcOpenShell project, LGPL-3.0-or-later.