minarray

Returns the minimum value in a numeric array and optionally its index.

Syntax

ModernClassic

kmin [,kindx] = minarray(karray)
imin [,iindx] = minarray(iarray)

kmin [,kindx] minarray karray
imin [,iindx] minarray iarray

Performance

kmin -- variable for result.

kindx -- position (index) of result in array.

karray -- array for reading.

The array must be initialized and nonempty. The i-rate form runs once at initialization. The k-rate form reads the array on each control cycle.

The optional index is zero-based and selects the first occurrence when values tie. For a multidimensional array, it counts through all elements in storage order, with the last dimension changing fastest.

Replacing mintab

mintab is the deprecated k-rate name. Replace kValue, kIndex = mintab(kArray) with kValue, kIndex = minarray(kArray). Keep the same array and outputs. Both names use the same k-rate implementation. Only minarray offers the i-rate form.

Examples

Here is an example of the minarray opcode. It uses the file minarray.csd.

<CsoundSynthesizer>
<CsOptions>
; Select audio/midi flags here according to platform
-n 
</CsOptions>
<CsInstruments>
ksmps = 32
0dbfs = 1
;example by joachim heintz

           seed       0

instr 1
;create an array with 10 elements
kArr[]     init       10
;fill in random numbers and print them out
kIndx      =          0
  until kIndx == 10 do
kNum       random     -100, 100
kArr[kIndx] =         kNum
           printf     "kArr[%d] = %10f\n", kIndx+1, kIndx, kNum
kIndx      +=         1
  od
;investigate minimum number and print it out
kMin, kMinIndx minarray kArr
           printf     "Minimum of kArr = %f at index %d\n", kIndx+1, kMin, kMinIndx
           turnoff
endin
</CsInstruments>
<CsScore>
i1 0 0.1
e
</CsScore>
</CsoundSynthesizer>

See also

Array opcodes

Credits

Author: John ffitch
October 2011

New in Csound version 5.14

Revised in Csound version 6.00 to work on multidimensional arrays