Specialization kata · BIM-002

Read the property sets and find what is missing

List every property set on the wall and window with its values and types, and mark the properties that exist but hold no value.

Draft. This recipe is a draft. Its checks may not have been run, and it can change.

Status
Draft
Kata ID
BIM-002
Maintainer
BIM pathway maintainer
Last verified
Not available. Built and checked by the Dojo maintainers and CI; no independent or professional review yet.
Found a problem?
Report it

The outcome

A table of every property on the wall and window, with its value, its IFC type and whether it is empty.

For: Learners who finished BIM-001.

Done when

  • Every property in Pset_WallCommon and Pset_WindowCommon is listed with its IFC type
  • Empty labels are marked as empty, not as values
  • Your table matches /examples/bim-pathway/generated/original/properties.json

You make: Property table. Outcome: Read property sets.

Showcase and provenance

The Dojo’s worked example, made by the maintainers rather than by a learner: buildingSMART’s wall-with-opening-and-window sample, a practice IDS, an edited copy and every check result, computed by the site’s CI.

See the showcase

Made by
buildingSMART International (sample model); Developer Dojo maintainers (IDS, edit and checks)
Source
buildingSMART Certification-datasets, pinned commit 80d976a9b193a26a8e928c3e79bff67af1de68a8; checks from /examples/bim-pathway/tools/bim_pathway.py
Licence
Sample model CC BY 4.0 (buildingSMART International); IDS files, script and outputs MIT
Date

Brief, inputs and constraints

Inputs

  • wall-with-opening-and-window.ifc. Source: buildingsmart/ifc-wall-example (copy on /examples/bim-pathway/). Terms: CC BY 4.0, buildingSMART International.

Constraints

  • Licensed sample only
  • No paid tools
  • Offline capable

Capabilities practised

  • Inspect model
  • Verify evidence

Stack, permissions and cost

Stack components with version, permissions and cost
PartComponentVersionPermissionsCost
ToolIfcOpenShell0.9.0.post1Reads the IFC copy you open; writes only the file your script savesFree (LGPL-3.0-or-later)
ToolIfcTester0.9.0Reads the IDS file and the IFC copy; writes only the report you ask forFree (LGPL-3.0-or-later)
RuntimePython in a virtual environment3.12Runs on your own machine; network only to install the pinned packagesFree
DatabuildingSMART wall-with-opening-and-window sample (IFC4)Certification-datasets commit 80d976a, SHA-256 73b0e45d…097832Read a copy; the licence allows changes with creditFree (CC BY 4.0)
HarnessAny chat assistant or coding agentNot available. Not fixed; an assistant may draft a script or explain an entity, and every claim it makes is checked against the fileReads what you paste in; if it runs commands, give it only the copy of the modelNot available. Depends on your assistant and plan; not measured

Stack recipes

  • Ifcopenshell and python

Why this stack

IfcOpenShell and IfcTester are open source, run offline once installed and implement the buildingSMART IFC and IDS standards, so every learner can rerun the same checks on the same file and get the same output. CI runs the identical script on every pipeline.

Alternatives

  • A desktop BIM authoring tool (for example Bonsai for Blender, or a commercial tool). Shows the model visually and edits it by hand, but results depend on the tool and its export settings. Not tried for this pathway. Not tested for this recipe.
  • A web IFC viewer. Lets you look at the geometry in a browser without installing anything, but a viewer is not a validator. No viewer was checked for this pathway. Not tested for this recipe.

Agents and review gates

  1. Drafting assistant

    Drafts a script that prints each property set as a table.

    Review gate: You check three values by hand in the file before you trust the script.

  2. Learner as reviewer

    Decides which empty properties matter for the brief.

    Depends on: Drafting assistant

    Review gate: Every empty property in the table is either explained or turned into a question for the author.

Setup and smoke test

  1. Create a virtual environment with Python 3.12: python3.12 -m venv .venv
  2. Install the pinned packages: .venv/bin/pip install --require-hashes -r /examples/bim-pathway/tools/requirements.txt, or pip install ifcopenshell==0.9.0.post1 ifctester==0.9.0
  3. Download the sample model and the practice IDS from /katas/bim-pathway into a new, empty folder. Work on copies; keep the original.

