com.esri.arcgis.spatialanalyst
Interface IDensityOp

All Superinterfaces:

Serializable

All Known Implementing Classes:

RasterDensityOp

public interface IDensityOp
extends Serializable

Provides access to members that control the density operations.

Remarks

Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

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

Method Summary

IGeoDataset	kernelDensity(IGeoDataset sourceFeatures, Object radiusDistance, Object scaleFactor) Calculates the kernel density of points or lines in a radius around each output cell.
IGeoDataset	lineDensity(IGeoDataset lineFeatures, Object radiusDistance, Object scaleFactor) Calculates the simple density of lines in a radius around each output cell.
IGeoDataset	pointDensity(IGeoDataset pointFeatures, IRasterNeighborhood nbrhood, Object scaleFactor) Calculates the simple density of points in a neighborhood around each output cell.

Method Detail

pointDensity

IGeoDataset pointDensity(IGeoDataset pointFeatures,
                         IRasterNeighborhood nbrhood,
                         Object scaleFactor)
                         throws IOException,
                                AutomationException

Calculates the simple density of points in a neighborhood around each output cell. Density is measured as number of points per unit area.

Remarks

sourceFeatures	Input point or polyline featureclass, featureclass descriptor or featureDataset used to calculates the density of features around each output cell. For density functions, SPOT is the default field used when no field has been specified. If a SPOT field does not exist, then no field will be used, and each feature will be counted only once in the calculation. This is similar to specifying a keyword for the field of "NONE". If a field other than NONE is used, the field's value (the item value) determines the number of times to count the point. To specify the field you want form your dataset, use the FeatureClassDescriptor object.
nbrhood	An IRasterNeighborhood defining the configuration of the neighborhoods within which the point desnity will be calculated. IDensityOp:PointDensity supports any supports any neighborhood supported by IRasterNeighborhood. They include a rectangle, circle, annulus, wedge, and an irregular shaped neighborhood. The neighborhood will be defined by the minimum-bounding rectangle of the specified neighborhood. The minimum-bounding rectangle will include more cells then the specified neighborhood in certain cases such as with a circle, annulus, and wedge. The neighborhoods types are: SetAnnulus (innerRadius As Double, outerRadius As Double, unitsType as esriGeoAnalysisUnitsEnum) SetCircle (radius As Double, unitsType as esriGeoAnalysisUnitsEnum) SetDefault () SetIrregular (height As Long, width As Long, entryValues)
[scaleFactor]	Used to convert the map units of the input dataset to different units. The default value is 1, which calculates density in units of number of points per one square map unit. Effectively, output raster values are multiplied by the square of this factor.

• The method returns a reference to a Raster object.
• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pointFeatures - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

nbrhood - A reference to a com.esri.arcgis.geoanalyst.IRasterNeighborhood (in)

scaleFactor - A Variant (in, optional, pass null if not required)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

lineDensity

IGeoDataset lineDensity(IGeoDataset lineFeatures,
                        Object radiusDistance,
                        Object scaleFactor)
                        throws IOException,
                               AutomationException

Calculates the simple density of lines in a radius around each output cell. Density is measured as length of lines per unit area.

Remarks

lineFeatures	Input polyline featureclass, featureclass descriptor or featureDataset used to calculate the density of lines features around each output cell. For density functions, SPOT is the default field used when no field has been specified. If a SPOT field does not exist, then no field will be used, and each feature will be counted only once in the calculation. This is similar to specifying a keyword for the field of "NONE". If a field other than NONE is used, the length of the line is considered to be its actual length times the value of the field for that line. To specify the field use the FeatureClassDescriptor object.
[radiusDistance]	A circular neighborhood with the given radius. The default radius is calculated so that all cells in the output grid have at least one point within the neighborhood.
[scaleFactor]	Used to convert the map units of the input dataset to different units. The default value is 1, which calculates density in units of number of points per one square map unit. Effectively, output raster values are multiplied by the square of this factor.

• The method returns a reference to a Raster object.
• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

lineFeatures - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

radiusDistance - A Variant (in, optional, pass null if not required)

scaleFactor - A Variant (in, optional, pass null if not required)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

kernelDensity

IGeoDataset kernelDensity(IGeoDataset sourceFeatures,
                          Object radiusDistance,
                          Object scaleFactor)
                          throws IOException,
                                 AutomationException

Calculates the kernel density of points or lines in a radius around each output cell. A kernel function is used to distribute density values around each point or line.

Remarks

pointFeatures	Input point featureclass, featureclass descriptor or featureDataset used to calculate the density of point features around each output cell. For density functions, SPOT is the default field used when no field has been specified. If a SPOT field does not exist, then no field will be used, and each feature will be counted only once in the calculation. This is similar to specifying a keyword for the field of "NONE". If a field other than NONE is used, the field's value (the item value) determines the number of times to count the point. To specify the field use the FeatureClassDescriptor object.
[radiusDistance]	A circular neighborhood with the given radius. The default radius is calculated so that all cells in the output grid have at least one point within the neighborhood.
[scaleFactor]	Used to convert the map units of the input dataset to different units. The default value is 1, which calculates density in units of number of points per one square map unit. Effectively, output raster values are multiplied by the square of this factor.

• The method returns a reference to a Raster object.
• Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

sourceFeatures - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)

radiusDistance - A Variant (in, optional, pass null if not required)

scaleFactor - A Variant (in, optional, pass null if not required)

Returns:

A reference to a com.esri.arcgis.geodatabase.IGeoDataset

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.