E3DLidar

E3DLidar is a reference to a lidar object. For details on creating an E3DLidar object, see E3De::OpenLidar and E3DLidar::Init.

This method has been deprecated. Use ENVIPointCloud or ENVIPointCloudQuery instead.

Example

; Create a headless instance

e = E3De(/HEADLESS)

; Open a las file

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

  SUBDIRECTORY = ['DataSample'])

lidar = e.OpenLidar(file, /DIRECT_READ)

; Print number of points and extents

print, lidar.Total_Number_Of_Points

print, lidar.Data_Range

; Close any open lidar objects

e.Close

Methods

Properties

Properties marked as (Get) can be retrieved, but not set.

TOTAL_NUMBER_OF_POINTS (Get)

An unsigned long 64-bit value containing the total number of points in the dataset. If there are multiple files associated with this E3DLidar, this is the total number of points in all the files.

DATA_RANGE (Get)

This property retrieves a six-element array containing the boundary of the entire data space, in the form [x_min, y_min, z_min, x_max, y_max, z_max].

The DATA_RANGE values use the coordinate system of the dataset (see the SPATIALREF property).

TILE_SIZE_METERS (Get)

A double value containing the tile size used in the optimized file. The value will be 0 if LiDAR data has not been written to an optimized file.

TILES_X (Get)

A long integer value containing the number of tiles in the X direction in the optimized file. The value will be 0 if LiDAR data has not been written to an optimized file.

TILES_Y (Get)

A long integer value containing the number of tiles in the X direction in the optimized file. The value will be 0 if LiDAR data has not been written to an optimized file.

READ_ONLY (Get)

Returns 1 if the E3DLidar is read-only, and returns 0 if it is not. If the value is 0, the WritePoints and Save methods are available.

SPATIALREF (Get)

A reference to an E3DLidarSpatialRef object that contains the coordinate system information for this LiDAR data. If there is no coordinate system information (for example, the LAS header does not contain it) then this property will return !NULL.

If E3De::OpenLidar was called with an .ini file or an array of LiDAR files, this property contains the coordinate system information for the project (either UTM WGS84 or arbitrary).

If E3De::OpenLidar was called with a single LiDAR file containing coordinate system information and the DIRECT_READ keyword is set, this property contains its coordinate system information.

DIRECT_READ (Get)

Returns 1 if the LiDAR file is being read directly without processing into an optimized file format. Otherwise, returns 0. See the E3De::OpenLidar DIRECT_READ keyword for details.

SOURCE_URI (Get)

An array of strings containing the fully-qualified filenames of the LiDAR files used in this E3DLidar. This is useful to get the list of files that were imported into an ENVI LiDAR project. If E3De::OpenLidar was called with a single LiDAR file and the DIRECT_READ keyword was set, then only one filename will be returned.

AUXILIARY_URI (Get)

This property retrieves a string containing the path to the directory that contains the E3DLidar's associated files. If there are no associated files, !NULL is returned.

URI (Get)

A string that is a fully-qualified LiDAR filepath.

Version History

3.2	Introduced
ENVI 5.3	Obsolete