lorisinfo

lorisinfo — Compute k-rate and i-rate information about a Loris analysis.

Syntax

kfundamental, kfundaParNum, itotalPar, kmaxAmp, kmaxNoise  lorisinfo isrcidx

Description

Computes several statistics for each analysis frame of isrcidx

Initialization

isrcidx is an integer label that identifies the stored set of SDIF partials that are used. Use lorisread to import partials from an SDIF file, store them in memory and assign a label.

Performance

kfundamental is an estimate of the fundamental frequency in the current frame of isrcidx. Presently the algorithm is too simple — the highest energy partial unless there is partial an octave or an octave and a half below within -20 dB. This will change in the next release, probably using Miller Puckette's sigmund~ code from pure data.

kfundaParNum is the integer partial label (which is assigned by loris during analysis) of the estimated fundamental in the current frame of isrcidx. This is very useful to know for refering to other harmonic partials by label (not frequency) and is probably most applicable to single-note analyses.

itotalPar is the total number of partials in isrcidx (starting from 1, not 0). Per Loris, each analysis frame has the same number of partials, though some may be 0 Hz.

kmaxAmp is the largest amplitude coefficient found in the current frame of isrcidx.

kmaxNoise is the largest noise coefficient found in the current frame of isrcidx.

Credits

The Loris unit generators were written by Kelly Fitz (loris@cerlsoundgroup.org). It is patterned after a prototype implementation of the lorisplay unit generator written by Corbin Champion, and based on the method of Bandwidth-Enhanced Additive Synthesis and on the sound morphing algorithms implemented in the Loris library for sound modeling and manipulation. The opcodes were further adapted as a plugin for Csound 5 by Michael Gogins. Ben Hackbarth (hackbarth@ucsd.edu) wrote the Extended Loris Opcodes.