CalibraMusic

Music theory utilities for pitch and note conversions.

What is CalibraMusic?

CalibraMusic provides conversion functions between different musical pitch representations:

• Hz (Hertz): Physical frequency (e.g., 440.0 Hz)

• MIDI note numbers: Integer scale (60 = middle C, 69 = A4)

• Note labels: Human-readable (e.g., "C4", "A#5", "Bb3")

• Cents: Fine pitch deviation (100 cents = 1 semitone)

Use it when you need to:

• Display detected pitch as a note name

• Calculate pitch deviation from a target note

• Convert between different pitch units for analysis

When to Use

Quick Start

Kotlin

// Convert frequency to note name
val noteLabel = CalibraMusic.hzToNoteLabel(440f)  // "A4"

// Convert note name to frequency
val frequency = CalibraMusic.noteLabelToHz("C4")  // 261.63 Hz

// Get cents deviation from nearest note
val deviation = CalibraMusic.centsDeviation(442f)  // +7.8 cents (sharp)

// Convert between MIDI and Hz
val midi = CalibraMusic.hzToMidi(440f)  // 69.0
val hz = CalibraMusic.midiToHz(60f)     // 261.63 Hz (middle C)

Swift

// Convert frequency to note name
let noteLabel = CalibraMusic.hzToNoteLabel(440)  // "A4"

// Convert note name to frequency
let frequency = CalibraMusic.noteLabelToHz("C4")  // 261.63 Hz

// Get cents deviation from nearest note
let deviation = CalibraMusic.centsDeviation(442)  // +7.8 cents

// Convert between MIDI and Hz
let midi = CalibraMusic.hzToMidi(440)  // 69.0
let hz = CalibraMusic.midiToHz(60)      // 261.63 Hz

Pitch Reference

Common Pitfalls

1. Invalid frequencies: Functions return Float.NaN or "-" for invalid input

2. Flat notation: Use lowercase 'b' for flats (e.g., "Bb4", not "BB4")

3. Octave numbering: Middle C is C4 (scientific pitch notation)

4. Cents interpretation: Positive = sharp, negative = flat

See also