Available with Spatial Analyst license.
Summary
Compute a set of attributes associated with your segmented image. The input raster can be a single-band or 3-band, 8-bit segmented image.
Usage
-
This tool generates the attributes for each segment that exists in the image. Attributes include mean, standard deviation, segment size, converged color (from the Segment Mean Shift tool), and compactness.
This parameter is only enabled if the Segmented key property is set to true on the input raster. If the only input into the tool is a segmented image, the default attributes are COLOR, COUNT, COMPACTNESS, and RECTANGULARITY. If an Additional Input Raster is also included as an input along with a segmented image, then MEAN and STD are available as options.
See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.
Syntax
ComputeSegmentAttributes (in_segmented_raster, {in_additional_raster}, {used_attributes})
Parameter | Explanation | Data Type |
in_segmented_raster | The input segmented raster dataset, where all the pixels belonging to a segment have the same converged RGB color. Usually, it is an 8-bit, 3-band RGB raster, but it can also be a 1-band grayscale raster. Once the tool completes, the key property is set to Segmented. | Segmented Raster | Raster dataset | Mosaic Dataset | Raster Layer | Mosaic Layer | Image Service Layer |
in_additional_raster (Optional) | Optionally incorporate ancillary raster datasets, such as a segmented image, a multispectral image, or a DEM, to generate attributes and other required information for the classifier. The raster datasets for this parameter must match those used to create the training .ecd file. | Segmented Raster | Raster Dataset | Mosaic Dataset | Raster Layer | Mosaic Layer | Image Service Layer |
used_attributes [used_attributes,...] (Optional) | Specify the attributes to be included in the attribute table associated with the output raster. This parameter is only enabled if the SEGMENTED key property is set to true on the input raster. If the only input into the tool is a segmented image, the default attributes are COLOR, COUNT, COMPACTNESS, and RECTANGULARITY. If an in_additional_raster is also included as an input along with a segmented image, then MEAN and STD are available as options.
| String |
Return Value
Name | Explanation | Data Type |
out_index_raster_dataset | The output segment index raster, where the attributes for each segment are recorded in the associated attribute table. | Raster |
Code Sample
ComputeSegmentAttributes example 1 (Python window)
This example computes segment attributes for a TIFF raster.
import arcpy
from arcpy.sa import *
compute_att = ComputeSegmentAttributes(
"c:/test/moncton_seg.tif", "c:/test/moncton.tif",
"COLOR;MEAN;STD;COUNT;COMPACTNESS;RECTANGULARITY")
compute_att.save("c:/test/moncton_computeseg.tif")
ComputeSegmentAttributes example 2 (stand-alone script)
This example computes segment attributes for a TIFF raster.
# Import system modules
import arcpy
from arcpy.sa import *
# Set local variables
inSegRaster = "c:/test/moncton_seg.tif"
in_additional_raster = "c:/test/moncton.tif"
attributes = "COLOR;MEAN;STD;COUNT;COMPACTNESS;RECTANGULARITY"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute
compute_att = ComputeSegmentAttributes(inSegRaster, in_additional_raster,
attributes)
#save output
compute_att.save("c:/test/moncton_computeseg.tif")
Environments
Licensing Information
- ArcGIS for Desktop Basic: Requires Spatial Analyst
- ArcGIS for Desktop Standard: Requires Spatial Analyst
- ArcGIS for Desktop Advanced: Requires Spatial Analyst