__header__

Description

The Color Distance Filter tool will create a monochrome filter (greyscale) which allows you to measure how close a color is to a trained (reference) color.

Using the Color Distance Filter

When the Color Distance Filter tool is dragged onto a sequence/playlist a small green box will appear on the viewer window. (When selected this box will turn red.) This box can be moved and resized over any area in the viewer window.
    

To train a color to use as your reference point first, drag the box over the color you wish to select.  To train the selected color, right-click the Color Distance Filter tool icon in the playlist and choose "Train".  When you select "Train" Automation Manager will take a moment and create the Color Distance Filter.  Once this process reaches 100% you can continue.

When running the Color Distance Filter tool in your program The result will be a monochrome image.  The color you selected as your reference point will appear black (or white if inverted is checked).  The more similar a color is to your reference color the lighter it will appear in the new filter.  The more dissimilar a color is to your reference color the darker it will appear.  Notice how the pink paper in the above image is now a dark grey, but the green discs are a light grey.

Distance Algorithims

IPCOLORDIFFSumAbs:
Distance from trained color as a sum of the absolute Distances;    = abs(tx - x)*m_Bias[0] +abs(ty - y)*m_Bias[1] + abs(tz - z)*m_Bias[2];

IPCOLORDIFFBlack:
Distance from Black;
   = x*m_Bias[0] + y*m_Bias[1] + z*m_Bias[2];

IPCOLORDIFFWhite:
Distance from White;
  = (3-x-y-z)*m_Bias[0] + (POS(x-tx) + POS(y-ty) + POS(z-tz))*m_Bias[1];

IPCOLORDIFFGeneric:
Sum Off Positive Component Distance from the Trained Color

IPCOLORDIFFGenericSQR:
Sum off Positive Squared Distance from the Trained Color

IPCOLORDIFFGenericSQRT:
Sum of Componet Positive Square root Distance from the Trained Color

IPCOLORDIFFDist:
default:
Euclidean distance

Note do not train if the color is passed as an input to the Train color

Inputs

CIFViewer

CIF

ROI

Parameters

Color Space

Distance Method

Invert

Smoothing

CreateOnLoad

Bias 1

Bias 2

Bias 3

UpdateViewer

RefreshViewer

CIF

TrainColor

__footer__