Adding Points and Replicas

Adding Points and Replicas

This content is archived.

Building Your Digital Twin Hierarchy in Point Editor

After you have set up the initial Point of Interest and Replica in Organization settings, you can continue building the hierarchical structure of your digital twin. All further configuration — adding new points, attaching replicas, and organizing the hierarchy — is done in the Point Editor.

ChatGPT Image May 13, 2026, 05_16_39 PM.png
Point Editor.

Understanding the Hierarchy

The digital twin hierarchy reflects the structure of your real-world environment. A typical hierarchy follows this pattern:

Site → Building → Floor → Area → Asset

Each level is a Point of Interest (PoI) with its own attached Replica. Clicking a PoI marker opens the next level down, allowing users to navigate from a high-level overview to individual equipment.

Level

Example Replica

PoIs on it

Level

Example Replica

PoIs on it

1 (Root)

World map

Factory locations

2

Site plan

Buildings

3

Floor plan

Rooms, zones

4

Room layout

Machines

5

3D model of a machine

Sensors, components

Create and manage PoIs and Replicas in Point Editor

Step 1 — Open Point Editor

Open Point Editor from the main menu. The editor displays all PoIs currently placed on the active replica, showing their locations and spatial distribution.

Make sure you are viewing the correct replica before adding new points. You can switch between replicas using the navigation menu.

Step 2 — Create a New Point of Interest

  1. Click the "Add new Point" button.

  2. A marker will appear on the replica. Drag it to the desired location.

  3. Fill in the details:

    • Name — a clear, descriptive label (e.g., "Assembly Line 3", "Loading Dock B").

    • Description — optional context about the point.

  4. Optionally, add supporting content:

    • Upload images (e.g., photos of equipment).

    • Attach documents (e.g., maintenance manuals and safety instructions).

    • Add links to related resources.

  5. Add HSEQ content (optional). If the point represents a safety- or environment-related object (fire extinguisher, emergency exit, recycling station, etc.), you can tag it with HSEQ information:

        a. Click "Add more".

    image-20260515-114152.png
    Add HSEQ content

        b. Choose a content type and subtype from the predefined list:

    • Safety — Fire Extinguisher, CO₂ Fire Extinguisher…

    • Recycling — Paper, Plastic, Cardboard..

    • Pest control - Insect traps, Rodent traps.

        d. Optionally fill in:

    • Title — a custom label for this item.

    • Serial number — for tracking and inspections.

    • Description — additional context.

        e. Click Save.

    You can attach multiple HSEQ items to a single PoI. Once added, HSEQ icons appear on the PoI marker and become available in HSEQ (Health, Safety, Environment, and Quality)archived.

Step 3 — Attach a Replica to a PoI

  1. Click ”Add Replica" to upload a file. Supported formats:

    • 2D images — floor plans, diagrams, schematics (.jpg, .png, .svg, .webp).

    • 3D models — interactive models in .glb format.

  2. Follow any file recommendations the system displays for optimal performance.

  3. Click Save.

  • Ideal size: under 3 MB; minimum resolution 1920×1080.

  • Formats: .jpg, .jpeg, .png, .gif, .svg, .svgz, .webp, .bmp, .jfif, .pjp, .pjpeg.

  • Avoid heavy transparency; prefer compressed, high-contrast imagery.

  • Limits: Max file size 1 GB; Max pixel count (H×W) 16,777,216.

  • Ideal size: under 3 MB for fast first-load; up to 50 MB initializes quickly but increases download time.

  • Performance depends more on object count, materials, and draw calls than raw size—optimize scene complexity.

  • Format: .glb, Must pass glTF validation (e.g., glTF-Validator).

  • Limit: Max file size 1 GB.

Best practice: Use level-of-detail (LOD), merge meshes where possible, reduce texture resolution and unused materials, and remove hidden geometry.

  • PoI not visible: Enable “Show points without events/data.”

  • Replica slow to load: Reduce file size or scene complexity; leverage browser cache via repeat visits.

  • Blurry 2D image: Increase resolution (≥1920×1080) while keeping file under ~3 MB if possible.

  • 3D artifacts or errors: Validate with glTF Validator and check materials, textures, and normals.

  • Wrong starting view: Adjust camera/zoom in Point Editor and save.

Step 4 — Configure Camera and View Settings

After attaching a replica, set the default view users will see when they open the PoI:

  1. Open the PoI.

  2. Click Point Editor. Now you see the current replica settings in the POI Editor.

  3. Open View settings.

  4. In the replica, adjust the camera position — orbit and pan to the desired angle and set the zoom level to frame the view.

  5. Click Save camera location & zoom as default.

image-20260513-145255.png
0515.mov.gif

Step 5 — Continue Building the Hierarchy

To add deeper levels to your digital twin, open a PoI that already has an attached replica:

  1. Click Point Editor. Now you see the current replica settings in the POI Editor — you are now working inside this level.

  2. From here, create new child PoIs on this replica, attach replicas to them.

Each PoI you open becomes the context for the next level down. Continue until your hierarchy reflects your real-world structure to the required level of detail.

Editing and Deleting Points

To edit a PoI: Select it from the list or click its marker on the replica. Modify the name, location, description, or attached content, then click Save.

To delete a PoI: Select the point and click Delete. If the PoI has child points or nested replicas, they will also be removed. A confirmation warning will appear before deletion.

image-20260513-150310.png

Finding Points

Use the Search function in Point Editor to locate a specific PoI by name when working with a large number of points.

image-20260513-150653.png