Sign-in and access: None. Nothing here needs an account.

Smoke test

Do
Run: .venv/bin/python -I -c "import ifcopenshell; print(ifcopenshell.open('wall-with-opening-and-window.ifc').schema)"
Expect
IFC4
Result
Passed /examples/bim-pathway/generated/original/inspection.json (schema)

Prompts

Copy a prompt into the assistant you use. Replace anything that does not fit your situation, and never paste private or personal data you are not allowed to share.

Draft a property table script

Get a starting script, then check it against the file.

You can also select and copy the text.

Practice exercise

IFC wall with opening and window sample. From IFC wall with opening and window sample (buildingSMART International).

Terms: CC BY 4.0, buildingSMART International.

Execution and handoffs

  1. Drafting assistant: Drafts the property table script. Hand-off: You run it on your copy.
  2. Learner: Check three values by hand (entity lines

Tests, failures and corrections

Checks with expected and recorded results
CheckExpectedResultEvidence
Read the properties of the sample with the pathway scriptPset_WallCommon has 10 properties, Pset_WindowCommon has 9; FireRating, AcousticRating, Reference and SurfaceSpreadOfFlame on the wall are empty labels; the wall's ThermalTransmittance is 0.24Passed on /examples/bim-pathway/generated/original/properties.json, recomputed by CI on every pipeline
Your property table matches the CI outputSame properties, types and empty markersNot runNot run, so there is no evidence. This is not a pass.

Failures and corrections

  • Observed: A script prints FireRating as a value, so it looks filled in Correction: The value is an empty IfcLabel. Print the raw value and its type, and treat an empty string as missing.

Adapt it

  • Add the window type's property sets Properties can sit on the type (IfcWindowType) as well as the occurrence; say which one wins when both exist.

Unseen Randori

See the BIM Randori recipe, BIM-R01.

Constraints

  • Empty is not a value

How it is judged: The table matches the CI output.

More Randori challenges

Belt evidence

Belt stages are proposed practice stages, not issued credentials. Evidence below is what a reviewer would look for; it is not a record that anyone has shown it.

Evidence a reviewer looks for

  • A property table for the wall and window that matches the Dojo's CI output, with empty values marked (Automated check, against Industry Foundation Classes (IFC))
  • The learner explains why an empty label is not the same as a recorded value (Self-check)

Belt criteria

  • Practice: Lists Pset_WallCommon and Pset_WindowCommon with types and marks the empty labels
  • Adapt: Finds the empty properties in another openly licensed model
  • Demonstrate: Turns a property table into a short list of questions for the model's author

See the belt stages

Connections

Used by
No other kata names this one as a foundation yet.
Professional review
Required. Any real use of this outcome needs independent validation and any approval required from a qualified professional. Practice here does not grant a licence.

Standards in scope

  • Industry Foundation Classes (IFC), IFC4 ADD2 TC1 (ISO 16739-1:2018), as declared by the sample file. Applies to: The buildingSMART practice sample and copies of it only. Review scope: What the listed checks test: the schema the file declares, its entities and relationships. No claim about any real building.

Sources

  • buildingSMART International

    IFC wall with opening and window sample (opens the publisher's site in a new tab)

    • Free
    • Docs
    • Beginner

    Inspect a real IFC4 sample and trace a wall, opening, window, property set and storey through their references. The linked source is a pinned educational example; its dataset is licensed CC BY 4.0; check its terms before reuse. An IFC file is not by itself proof of building safety, compliance or professional approval.

Maintenance and caveats

Review cadence: Every six months, when IfcOpenShell or IfcTester releases a new minor version, or when buildingSMART revises IFC or IDS

  • This recipe is a draft: the example was built and checked by the Dojo maintainers and CI, and no learner has run it yet.
  • The sample is a three-element test file, not a building. Nothing learned from it is evidence about a real project.
  • No model, property value or check result here is professionally reviewed or approved. A real project needs the qualified people its contract and jurisdiction name.
  • Information (IDS), schema and geometry checks are separate outcomes. Passing one says nothing about the others, and there is no combined score.
  • Property values in a sample model are test data. A thermal transmittance or rating in this file is not a product or design value.

All kata recipes · Back to katas