Analyze

Compute min, max, average, sum, RMS, and median from values.

What it does

Analyze reports statistics for whatever arrives on Source: minimum, maximum, average, sum, RMS, median and standard deviation. Images and Volumes also report where the brightest and darkest values sit. Points and geometry report centroid (average position) and count.

Channel Mode sets how colour is measured on image and Volume input. Luminance collapses RGB to one brightness value per Rec.709. Per Channel keeps red, green and blue as separate figures.

When to use it

ParameterTypeDefault
sourceAny
channel_modeString"Luminance"

Gotchas

Not every output is meaningful for every input. Min Index and Max Index apply to a list of numbers, Min Position and Max Position to images and Volumes, Centroid to points and geometry. An output that does not apply to the connected input carries no useful value.

Analyze reports values. For dimensions, type and bounds, use Info.

Channel Mode affects image and Volume analysis only. It has no effect on a plain list of numbers.

Worked example

  1. Add an Analyze node and wire an image into Source.

  2. Leave Channel Mode on Luminance for a single brightness figure, or switch to Per Channel for separate R/G/B statistics.

  3. Read Average for the image's overall brightness, or Max Position for the brightest pixel's location.

  4. Wire Average into a Compare or Range node to drive an effect from the image's content.

See also

Info · Range · Math · Numbers, signals & audio