This document is archived and information here might be outdated.  Recommended version.


ILasSurface.InterpolateFeatureClass Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabaseExtensions)  

ILasSurface.InterpolateFeatureClass Method

Interpolate feature class.

[Visual Basic .NET]
Public Sub InterpolateFeatureClass ( _
    ByVal pTrackCancel As ITrackCancel, _
    ByVal pLasFilter As ILasFilter, _
    ByVal Resolution As Double, _
    ByVal Method As esriTinPointSelectionMethod, _
    ByVal Type As esriSurfaceInterpolationType, _
    ByVal ZFactor As Double, _
    ByVal pInClass As IFeatureClass, _
    ByVal pQueryFilter As IQueryFilter, _
    ByVal pOutClass As IFeatureClass, _
    [ByRef pStepSize As Object] _
)
[C#]
public void InterpolateFeatureClass (
    ITrackCancel pTrackCancel,
    ILasFilter pLasFilter,
    double Resolution,
    esriTinPointSelectionMethod Method,
    esriSurfaceInterpolationType Type,
    double ZFactor,
    IFeatureClass pInClass,
    IQueryFilter pQueryFilter,
    IFeatureClass pOutClass,
    ref object pStepSize
);
[C#]

Optional Values

pStepSize   To indicate that this parameter is undefined, first define a variable object Missing=Type.Missing; then pass this in as ref Missing.
[C++]
HRESULT InterpolateFeatureClass(
  ITrackCancel* pTrackCancel,
  ILasFilter* pLasFilter,
  double Resolution,
  esriTinPointSelectionMethod Method,
  esriSurfaceInterpolationType Type,
  double ZFactor,
  IFeatureClass* pInClass,
  IQueryFilter* pQueryFilter,
  IFeatureClass* pOutClass,
  VARIANT* pStepSize
);
[C++]

Parameters pTrackCancel [in]
pTrackCancel is a parameter of type ITrackCancel pLasFilter [in]
pLasFilter is a parameter of type ILasFilter Resolution [in] Resolution is a parameter of type double Method [in]
Method is a parameter of type esriTinPointSelectionMethod Type [in]
Type is a parameter of type esriSurfaceInterpolationType ZFactor [in] ZFactor is a parameter of type double pInClass [in]
pInClass is a parameter of type IFeatureClass pQueryFilter [in]
pQueryFilter is a parameter of type IQueryFilter pOutClass [in]
pOutClass is a parameter of type IFeatureClass pStepSize [optional] pStepSize is a parameter of type VARIANT
To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Product Availability

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

Description

Interpolates height for point, line, and polygon features.

pTrackCancel references a CancelTracker that can be used to stop the process. This can be set to NULL if the ability for the user to cancel isn't required.

pLasFilter defines the selection criteria for what points to use from the las files. The processing extent is also controlled by the area of interest property of the filter.

Resolution is the bin size, or horizontal sample distance, used for point thinning. The value should be provided in the XY units of the dataset. A square roving window of this size is passed over the set of filtered points. At each location one of the points inside the window is selected based on the selection Method. If there are no points in the window, no point is used. If there is only one point, then that point is used. Specify a Resolution of -1 for no thinning.

Method defines the point selection criteria for bin based point thinning. Valid options include min, max, and average. The random method is not a valid option. If you don't want thinning select min, max, or average with a Resolution of -1.

Type is the interpolation method to use. If this is set to natural neighbors then it's usually a good idea to include a stepsize.

zFactor is used to change units of the output cell values (e.g., to convert feet to meters). The output z values are multipled by the zFactor.

pInClass is the input point, polyline, or polygon feature class.

pQueryFilter is used to select input features. This may be set to NULL in which case all features will be used as input.

pOutClass is the target featureclass where output 3D features will be written.

[stepsize] is a horizontal distance used for densification of input polyline and polygon vertices. It's not needed if the interpolation Type is linear since the sampling strategy (i.e., sampling at original vertices plus triangle edge intersections) will capture all necessary detail. A stepsize is recommended when the interpolation Type is natural neighbors. This is because the natural neighbor surface varies smoothly and continuously across triangle faces and you need to specify what sample interval to use to capture this.

See Also

ILasSurface Interface