In Harmonia, the term assessment has a specific meaning: it is a section of a document that students complete (fill in) and Harmonia assesses and evaluates (grades). Most Harmonia assessments are derived from musical scores. A score assessment consists of two parts: the visible student view of the score and an authority analysis (or grading key) that Harmonia uses to evaluate what the student inputs. As soon as a music score is added to a document page, Harmonia automatically analyzes it and displays the results of the analysis in a green theory line directly beneath the score. Any theory symbol determined by Harmonia's analysis can then be overridden (altered) by a teacher. The resulting combination — automatic analysis plus any teacher overrides — is called the authority analysis, which serves as the basis for grading student work. While there are different kinds of score assessments possible, in Harmonia they all belong to one of three broad categories:

• In a composition assessment, students compose a score that is graded against standard part-writing rules and the authority analysis visible in the theory line below the score. Composition assessments can include pitch and pitch-class notation, triad and seventh chord notation, and 2-voice contrapuntal and 4-part SATB part-writing exercises. Note: students do not need to exactly compose the authority version of the score. As long as their input follows general part-writing rules and guidelines, their answer(s) may be evaluated as correct.
• In an analysis assessment, students study a score and then enter appropriate analytical symbols into the theory line. Students' symbols are then checked against the authority analysis. Analysis assessments can include pitch, pitch-class, or scale-degree identification, interval identification, chord symbol identification, or diatonic and chromatic roman numeral analysis.
• In a mixed assessment, students compose a score and complete an analysis, both of which are then independently compared against the authority analysis. The total point value of a mixed assessment will be sum of its composition and analysis points. A Figured Bass Assessment, for example, is a specific type of mixed assessment.

In Harmonia you can convert any music score into an analysis or composition assessment. In this documentation we demonstrate both types of conversion using an example four-part score. Please see Importing Music XML for more information.

Preparing a Score for Conversion

Begin by adding a score to a page. See here for how to add a score to a page. Once a score is added to a page, examine Harmonia’s automatic analysis for correctness.

Before converting a score into any type of assessment, first ensure that the musical pitches are correct. In particular, any visible Harmonia error annotation on the score should be resolved before converting the music into an assessment because those errors will affect the grading. Also consider resolving warnings and comments before converting to an assessment. In the case of an analysis assessment, the theory line should contain the symbols you want students to provide by typing them into the assessment's theory line. For example, in an analysis assessment of a four part-score score the theory line should display the roman numerals you expect students to provide in the exercise.

A theory line displaying roman numerals is suitable for creating either a four-part composition assessment or a roman numeral analysis assessment. If you convert the score to a composition assessment, use the Analysis Editor to select the theory-line display style you want the students to use as their guide for composing the score. For example, in a typical four-part composition assessment, the theory line will display either roman numerals or figured bass.

A theory line displaying figured bass is also useful for creating a four-part composition exercise.

Converting a Score into an Assessment

Once the score and theory line are ready and the score is selected on the page, select “Convert Score to Assessment” from the Teacher menu. Select the desired assessment type from the pulldown menu and then configure the score by clicking on the Assessment tab in the Music panel on the right.

Assessment Types

When clicking the “Convert Score to Assessment” in the Teacher menu, users may choose the type of assessment conversion desired. Although there are a number of different assessment types, they all belong to one of three broad categories:

Composition Assessments

When a score is converted into a composition assessment the symbols in its theory line are locked and notes in the score can be converted into draggables, i.e. items that the student moves up and down to compose the score. The completed composition is then analyzed by Harmonia and compared against the authority analysis to determine a grade for the assessment

Analysis Assessents

When a score is converted into an analysis assessment the notes in the score are locked (made unselectable or uneditable) and the symbols of the authority analysis currently visible in the theory line become hidden. The theory-line entries are then converted into empty fields (boxes) for students to enter their analysis symbols. The completed analysis is then compared against the hidden authority analysis to determine a grade for the assessment.

Mixed Assessments

When a score is converted into a mixed assessment, notes in the score can be converted into draggables and the theory line contains empty fields. The completed composition and the analysis are analyzed by Harmonia and independently compared against the authority analysis to determine a grade for the assessment. The total point value of a mixed assessment will be the sum of composition points and analysis parts.

The Assessments

Here is a brief explanation of the available assessments that can be selected from the Assessment Types menu:

Roman Composition Assessment

Students compose a score that satisfies a roman numeral analysis or figured bass line visible in the theory line. This kind of assessment is available for scores that Harmonia processes using its Harmonic Analysis engine.

Roman Analysis Assessment

Students type roman numerals into the theory line. This kind of assessment is available for scores that Harmonia processes using its Harmonic Analysis engine.

Figured Bass Assessment

A mixed assessment that combines Roman Composition and Roman Analysis in one assessment, always displaying figured bass symbols directly below the score and above the theory line.

Chord Symbol Analysis Assessment

Students type chord symbols into the theory line. This kind of assessment is available for scores that Harmonia processes using its Chordal Analysis or Harmonic Analysis engine.

Chord Symbol Composition Assessment

Students compose chords that satisfy the chord symbols visible in the theory line. This kind of assessment is available for scores that Harmonia processes using its Chordal Analysis or Harmonic Analysis engine.

Chord Type Analysis Assessment

Students type chord symbols in the theory line. This kind of assessment is available for scores that Harmonia processes using its Chordal Analysis or Harmonic Analysis engines.

