Overview
The Floor Plans section makes it possible to upload floor plans directly into oculai. Once construction section masks have been created, they are automatically synced with the schedule, so current construction progress is visible directly on the plan.
The building and floor structure can be built up entirely within the system itself, without coordination with oculai. This gives teams the flexibility to map the project hierarchy exactly as it exists on the construction site.
Uploading floor plans
Plan quality determines how much is set up automatically
Upload PDFs exported directly from the BIM model, uncompressed. oculai reads the data embedded in the file, so the cleaner the export, the more can be set up automatically — plan type, scale and placement in the project hierarchy. Compressed, flattened or scanned PDFs lose this embedded information and have to be set up manually.
Uploading
Plans are uploaded via the Upload button at the top right of the Floor Plans overview, individually or as a group, by drag and drop or via the file browser.
No further action is required after uploading. oculai sorts the plans into the project hierarchy, which is built from the schedule that has been uploaded. Sorting can take a few days.
Floor Plans overview
All uploaded plans appear in the Floor Plans overview.
Navigating via the project hierarchy
The Project hierarchy panel on the right shows all buildings with their floors/levels and the number of plans on each. It works as the navigation: clicking a building or floor/level narrows the overview to that part of the project only. Clicking Ground Level, for example, shows only the plans on that level. This keeps the overview manageable on projects with many plans.
Plans that could not be assigned a building or floor/level appear under Unassigned at the top of the panel and can be placed manually.
Views
Plans can be searched by name, and the view switched between card view and list view using the toggle at the top right.
Card view shows each plan as a thumbnail with its building and floor/level tags, the plan name and when it was last updated. Icons on the card indicate whether the plan has been calibrated and whether it contains sketches.
List view shows all plans as a table:
Plan name
Building and Floor/Level — both filterable
Type — read out automatically, or set manually
Calibration — a checkmark appears once the plan is calibrated
Sketches — a checkmark appears if the plan contains sketches
Scale
Last edited
Opening and navigating a plan
Clicking a plan opens it in the detail view.
Navigation the dropdown at the top left switches between buildings and floors/levels, and shows how many plans exist at each position.
Sidebar on the right, containing Sketches, Scale and Construction phases. The sidebar can be shown and hidden via the icon at the top right.
❕ Always check the scale after uploading. If a plan contains multiple scales (e.g. floor plan with integrated detail sections), the system selects the larger one — manual correction may be necessary.
Sketches
Sketches are markups drawn directly on the plan: shapes, lines, arrows, highlights and text. They are used to record meeting notes, mark areas for discussion and communicate visually with the team. Sketches can be exported and shared.
Sketches are saved in layers and can be organized into groups, for example one group per weekly site meeting. Each group can be shown or hidden with the eye icon, so older weeks can be folded away while the current week stays visible.
New sketches are created via + New sketch in the sidebar. Existing sketches can be brought over from another plan via Copy from another plan.
💡 Sketches work the same way in the plan and in the camera view. For the full set of drawing tools, grouping and export, see the article on sketching. (link to follow)
Drawing construction section masks
Construction section masks can be created in two ways:
Via the mask icon in the toolbar at the bottom of the plan, or
via the + Add construction section button in the sidebar.
After activating the drawing tool, draw the area of the construction section by clicking the corner points. Press Enter to complete the shape, then choose the name of the construction section from the dropdown.
Editing masks
Clicking on an existing mask puts it into edit mode.
The corner points of the mask can be moved and adjusted.
The dark blue points between the corners allow adding new support points for more complex shapes.
In the displayed edit toolbar, the name can be changed and a color for the mask can be selected.
Using the color picker (eyedropper), individual color values can be entered to align the colors of the construction sections with the schedule or other planning tools.
The mask can be deleted via the trash icon in the toolbar.
Managing masks in the sidebar
All drawn construction sections appear in the sidebar with their respective area information as well as a total area of all sections.
The eye icon next to an entry can be used to show or hide a mask on the plan.
The three-dot menu next to each entry offers options to edit or delete.
Copying masks from another plan
If construction sections recur on multiple floors/levels at the same positions, they can be copied via Copy from another plan in the sidebar.
Click Copy from another plan.
Select the desired floor/level to copy from.
Select the desired masks.
Click Copy.
The masks are transferred to the current plan and can be further adjusted there if needed.
Measurement tool
Next to the mask icon in the toolbar at the bottom of the plan is the measurement tool. This can be used to measure any distances and lengths directly in the plan. The unit can be adjusted in the sidebar under Measurement tool.
Export
Via the three-dot menu at the top right of the open plan, the plan can be exported.
The export always contains exactly what is visible on the canvas. To leave sketches or construction phases out of an export, hide them beforehand using the eye icon in the sidebar.






