Mesh data imports allow 3D mesh datasets to be uploaded as interactive data layers. Unlike traditional GIS layers, mesh data imports use 3D mesh geometry where data can be attached to individual components of the model. Once imported, the mesh behaves like a data layer within the platform, allowing it to be visualised, filtered, colour-coded, and queried directly in the 3D environment.

Using the mesh data

When a mesh data layer is uploaded:

1. The GLB file is imported into the Hub
2. The platform reads the individual mesh/component names contained within the model
3. An optional CSV file can then be attached to associate attribute data with those meshes
4. The imported mesh becomes available as a data layer in the 3D App

Once imported, the mesh layer can be:

• visualised in 3D
• colour-coded by attributes
• filtered using associated data
• queried alongside other datasets
• used with timeline-based workflows where timestamp data exists

For guidance on how to prepare and structure the .csv file, see Preparing mesh data CSV files.

Supported file formats

Mesh data imports use two file types:

• GLB for the 3D model
• CSV for optional attribute data

The GLB contains the 3D mesh, including its individual components. The CSV is used to attach information to those components, such as floor use, material type, construction status, or analysis results. Each row in the CSV represents a part of the model and defines what that part is or how it should be interpreted in the platform.

Mesh name matching

For attributes to display correctly, the mesh names in the CSV must match the mesh/component names inside the GLB model. Inconsistent naming - such as differences in spacing, casing, or punctuation - will prevent attributes from linking to their corresponding components.

Versioning and updates

To update an existing mesh import, upload a new version of the GLB and CSV files. The platform will replace the previous data while retaining any layer settings or styling you've applied.

Mesh data imports make it possible to attach and explore data directly on 3D models, enabling richer spatial analysis and more intuitive interpretation of complex datasets.