HETRO

[GENERIC-FUNCTION]


om4csound
Function Reference
ARGUMENTS:
  - sound a sound  
  - outfile name of the output file [default = "ratzinger"]
&optional
 
  - sample_rate sampling rate of the audio input file. This will over-ride the srate of the soundfile header, which otherwise applies  
  - channel channel number sought. If omitted, the default is to process all channels. If a value is given, only the selected channel will be processed  
  - begin beginning time (in seconds) of the audio segment to be analyzed  
  - duration duration (in seconds) of the audio segment to be analyzed  
  - begfreq estimated starting frequency of the fundamental, necessary to initialize the filter analysis. The default is 100 (cps)  
  - partials number of harmonic partials sought in the audio file. Default is 10, maximum is a function of memory available  
  - maxamp maximum amplitude summed across all concurrent tracks. The default is 32767  
  - minamp amplitude threshold below which a single pair of amplitude/frequency tracks is considered dormant and will not contribute to output summation. Typical values: 128 (48 db down from full scale), 64 (54 db down), 32 (60 db down), 0 (no thresholding). The default threshold is 64 (54 db down)  
  - brkpts initial number of analysis breakpoints in each amplitude and frequency track, prior to thresholding (-m) and linear breakpoint consolidation. The initial points are spread evenly over the duration. The default is 256  
  - cutfreq substitute a 3rd order Butterworth low-pass filter with cutoff frequency cutfreq (in Hz), in place of the default averaging comb filter. The default is 0 (don't use)  

Description:

hetro takes an input soundfile, decomposes it into component sinusoids, and outputs a description of the components in the form of breakpoint amplitude and frequency tracks. Analysis is conditioned by the control flags below. A space is optional between flag and value



Auto doc generation by OpenMusic 7.0 © 2022 IRCAM