head_music 7.0.4 → 8.0.0

data/lib/head_music/{data → instruments}/instruments.yml

@@ -458,6 +458,13 @@ cymbal:
       staff_schemes:
         default:
           - clef: neutral_clef
+didgeridoo:
+  family_key: didgeridoo
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: neutral_clef
 double_bass:
   alias_name_keys:
     - contrabass
@@ -561,6 +568,15 @@ hammered_dulcimer:
         default:
           - clef: treble_clef
   orchestra_section_key: percussion
+harmonica:
+  alias_name_keys:
+    - mouth_organ
+  family_key: harmonica
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
 harp:
   family_key: harp
   variants:
@@ -963,6 +979,13 @@ subcontrabass_saxophone:
             sounding_transposition: -38
   range_categories:
     - subcontrabass
+sitar:
+  family_key: sitar
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
 snare_drum:
   alias_name_keys:
     - side_drum
@@ -997,6 +1020,15 @@ sousaphone:
             sounding_transposition: 0
   range_categories:
     - bass
+steelpan:
+  alias_name_keys:
+    - steel_drum
+  family_key: steelpan
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
 suspended_cymbal:
   family_key: cymbal
   variants:
@@ -1005,6 +1037,8 @@ suspended_cymbal:
         default:
           - clef: neutral_clef
 synthesizer:
+  alias_name_keys:
+    - electronic_keyboard
   family_key: synthesizer
   variants:
     default:
@@ -1014,6 +1048,13 @@ synthesizer:
             name_key: right_hand
           - clef: bass_clef
             name_key: left_hand
+tabla:
+  family_key: tabla
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: neutral_clef
 tam_tam:
   alias_name_keys:
     - gong
@@ -1069,6 +1110,13 @@ tenor_voice:
             sounding_transposition: -12
   range_categories:
     - tenor
+theremin:
+  family_key: theremin
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
 timpani:
   alias_name_keys:
     - kettledrum
@@ -1148,6 +1196,74 @@ tuba:
       staff_schemes:
         default:
           - clef: bass_clef
+ukulele:
+  alias_name_keys:
+    - soprano_ukulele
+  family_key: ukulele
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
+  range_categories:
+    - soprano
+    - alto
+pocket_ukulele:
+  alias_name_keys:
+    - sopranino_ukulele
+    - piccolo_ukulele
+  family_key: ukulele
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
+  range_categories:
+    - sopranino
+    - soprano
+concert_ukulele:
+  alias_name_keys:
+    - alto_ukulele
+  family_key: ukulele
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
+  range_categories:
+    - soprano
+    - alto
+tenor_ukulele:
+  family_key: ukulele
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
+  range_categories:
+    - tenor
+baritone_ukulele:
+  family_key: ukulele
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: treble_clef
+  range_categories:
+    - alto
+    - tenor
+    - baritone
+bass_ukulele:
+  family_key: ukulele
+  variants:
+    default:
+      staff_schemes:
+        default:
+          - clef: bass_clef
+  range_categories:
+    - bass
+    - baritone
+    - tenor
 vibraphone:
   alias_name_keys:
     - vibes

data/lib/head_music/{instrument → instruments}/staff.rb

@@ -1,4 +1,7 @@
-class HeadMusic::Instrument::Staff
+# Namespace for instrument definitions, categorization, and configuration
+module HeadMusic::Instruments; end
+
+class HeadMusic::Instruments::Staff
   DEFAULT_CLEF = "treble_clef"
 
   attr_reader :staff_scheme, :attributes
@@ -9,7 +12,7 @@ class HeadMusic::Instrument::Staff
   end
 
   def clef
-    HeadMusic::Clef.get(smart_clef_key)
+    HeadMusic::Rudiment::Clef.get(smart_clef_key)
   end
 
   def smart_clef_key

data/lib/head_music/{instrument → instruments}/staff_scheme.rb

@@ -1,4 +1,9 @@
-class HeadMusic::Instrument::StaffScheme
+require_relative "staff"
+
+# Namespace for instrument definitions, categorization, and configuration
+module HeadMusic::Instruments; end
+
+class HeadMusic::Instruments::StaffScheme
   attr_reader :variant, :key, :list
 
   def initialize(variant:, key:, list:)
@@ -13,7 +18,7 @@ class HeadMusic::Instrument::StaffScheme
 
   def staves
     @staves ||= list.map do |attributes|
-      HeadMusic::Instrument::Staff.new(self, attributes)
+      HeadMusic::Instruments::Staff.new(self, attributes)
     end
   end
 end

data/lib/head_music/{instrument → instruments}/variant.rb

