Skip to content

Story View and Hierarchy Navigation

The 3D viewer organizes building data in a structured hierarchy displayed in the left panel.

The viewer uses a four-level hierarchy:

No Selection (Default)
└── Story (Building Level/Floor)
└── Room (Space)
└── Building Element (Wall, Floor, Ceiling, etc.)

Each level provides progressively more detailed control over building elements.

The left panel displays the building structure as an expandable tree:

  • Expandable Tree View: Click arrows to expand/collapse levels
  • Visual Hierarchy: Indentation shows parent-child relationships
  • Selection Indicator: Active selection highlighted in panel

Expanding Levels:

  1. Click arrow icon next to story name to expand
  2. View list of rooms on that story
  3. Click arrow next to room to expand
  4. View building elements in that room

Collapsing Levels:

  • Click expanded arrow to collapse that branch
  • Hides child elements from view

The top level shows all building levels/floors:

  • Story Name: “Level 1”, “Level 2”, “Ground Floor”, etc.
  • Elevation: Height above datum (optional display)
  • Element Count: Number of elements on each story
  • Status Indicators: Completion or validation status icons

Click on a story name to:

  • Select entire story as current scope
  • Display all rooms on that story in hierarchy
  • Show story overview in properties panel (right)
  • Focus 3D view on that floor level

When a story is selected:

  • View all elements on that floor
  • Apply bulk properties to story scope
  • Export story data
  • Toggle story visibility in 3D view

Expand a story to see rooms within:

  • Room Name/Number: “Living Room”, “Room 101”, etc.
  • Area: Floor area in square meters
  • Building element summary: Count of walls, floors, ceilings
  • Thermal properties: Heating status, temperature setpoint

Click on a room name to:

  • Select room as current scope
  • Display building elements that define the room
  • Show room properties in right panel
  • Highlight room in 3D view

When a room is selected:

  • Edit room properties (name, type, area)
  • View boundary elements (walls, floors, ceilings)
  • Calculate room metrics (volume, surface area, heat loss)
  • Assign materials to all room elements

Expand a room to see building elements:

  • Element type icons: Wall, floor, roof, window, door
  • Element ID/Name: Unique identifier or description
  • Area: Surface area in square meters
  • Material: Assigned construction type

Click on an element to:

  • Select element as current scope
  • Show element properties in right panel
  • Highlight element in 3D view with color
  • Display edge dimensions as labels in 3D

When an element is selected:

  • Edit element properties (area, orientation, inclination)
  • Assign materials and thermal properties
  • View/edit B-factor (thermal reduction factor)
  • Split element into multiple parts
  • Add openings (windows, doors)
  • Edit geometry (move points, reshape)
  • View dimensions on edges

The hierarchy panel and 3D canvas are bidirectionally linked:

When you click an item in the hierarchy panel:

  1. 3D view focuses on that element
  2. Element highlights in 3D with color
  3. Camera may reposition to show element
  4. Properties panel updates with element details

When you click a mesh in the 3D view:

  1. Hierarchy panel highlights the corresponding item
  2. Parent tree expands to show selection
  3. Properties panel displays element info

Control visibility of different types of content in the 3D view.

Location: Bottom-left corner of the 3D canvas

Click the layers button (stacked layers icon) to open the layer controls menu.

The layer controls are organized into three categories:

Toggle visibility for note types:

  • Condition - Condition assessment notes
  • Electric - Electrical installation notes
  • Building element - Building element notes
  • Material - Material-related notes
  • Other - Other notes
  • Technical installation - Technical installation notes

Toggle visibility for building elements:

  • Ceilings - Show/hide ceiling elements in 3D view

Toggle visibility for additional information:

  • Projections - Show/hide projected measurements
  • Labels - Show/hide measurement labels
  • Measured areas - Show/hide area measurements

To toggle a layer:

  1. Click the layers button in bottom-left corner of 3D canvas
  2. Check or uncheck the layer checkbox
  3. Changes apply immediately to the 3D view

When a layer is hidden:

  • Elements are not rendered in 3D canvas
  • Elements are still visible in hierarchy panel
  • Can still be selected from hierarchy panel
  • Properties can still be edited

The viewer displays coordinate axes to help with spatial orientation:

Located in the 3D canvas:

  • X/Y/Z Axes: Visual gizmo showing coordinate system orientation
  • Spatial Reference: Helps maintain awareness of 3D space layout

In certain contexts, edge dimensions may display:

  • Length in Meters: Shows measurements for specific elements
  • Label Position: Positioned along edge in 3D space
  • Scale Adaptive: Labels remain readable at any zoom level
  • Contextual Display: Shown selectively based on element type and selection

Use the Ruler tool for custom measurements:

  1. Select Ruler from tool palette
  2. Click first point in 3D view
  3. Click second point to complete measurement
  4. Distance label appears between points
  5. Measurement persists until tool is changed or canceled

Based on the actual implementation:

  • No drag-and-drop reordering: Cannot move elements between rooms/stories
  • No multi-selection: Select one item at a time (use parent level for bulk scope)
  • Fixed hierarchy levels: Cannot add custom hierarchy levels
  • No custom grouping: Grouping limited to story → room → element structure

The current implementation does not include keyboard shortcuts for hierarchy navigation. Navigation is performed via mouse clicks in the panel or 3D view.


Related Topics: