com.esri.arcgis.geodatabaseextensions
Interface ILasPointCloud

All Superinterfaces:

Serializable

All Known Implementing Classes:

LasDataset

public interface ILasPointCloud
extends Serializable

Provides access to points.

Product Availability

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

Method Summary

double	estimatePointCount(IGeometry pAOI) Estimate point count.
void	estimatePointSpacing(IEnvelope pAOI, double[] pMinSpacing, double[] pMaxSpacing, double[] pMeanSpacing) Estimate point spacing.
IArray	getLasPointInfo(ITrackCancel pTrackCancel, IGeometry pLocation, double pointID) Returns an array of ILasPointInfo(the 1-based pointID is optional).
IEnumLasPoint	getLasPoints(ITrackCancel pTrackCancel, ILasPointFilter pFilter, double thinningFactor, double zFactor) getLasPoints
IEnumLasPoint	getLasPointsByBudget(ITrackCancel pTrackCancel, ILasPointFilter pFilter, double maxPointCount, double zFactor) getLasPointsByBudget
void	lasPointStatsAsRaster(ITrackCancel pTrackCancel, ILasPointFilter pFilter, IRasterDataset pDataset, int type, int attribute) Export to Raster.
void	queryLasPointInfo(int fileIndex, double pointID, ILasPointInfo pInfo) Query point information associated with the 1-based point ID.

Method Detail

estimatePointCount

double estimatePointCount(IGeometry pAOI)
                          throws IOException,
                                 AutomationException

Estimate point count.

Description

Returns an estimate of the number of points within the specified area of interest.

pAOI is the input geometry representing the area of interest. Valid geometries are Polygon, Envelope and a GeometryBag with polygons or envelopes. The Z range information, if set on the input geometry, is ignored.

Product Availability

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

Parameters:

pAOI - A reference to a com.esri.arcgis.geometry.IGeometry (in)

Returns:

The pcPoints

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

estimatePointSpacing

void estimatePointSpacing(IEnvelope pAOI,
                          double[] pMinSpacing,
                          double[] pMaxSpacing,
                          double[] pMeanSpacing)
                          throws IOException,
                                 AutomationException

Estimate point spacing.

Description

Returns min, max, and mean point spacing estimates based on the LAS files whose extents intersect the passed envelope. If only one file is within the extent then min, max, and mean will be the same. If multiple files are intersected the min is set to the file with the smallest spacing, max to the one with the largest, and mean is based on estimating the total points within the envelope.

Point spacing estimates at this level (i.e., the dataset) are based on estimates made per LAS file. They'll be more reliable if statistics for the LAS dataset have been calculated (see ILasDatasetEdit.CalculateStatistics and ILasFile.HasStatistics).

Product Availability

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

Parameters:

pAOI - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

pMinSpacing - The pMinSpacing (out: use single element array)

pMaxSpacing - The pMaxSpacing (out: use single element array)

pMeanSpacing - The pMeanSpacing (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLasPoints

IEnumLasPoint getLasPoints(ITrackCancel pTrackCancel,
                           ILasPointFilter pFilter,
                           double thinningFactor,
                           double zFactor)
                           throws IOException,
                                  AutomationException

getLasPoints

Description

Returns a Las point enumerator to retrieve points from a LAS dataset.

pTrackCancel is a reference to a Cancel Tracker object that can be used to monitor progress and/or cancel the process. This can be set to a NULL pointer ('Nothing' in VB) if desired.
pFilter references a ILasPointFilter that defines the selection criteria for what points to read from the las files.

thinningFactor is a double with a valid range: >0 and <=1.0. Multiplied by 100, it represents the percentage of points to retrieve from within the area of interest defined by pFilter.

zFactor is used to convert the vertical units of the retrieved points (e.g., to convert feet to meters). The output point z values are multipled by the zFactor.

Product Availability

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

Parameters:

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

pFilter - A reference to a com.esri.arcgis.geodatabaseextensions.ILasPointFilter (in)

thinningFactor - The thinningFactor (in)

zFactor - The zFactor (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLasPointsByBudget

IEnumLasPoint getLasPointsByBudget(ITrackCancel pTrackCancel,
                                   ILasPointFilter pFilter,
                                   double maxPointCount,
                                   double zFactor)
                                   throws IOException,
                                          AutomationException

getLasPointsByBudget

Description

Returns a Las point enumerator to retrieve points from a LAS dataset with a constraint on the upper limit of the number of points.

pTrackCancel is a reference to a Cancel Tracker object that can be used to monitor progress and/or cancel the process. This can be set to a NULL pointer ('Nothing' in VB) if desired.

pFilter references a ILasPointFilter that defines the selection criteria for what points to read from the las files.

maxPointCount is the maximum number of points that is desired.

zFactor is used to convert the vertical units of the retrieved points (e.g., to convert feet to meters). The output point z values are multipled by the zFactor.

Product Availability

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

Parameters:

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

pFilter - A reference to a com.esri.arcgis.geodatabaseextensions.ILasPointFilter (in)

maxPointCount - The maxPointCount (in)

zFactor - The zFactor (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLasPointInfo

IArray getLasPointInfo(ITrackCancel pTrackCancel,
                       IGeometry pLocation,
                       double pointID)
                       throws IOException,
                              AutomationException

Returns an array of ILasPointInfo(the 1-based pointID is optional).

Description

Returns an array of point info objects located near the input geometry.

pTrackCancel is a reference to a Cancel Tracker object that can be used to monitor progress and/or cancel the process. This can be set to a NULL pointer ('Nothing' in VB) if desired.

pLocation is the input geometry. Valid geometries are Point, Envelope. The z information on the input geometry is honored. If extent is z-aware, its z-range is honored.

pointID is optional. If provided, point info object(s) of the point(s) with the input pointID that satisfy the location's extent are returned.

Product Availability

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

Parameters:

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

pLocation - A reference to a com.esri.arcgis.geometry.IGeometry (in)

pointID - The pointID (in)

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryLasPointInfo

void queryLasPointInfo(int fileIndex,
                       double pointID,
                       ILasPointInfo pInfo)
                       throws IOException,
                              AutomationException

Query point information associated with the 1-based point ID.

Description

Queries the point information for the specified point in a specified file.

FileIndex is the input file index (0-based).

PointID is the input point id (1-based).

pInfo is ILasPointInfo object representing the point information. This object needs to be pre-initialized.

Product Availability

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

Parameters:

fileIndex - The fileIndex (in)

pointID - The pointID (in)

pInfo - A reference to a com.esri.arcgis.geodatabaseextensions.ILasPointInfo (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

lasPointStatsAsRaster

void lasPointStatsAsRaster(ITrackCancel pTrackCancel,
                           ILasPointFilter pFilter,
                           IRasterDataset pDataset,
                           int type,
                           int attribute)
                           throws IOException,
                                  AutomationException

Export to Raster.

Description

Populates the input raster dataset with values that reflect statistical information about measurements from LAS files referenced by a las dataset.

pTrackCancel is a reference to a Cancel Tracker object that can be used to monitor progress and/or cancel the process. This can be set to a NULL pointer ('Nothing' in VB) if desired.

pFilter is a reference to an ILasPointFilter. If set, only points that match the criteria set on the filter are considered while computing statistics.

pDataset is the raster dataset to which the point statistics information will be written to. The raster must already exist.

Type is the statistic type computed about the points in each cell of the raster dataset.

Attribute is the point attribute using which the statistics are computed on a cell by cell basis.

Product Availability

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

Parameters:

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

pFilter - A reference to a com.esri.arcgis.geodatabaseextensions.ILasPointFilter (in)

pDataset - A reference to a com.esri.arcgis.geodatabase.IRasterDataset (in)

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

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.