analyze_harmony
Read-onlyIdempotent
Identify the key of a score and name every chord in Roman numerals. Works offline on raw score data to provide a tonal center estimate and full harmonic analysis.
Instructions
Estimate the key of a ScoreSpec and name its chords in Roman numerals.
Entirely offline: the score is analysed as data and Dorico is not involved, so
this works on music that has never been in a project.
Returns:
Result dictionary with the key estimate, its confidence, and a Roman numeral
reading of each sonority.
Note:
Key estimation relies on pitch distribution. For short or highly chromatic
excerpts, verify the estimated tonal center before relying on Roman numerals.
This answers what the harmony is. For whether the voices move well between
those chords use check_voice_leading, for strict two-part exercises
check_counterpoint, and for what could come next suggest_next_chord.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| score | Yes | The score to work on, as a ScoreSpec object: metadata, parts, and the events inside them. Call score_schema first for the exact shape, which refuses unknown keys rather than ignoring them. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||