Josquin Humdrum encoding standards

Reference records

Reference records are lines which start with three exclamation marks followed by a reference key, then a colon, and then the value for the reference key.

Header reference records

Reference records which occur before the start of the data:

  !!!COM: Josquin des Prez

COM is the composer of the work. COM is used with the work is securely attributed to Josquin as the composer.

  !!!COA: Josquin des Prez

COA is the attributed composer of the work. When the authorship is in question, COA is used to give the suspected composer. When there is both a COM and COA entry in the file, then the COA is the spurious composer.

  !!!CDT: ~1450-1521/08/27

CDT is the Composer's birth and death dates. Josquin was born in approximately 1450 and died 27 August 1521. Note all dates in Humdrum reference records are in the form year/month/day[/hour:minute:second]. A tilde character before a number such as the year means circa, or an approximate date.

  !!!OPR: Missa Ave maris stella

When the data file contains a Mass section, it is treated as an independent work, with one section to a file. The OPR (opus parent) record will give the name of the mass, while the OTL record the name of the Mass section (Kyrie, Gloria, Credo, Sanctus, and Agnus Dei).

  !!!ONM: 1

For Masses, ONM (opus number) is the order of the main segmentation of the mass, which is typically:

1. Kyrie
2. Gloria
3. Credo
4. Sanctus
5. Agnus Dei

  !!!OTL: Kyrie

OTL (opus title) stores the title of the work/movement represented in the file. The title for Mass sections will be stored in an OTL record. For Motets, the first line(s) of the vocal text will be used as the title.

  !!!OTL@@LAT: Sancta mater istud agas

When an OTL record contains two at signs (@@) (or any reference record), a 3-letter ISO 639-2 language code will follow. This language is either the primary language to use for the reference record, or it may also mean the original language in the case where translations are given in other reference records. The language code should be in upper case. In this case LAT means Latin.

  !!!OTL@ENG: Holy Mother! pierce me through

When a reference record is only followed by a single at sign (@), the language code which follows is a language into which the reference value has been translated into. In this case the title is translated into English, and also it implies that English was not the original language for the reference record.

  !!!AGN: Mass; Kyrie

AGN (analytic genre) is used to encode the genre within the data. This is useful for selecting or grouping works by genre for analysis. Multiple analysis genres are separated by semicolons, such as in this case where the work is a part of a mass, but is more specifically a kyrie.

  !!!SCT: NJE 3.1

SCT is a scholarly catalog number, in abbreviated form. In this case "NJE" stands for the "New Josquin Edition", "3" stands for the third volume of the series, and "1" indicates that the work is the first one (or a section of the first one in this case) in the volume.

  !!!SCA: New Josquin Edition 3.1

SCA is an unabbreviated scholarly catalog number.

  !!!voices: 4

voices is the number of voices in the work/section. This value is usually the same as the number of spines (columns) in the Humdrum data, but is occasionally different, such as in the case where one of the original parts has been lost.

Trailer reference records

Reference records which occur before the start of the data:

  !!!RDF**kern: l=long note in original notation

RDF**kern is an encoding emendation for the **kern data type. In this case the character "l" when found in **kern data is used to represent a terminal long note, which should be displayed as a long note regardless of it

  !!!RDF**kern: i=musica ficta

This encoding emendation indicates that the character "i" found in **kern data is used to indicate a musica ficta accidental which is not found in the original score, but was implicitly applied by performers in Josquin's time (as assumed by the modern editor).

  !!!RDF**kern: %=rational rhythm

When this encoding emendation is used, it indicates the presence of a non-backwards compatible **kern rhythm code. There are two rhythmic values which cannot be represened in standard **kern:

1. triplet whole notes (semibreves) (2/3rds of a whole note) represented in the data as "3%2" which is the inverse of 2/3.
2. triplet breves (double whole notes) (4/3rds of a whole note) represented in the data as "3%4" which is the inverse of 4/3. This record can be used to ascertain whether the rhythmic data can be correctly processed with the Humdrum toolkit without pre-processing.

  !!!rscale-alt: 1/2

When this reference record is present (always with an !!!RDF**kern: %=rational rhythm emendation, this is the rhythmic scaling which is necessary in order to allow the note rhythms to be fully understood by the standard Humdrum Toolkit commands. You may use the Humdrum Extras program rscale to alter the rhythms in the file to make them compatible with the standard Humdrum Toolkit commands:

   rscale -a file.krn | census -k

To convert data back into the original rhythmic values, use the -o option:

   rscale -a file.krn | rscale -o

When the data contains a triplet whole note ("3%2"), the rscale alternate entry should be at least 1/2 to shift the triplet whole note to the triplet half-note rhythmic level. If the data contains a triplet breve ("3%4"), the rscale alternate entry should be at least 1/4 to shift the triplet breve to the triplet half-note rhythmic level.

  !!!RDF**kern: V=start of tuplet marker
  !!!RDF**kern: Z=end of tuplet marker

Triplet markings in the data are explicitly indicated in the data with V for the start of a tuplet marking, and Z as the end of the tuplet marking. These specific characters may change in the future, but the rest of the emendation line will remain the same. The explicit tuplet markings are needed to differentiate between isolated triplets (such as might originally be written in red notation in mensural notation) from notes marked with the mensural sign "3". The "3" sign essentially is a shorthand for a longer section of triplets, and the triplet brackets are not displayed when a "3" mensural sign is in effect.

  !!!ENC: Jesse Rodin; Victoria Chang 2011/04/01/

ENC is the encoder (transcriber) of the work in Finale from a printed score using a MIDI keyboard. If there is more than one encoder who generated the data their names will be separated a semi-colons (;).

  !!!END: 2011/04/01/

END is the primary encoding date, typically the date on which the encoding was finished. May be estimated if the original encoding date was not recorded.

  !!!EED: Jesse Rodin

EED is the electronic editor. This is the person to complain to about the content of the data, such as a wrong note or questionable editorial decision.

  !!!EEV: 2011/04/06/

EEV is the electronic edition version. When the data is change (such as to fix an errata), this date should be changed to the current date.

  !!!ONB: Translated from MusicXML and edited on 2011/04/06/ by Craig Sapp

ONB stands for opus nota bene which is a free-form note. In this case there will be a reference record in this form in the bottom reference records which indicates when the musical data was extracted from the MusicXML data exported from Finale (Finale versions 2009, 2010, or 2011). If the MusicXML data file representing the same data has an encoding date later than this date, then there may be differences between the two versions of the music. However, if the EEV date is later than the encoding date within the MusicXML file, it is likely than any fix made to the MusicXML data was also manually made to the Humdrum file.

 !!onb: tie removed from Tenor voice G in m97 [2011/04/06/]

Ocassionally there will be !!onb: comments which are used to store errata fixes made to the data. These are primarily used to coordinate with the MusicXML files created in Finale. When the coordination between the two files is secure, these errata records may be deleted.