@@ -1,4 +1,7 @@
-class HeadMusic::Instrument::Variant
+# Namespace for instrument definitions, categorization, and configuration
+module HeadMusic::Instruments; end
+
+class HeadMusic::Instruments::Variant
   attr_reader :key, :attributes
 
   def initialize(key, attributes = {})
@@ -10,13 +13,13 @@ class HeadMusic::Instrument::Variant
     return unless attributes["pitch_designation"].to_s != ""
 
     @pitch_designation ||=
-      HeadMusic::Spelling.get(attributes["pitch_designation"])
+      HeadMusic::Rudiment::Spelling.get(attributes["pitch_designation"])
   end
 
   def staff_schemes
     @staff_schemes ||=
       (attributes["staff_schemes"] || {}).map do |key, list|
-        HeadMusic::Instrument::StaffScheme.new(
+        HeadMusic::Instruments::StaffScheme.new(
           key: key,
           variant: self,
           list: list

data/lib/head_music/locales/en.yml

@@ -86,6 +86,7 @@ en:
       mezzo_soprano_voice: mezzo-soprano
       percussion: percussion
       percussion_instrument: percussion instrument
+      pitched: pitched
       plucked: plucked
       plucked_instrument: plucked instrument
       reed: reed
@@ -95,6 +96,7 @@ en:
       stringed_instrument: stringed instrument
       strings: strings
       struck: struck
+      unpitched: unpitched
       voice: voice
       wind: wind
       wind_instrument: wind instrument
@@ -119,6 +121,7 @@ en:
       alto_flute: alto flute
       alto_recorder: alto recorder
       alto_saxophone: alto saxophone
+      alto_ukulele: alto ukulele
       alto_voice: alto
       arpeggione: arpeggione
       bagpipe: bagpipe
@@ -126,6 +129,7 @@ en:
       baritone_horn: baritone horn
       baritone_oboe: baritone oboe
       baritone_saxophone: baritone saxophone
+      baritone_ukulele: baritone ukulele
       baritone_voice: baritone
       bass: bass
       bass_clarinet: bass clarinet
@@ -137,6 +141,7 @@ en:
       bass_trombone: bass trombone
       bass_trumpet: bass trumpet
       bass_tuba: bass tuba
+      bass_ukulele: bass ukulele
       bass_voice: bass
       basset_horn: basset horn
       basset_recorder: basset recorder
@@ -154,6 +159,7 @@ en:
       clavichord: clavichord
       concert_bells: concert bells
       concert_cymbals: concert cymbals
+      concert_ukulele: concert ukulele
       contra_great_bass_recorder: contra-great bass recorder
       contrabass: contrabass
       contrabass_clarinet: contrabass clarinet
@@ -171,8 +177,10 @@ en:
       crotales: crotales
       cymbal: cymbal
       descant: descant
+      didgeridoo: didgeridoo
       double_bass: double bass
       double_contrabass_recorder: double-contrabass recorder
+      electronic_keyboard: electronic keyboard
       english_horn: English horn
       euphonium: euphonium
       fiddle: fiddle
@@ -188,6 +196,7 @@ en:
       great_highland_bagpipe: great highland bagpipe
       guitar: guitar
       hammered_dulcimer: hammered dulcimer
+      harmonica: harmonica
       harp: harp
       harpsichord: harpsichord
       hautbois_d_amour: hautbois d'amour
@@ -204,6 +213,7 @@ en:
       mezzo_soprano: mezzo-soprano
       mezzo_soprano_voice: mezzo-soprano
       military_drum: military drum
+      mouth_organ: mouth_organ
       natural_horn: natural horn
       oboe: oboe
       oboe_d_amore: oboe d'amore
@@ -219,25 +229,33 @@ en:
       piccolo_recorder: piccolo recorder
       piccolo_saxophone: piccolo saxophone
       piccolo_trumpet: piccolo trumpet
+      piccolo_ukulele: piccolo ukulele
       pipe_organ: pipe organ
+      pocket_trumpet: pocket trumpet
+      pocket_ukulele: pocket ukulele
       quart_bass_recorder: quart bass recorder
       recorder: recorder
       ride_cymbal: ride cymbal
       saxophone: saxophone
       side_drum: side drum
+      sitar: sitar
       snare_drum: snare drum
       sopranino_clarinet: sopranino clarinet
       sopranino_recorder: sopranino recorder
       sopranino_saxophone: sopranino saxophone
+      sopranino_ukulele: sopranino ukulele
       sopranissimo_recorder: sopranissimo recorder
       sopranissimo_saxophone: sopranissimo saxophone
       soprano: soprano
       soprano_clarinet: soprano clarinet
       soprano_recorder: soprano recorder
       soprano_saxophone: soprano saxophone
+      soprano_ukulele: soprano ukulele
       soprano_voice: soprano
       soprillo: soprillo
       sousaphone: sousaphone
+      steelpan: steelpan
+      steel_drum: steel drum
       string_bass: string bass
       sub_bass_recorder: sub-bass recorder
       sub_contrabass_recorder: sub-contrabass recorder
@@ -245,6 +263,7 @@ en:
       subcontrabass_saxophone: subcontrabass saxophone
       suspended_cymbal: suspended cymbal
       synthesizer: synthesizer
+      tabla: tabla
       tabor: tabor
       tam_tam: tam-tam
       tambourine: tambourine
@@ -255,7 +274,9 @@ en:
       tenor_saxophone: tenor saxophone
       tenor_trombone: tenor trombone
       tenor_tuba: tenor tuba
+      tenor_ukulele: tenor ukulele
       tenor_voice: tenor
+      theremin: theremin
       timpani: timpani
       timpanum: timpanum
       tom_drum: tom drum
@@ -266,6 +287,7 @@ en:
       trumpet: trumpet
       tuba: tuba
       tubular_bells: tubular bells
+      ukulele: ukulele
       vibes: vibes
       vibraphone: vibraphone
       viola: viola

data/lib/head_music/locales/es.yml

@@ -90,7 +90,7 @@ es:
       accordion: acordeón
       alto_clarinet: clarinete alto
       alto_flute: flauta alto
-      alto_recorder: flauta de pico alto
+      alto_recorder: flauta dulce alto
       alto_saxophone: saxofón alto
       alto_voice: contralto
       arpeggione: arpeggione
@@ -105,14 +105,14 @@ es:
       bass_drum: bombo
       bass_guitar: bajo eléctrico
       bass_oboe: oboe bajo
-      bass_recorder: flauta de pico bajo
+      bass_recorder: flauta dulce bajo
       bass_saxophone: saxofón bajo
       bass_trombone: trombón bajo
       bass_trumpet: trompeta baja
       bass_tuba: tuba baja
       bass_voice: bajo
       basset_horn: clarinete bajo
-      basset_recorder: flauta de pico bajo
+      basset_recorder: flauta dulce bajo
       bassoon: fagot
       bells: campanas
       bugle: cornetín
@@ -127,10 +127,10 @@ es:
       clavichord: clavicordio
       concert_bells: carillón orquestal
       concert_cymbals: platillos de orquesta
-      contra_great_bass_recorder: contrabajaùete
+      contra_great_bass_recorder: flauta dulce contrabajo
       contrabass: contrabajo
       contrabass_clarinet: clarinete contrabajo
-      contrabass_recorder: flauta de pico contrabajo
+      contrabass_recorder: flauta dulce contrabajo
       contrabass_saxophone: saxofón contrabajo
       contrabass_tuba: tuba contrabajo
       contrabassoon: contrafagot
@@ -143,9 +143,9 @@ es:
       crash_cymbal: platillo de choque
       crotales: crótalos
       cymbal: cimbalos
-      descant: flauta de pico soprano
+      descant: flauta dulce soprano
       double_bass: contrabajo
-      double_contrabass_recorder: flauta de pico subcontrabajo
+      double_contrabass_recorder: flauta dulce subcontrabajo
       english_horn: corno inglés
       euphonium: euphonium
       fiddle: violín
@@ -154,10 +154,10 @@ es:
       flute: flauta
       fortepiano: fortepiano
       french_horn: corno
-      garklein_recorder: flauta de pico garklein
+      garklein_recorder: flauta dulce garklein
       glockenspiel: metallofono
       gong: gong
-      great_bass_recorder: flauta de pico gran bajo
+      great_bass_recorder: flauta dulce gran bajo
       great_highland_bagpipe: gaita escocesa
       guitar: guitarra
       hammered_dulcimer: salterio
@@ -180,7 +180,7 @@ es:
       natural_horn: trompa natural
       oboe: oboe
       oboe_d_amore: oboe de amor
-      octocontrabass_recorder: flauta de pico subcontrabajo
+      octocontrabass_recorder: flauta dulce subcontrabajo
       orchestral_chimes: campanas orquestales
       orchestral_cymbals: platillos orquestales
       organ: órgano
@@ -189,32 +189,32 @@ es:
       piccolo: flautín
       piccolo_clarinet: clarinete piccolo
       piccolo_flute: flauta piccolo
-      piccolo_recorder: flauta de pico piccolo
+      piccolo_recorder: flauta dulce piccolo
       piccolo_saxophone: saxofón piccolo
       piccolo_trumpet: trompeta piccolo
       pipe_organ: órgano de tubos
-      quart_bass_recorder: flauta de pico bajo cuarteto
-      recorder: flauta de pico
+      quart_bass_recorder: flauta dulce bajo cuarteto
+      recorder: flauta dulce
       ride_cymbal: platillo de conducción
       saxophone: saxofón
-      side_drum: tambor laterale
+      side_drum: tambor lateral
       snare_drum: tambor de caja
       sopranino_clarinet: clarinete sopranino
-      sopranino_recorder: flauta de pico sopranino
+      sopranino_recorder: flauta dulce sopranino
       sopranino_saxophone: saxofón sopranino
-      sopranissimo_recorder: flauta de pico sopranissimo
+      sopranissimo_recorder: flauta dulce sopranissimo
       sopranissimo_saxophone: saxofón sopranissimo
       soprano: soprano
       soprano_clarinet: clarinete soprano
-      soprano_recorder: flauta de pico soprano
+      soprano_recorder: flauta dulce soprano
       soprano_saxophone: saxofón soprano
       soprano_voice: voz de soprano
       soprillo: soprillo
       sousaphone: sousafón
       string_bass: contrabajo de cuerdas
-      sub_bass_recorder: flauta de pico subbajo
-      sub_contrabass_recorder: flauta de pico subcontrabajo
-      sub_great_bass_recorder: flauta de pico subgran bajo
+      sub_bass_recorder: flauta dulce subbajo
+      sub_contrabass_recorder: flauta dulce subcontrabajo
+      sub_great_bass_recorder: flauta dulce subgran bajo
       subcontrabass_saxophone: saxofón subcontrabajo
       suspended_cymbal: platillo suspendido
       synthesizer: sintetizador
@@ -224,7 +224,7 @@ es:
       temple_blocks: bloques de templo
       tenor: tenor
       tenor_drum: tambor tenor
-      tenor_recorder: flauta de pico tenor
+      tenor_recorder: flauta dulce tenor
       tenor_saxophone: saxofón tenor
       tenor_trombone: trombón tenor
       tenor_tuba: tuba tenor
@@ -233,7 +233,7 @@ es:
       timpanum: tímpano
       tom_drum: tom
       tom_tom: tom-tom
-      treble_recorder: flauta de pico contralto
+      treble_recorder: flauta dulce contralto
       triangle: triángulo
       trombone: trombón
       trumpet: trompeta

data/lib/head_music/{alteration.rb → rudiment/alteration.rb}

@@ -1,8 +1,11 @@
-require "head_music/musical_symbol"
+require "head_music/rudiment/musical_symbol"
 
-# A Alteration is a symbol that modifies pitch, such as a sharp, flat, or natural.
+# A module for music rudiments
+module HeadMusic::Rudiment; end
+
+# An Alteration is a symbol that modifies pitch, such as a sharp, flat, or natural.
 # In French, sharps and flats in the key signature are called "altérations".
-class HeadMusic::Alteration
+class HeadMusic::Rudiment::Alteration
   include Comparable
 
   attr_reader :identifier, :cents, :musical_symbols
@@ -51,7 +54,7 @@ class HeadMusic::Alteration
   end
 
   def self.get(identifier)
-    return identifier if identifier.is_a?(HeadMusic::Alteration)
+    return identifier if identifier.is_a?(HeadMusic::Rudiment::Alteration)
 
     all.detect do |alteration|
       alteration.representions.include?(identifier)
@@ -86,7 +89,7 @@ class HeadMusic::Alteration
   end
 
   def <=>(other)
-    other = HeadMusic::Alteration.get(other)
+    other = HeadMusic::Rudiment::Alteration.get(other)
     cents <=> other.cents
   end
 
@@ -104,7 +107,7 @@ class HeadMusic::Alteration
 
   def initialize_musical_symbols(list)
     @musical_symbols = (list || []).map do |record|
-      HeadMusic::MusicalSymbol.new(
+      HeadMusic::Rudiment::MusicalSymbol.new(
         unicode: record[:unicode],
         ascii: record[:ascii],
         html_entity: record[:html_entity]

data/lib/head_music/{chromatic_interval.rb → rudiment/chromatic_interval.rb}

@@ -1,5 +1,8 @@
+# A module for music rudiments
+module HeadMusic::Rudiment; end
+
 # A chromatic interval is the distance between two pitches measured in half-steps.
-class HeadMusic::ChromaticInterval
+class HeadMusic::Rudiment::ChromaticInterval
   include Comparable
   include HeadMusic::Named
 
@@ -37,7 +40,7 @@ class HeadMusic::ChromaticInterval
   end
 
   def simple
-    HeadMusic::ChromaticInterval.get(semitones % 12)
+    HeadMusic::Rudiment::ChromaticInterval.get(semitones % 12)
   end
 
   def simple?
@@ -60,11 +63,11 @@ class HeadMusic::ChromaticInterval
   alias_method :specific_interval, :semitones
 
   def +(other)
-    HeadMusic::ChromaticInterval.get(to_i + other.to_i)
+    HeadMusic::Rudiment::ChromaticInterval.get(to_i + other.to_i)
   end
 
   def -(other)
-    HeadMusic::ChromaticInterval.get((to_i - other.to_i).abs)
+    HeadMusic::Rudiment::ChromaticInterval.get((to_i - other.to_i).abs)
   end
 
   def <=>(other)

data/lib/head_music/{circle.rb → rudiment/circle.rb}

@@ -1,7 +1,10 @@
-require "head_music/interval_cycle"
+require "head_music/rudiment/interval_cycle"
+
+# A module for music rudiments
+module HeadMusic::Rudiment; end
 
 # A Circle of Fifths or Fourths shows relationships between pitch classes
-class HeadMusic::Circle < HeadMusic::IntervalCycle
+class HeadMusic::Rudiment::Circle < HeadMusic::Rudiment::IntervalCycle
   def self.of_fifths
     get(:perfect_fifth)
   end
@@ -12,20 +15,20 @@ class HeadMusic::Circle < HeadMusic::IntervalCycle
 
   def self.get(interval = :perfect_fifth)
     @circles ||= {}
-    diatonic_interval = HeadMusic::DiatonicInterval.get(interval)
+    diatonic_interval = HeadMusic::Analysis::DiatonicInterval.get(interval)
     @circles[interval] ||= new(interval: diatonic_interval, starting_pitch: "C4")
   end
 
   def index(pitch_class)
-    pitch_classes.index(HeadMusic::Spelling.get(pitch_class).pitch_class)
+    pitch_classes.index(HeadMusic::Rudiment::Spelling.get(pitch_class).pitch_class)
   end
 
   def key_signatures_up
-    spellings_up.map { |spelling| HeadMusic::KeySignature.new(spelling) }
+    spellings_up.map { |spelling| HeadMusic::Rudiment::KeySignature.new(spelling) }
   end
 
   def key_signatures_down
-    spellings_down.map { |spelling| HeadMusic::KeySignature.new(spelling) }
+    spellings_down.map { |spelling| HeadMusic::Rudiment::KeySignature.new(spelling) }
   end
 
   def spellings_up

data/lib/head_music/{clef.rb → rudiment/clef.rb}

@@ -1,10 +1,13 @@
 require "yaml"
 
+# A module for music rudiments
+module HeadMusic::Rudiment; end
+
 # A clef assigns pitches to the lines and spaces of a staff.
-class HeadMusic::Clef
+class HeadMusic::Rudiment::Clef
   include HeadMusic::Named
 
-  RECORDS = YAML.load_file(File.expand_path("data/clefs.yml", __dir__)).freeze
+  RECORDS = YAML.load_file(File.expand_path("clefs.yml", __dir__)).freeze
 
   def self.get(name)
     get_by_name(name)
@@ -82,7 +85,7 @@ class HeadMusic::Clef
 
   def initialize_data_from_record(record)
     initialize_keys_from_record(record)
-    @pitch = HeadMusic::Pitch.get(record[:pitch])
+    @pitch = HeadMusic::Rudiment::Pitch.get(record[:pitch])
     @line = record[:line]
     @modern = record[:modern]
     initialize_musical_symbols(record[:symbols])
@@ -95,7 +98,7 @@ class HeadMusic::Clef
 
   def initialize_musical_symbols(list)
     @musical_symbols = (list || []).map do |symbol_data|
-      HeadMusic::MusicalSymbol.new(**symbol_data.slice(:ascii, :html_entity, :unicode))
+      HeadMusic::Rudiment::MusicalSymbol.new(**symbol_data.slice(:ascii, :html_entity, :unicode))
     end
   end
 end

data/lib/head_music/{consonance.rb → rudiment/consonance.rb}

@@ -1,5 +1,8 @@
+# A module for music rudiments
+module HeadMusic::Rudiment; end
+
 # Consonance describes a category or degree of harmonic pleasantness: perfect, imperfect, or dissonant
-class HeadMusic::Consonance
+class HeadMusic::Rudiment::Consonance
   LEVELS = %w[perfect imperfect dissonant].freeze
 
   def self.get(name)