head_music 8.2.1 → 8.3.0

data/lib/head_music.rb

@@ -56,6 +56,9 @@ require "head_music/rudiment/scale_type"
 require "head_music/rudiment/solmization"
 require "head_music/rudiment/spelling"
 require "head_music/rudiment/tuning"
+require "head_music/rudiment/tuning/just_intonation"
+require "head_music/rudiment/tuning/pythagorean"
+require "head_music/rudiment/tuning/meantone"
 
 # instruments
 require "head_music/instruments/instrument_family"

data/user_stories/backlog/band-score-order.md

@@ -0,0 +1,38 @@
+# Band Score Order
+
+As a band director or arranger
+
+I want to organize instruments in band score order
+
+So that my scores follow standard concert band conventions
+
+## Scenario: Display instruments in band order
+
+Given I have a composition for concert band
+
+When I request the score order for a band arrangement
+
+Then the instruments should be ordered as follows:
+  - Flutes
+  - Oboes
+  - Bassoons
+  - Clarinets
+  - Saxophones
+  - Cornets
+  - Trumpets
+  - Horns
+  - Trombones
+  - Euphoniums
+  - Tubas
+  - Timpani
+  - Percussion
+
+## Scenario: Recognize different percussion placement
+
+Given I am working with both orchestral and band scores
+
+When I compare the score orders
+
+Then I should note that percussion placement differs:
+  - In orchestral scores: percussion appears after brass
+  - In band scores: percussion appears at the bottom

data/user_stories/backlog/chamber-ensemble-score-order.md

@@ -0,0 +1,33 @@
+# Chamber Ensemble Score Order
+
+As a chamber music composer
+
+I want to organize instruments in standard chamber ensemble orders
+
+So that my scores follow established conventions for small ensembles
+
+## Scenario: Display brass quintet in standard order
+
+Given I have a brass quintet composition
+
+When I request the score order
+
+Then the instruments should be ordered as follows:
+  - Trumpet I
+  - Trumpet II
+  - Horn
+  - Trombone
+  - Tuba
+
+## Scenario: Display woodwind quintet in standard order
+
+Given I have a woodwind quintet composition
+
+When I request the score order
+
+Then the instruments should be ordered as follows:
+  - Flute
+  - Oboe
+  - Clarinet
+  - Horn
+  - Bassoon

data/user_stories/backlog/consonance-dissonance-classification.md

@@ -0,0 +1,57 @@
+# Consonance and Dissonance Classification
+
+As a music theorist or counterpoint student
+
+I want to classify intervals by their consonance and dissonance levels
+
+So that I can apply proper voice leading rules
+
+## Scenario: Classify open consonances
+
+Given I have a perfect fifth or perfect octave
+
+When I check the consonance classification
+
+Then it should be identified as "open consonance"
+
+## Scenario: Classify soft consonances
+
+Given I have a third or sixth interval (major or minor)
+
+When I check the consonance classification
+
+Then it should be identified as "soft consonance"
+
+## Scenario: Classify mild dissonances
+
+Given I have a major second or minor seventh
+
+When I check the consonance classification
+
+Then it should be identified as "mild dissonance"
+
+## Scenario: Classify sharp dissonances
+
+Given I have a minor second or major seventh
+
+When I check the consonance classification
+
+Then it should be identified as "sharp dissonance"
+
+## Scenario: Handle perfect fourth context
+
+Given I have a perfect fourth interval
+
+When I check the consonance classification
+
+Then it should indicate context-dependent classification
+
+And note it can be either consonant or dissonant
+
+## Scenario: Classify tritone
+
+Given I have a tritone interval
+
+When I check the consonance classification
+
+Then it should be identified as "neutral" or "restless"

data/user_stories/backlog/dyad-analysis.md

