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.
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 question | How 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:
| Chip | What it means |
|---|---|
| Up to date | Nothing 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 revision | Something the drawing shows has changed in the model: a new revision is needed. |
| Revised in the last issue | A new revision of this drawing was released in the last issue. |
| New since you last looked | You last opened an earlier revision of this drawing. |
| Not linked to the model | A 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.
- Compared with picks the earlier revision to compare against. By default it is the one before, or the revision you last opened, so a re-issue shows you only what is new to you.
- ▶ Revisions plays every revision in turn, each one's changes lit.
- Review opens the review panel for this revision (see below).
- Print as PDF prints the revision as issued, as PDF/A. A print is a copy, like paper; the revision is the record.
- In 3D opens the building's model at the two revisions compared, with what changed lit.
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.
- Step from place to place with ‹ Previous and Next ›, or [ and ]. The view frames each change, in every view on the sheet that shows it.
- Each change you have looked at gets a tick, kept per person.
- Details gives the counts: changed, added, removed, redrawn; views where records changed but nothing drawn did; changes to the title block, such as a new revision row.
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
- Hover a line to see the element that drew it; click it to see the element, where it is drawn, and its record under Details for engineers.
- Find (/) finds an element by name, id or kind, or a view by name.
- Layers shows or hides the drawing's layers, for instance the revision clouds.
- Measure (M) measures on the paper. The sheet is drawn in paper millimetres and each view knows its scale.
- Whole sheet (F) fits the sheet; 1–9 jump to a view; drag to pan, wheel or pinch to zoom. A small map of the sheet shows where you are and where the changes are.
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.
- Open a round. On the drawing's page, choose the revision and press Review. The panel opens beside the sheet.
- Ask reviewers. Under Reviewers, choose a member of the building with Ask someone… and give their role. They are notified.
- 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.
- 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.
- Decide. Each reviewer gives Your decision, from the codes in the project's drawing profile.
- 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.
- Choose What you sign: Checked, Reviewed, Approved, Authorised, Accepted or Rejected, with Your role and, for a decision, The decision.
- The sign-off is a signed statement over the digests of the issued files, time-stamped by an independent time-stamp authority. If the files changed after the page read them, EikHub keeps no signature and asks you to look again: what you reviewed is what you sign.
- Anyone can check a sign-off later without EikHub, with the signer's public key and the time-stamp authority's certificate. The page marks each one as verified.
- A tool may record "Checked by a tool". A person's approval is always a person's.
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.
- Add a note on the model, on an element or on no element. Each note keeps the element it is on and the view it was written from, with any section, so anyone can fly back to where it was seen.
- Reviewers, states, replies, decisions and closing work as for drawings. A closed round goes to the authoring tool as a file, and exports as BCF.
- A new round can carry the notes still open in rounds on earlier versions. A note whose element changed is marked for a new review.
Keys and words
| Key | On a drawing |
|---|---|
| [ ] | Previous and next change |
| X · B · D | Show changes · Before | After · As issued |
| F · 1–9 | Whole sheet · a view by its number |
| / · M | Find · Measure |
| Word | Meaning |
|---|---|
| Revision | One issued state of a drawing: its SVG, its records and its sign-offs. It never changes. |
| Issue | A release of revisions to people, for a purpose. |
| Read set | Every record a revision was drawn from. It is how EikHub knows a drawing is out of date. |
| Review round | A review of one revision (or one version of the model), with reviewers, notes and decisions. |
| Drawing profile | The project's own codes: statuses, purposes, review states, decisions and which sign-offs each status needs. |
| Sign-off | A person's signed, time-stamped statement about one revision. |