Analyze CHOP

From TouchDesigner 099 Wiki

Summary

The Analyze CHOP looks at the values of all the values of a channel, and outputs a single-number result into the output. The output is one sample long. It can analyze for maximum, average, peaks and other aspects of a channel.

PythonIcon.png analyzeCHOP_Class

Parameters - Analyze Page

Function - This menu determines the function applied to the channel.

  • Average - the average of the channel.
  • Maximum - the maximum value of the channel.
  • Minimum - the minimum value of the channel.
  • Sum - the sum of all the samples in the channel.
  • RMS Power - the RMS (root-mean-square) of the channel.
  • First Peak Value - the value of the first peak in the channel.
  • First Peak Index - the index of the first peak in the channel. The index of the first sample is 0.
  • Highest Peak Value - the value of the highest peak in the channel.
  • Highest Peak Index - the index of the highest peak in the channel. If multiple samples have the same highest peak value, it returns the index of the last peak sample.
  • Lowest Peak Value - the value of the lowest peak in the channel.
  • Lowest Peak Index - the index of the lowest peak in the channel. If multiple samples have the same lowest peak value, it returns the index of the last peak sample.
  • Total Peaks - the total number of peaks in the channel.

Allow Start Peaks - If the values of the first 2 samples are v0 and v1, if v0 > v1, count it as a peak. The default is to never count the first sample as a peak.

Allow End Peaks - If the values of the last 2 samples are vn and vm, if vm > vn, count it as a peak. The default is to never count the last sample as a peak.

No Peak Value - When no peaks are found, make this number (default is -1) the result that is output. When the Function is set to Peak Index or Peak Value, it is a way to detect that no peaks were found.

Analyze Valleys vs Peaks - Analyze instead for the First Valley, Highest Valley, and Lowest Valley, when the corresponding Function menu options are chosen.

Parameters - Common Page

Notes

http://www.aqdi.com/rms.htm

Is this text:

"This is where RMS comes in to play. Skipping the potentially brain damaging
math, it turns out that the RMS or effective value of a sine wave is 0.707 times the peak value. (1/0.707 is the square root of two; that is, 1/0.707 times 1/0.707 equals 2.) "

Which is exactly what sending a default Wave CHOP into the Analyze CHOP gives when you select "RMS Power". Yahoo!