Stomra and EikHub · Guide
Tests for your building
Software is tested on every change. Now your building is too: say what must hold in plain words, and Stomra and EikHub check it as you model, before you issue drawings, on every proposal and every night.
Start here. In Stomra, set the site’s country and the day the building permit application reached the municipality in Project information ▸ Permit and site. Then open the Tests tab in the navigator. In Sweden, Boverket’s pack is picked by itself.
What a test is
A test is a sentence, a rule and two small buildings.
- The sentence is yours: “Every bathroom, WC and laundry has an extract terminal connected to the FTX unit, or to a fan that exhausts outdoors.”
- The rule is what your assistant makes of it: which rooms it applies to, what it looks for, the values it compares.
- The two small buildings are examples, one that passes and one that fails. A rule is kept only when it passes the one and fails the other, so you know it means what you wrote.
Tests are kept in the building, beside the model, and change with it. Who may change them is set like any other part: on EikHub, the project manager owns them.
The tests you get
Every building starts with two layers you do not have to write.
Wet rooms are ventilated
Every bathroom, WC and laundry has an extract terminal whose duct reaches the FTX unit or a fan to outdoors. With your firm’s flow, it checks the flow too.
Roofs are drained
Every roof edge with a gutter has a downpipe. With your design rainfall, each roof’s area times the rain must fit within its gutters and downpipes.
The facade keeps to the plan
No wall passes the facade line or building limit of the detailed development plan, within the tolerance you set.
The universal base holds for any building and carries no code values: it checks that the building works. Your country’s pack is picked from the site. In Sweden it holds the requirements in Boverket’s regulations that can be read from a model, each naming its regulation and paragraph. Where Boverket points to a standard, the pack names the standard; its values are yours to enter.
Your firm’s tests and your project’s
On top of the base and the country, your organisation keeps its own tests on EikHub, and each project keeps its own in the building.
| Layer | Kept by | For example |
|---|---|---|
| Organisation | Your firm, on EikHub | A wet-room extract of 15 l/s; your design rainfall; the sections and build-ups you prefer |
| Project | The project, in the building | Elevated sunlight in the living room; a wall U-value of 0.15 W/m²K; beams from a steel supplier’s surplus list |
A layer may tighten what the layer below says, never loosen it without a waiver.
When tests run
| When | What happens |
|---|---|
| As you model | Stomra tells you when a change breaks a test, as you make it |
| When you ask | openeik test runs the suites on a building folder, from any app or script |
| Before you issue | Stomra runs the suites when you open Publish; a test failing at error asks you before the drawings go out |
| On every proposal | EikHub runs the suites on the proposal once tests are switched on in the building’s settings; tests a building requires hold the merge when they fail |
| Every night | EikHub runs them on every line of work, against today’s plan data and supplier lists, so a change outside the model is caught too |
Reading a result
A run reads like a test report: each test passed, failed or waived, and every failure names the element, what was measured, what was required and a way to fix it.
PASS wet-rooms-ventilated 9 rooms, each extract reaches FTX unit A1
PASS exterior-wall-u 23 walls, highest U 0.16 ≤ 0.18 W/m²K
FAIL gutters-sized roof R2 needs 1.85 l/s; gutter G4 carries 1.20
FAIL facade-line wall W17 is 0.34 m past the facade line
WAIVED steel-surplus beam B9 HEA 200 · ordered already · until 1 Dec
12 passed · 2 failed · 1 waived
An example; the project and its numbers are made up.
In Stomra the Tests tab lists each test, and clicking a finding selects its element; the status bar says when a change makes a test fail. Your assistant can propose the fix as a change into an alternative for you to review. On EikHub each failure is marked on its element in the proposal’s checks, and a building’s main shows its latest run.
Writing a test with your assistant
- Say what must hold, in your words: “Every stair in this project has a going of at least 270 mm.”
- Your assistant writes the rule and the two small example buildings, and runs them.
- The test is kept only when the passing example passes and the failing one fails. You see the sentence, the rule and the result.
- It is kept with the project. A suite your organisation keeps on EikHub can be pinned to the project in the same way.
When a finding is fine after all
Sometimes a failing test is right to pass over: the beam is ordered already, the plan has an exemption. Waive that one finding with a reason, an owner and an end date. The waiver follows the element through new versions, and the test reports it as waived until the date passes.
What tests are not
- A passing suite is not a building permit or an approval. The responsible engineer still answers for the design.
- A test can only check what the model holds. When the data is missing, such as no air system modelled, it says it could not check, rather than passing or failing.
- Stomra does not reproduce standards. Where a requirement comes from a standard, the test names it and you enter its value.