CreatePointCloud Task

This task creates an ENVI LiDAR project that can be visualized using the ENVI 3D Web Viewer. The project can also be used with the ENVI LiDAR viewer and the ENVI LiDAR processing API. Two point cloud datasets cannot be open simultaneously. After running this task, any ENVIPointCloud object references with previously open data will become invalid and should not be used.

Example

The following example takes a single LiDAR dataset and creates the Levels of Detail required for streaming.

; Start the application

e = ENVI(/HEADLESS)

; Open a file

file = FILEPATH('DataSample.las', ROOT_DIR=e.ROOT_DIR, $

  SUBDIRECTORY = ['data','lidar'])

; Get the task from the catalog of ENVITasks

task = ENVITask('CreatePointCloud')

; Define input properties

task.INPUT_URI = [file]

; Run the task

task.Execute

; Get the output point clouds

outputEnviPointCloud = task.OUTPUT_POINTCLOUD

Syntax

Result = ENVITask('CreatePointCloud')

Input properties (Set, Get): INPUT_URI, LEVELS, SPATIAL_REFERENCE, OUTPUT_URI

Output properties (Get only): OUTPUT_POINTCLOUD

Properties marked as "Set" are those that you can set to specific values. You can also retrieve their current values any time.

Methods

This task inherits the following methods from ENVITask:

Properties

This task inherits the following properties from ENVITask:

COMMUTE_ON_DOWNSAMPLE

INPUT_URI (required)

Specify an array of point cloud datasets from which to create the project. The array is of the form:

['/data/file1.las', '/data/file2.las']

LEVELS (optional)

Specify an integer with the number of levels of detail to create. If you do not specify LEVELS, the task will automatically calculate the number of levels. Set this property to zero if the project will not be used for streaming with the ENVI 3D Web Viewer.

SPATIAL_REFERENCE (optional)

Specify an optional ENVIPointCloudSpatialRef object with the coordinate system used by the point cloud files being opened. You do not need to set this property if opening .las files that already contain coordinate system information (for example, in the LAS header).

If you do not set this property, the task checks the first point cloud file in the INPUT_URI array for coordinate system information. All of the files are assumed to use the same coordinate system.

If the first file does not contain coordinate system information and you do not specify this property, then the coordinates will be treated as arbitrary (undefined geographic location) with units in meters.

If the first point cloud file does contain coordinate system information and you set this property, the specified coordinate system will override that in the point cloud file.

OUTPUT_URI (required)

Specify a scalar string that is a fully-qualified path of the destination location of the project. If you do not set this property, the output will set to the ENVI output directory.

OUTPUT_POINTCLOUD

This property contains a reference to the ENVIPointCloud object.

Version History

ENVI 5.4.1

Introduced

API Version

4.2