Stomra Guides

EikHub · Guide

Sharing analyses through EikHub

Femra and Varmra keep their analyses beside the model in the building on EikHub, where everyone who reads it sees them and whether they still hold.

A version of a building on EikHub holds the model's records, a Femra folder, a Varmra folder and the report PDFs; the Analyses tab shows each analysis as current or stale villa · version 14 ├ the model's records ├ femra/frame/ │ model · results · manifest ├ varmra/energy/ │ project · results · manifest └ assets frame-report.pdf · energy-report.pdf Model · Drawings · Analyses Energy balance · Varmra Current Computed on version 14 · Report (PDF) Open in Varmra Frame · Femra Stale Computed on version 12 · Report (PDF) Since then: 2 records it read changed. Open in Femra
Each app keeps its analysis in its own folder of the building's version, with its report as a PDF. The Analyses tab on eikhub.com says, for each one, whether the building has moved on since it was computed.

What it gives you

EikHub is where buildings branch, get reviewed and merge, the way software does. A building on EikHub is a series of versions of one OpenEik model. Beside the model, a version can hold the work of the applications that analyse it: Femra's structural analysis and Varmra's energy balance, each with its report.

One place

The model, the drawings and the analyses of a building are read in one place, by the same people.

Tied to a version

Every analysis names the version it was computed from, so you always know what it is about.

It says when it is out of date

EikHub compares what the analysis read with the version you look at and marks it current or stale.

The report goes with it

The report PDF is kept in the version beside the analysis, ready to download.

There is nothing to share twice: whoever may read the building reads its analyses too.

The ideas behind it

TermWhat it means
BuildingA model on EikHub, with its versions, its main line and its alternatives.
VersionOne saved state of the whole building. A version never changes; a change makes a new one.
App folderEach application keeps its files in a folder of its own in the version, such as femra/frame/ or varmra/energy/. The model's own records stay as they are.
Result setOne run of an analysis: its inputs, its results and a manifest. A version can keep several; the newest is shown first.
ManifestThe result set's label. It names the version the analysis was computed from and a fingerprint of the records it read, such as the walls, windows, roofs and rooms an energy balance uses.
ReportThe analysis's report as a PDF, kept in the version as a file the manifest names.
Run idThe result set's identity. The same inputs on the same engine give the same id.

The folders, manifests and the rule for "current" are part of the open OpenEik format, so every application judges them the same way.

Current and stale

An analysis does not go out of date just because the building has a newer version. It goes out of date when something it read has changed.

Version 12: the energy balance is computed, current. Version 13: a beam resized, nothing the energy balance read changed, still current. Version 14: a wall build-up changed, stale. version 12 The energy balance is computed here. The manifest records version 12 and the records it read. Current version 13 A beam is resized and the sheets re-issued. Nothing the energy balance read has changed. Current version 14 A wall's build-up changes. "Since then: 1 record it read changed." It needs computing again. Stale
An example of a building's history. The analysis stays current through version 13 and turns stale in version 14, when something it read changes.

A stale analysis is not wrong; it is about an earlier version. To bring it up to date, open it in its application, read the newest version of the building, compute again and save.

Saving from Varmra

Varmra saves an energy balance into the building it was read from.

  1. Read the building from EikHub. In the Building envelope step, Import from EikHub lists the buildings you can read. Sign in with EikHub: your Stomra account, or Google. Varmra has no separate login.
  2. Watch the building pin. The project bar shows which version the project was read from and whether it still holds: Building current, or Building changed when inputs Varmra reads have changed. Its menu says which, and Read the newest version brings them in. Your answers to the import's checks are carried over. Varmra checks when the project opens, every ten minutes while the tab is in view, and when you come back to the tab.
  3. Calculate. Work through the steps as usual.
  4. Save to EikHub. On the Report step, Save to EikHub writes the energy balance and its report PDF into Varmra's folder in a new version of the building. The first time, EikHub asks you to let Varmra save. When it is done, Open on EikHub takes you to the building.

Varmra does not save while the building has changed in what it reads: read the newest version first, so the saved analysis is pinned to a version it really matches.

A formal report usually belongs to an issued version. Read that version in Varmra as a version of its own: it follows no line of work, so it never goes stale.

Saving from Femra

Femra writes its model, loads and results into its own folder of the building, and the calculation report beside them: as HTML in the run's folder, and as a PDF the run's manifest names, printed as you set it in Project → Calculation report.

Reading analyses on EikHub

On eikhub.com, open the building and choose the Analyses tab. It shows the analyses in the latest version on main, or in the version you chose, one card per application's model:

To see how an analysis stood at another point in the building's history, choose that version; the tab links back to the latest.

Opening an analysis from the building

On a card, Open in Varmra or Open in Femra opens the analysis in its application as a copy of your own, read from the version you are looking at. You can study it, change it, compute again and save your result into the building in turn. The analysis in the building stays as it was.

Who sees and who saves

You canWhat you can do with the analyses
Read the buildingSee every analysis and download its report.
Write to the buildingSave an analysis into it from Varmra or Femra, where the building's ownership lets you write that application's folder.
Propose to the buildingSend an analysis as a proposal that an admin of the building merges.

A building that is private stays private: someone who may not read it is told it does not exist, so its name never shows. When EikHub does not let an application save, the application says so and nothing is saved.