com.esri.arcgis.geodatabaseextensions
Interface ILasStatistics

All Superinterfaces:

Serializable

All Known Implementing Classes:

LasStatistics

public interface ILasStatistics
extends Serializable

Provides access to members of LasFile.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

ISimpleStatistics	getAttributeStatistics(int attribute) Get statistics of the specified LAS attribute.
ILasClassCodeStatistics	getClassCodeStatistics(int classCode) Get statistics associated with the specified class code.
ILasReturnStatistics	getReturnStatistics(int type) Get statistics associated with the specified return type.
ILongArray	getUniqueClassCodes() Get unique class codes.
ILongArray	getUniqueReturns() Get unique returns (as esriTerrainLasReturnType).
IEnvelope	getWithheldExtent() The XYZ extent of withheld points.
double	getWithheldPointCount() The number of withheld points.

Method Detail

getWithheldPointCount

double getWithheldPointCount()
                             throws IOException,
                                    AutomationException

The number of withheld points.

Description

Returns the number of points flagged as withheld in the file/dataset. Withheld points are those identified using the bit field encoding scheme laid out in the LAS Specification. Generally, these points are intended to be excluded from use.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

The pCount

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getWithheldExtent

IEnvelope getWithheldExtent()
                            throws IOException,
                                   AutomationException

The XYZ extent of withheld points.

Description

Returns the XYZ extent of points flagged as withheld in the file/dataset. Withheld points are those identified using the bit field encoding scheme laid out in the LAS Specification. Generally, these points are intended to be excluded from use. The envelope will be empty (IEnvelope.IsEmpty == TRUE) if there are no withheld points.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

A reference to a com.esri.arcgis.geometry.IEnvelope

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAttributeStatistics

ISimpleStatistics getAttributeStatistics(int attribute)
                                         throws IOException,
                                                AutomationException

Get statistics of the specified LAS attribute.

Description

Returns the LasAttributeStatistics for the specified attribute.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

attribute - A com.esri.arcgis.geodatabaseextensions.esriLasAttributeType constant (in)

Returns:

A reference to a com.esri.arcgis.geodatabaseextensions.ISimpleStatistics

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUniqueReturns

ILongArray getUniqueReturns()
                            throws IOException,
                                   AutomationException

Get unique returns (as esriTerrainLasReturnType).

Description

Returns an ILongArray of esriTerrainLasReturnType. The number of entries in the array will equal the number of return types present in the file/dataset. These include the returns with explicit return numbers (i.e., returns 1-5) plus those which are inferred by comparing the return number for a point to the total returns for the pulse associated with the point (e.g., to derive first of many, last of many, single, etc.).

Note:

Some LAS files in the wild have been found to contain returns numbered "0". These are not valid returns but if they exist in the file they will be reported in the LongArray with a value of "0". Their presence will induce the addition of others like esriTerrainLasReturnLast (for point records that have both return number and number of returns set to 0) and esriTerrainLasReturnAll.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

A reference to a com.esri.arcgis.system.ILongArray

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUniqueClassCodes

ILongArray getUniqueClassCodes()
                               throws IOException,
                                      AutomationException

Get unique class codes.

Description

Returns an Array of LasClassCodeStatistics. The number of entries in the array will equal the number of classes present in the file/dataset.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

A reference to a com.esri.arcgis.system.ILongArray

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getReturnStatistics

ILasReturnStatistics getReturnStatistics(int type)
                                         throws IOException,
                                                AutomationException

Get statistics associated with the specified return type.

Description

Provides the LasReturnStatistics for the specified return type. NULL is returned if there are no points of the specified type.

Note:

Some LAS files in the wild have been found to contain returns numbered "0". These are not valid returns but you can check to see if they are present by passing a "0" for the return type instead of one of the esriTerrainLasReturnType values.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

type - A com.esri.arcgis.geodatabaseextensions.esriTerrainLasReturnType constant (in)

Returns:

A reference to a com.esri.arcgis.geodatabaseextensions.ILasReturnStatistics

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getClassCodeStatistics

ILasClassCodeStatistics getClassCodeStatistics(int classCode)
                                               throws IOException,
                                                      AutomationException

Get statistics associated with the specified class code.

Description

Returns the LasClassCodeStatistics for the specified class. The valid range for las class codes is 0-31 for LAS files rev 1.1 through 1.3. NULL is returned if there are no points with that class code.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

classCode - The classCode (in)

Returns:

A reference to a com.esri.arcgis.geodatabaseextensions.ILasClassCodeStatistics

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.