Upload 360 images and point clouds to third-party software

Prev Next

This article explains how to upload extracted 360 images and the associated point cloud to third-party visualization platforms. The four platforms officially tested to work with Aura are Pointerra3D, Cintoo Cloud, Bently iTwin, and Prevu3D.

Aura version 1.9 or later allows you to view geolocated 360 panoramic images alongside point clouds.

What you will need

  • Extracted 360 images and the associated CSV reference files, output by Aura (see Process a 360 scan and extract images in Aura).

  • A processed point cloud from the same scan.

  • An active account with the third-party platform being used.

  • For platform-specific file format requirements, see the relevant procedure below.

Procedure

Each procedure below is independent. Follow the steps for the platform being used.

Step 1: Upload to Prevu3D

Please link to the Prevu3D instructions for uploading scans.

Step 2: Upload to Pointerra 3D CORE

File format requirements

Support for various file formats and sources (e.g. LAS/LAZ, PTS, E57, Geotiff, XYZ, PLY, SHP, DXF, KML, Geojson, ESRI GDB, OBJ, IFC, FBX, Cesium 3D Tiles, ECW, JPGs)

  1. Go to Core - Pointerra3D and log in to your Pointerra3D account.

  2. Click the Upload button on the top right of the page to display the Upload data wizard.

  3. Click Add files then browse for the point cloud files (LAZ) that were processed in Emesent Aura (before the image extraction). The point cloud file(s) in the write_global folder must be used for this, not the ones in any of the georeferenced write_global_xxx folders.

  4. Specify the Source coordinate system. If there is no GPS/RTK data in the scan, select My data is not georeferenced.

    - or -

    Select Let me select from a list of coordinate systems if the data is georeferenced. The Coordinate System should match the coordinate system described by the .prj file(s) in the write_global folder. Usually, this is a WGS84 UTM zone, with the Vertical Datum set to Ellipsoid.

    Before importing into Pointerra, ensure the data is projected using an external tool. You can use third-party GIS software like QGIS or Global Mapper to re-project your data to a different coordinate system. Note that both the point cloud files and the frames_pointerra.csv (see below) must be re-projected the same way. Re-projection of the point cloud and images will come in a future version of Aura.

    Source vertical units are in meters.

  5. Enter any metadata information to help identify the scan (optional).

  6. Click the 360 Photos button.

  7. Enter a dataset name then under Source Files, click on the Upload tab.

  8. Click Add files to attach the images and the frames_pointerra.csv file, which contains the spatial reference and file association.

    It is recommended to manually select the files instead of adding a folder as there may be additional files in a folder that may confuse the system.

  9. If your data is georeferenced, ensure the Same as point cloud option under Source coordinate system is selected.

  10. Click Add.

  11. Specify the destination of the point cloud and images in the Pointerra cloud folder structure.

  12. Configure the email notifications (optional).

  13. After completing the wizard, click the Begin Upload button.

  14. Wait for the upload to be completed before closing the web browser.

  15. You will be taken to a Jobs screen where you can track the progress of the processing job, when it is completed you receive a notification that it is available to view.

Step 3: Import scans to Cintoo Cloud

File format requirements

E57, traj (.xyz), .jpeg

  1. Click the cloud icon in the top right to install the application locally. Once installed (using admin privileges), upload the 360 images within the selected project. This will launch Cintoo Connect.

  1. Click the Indoor Mobile Scanner tab.

  2. Select Emesent Hovermap as the source Device / Format.

  3. Select the point cloud (E57) and the scanning path (.xyz) files generated from Emesent Aura.

  4. You may modify the Positions sampling value as required. For example, a value of 1/4 creates 1 scan location for every 4 panoramic images included in the scanning path. The number of 3D scans and the average distance between each one is indicated in Cintoo Connect and will be added to your scan count.

  5. Click Import.

  6. Check the Messages tab from time to time to see if the process is running smoothly.

  7. Your new 3D scans will appear in your Cintoo Cloud project.

Step 4: Import 360 images to Cintoo Cloud

Importing the 360° images to Cintoo requires an additional step. The images are geolocated within the cloud and are presented as the same coordinate system that is available to the 360 scans.

The 360° images do not count as scans in your scan count.

The maximum number of 360 images that you can upload to Cintoo Cloud is limited to the number of scans that you subscribed to. For example, if you have a subscription for 5,000 scans, you can upload up to 5,000 additional 360° images.

360° images are 2D only, so you cannot use them to add annotations (which are linked to a 3D point) or to make measurements. They are used for display only.

  1. Using Cintoo Connect, go to the Terrestrial Laser Scanner tab then click Select input files.

  1. Navigate to the output folder that was created during the Emesent Aura 360 image extraction step (it will be inside the second output folder from the active scan directory).
    For example: C:\..\Output\frame_extraction\frames\

  2. Select the frames_cintoo.csv file and click Import. The import and upload process will start automatically.

The frames_cintoo.csv file already contains the correct column headings for importing into Cintoo.

Step 5: Import Emesent point cloud to iTwin (Bentley)

Before starting iTwin import, complete the following one-time setup:

To import the point cloud:

  1. Click the Resources button then select Create Mapping Resource.

  2. Specify the following settings:

Field

Value

Directory

Choose the write global output for your point cloud

Name

Enter a name for your resource

Template

Select Emesent-Hovermap

CRS

Select the appropriate CRS for your dataset

  1. Click Create.

  2. In the Edit Mapping Resource panel, click Import point cloud.

  3. Click Select Files then browse for the point cloud generated using Emesent Aura.

  4. Click Start Now.

  1. Wait for the dataset to load.

Step 6: Import 360 images to iTwin (Bentley)

  1. Click the Resources button then select Create Mapping Resource.

  1. Specify the following settings:

Field

Value

Type

Mobile

Directory

Enter the frames directory from your 360 image output (that includes all the images)

Name

Enter a name for your resource

Template

Select Mobile Mapping Generic

Source / Target CRS

Select the appropriate CRS for your dataset

  1. Click Create.

  2. In the Edit Mapping Resource panel, click Import Panorama 1.

  1. Click Choose File then browse for frames_bentley.csv file located in the frame_extraction folder generated during the image extract process in Emesent Aura.

  2. Click Open File Location then copy all the images from the frame_extraction folder into this folder.

  3. Click on the Mobile Mapping tab at the bottom window then click on one of the capture points to view the corresponding 360 images.

Outcome

The 360 images and associated point cloud have been uploaded to the chosen third-party platform, where they can be viewed, shared, and (depending on the platform) annotated or measured.

Additional information