Stomra Guides

EikHub · Guide

Drawing review on EikHub

Review issued drawings by what changed in the building. Notes stay on their element, and a sign-off names the exact file you saw.

X-ray of a plan: the building faint, the moved window lit, its old place dashed, and the change list beside it Living Bedroom Kitchen Bath 500 mm WHAT CHANGED IN REV B 1 change since rev A East window moved 500 mm along its wall Also redrawn because of it (1) Bedroom east wall ‹ Previous 1 of 2 places Next › Keys: [ and ] step
Show changes (X-ray): the drawing fades, the element that changed is lit, its old place is a dashed outline, and an element drawn differently only because of it is lit more softly. The list beside the sheet says each change in words.

What drawing review is

On EikHub a building's drawings are issued OpenEik drawings: SVG sheets in which every line drawn from the model names the element that drew it. EikHub also holds the model each drawing was drawn from. Together that lets it answer the questions a reviewer asks, from the files themselves:

The questionHow EikHub answers it
What changed on this sheet?The elements whose lines changed, each in a sentence, lit on the sheet.
Was this line drawn differently because of something else?It is listed under "Also redrawn because of it", beneath the change that caused it.
Is this drawing still true to the model?The register says "Up to date", or "Model changed after this revision".
Did my note get dealt with?The note follows its element into the next revision, and says when that element changed.
What have I already looked at?A tick per change and per person, and "New since you last looked" on the register.
Who approved exactly this?A signed sign-off that names the digest of the issued file.

EikHub coordinates; it never edits the building. Drawings are drawn and issued by the authoring tool, such as Stomra. On EikHub people look, compare, comment, review, sign off and send. What EikHub keeps of a review or a sign-off it offers as the standard's own files, and the authoring tool saves them into the building with its next revision.

Reviewers compare released revisions, never the hundred small edits between them. An engineer works, then issues; the review is of what was issued.

The Drawings tab

Every building has a Drawings tab beside Model, History, Analyses and Proposals. It is the register: each drawing with its number, title, latest revision, status, date and who issued it. You can also show the drawings as Issues: the drawings released together, newest first.

A chip on each drawing says whether it still matches the model:

ChipWhat it means
Up to dateNothing the drawing shows has changed in the model since it was issued. This also covers two quieter cases: something it was drawn from changed, but drawn again it looks the same; or only a newer version of the drawing tool would draw it differently.
Model changed after this revisionSomething the drawing shows has changed in the model: a new revision is needed.
Revised in the last issueA new revision of this drawing was released in the last issue.
New since you last lookedYou last opened an earlier revision of this drawing.
Not linked to the modelA drawing from outside the model. EikHub cannot check it against the model.

The chips are worked out from the drawing's read set, the list of every record it was drawn from, so EikHub knows a drawing is out of date without drawing anything. You can also look at the register as it stood at an earlier version of the model.

A drawing and its revisions

Open a drawing and its page starts with a title block: the number and title, the revision, status, date, who issued it and in which issue. Below it every revision of the drawing sits in a strip; click one to show it. The checks EikHub ran on the revision and its sign-offs are on the same line.

When the model has moved on since the revision you are looking at, a banner says so and names the elements: "The model has changed since … was issued." Show on the drawing draws the model as it is now onto the issued sheet, so you see how out of date it is before anyone issues again. Nothing shown that way is issued.

Seeing what changed

Three buttons choose how you look at the sheet. They never mix.

As issued D

The drawing exactly as it was issued.

Show changes X

X-ray: the drawing fades and only what changed is lit. A moved element shows its old place dashed.

Before | After B

Both revisions whole, with all their line work. Drag the Divider, or use Blink to flick between them.

X-ray answers "what exactly changed?". Before | After answers "is the new drawing a good drawing?". The 3D compare of two versions uses the same two ways of looking and the same keys.

The change list

Beside the sheet, under "What changed in …", each change is a sentence, such as "East window moved 500 mm along its wall". A note written when the revision was issued is shown at the top. Elements that did not change themselves, but were drawn differently because of a change they depend on, are folded under Also redrawn because of it: a wall whose window moved is one.

Because lines are compared by the element that drew them, a view moved on the sheet does not make the whole house look changed, which is the usual failure of comparing two pictures.

Finding your way on a sheet

Drawings on a proposal

A proposal is a change to the building that an admin of the building merges (see EikHub basics). Its Drawings tab says, before anyone merges, which issued drawings it would put out of date: each is marked "Needs a new revision", with the elements that change on it. A proposal that touches nothing drawn says "Merged, this changes nothing on the issued drawings."

When the authoring tool attaches the drawing drawn again from the proposal, the tab shows the change on it in X-ray, against the issued revision.

Running a review round

A review round is a review of one revision of one drawing, with its reviewers, their notes and their decisions.

  1. Open a round. On the drawing's page, choose the revision and press Review. The panel opens beside the sheet.
  2. Ask reviewers. Under Reviewers, choose a member of the building with Ask someone… and give their role. They are notified.
  3. Add notes. Add a note on the drawing, then click where it belongs. A note can be a comment, a cloud, an arrow, a highlight or text. It is pinned to the element under the pointer, not only to a place on the paper. Write what should change, or what to check.
  4. Work through them. Each note has a state from the project's own list (in Sweden, typically the BEAst review states) and a thread of replies. Filter by open or closed notes.
  5. Decide. Each reviewer gives Your decision, from the codes in the project's drawing profile.
  6. Close the review. Closing freezes the round. Export it as The review file or as BCF; the authoring tool saves the round into the building with its next revision.

Notes follow their element

When a new revision replaces the one reviewed, open notes are carried into the next round, each once, from where it last stood. A note on the east window moves with the window. If the element changed after the note was written, the note says "its element changed since it was written", so someone looks again. If the element is no longer on the sheet, the note stays at its last place and says so. It is never dropped.

An app or agent can propose notes for the person it works for. They are marked as proposed and count for nothing until a person accepts them.

Signing off a revision

Where the project's drawing profile asks for sign-offs, a person signs off the revision on its page with a passkey, the key your device or password manager keeps. Make one once in Settings.

Sign-offs are optional and follow the stage: a sketch shared for information needs none, and the profile says which statuses require which sign-offs. Sending signed drawings to people outside the building is covered in Signed receipts on EikHub.

Reviewing the model in 3D

The same kind of round works on a version of the model itself. On a version's page, or on the Model tab, choose Review this version.

Keys and words

KeyOn a drawing
[ ]Previous and next change
X · B · DShow changes · Before | After · As issued
F · 1–9Whole sheet · a view by its number
/ · MFind · Measure
WordMeaning
RevisionOne issued state of a drawing: its SVG, its records and its sign-offs. It never changes.
IssueA release of revisions to people, for a purpose.
Read setEvery record a revision was drawn from. It is how EikHub knows a drawing is out of date.
Review roundA review of one revision (or one version of the model), with reviewers, notes and decisions.
Drawing profileThe project's own codes: statuses, purposes, review states, decisions and which sign-offs each status needs.
Sign-offA person's signed, time-stamped statement about one revision.