@@ -0,0 +1,65 @@
+# Dyad Analysis
+
+As a music analyst or counterpoint student
+
+I want to analyze two-note combinations (dyads)
+
+So that I can understand harmonic implications in two-part music
+
+## Scenario: Identify interval in dyad
+
+Given I have two pitches forming a dyad
+
+When I access the interval property
+
+Then I should receive the correct interval between the pitches
+
+## Scenario: Find implied triads from thirds
+
+Given I have a dyad that forms a third
+
+When I request the implied triad
+
+Then I should receive the most likely triad containing those pitches
+
+And it should consider the musical context
+
+## Scenario: List possible triads from fifth
+
+Given I have a dyad forming a perfect fifth
+
+When I request possible triads
+
+Then I should receive both major and minor triad options
+
+And each should contain the given pitches
+
+## Scenario: List possible triads from third
+
+Given I have a dyad forming a minor third
+
+When I request possible triads
+
+Then I should receive minor and diminished triad options
+
+And for a major third I should receive major and augmented options
+
+## Scenario: Find possible seventh chords
+
+Given I have a dyad
+
+When I request possible seventh chords
+
+Then I should receive all seventh chords containing those pitches
+
+And they should include appropriate inversions
+
+## Scenario: Handle enharmonic possibilities
+
+Given I have a dyad with enharmonic possibilities
+
+When I request possible enharmonic chords
+
+Then I should receive chords based on enharmonic respellings
+
+And each should be correctly identified

data/user_stories/backlog/orchestral-score-order.md

@@ -0,0 +1,43 @@
+# Orchestral Score Order
+
+As a composer or conductor
+
+I want to organize instruments in orchestral score order
+
+So that my scores follow standard orchestral conventions
+
+## Scenario: Display instruments in orchestral order
+
+Given I have a composition with multiple instruments
+
+When I request the score order for an orchestral arrangement
+
+Then the instruments should be ordered as follows:
+  - Woodwinds (flutes, oboes, clarinets, bassoons)
+  - Brass (horns, trumpets, trombones, tuba)
+  - Percussion (timpani, percussion)
+  - Harp and keyboards
+  - Soloists (instrumental or vocal)
+  - Voices
+  - Strings (violins I, violins II, viola, violoncellos, double bass)
+
+## Scenario: Use standard orchestral abbreviations
+
+Given I am creating an orchestral score
+
+When I display instrument names
+
+Then I should see standard abbreviations:
+  - Fl or Fls for Flutes
+  - Ob or Obs for Oboes
+  - Cl or Cls for Clarinets
+  - Bsn or Bsns for Bassoons
+  - Hn or Hns for Horns
+  - Tpt or Tpts for Trumpets
+  - Trb or Trbs for Trombones
+  - Timp for Timpani
+  - Perc for Percussion
+  - Vlns for Violins
+  - Vla for Viola
+  - Vcl for Violoncellos
+  - DB for Double Bass

data/user_stories/backlog/pitch-class-set-analysis.md

@@ -0,0 +1,39 @@
+# Pitch Class Set Analysis
+
+As a music theorist studying atonal music
+
+I want to analyze pitch class sets
+
+So that I can identify set relationships and transformations
+
+## Scenario: Find normal form
+
+Given I have a pitch class set
+
+When I request the normal form
+
+Then I should receive the most compact rotation
+
+And it should minimize the interval span
+
+## Scenario: Find prime form
+
+Given I have a pitch class set
+
+When I request the prime form
+
+Then I should receive the most compact form
+
+And it should consider both the original and all inversions
+
+And it should be the optimal normal form among all possibilities
+
+## Scenario: Compare equivalent sets
+
+Given I have two different pitch class sets
+
+When I compare their prime forms
+
+Then I can determine if they are equivalent
+
+And identify the transformation relationship between them

data/user_stories/backlog/pitch-set-classification.md