Chord Type Composition Assessment

Students compose chords that satisfy the chord types visible in the theory line. This kind of assessment is available for scores that Harmonia processes using its Chordal Analysis or Harmonic Analysis engine.

Scale Degree Analysis Assessment

Students type scale degrees into the theory line. This kind of assessment is available for scores that Harmonia processes using its Scale Analysis engine.

Scale Degree Composition Assessment

Students compose pitches that satisfy the scale degrees visible in the theory line. This kind of assessment is available for scores that Harmonia processes using its Pitch Analysis engine.

Interval Analysis Assessment

Students type intervals in the theory line. This kind of assessment is available for scores that Harmonia processes using its Interval Analysis engine.

Interval Composition Assessment

Students compose pitches that satisfy the intervals visible in the theory line. This kind of assessment is available for scores that Harmonia processes using its Interval Analysis engine.

Pitch Analysis Assessment

Students type pitches in the theory line. This kind of assessment is available for scores that Harmonia processes using its Pitch Analysis engine.

Interval Composition Assessment

Students compose pitches that satisfy the pitch names visible in the theory line. This kind of assessment is available for scores that Harmonia processes using its Pitch Analysis engine.

Configuring and Customizing an Assessment

Once a score is converted into an assessment, the Assessment Editor installs controls for customizing the display and behavior of the newly converted score and theory line. The controls differ according to the type of assessment being configured.

Configuring Analysis Assessments

The Theory Line controls are available for all analysis assessments. To use these buttons, first click on a boxed theory-line entry on the score to configure. These buttons provide the following functionality:

Show Answer

Displays the analysis symbol (answer) a student would otherwise provide and makes that symbol inactive and ungraded in an assessment.

Clear Answer

If the entry currently shows the answer, the Clear Answer button will replace it with an empty entry, and that entry will become active and gradable in the assessment.

Hide Entry

Makes the selected entry in the theory line invisible and ungraded in the assessment. Note that a hidden entry will appear as an entry with a dotted border for teachers, but when a student views the assessment, a blank space will appear in that position.

Unhide Entry

If the selected entry is currently hidden, the Unhide Entry will make it visible and active in the assessment.

Friendly Key

Normally the first entry in a Roman Numeral analysis includes the "home key" of the analysis. If the Friendly Key toggle is off then the student must provide both the key and the roman numeral in the first entry of the piece. Toggling the Friendly Key button will display the home key for the student and only the roman numeral will need to be typed for that entry. If you do not choose to use the Friendly Key button, remind students in the assessment's written instructions to include the key along with the first chord label in the first entry. The Friendly Key toggle is only active for the first text-box entry of the piece or in entries containing a direct modulation.

Customizing the theory line of an analysis assessment. The answer for the secondary dominant was made visible and inactive using the Show Answer button, and the first entry uses the Friendly Key feature so the student only needs to provide the roman numeral.

Configuring Composition Assessments

The Draggables customization controls are available for all composition assessments. A draggable is Harmonia's term for an item that a student clicks and drags to compose a note in the composition. Notes that are not draggable are inactive and ungraded in the composition. To use these buttons, first click on a note in the score to convert. The Draggables buttons provide the following functionality:

Convert Note

Converts the selected note into a draggable or an inactive note, depending on the current state.

Convert Chord

Converts all the notes in the chord containing the selected note into draggables or inactive notes, depending on the current state of the selected note.

Convert Voice

Converts all the notes belonging to the same voice as the selected note to draggables or inactive notes, depending on the current state of the selected note.

Convert All

Converts all the notes in the score to draggables or inactive notes.

The Locking customization controls allow you to lock notes in the score. A locked note is visible to the student but inactive and ungraded by the assessment. To use these buttons, first click on (select) a note in the score to lock. The Locking buttons provide the following functionality:

Lock Note

Locks or unlocks the selected note, depending on the current state.

Lock Voice

Locks all the notes belonging to the same voice as the selected note.

Unlock Voice

Unlocks all the notes belonging to the same voice as the selected note.

Configuring Mixed Assessments

Mixed assessments display the composition controls and the analysis controls together in the configuration editor.

The Grading Editor

Before saving and adding an assessment to your Harmonia course, check the grading scheme to make sure it corresponds to your grading needs. Harmonia currently offers Additive Grading, in which the total points achieved in the assessment is calculated as the sum of all item point values minus their individual error deductions. Look to future releases for Subtractive Grading to be offered as an additional grading choice.

To make any changes to points values, click on the Error Deductions... box. Depending on the assessment type, specific possible errors will be available for editing in a pop-up window. Use the pre-set deductions or make your own changes.

The Grading Editor allows you to determine the points and error deductions that Harmonia will use for grading the assessment. Setting a deduction to 0 eliminates that check from the grading scheme.

Error Deductions for Pitch Analysis and Pitch Composition Assessments

Error Deductions for Interval Analysis and Interval Composition Assessments

Error Deductions for Chord Symbol Analysis and Chord Symbol Composition Assessments

Analysis Deductions for Roman Numeral Analysis and Four Part Composition Assessments

Part Writing Deductions for Four Part Composition Assessments

Final Steps

Once you configure all the assessments in the document and add any text directions, (and/or audio, video, images) you want students to see, save the file and quit Harmonia. Log into your course on our server and upload the file for delivery to your students. For more information on this process see Add homework assignments to your Harmonia.