ArcObjects Library Reference (GeoDatabase)  

ITinSurface3.Intersect Method

Intersect with a reference TIN.

[Visual Basic .NET]
Public Sub Intersect ( _
    ByVal pReferenceSurface As ITinSurface, _
    ByVal pAOI As IGeometry, _
    ByVal pOutFeatureClass As IFeatureClass, _
    ByVal volumeFieldName As String, _
    ByVal surfaceAreaFieldName As String, _
    ByVal codeFieldName As String _
)
[C#]
public void Intersect (
    ITinSurface pReferenceSurface,
    IGeometry pAOI,
    IFeatureClass pOutFeatureClass,
    string volumeFieldName,
    string surfaceAreaFieldName,
    string codeFieldName
);
[C++]
HRESULT Intersect(
  ITinSurface* pReferenceSurface,
  IGeometry* pAOI,
  IFeatureClass* pOutFeatureClass,
  BSTR volumeFieldName,
  BSTR surfaceAreaFieldName,
  BSTR codeFieldName
);
[C++]

Parameters

pReferenceSurface [in]

  pReferenceSurface is a parameter of type ITinSurface

pAOI [in]

  pAOI is a parameter of type IGeometry

pOutFeatureClass [in]

  pOutFeatureClass is a parameter of type IFeatureClass

volumeFieldName [in]   volumeFieldName is a parameter of type BSTR surfaceAreaFieldName [in]   surfaceAreaFieldName is a parameter of type BSTR codeFieldName [in]   codeFieldName is a parameter of type BSTR

Product Availability

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

Description

Calculates the difference between two TINs. Outputs 2D polygons that divide space based on whether the source surface is above, coincident to, or below the reference surface. Boundaries of the polygons represent where the two surfaces intersect in 3D space. Each polygon is assigned a numeric code to indicate its relation: -1 is assigned to polygons where the source surface is below the reference surface, 0 to polygons where it's coincident, and 1 to polygons where it's above. Volume, area, and surface area are also calculated for each polygon. Volume represents the cubic space between the two surfaces. Area is the planimetric, or projected, area. Surface area takes slope into account and is that of the source surface.

pReferenceSurface is the other TIN being used to compare the source surface against. Above, coincident, and below assessments on the source surface are made relative to the reference surface.

pOutFeatureClass is where output features will be written. It needs to be a 2D polygon feature class.

volumeFieldName is the name of the field where volume is written. The field type should be a double.

surfaceAreaFieldName is the name of the field where surface area is written. The field type should be a double.

codeFieldName is the name of the field where the verical relation code is written.

 

Notes:
Surfaces must have some overlap in XY extent.

While this method will add fields if they don't already exist it's best to add them first. This gives you the opportunity to place the feature class into LoadOnly mode (if not a shapefile) before calling the method. It's not recommended for anything to be adding fields while in LoadOnly mode.

Both TINs must not be in edit mode when calling this method.

See Also

ITinSurface3 Interface