## octcps

Convert frequency (Hz) to linear octaves.

### Synopsis

linoct = **octcps**(*freq*)

### Description

**octcps** returns a corresponding linear octave value for a given
frequency value (Hz). Linear octaves are similar to octave.pitch-class
(oct.pc) notation in that 8.00 is middle C, 9.00 is the C an octave
above, etc. The difference is that the fractional part of the
specification represents a direct mapping onto the notes of the scale
between octaves. For example, in oct.pc notation the value 8.06
represents F-sharp (the tritone, 1/2 the chromatic scale between 8.00
and 9.00). This would be represented as 8.5 in linear octaves.

NOTE: With the exception of boost, The RTcmix conversion
functions follow a pattern. The command isdivided into two halves, the
one closest to the argument represent the format of the argument, and
the one closest to the assignment represents the format to be returned.
For example, “cpspch” is divided into “cps” and “pch”. The argument is
in oct.pc form (“pch”) and the return value will be in cps (“cps”).

The various format specifiers are:

```
amp = linear amplitude (16-bit, 0-32767)
cps = cycles per second (Hz)
db = decibels
midi = MIDI note number (60 is middle C)
oct = linear octaves (8.5 is halfway between octave 8.00 [middle C] and 9.00)
pch = octave.pitch-class (oct.pc; 8.00 is middle C, 8.02 is D, 8.12 = 9.00 = C above middle C)
let = note-letter specification ("C4" is middle C, "C#4" is C-sharp above middle C,
"Gb5" is G-flat the octave above middle C octave. [see pitch-reps for more info])
```

### Arguments

*freq*

Any number, floating point or integer, representing a direct
frequency value (Hz).

### Examples

```
loct = octcps(440.0)
loct = octcps(787.98)
```

### See Also

ampdb, boost, dbamp,
cpslet, cpsmidi, cpsoct,
cpspch, midipch, octlet,
octmidi, octpch, pchcps,
pchlet, pchmidi, pchoct