A new maintenance tech can't find the compressor room, and nobody remembers which pump is which. At Acme Precision, the facilities coordinator puts each building's floor plan into Data Vision Digital Twin, captures every room, and marks the equipment in it, so anyone can click their way to a room and see the asset record behind each machine.
What it does
The screen uses its own words for buildings and rooms:
- An entity is a building, a site or one floor. It can hold a floor plan.
- A scene is one room or area in it, captured as four wall photos, a 360° panorama or a 3D model you can walk around in.
- An area is an outline drawn on the floor plan. Clicking it opens its scene.
- A polygon is a shape drawn inside a scene over a piece of equipment or a doorway. It links to an asset, or to the next room.
The page has three parts:
- Digital Twin Entities on the left lists your buildings, with New Entity and Help. Click one and the list shows its scenes instead, with New Scene, Search scenes…, All Entities and Floor Plan.
- The middle shows the open building's floor plan, with Upload Floor Plan, AI Detect Rooms and the plan controls, or the open scene in the viewer.
- View Assets on a scene's card slides in the list of its polygons and what each one links to.
Set it up
- Give people the permissions they need (see Users and roles: create and edit roles). Out of the box, Viewers look, Operators build buildings, rooms and shapes, and Admins also delete, run AI room detection and send videos for 3D processing.
- Open Module Settings from the ⋮ on the Data Vision Digital Twin sidebar row. On Preferences, splat_capture_enabled is on to start. Turn it off if you only want floor plans, photos and panoramas: the Video, Splat, Process to 3D and Walk-around capture modes are then hidden. See Module settings and versions.
- To link equipment shapes to real asset records, add the Assets module too. Without it, shapes take a typed reference such as a tag number.
- AI Detect Rooms needs the workspace's Claude AI to be set up.
- Add your first building (below), then its rooms.
Add a building and its floor plan
- In Digital Twin Entities, click New Entity.
- Type a Name, such as Acme Precision - Plant 2, and a Description if it helps.
- Under Floor plan, click Choose image and pick a JPG, PNG, WebP or SVG. You can skip this and add it later.
- Click Create Entity.
- To add or replace the plan later, open the building and click Upload Floor Plan. If outlines were drawn on the old plan, OK deletes them and Cancel keeps them for you to move by hand.
To change a building, click the pencil on its card. The × deletes it; its rooms are kept and listed under Unassigned.
Move around a floor plan
- Click a building in Digital Twin Entities. Its floor plan opens.
- Use − and + to zoom, and drag to move around. Fit shows the whole plan again.
- If the plan is sideways, use the rotate buttons. The new direction is saved for everyone.
Find the rooms with AI
- Open a building that has a floor plan and click AI Detect Rooms. It stays greyed out until the building has a plan.
- Under What is on this plan?, choose Named rooms (offices and other walled rooms), Work areas (an open shop floor) or Both.
- In Review AI-detected rooms, untick any you don't want.
- Click Create selected scenes. Each room gets a scene, a pin on the plan and an outline.
If the review says rooms are already outlined when the plan looks empty, click Clear outlines & re-run. Each run uses AI.
Outline an area by hand
- On the floor plan, click ✏️ Area in the plan controls.
- Click each corner of the area. Press Enter or double-click to finish, or Esc to stop.
- Type a name for the area.
- Choose OK to create a scene for it, or Cancel to keep just the outline.
Click an outline to Adjust shape, Rename, Link a scene or Unlink scene, or Delete outline. A linked scene is kept when its outline is deleted.
Add a room
- Open the building and click New Scene.
- Type a Name, and a Location and Description if you like.
- Under Capture mode, pick how you captured the room:
- Images: click each of the North wall, East wall, South wall and West wall slots and pick a photo.
- Video: pick a walkthrough video, pause it at each corner and click Capture for North, then East, South and West.
- Panorama: pick a 360° image. A 360 camera export wraps as a full sphere.
- Splat: pick a finished 3D scan (.ply, .splat or .ksplat) from an app such as Polycam, Postshot or Luma.
- Process to 3D or Walk-around: see the next section.
- Click Create & Upload.
A room made from an AI outline starts empty: open it and click Add Media. To change a room later, click Edit on its card and then Save Changes. Delete removes the room and every shape in it.
Turn a walkthrough video into a 3D room
- Click New Scene, type a Name, and choose Process to 3D.
- Pick the Source video. Walk slowly with the camera steady; 15 to 60 seconds is usually enough for a room.
- Pick a Quality preset: Fast (about 5 minutes), Standard (about 12) or Premium (about 25).
- Tick Pause to review before training to check the video before the expensive step.
- Click Create & Upload. The scene appears straight away and a card shows the job's progress. You can close the page and come back.
- If you paused it, the Pipeline Diagnostics window shows the Curated frames and the Camera trajectory. Click Continue to training, or Abort to stop without spending more.
Walk-around works the same way from a video that walks the room's edge. Instead of a 3D model, it works out the room's shape and makes one straight-on photo of each wall.
Every run uses paid GPU time, so keep Process walkthrough videos to the one or two people who make 3D rooms.
Look around a room
- Click a room in the list, or click its pin on the floor plan and then Open Scene.
- Drag to look around and scroll to zoom. In a 3D scan, right-drag to slide and double-click the point you want to turn around.
- For wall photos, Flat shows the four walls side by side and 3D puts you back in the room. For a panorama, Sphere changes how the image wraps.
- In a 3D scan, slide Density to hide faint specks on screen.
Mark equipment and link it to an asset
- Open the room and click Draw Polygon.
- Click at least three points around the machine, then click Finish (or Cancel).
- Type a label, such as Coolant pump P-101.
- Click the shape's marker and then Edit. Pick the Asset, or type an Asset reference (free text). Add an image or Notes if you like.
- For a door, pick the next room under Doorway — leads to.
- Click Save. Delete removes the shape.
Look up equipment in a room
- Click View Assets on the room's card to list every shape and what it links to.
- Click a shape in the room or in the list. Its card shows the linked asset and its nameplate; Show all lists every nameplate field.
- Click Focus to turn the view to it, or Details for the asset's full record, photos and history.
- On a doorway, click Walk through to go to the next room.
Tidy or improve a 3D room
These buttons show while a 3D scan is open:
- Re-clean removes stray specks around the room. Lasso delete removes what you drag around; check the orange selection, then click Delete.
- Undo goes back one step.
- To fill a gap, record another video of that part, click Add video, then Regenerate. It rebuilds the model from every video in Pool, which takes 15 to 40 minutes.
Who can do what
Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see Users and roles: create and edit roles. Out of the box shows the module's starting roles that have it.
| Permission | What it lets someone do | Out of the box |
|---|---|---|
| View the digital twin | Open buildings, floor plans and rooms, look around in 3D, and see which equipment is marked where. | Admin, Operator, Viewer |
| Upload photos and floor plans | Meant to control uploading wall photos, panoramas, 3D files and floor plans (see notes: not actually checked today). | Admin |
| Edit buildings and rooms | Create and edit buildings, rooms, floor-plan outlines and equipment shapes, clean up 3D models, and approve or cancel video processing. | Admin, Operator |
| Delete buildings and rooms | Delete buildings, rooms (with all their equipment shapes), floor-plan outlines, equipment shapes and pooled video captures. Give with care. | Admin |
| Find rooms on floor plans with AI | Run AI room detection on a floor plan; each run uses paid AI. | Admin |
| Process walkthrough videos | Send videos to a paid GPU to build 3D models, and add more video to rebuild a model. Give with care. | Admin |
Ask its agent
The Digital Twin Assistant answers questions about your rooms and shapes. Try:
- "List all my digital-twin scenes."
- "Which equipment is marked in the compressor room at Plant 2?"
- "Show me scenes that still have unmapped polygons."
It can also delete a room for someone who may delete, after they say yes. Uploading, drawing and video processing are done on the screen. See Agent chat.
Good to know
- Deleting a building keeps its rooms under Unassigned. Deleting a room can't be undone and removes its shapes.
- Some buttons show for everyone but are refused on save without the permission.
- Naming a shape or an area, and Link a scene, use small browser boxes. Link a scene asks you to type the room's number from a list.
- The share icon on a room's card copies a link to the room.
- A panorama only wraps as a full sphere when the image is exactly twice as wide as it is tall. A phone's panorama mode covers about half the room.
- Rooms from AI detection have outlines and pins but no pictures until you add media.
More help
Open the module's Help, at the top of the left column, for the full reference: capture modes, the viewer, 3D processing, who can do what and common questions. Its Setup page is for administrators.