com.esri.arcgis.geodatabaseextensions
Interface ITerrainLasDataInfo2

All Superinterfaces:

ITerrainLasDataInfo, Serializable

All Known Implementing Classes:

TerrainLasDataImporter

public interface ITerrainLasDataInfo2
extends ITerrainLasDataInfo, Serializable

Provides access to members that provide information about a LAS file.

Product Availability

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

Method Summary

int	getFileSourceID() The LAS file's source ID.
void	getPointInfoByClassCode(ITrackCancel pTrackCancel, ILongArray pCodes, IDoubleArray[] ppCounts, IArray[] ppExtents) Get the number of points corresponding to the specified class codes.
boolean	isStandardGpsTime() Indicates if the GPS time is standard GPS Time.

Methods inherited from interface com.esri.arcgis.geodatabaseextensions.ITerrainLasDataInfo

getDataExtent, getFlightDateJulian, getGeneratingSoftware, getNumberOfPointRecords, getNumberOfPointsByReturn, getPointDataFormat, getSpatialReference, getSystemID, getVersion, getYear, init

Method Detail

getFileSourceID

int getFileSourceID()
                    throws IOException,
                           AutomationException

The LAS file's source ID.

Description

Returns the 'File Source ID' listed in the header of the LAs file.

Here's a description for 'File Source ID' as listed in the LAS 1.2 specification:
File Source ID (Flight Line Number if this file was derived from an original flight line): This field should be set to a value between 1 and 65,535, inclusive. A value of zero (0) is interpreted to mean that an ID has not been assigned. In this case, processing software is free to assign any valid number. Note that this scheme allows a LIDAR project to contain up to 65,535 unique sources. A source can be considered an original flight line or it can be the result of merge and/or extract operations.

Product Availability

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

Returns:

The pID

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isStandardGpsTime

boolean isStandardGpsTime()
                          throws IOException,
                                 AutomationException

Indicates if the GPS time is standard GPS Time.

Description

This method returns TRUE if the time contained in the LAS file represents standard GPS time and FALSE if it represents GPS week time.

Product Availability

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

Returns:

The pbIsAStandard

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getPointInfoByClassCode

void getPointInfoByClassCode(ITrackCancel pTrackCancel,
                             ILongArray pCodes,
                             IDoubleArray[] ppCounts,
                             IArray[] ppExtents)
                             throws IOException,
                                    AutomationException

Get the number of points corresponding to the specified class codes.

Description

Returns point count and extent information based on LAS class codes.

pTrackCancel is a reference to a CancelTracker to support progress reporting and the ability to halt the process. To bypass this feature pass a NULL pointer.

pCodes is a LongArray containing the LAS class codes. You can either provide an empty array, in which case all codes contained in the file will be discovered and written into the array for you, or you can specify specific codes of interest. If you specify the codes then the count and extent information will be reported only for those classes.

pCounts is an output DoubleArray containing the number of points per class. There is a one to one correspondence between the codes in the pCodes array and the counts in the pCounts array.

pExtents in an output array of envelopes. The envelopes capture the XYZ extents of the points based on class code. There is a one to one correspondence between the codes in the pCodes array and the envelopes placed in the pExtents array. If a code has been specified in the pCodes array that does not exist in the file the resulting envelope will be empty (IGeometry.IsEmpty=TRUE).

Product Availability

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

Parameters:

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

pCodes - A reference to a com.esri.arcgis.system.ILongArray (in)

ppCounts - A reference to a com.esri.arcgis.system.IDoubleArray (out: use single element array)

ppExtents - A reference to a com.esri.arcgis.system.IArray (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.