Overview

The Simple 3D Model option allows you to upload basic 3D models into vSite. While supported, this method is more time-consuming to position and configure compared to other data source types. Consider alternative formats if available.

How To

Simple 3D Model Upload Process

To add a Simple 3D model, go to the Datasources tab and click Add Source (Fig. 1).

1. Drag and Drop your file into the Add Datasource popup (Fig. 2).
2. Select DWG-DXF-IFC-NWC-NWD-RVT (3D Solids) from the Type dropdown field and click Next.
3. Fill in the mandatory fields then click Create.

You will receive a message at the bottom of your screen notifying you that your data source was created. You should now be able to locate this data source on the Data Sources page.

Simple 3D Model File Configuration Settings

Model Level

Layer Group

Select one of the predetermined layer groups (made at the team level). By default, all child nodes inherit all settings from the parent node - if anything is set at the Root level, all models within the root will be set the same way.

Header

This editable field name defaults to the name of the element in the original dataset (Model/Folder, Category). The header can be seen when pointed at using the vSite AR mobile app.

Object Type

This field should remain untouched as it could lead to configuration issues. It can however be used to verify which object type has been uploaded (Point, Line, Area, 3D Model, or Unknown).

Select Color

Select from preset colors or customize your own from the colour palette controls.

Object Configuration

Coordinate System Type

For Simple 3D model datasources, there are 2 options for Coordinte system type.

Manual: Enter the vertical datum and unit of measure for the dataset. These additional fields will appear below to complete the manual coordinate process: Altitude, Latitude, Longitude, Pitch, Roll, and Yaw. This is the default coordinate system type for Simple 3D Models.

Custom: This option will allow you to spatially reference your model with a custom coordinate system that has been set up in the admin portal. For more details, click here.

Object Positioning: There are 6 fields that are used for manually positioning your 3D model

Altitude: The model's height above ground level.

Latitude: The model's north-south position on the Earth, measured in degrees from the Equator

Longitude: The model's east-west position on the Earth, measured in degrees from the Prime Meridian.

Pitch: The model's rotation around its side-to-side axis, causing it to tilt up or down.

Roll: The model's rotation around its front-to-back axis, causing it to tilt left or right.

Yaw: The model's rotation around its vertical axis, determining the direction it faces (its compass heading).

Elevation Type

At the layer folder level, there are four options:

• Use Parent Node Setting - Takes configuration settings made at the Root level (see above).
• Default - Allows the system to recognize if the data set is z-enabled or not. If z-enabled, the base for the elevation calculations will refer to the sea level and its corresponding vertical datum. If not, it will count as Surface offset.
• Surface offset - Refers to the selected digital surface as the base for the elevation calculations.
• Ignore z-value - Ignores z-values within the data set.

Supplementary Material

Simple 3D Model Requirements

To ensure a successful upload, the following file requirements must be met:

• Include .dae, .shp, .shx, .dbf, and .prj files for each layer.

• Place all files into a single folder.

• Compress the folder into a .zip archive.

Notes:

• If the model is textured, ensure that the texture is included and compressed with the model into the .zip file.

• Use Select File to upload new files, Replace with New Version to update existing files, and Delete to remove them.

• Simple 3D Models may require additional effort to place accurately compared to other supported data source formats. See Alternative Source Formats.