Open topic with navigation

# Color Clustering

Color Clustering determines the dominant colors in an image or video frame by clustering similar colors. The task returns the color at the center of each cluster, and the proportion of the pixels that belong to each cluster. If you configure a color dictionary, the task clusters colors around the colors that are defined in the dictionary, and returns a name (such as "light blue" or "red") for each cluster.

This section describes the parameters that you can use to configure color clustering.

Configuration Parameter | Description
--- | ---
ColorDictionary | The path to a dictionary file that associates names with RGB color values.
ColorSpace | The color space in which the results of analysis are provided.
ColorThreshold | Discards colors that do not make up a significant proportion of the frame.
CombineNamedColors | A Boolean value that specifies whether to combine clusters that have the same color name.
FrameRate | (Deprecated) The number of frames to analyze per second of video.
Input | The image track to process.
Region | Specifies a region of the frame to process, instead of the entire frame.
RegionUnit | Specifies the units used by the `Region` parameter.
RestrictToInputRegion | Specifies whether to analyze a region of the input image or video frame that is specified in the input record, instead of the entire image.
SampleInterval | The interval at which frames are selected to be analyzed, in milliseconds.
Type | The analysis engine to use. Set this parameter to `ColorCluster`.

## Output Tracks

Output track | Type | Description | Output1This column indicates whether the information contained in the track is included by default in the output created by an output task (when you don't set the Input parameter for the output task).
--- | --- | --- | ---
ClusteredImage | ColorClusterImage | Contains the source image, containing only colors that match the center of a color cluster, and cropped to the analyzed region. If the analyzed region is not rectangular any pixels outside the region are transparent (or black if you use an image format that does not support transparency). | False
Result | ColorClusterResult | Contains a record for each analyzed frame. Each record contains information about the colors that are present in the image. | True

ColorClusterResult

Field name | Type | Description
--- | --- | ---
id | UUIDData | A universally unique identifier to identify the analyzed image or video frame.
colorspace | String | The color space in which the results are presented.
cluster | An array of ColorClusters | Information about the colors in the analyzed frame.

ColorCluster

Field name | Type | Description
--- | --- | ---
Color | String | The color at the center of a cluster.
Colorname | String | Only present if you set the parameter ColorDictionary. Provides the name of the color from the dictionary.
Proportion | Float | The proportion of pixels in the frame that belong to the cluster.

ColorClusterImage

Field name | Type | Description
--- | --- | ---
id | UUIDData | A universally unique identifier to identify the analyzed image or video frame.
image | ImageData | The source image, containing only colors that match the center of a color cluster, and cropped to the analyzed region. If the analyzed region is not rectangular any pixels outside the region are transparent (or black if you use an image format that does not support transparency).

© 2017 Hewlett Packard Enterprise Development LP | Send documentation feedback to HPE Close Send documentation feedback To open the configured email client on this computer, open an email window. Otherwise, copy the information below to a web mail client, and send this email to AutonomyTPFeedback@hpe.com. We appreciate your feedback! Product: Topic Title: Help Topic: Feedback:

_HP_HTML5_bannerTitle.htm