Class HarmonicColorAnalyzer

Namespace

Celeritas.Core.Analysis

Assembly

Celeritas.dll

Detects harmonic color features: chromatic notes, modal turns (mixture / modal borrowing), and simple melodic harmony (chord tones vs common non-chord tones).

public static class HarmonicColorAnalyzer

Inheritance

object

HarmonicColorAnalyzer

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Methods

Analyze(NoteEvent[], (string Chord, Rational Start)[], KeySignature, HarmonicColorAnalysisOptions?)

Analyze melody + a tuple-based chord progression (as used in examples).

public static HarmonicColorAnalysisResult Analyze(NoteEvent[] melody, (string Chord, Rational Start)[] chordProgression, KeySignature key, HarmonicColorAnalysisOptions? options = null)

Parameters

melody NoteEvent[]

chordProgression (string Chord, Rational Start)[]

key KeySignature

options HarmonicColorAnalysisOptions

Returns

HarmonicColorAnalysisResult

Exceptions

ArgumentNullException

melody or chordProgression is null.

ArgumentException

A chord symbol in chordProgression cannot be parsed.

Analyze(ReadOnlySpan<NoteEvent>, IReadOnlyList<ChordAssignment>, KeySignature, HarmonicColorAnalysisOptions?)

Analyze melody + chord assignments in a known key.

public static HarmonicColorAnalysisResult Analyze(ReadOnlySpan<NoteEvent> melody, IReadOnlyList<ChordAssignment> chords, KeySignature key, HarmonicColorAnalysisOptions? options = null)

Parameters

melody ReadOnlySpan<NoteEvent>

chords IReadOnlyList<ChordAssignment>

key KeySignature

options HarmonicColorAnalysisOptions

Returns

HarmonicColorAnalysisResult

Exceptions

ArgumentNullException

chords is null.

Analyze(ReadOnlySpan<NoteEvent>, IReadOnlyList<(string Chord, Rational Start)>, KeySignature, HarmonicColorAnalysisOptions?)

Analyze melody + a tuple-based chord progression (as used in examples). Each tuple is (ChordSymbol, StartTime). End times are inferred from the next chord, and the last chord defaults to a duration of 1 whole note.

public static HarmonicColorAnalysisResult Analyze(ReadOnlySpan<NoteEvent> melody, IReadOnlyList<(string Chord, Rational Start)> chordProgression, KeySignature key, HarmonicColorAnalysisOptions? options = null)

Parameters

melody ReadOnlySpan<NoteEvent>

chordProgression IReadOnlyList<(string Chord, Rational Start)>

key KeySignature

options HarmonicColorAnalysisOptions

Returns

HarmonicColorAnalysisResult

Exceptions

ArgumentNullException

chordProgression is null.

ArgumentException

A chord symbol in chordProgression cannot be parsed.