Point clouds (LAS/LAZ)

The Umbra command line tool that is included in the SDK package is designed for importing and umbrafying 3D content.

This guide is tailored specifically for scanned 3D data originating from laser scans or photogrammetry and imported as raw point clouds, especially in LAS (or LAZ) format into Umbra.

How to Umbrafy LAS-input:

  1. In short, you can move directly to umbrafying your LAS-input if:
    • Your LAS-input is not georeferenced at all
    • Your LAS is properly georeferenced (EPSG:4326 / WGS84 long/lat)
    • If neither of these is true, you can find some troubleshooting below
  2. Download the Umbra SDK package from our Downloads section.
  3. Navigate to ..\UmbraCompositSDK-<version>\bin<yourplatform>\
  4. Run umbra.exe. You can run umbra.exe help umbrafy for further help.

For choosing the right resolution parameter for your 3D data, check this support article: Feature Size

Example Usage:

umbra umbrafy --input-las “C:/my_massive_LAS/” --content-profile scanned --feature-size 0.25 --api-key <your_api-key here> --scene-name “My Massive LAS” --backface-removal false

In addition, we suggest adding the following parameter depending if a specific type of scanning equipment was used in the reality capture. If the content is captured using an aerial drone or you’re uncertain, then just ignore this parameter altogether.

Scanning station: --point-cloud-connect-radius 0.1

Aerial (aircraft) scans: --point-cloud-connect-radius 1.0

Troubleshooting LAS:

Convert to Long/Lat

If your LAS-georeferencing is in some other coordinate system than EPSG:4326 / WGS84 long/lat, you can try the following measures to convert it:

  1. Download and install LAS-tools
  2. Run las2las with the following parameters

    las2las -i yourfile.las -o yourfile_fixed.las -target_longlat

If this doesn’t work for you, you can also try the conversion using [PDAL - Point Data Abstraction Library](PDAL - Point Data Abstraction Library). There are most likely other solutions for the conversion, so feel free to share your workflow with us: support@umbra3d.com

Using LAZ:

If your input point cloud is compressed into LAZ, you can try the following:

  1. Download and install LAS-tools
  2. Run las2las with the following parameters to decompress the LAZ to LAS

    las2las -i yourfile.laz -o yourfile.las -target_longlat