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


IGeneralizeOp.RegionGroup Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (SpatialAnalyst)  

IGeneralizeOp.RegionGroup Method

Records for each cell in the output, the identity of the connected region to which it belongs.

[Visual Basic .NET]
Public Function RegionGroup ( _
    ByVal Raster As IGeoDataset, _
    ByVal useDiagonalNeighbors As Boolean, _
    ByVal withinZones As Boolean, _
    ByVal createLinkField As Boolean, _
    [ByRef excludedValue As Object] _
) As IGeoDataset
[C#]
public IGeoDataset RegionGroup (
    IGeoDataset Raster,
    bool useDiagonalNeighbors,
    bool withinZones,
    bool createLinkField,
    ref object excludedValue
);
[C#]

Optional Values

excludedValue   To indicate that this parameter is undefined, first define a variable object Missing=Type.Missing; then pass this in as ref Missing.
[C++]
HRESULT RegionGroup(
  IGeoDataset* Raster,
  VARIANT_BOOL useDiagonalNeighbors,
  VARIANT_BOOL withinZones,
  VARIANT_BOOL createLinkField,
  VARIANT* excludedValue,
  IGeoDataset** RegionGroup
);
[C++]

Parameters Raster [in]
Raster is a parameter of type IGeoDataset useDiagonalNeighbors [in] useDiagonalNeighbors is a parameter of type VARIANT_BOOL withinZones [in] withinZones is a parameter of type VARIANT_BOOL createLinkField [in] createLinkField is a parameter of type VARIANT_BOOL excludedValue [optional] excludedValue 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. RegionGroup [out, retval]
RegionGroup is a parameter of type IGeoDataset

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

Remarks

raster

An input Raster, RasterDataset, RasterBand, or RasterDescriptor whose cells define the zone values to be regrouped

useDiagonalNeighbors

Defines the manner in which to evaluate connectivity between cells

If True, the connectivity between cells of the same value if they are within the immediate eight-cell neighborhood (eight nearest neighbors) of each other will be used. This includes if they are to the right or left, above or below, or are diagonal to each other.

If False, the connectivity between cells of the same value only if the cells are directly to the right or left, or above or below each other—the four nearest neighbors will be used. If two cells with the same value are diagonal from one another, they are not considered connected

withinZones

Defines the requirement of which cell values should be considered when testing for connectivity

If True, will test for the connectivity between input values that are the same within the same zone. The only cells that can be grouped are cells from the same zone (the same value) and that meet the spatial requirements of connectivity specified by useDiagonalNeighbors Boolean.

If False, will test the connectivity by the spatial requirements specified by the useDiagonalNeighbors Boolean between cells with any values except for the excluded value identified by the argument excludedValue if one is specified. A value for the excludedValue argument must be input when withinZones Boolean is False.

createLinkField

Defines if a Link item is added to the value attribute table of the output Raster

If True, an item Link will be added to the table of the output Raster. The Link item stores the original values for each newly created zone (created from disconnected regions) from the input Raster before they were regrouped.

If False, the table for the output Raster will only contain the items Value and Count.

[excludedValue]

Identifies a value such that if a cell location contains the value, no spatial connectivity will be evaluated no matter what the Boolean is for the useDiagonalNeighbors

Cells with the excluded value will be treated as NoData and are eliminated from calculations. Cell locations that contain an excluded value will receive zero for the location on the output Raster. The excluded value is similar to the concept of a background value or setting a mask for a single function with the Options dialog. It is particularly useful in conjunction with a False value for within Zones.

 

See Also

IGeneralizeOp Interface