E3DLidar::GetDataRange

The GetDataRange function method returns 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].

If E3De::OpenLidar DIRECT_READ mode is used, the data range values use the coordinate system of the dataset. If a project is open, the data range values use the WGS84 coordinate system. If a SPATIALREF is supplied, the data range values are returned using this coordinate system.

This method has been deprecated. Use ENVIPointCloud DATA_RANGE or ENVIPointCloudQuery DATA_RANGE properties 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)

datarange = lidar.GetDataRange()

print, datarange

; Close any open lidar objects

e.Close

Syntax

Result = E3De.GetDataRange([, ERROR=variable] [SPATIALREF=E3DLidarspatialref])

Return Value

A six-element array containing the boundary of the entire data space, in the form [xMin, yMin, zMin, xMax, yMax, zMax].

Keywords

ERROR

Set this keyword to a named variable that will contain any error message issued during execution of this routine. If no error occurs, the ERROR variable will be set to a null string (''). If an error occurs and the routine is a function, then the function result will be undefined.

When this keyword is not set and an error occurs, ENVI returns to the caller and execution halts. In this case, the error message is contained within !ERROR_STATE and can be caught using IDL's CATCH routine. See IDL Help for more information on !ERROR_STATE and CATCH.

See Manage Errors for more information on error handling in ENVI programming.

SPATIALREF

An instance of an E3DLidarSpatialRef. If this keyword is set, the points returned in Result will be converted to the coordinate system specified by the E3DLidarSpatialRef.

This is useful for converting coordinates between the native E3DLidar coordinate system and a user specified coordinate system. If ED3e::OpenLidar is called without DIRECT_READ, the native E3DLidar coordinate system will be UTM WGS84. This can be queried via the E3DLidar SPATIALREF property.

If this keyword is set and the LiDAR file does not have information about the coordinate system used, or the coordinate system in use is Arbitrary, an error will be generated.

Version History

3.2	Introduced
ENVI 5.3	Obsolete