Data Preparation and Organization for Orbit 3DM Publisher Viewer

This page describes the best-recommended practices in data preparation and organization to achieve consistently reliable high performance when Publishing a big amount of data.

Orbit 3DM Publisher Viewer processes most requests on the end-user side, not on the Publishing server. Unlike the previous generation of Orbit Viewer: Flash Viewer, HTML5 Viewer relies on data being optimized for streaming which means:

• All data, except for 3D Mesh (see below), should be in native Orbit formats.
• The performance is affected drastically by the amount of resources, not their size - the recommended maximum number of Runs in one Publication is not more than 20.
• WM(T)S should be accessed with a special Orbit Tile Map (.otm) driver.
• If a Publication contains at least one Resource not compliant with mandatory requirements, it will not open.

To publish mobile mapping resources, data must be imported as Runs.
It is possible to use Orbit 3DM Publisher Catalog on the server to Import Runs. However, it is highly recommended to have a dedicated Content Manager license and run data processing (Import and Merging Runs) on a separate machine with all resources being processed locally. All Mapping Runs\Oblique Projects included in a Publication have to be HTML5-ready, see Catalog > Cloud & HTML5.

Workflow:

1. Import and process your data into mobile mapping runs using the “Import Run” procedure, see Manage Mapping Runs.
2. Optimize Imagery.
3. Manage the runs in the 3DM console, see Console > Resource.

• All 'simple' resources (point cloud, photo positions, simplified trajectory) inside a Compound Resource (MM\UAS Run or Oblique Project) should be in the same projection system (CRS).
• Only necessary attributes should be included in the photo positions locations.ovt files: Orbit system attributes and only those attributes which are of interest for end user if any. To strip photo positions of unnecessary attributes:
  1. Back up locations.ovt.
  2. Convert locations.ovt to *.ovf.
  3. Remove attributes through Dataset Structure - Structure.
  4. Convert *.ovf to locations.ovt and replace original file.
• Runs belonging to one logical group should be physically merged into one Run (contrary creating Project containing multiple Runs) with Delivery.

• All vector layers should be converted to Orbit native formats. Use Convert Data or Optimize Data tools to convert supported vector formats into *.ovf or *.ovt.
• Every vector layer must have Orbit Legend File (*.olg) and Orbit Resource Descriptor (*.ord) files accompanying it.
• Vector layers of Point type must have Orbit Symbol Library (*.osl) file accompanying it. The easiest way to create *.osl file is:
  1. Open .olg file and search for the parameter 'Symbol.Library'.
  2. Copy the .osl file corresponding to the value of that parameter from ..\server\program\symbols in the installation folder.
  3. Paste it next to the .ovf file.
  4. Rename it to the same name as the vector file.

Workflow:

1. Import and convert the vector files in an Orbit desktop product.
2. Manage vector files in the 3DM console, see Console > Resource.

• Remove all unnecessary attributes and labels from vector files.

A point cloud which is not part of a run/project can be added separately to a publication.

• Import and convert the point cloud files in an Orbit desktop product.
• Manage pointcloud files in the 3DM console, see Console > Resource.

WM(T)S services

• WM(T)S services are supported as local resources in Orbit Tile Map Service file (*.otm) format.
• Manage basemap files in the 3DM console, see Console > Resource.

Georeferenced images

• Georeferenced Orbit Multiresolution Image (*.omi) with accompanying *.ord file is also supported as basemap layer.
  
• Manage basemap files in the 3DM console, see Console > Resource.

Mesh datasets can be added to a publication as a separate resource.
Supported type of mesh datasets:

• Cesium b3dm using gltf storage type.
• *.3dtiles, *.ord and *.ini files have to be available for Orbit to understand how to read cesium 3D tiles.
  • *.3dtiles is an empty text file
  • *.ini file can be empty or contain translation and scale of the mesh.