@@ -0,0 +1,62 @@
+# Pitch Set Classification
+
+As a music theorist
+
+I want to classify pitch sets by their size and properties
+
+So that I can analyze and categorize harmonic structures
+
+## Scenario: Identify empty set
+
+Given I have no pitches
+
+When I create a pitch set
+
+Then it should be identified as an EmptySet
+
+## Scenario: Identify monad
+
+Given I have a single pitch
+
+When I check the pitch set type
+
+Then it should be identified as a Monad
+
+And monad? should return true
+
+## Scenario: Identify dyad
+
+Given I have exactly two pitches
+
+When I check the pitch set type
+
+Then it should be identified as a Dyad
+
+And dyad? should return true
+
+## Scenario: Distinguish triads from trichords
+
+Given I have three pitches
+
+When I analyze the pitch set
+
+Then trichord? should return true for any 3-pitch set
+
+And triad? should return true only if they form stacked thirds
+
+## Scenario: Identify larger pitch sets
+
+Given I have a pitch set with N pitches
+
+When I check the classification
+
+Then it should be identified as:
+  - Tetrachord (4 pitches) with seventh_chord? check
+  - Pentachord (5 pitches)
+  - Hexachord (6 pitches)
+  - Heptachord (7 pitches)
+  - Octachord (8 pitches)
+  - Nonachord (9 pitches)
+  - Decachord (10 pitches)
+  - Undecachord (11 pitches)
+  - Dodecachord (12 pitches)

data/user_stories/backlog/sonority-identification.md

@@ -0,0 +1,47 @@
+# Sonority Identification
+
+As a music theorist or composer
+
+I want to identify and work with named sonorities
+
+So that I can analyze and create harmonic structures
+
+## Scenario: Get sonority by identifier
+
+Given I need a specific sonority
+
+When I call Sonority.get with an identifier like "major triad"
+
+Then I should receive the corresponding sonority object
+
+And it should contain the correct interval structure
+
+## Scenario: Identify sonority from pitch set
+
+Given I have a set of pitches
+
+When I call Sonority.for with the pitch set
+
+Then I should receive the identified sonority
+
+And it should correctly name the harmonic structure
+
+## Scenario: Generate pitch set from sonority
+
+Given I have a sonority and a root pitch
+
+When I call Sonority.pitch_set_for with root pitch and inversion
+
+Then I should receive the correct pitches
+
+And they should be in the specified inversion
+
+## Scenario: Access sonority from pitch set
+
+Given I have a PitchSet object
+
+When I call the sonority method
+
+Then I should receive the corresponding Sonority object
+
+And it should correctly identify the harmonic content

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: head_music
 version: !ruby/object:Gem::Version
-  version: 8.2.1
+  version: 8.3.0
 platform: ruby
 authors:
 - Rob Head
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-21 00:00:00.000000000 Z
+date: 2025-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -144,6 +144,7 @@ files:
 - ".ruby-version"
 - ".yardopts"
 - CHANGELOG.md
+- CLAUDE.md
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - Gemfile
@@ -152,8 +153,10 @@ files:
 - README.md
 - Rakefile
 - TODO.md
+- bin/check_instrument_consistency.rb
 - bin/console
 - bin/setup
+- check_instrument_consistency.rb
 - head_music.gemspec
 - lib/head_music.rb
 - lib/head_music/analysis/circle.rb
@@ -219,6 +222,9 @@ files:
 - lib/head_music/rudiment/solmizations.yml
 - lib/head_music/rudiment/spelling.rb
 - lib/head_music/rudiment/tuning.rb
+- lib/head_music/rudiment/tuning/just_intonation.rb
+- lib/head_music/rudiment/tuning/meantone.rb
+- lib/head_music/rudiment/tuning/pythagorean.rb
 - lib/head_music/style/analysis.rb
 - lib/head_music/style/annotation.rb
 - lib/head_music/style/guidelines/always_move.rb
@@ -262,6 +268,14 @@ files:
 - lib/head_music/utilities/hash_key.rb
 - lib/head_music/version.rb
 - test_translations.rb
+- user_stories/backlog/band-score-order.md
+- user_stories/backlog/chamber-ensemble-score-order.md
+- user_stories/backlog/consonance-dissonance-classification.md
+- user_stories/backlog/dyad-analysis.md
+- user_stories/backlog/orchestral-score-order.md
+- user_stories/backlog/pitch-class-set-analysis.md
+- user_stories/backlog/pitch-set-classification.md
+- user_stories/backlog/sonority-identification.md
 homepage: https://github.com/roberthead/head_music
 licenses:
 - MIT