Josquin Project encoding standards

Conventions for encoding Josquin music in Finale. See Hyperscribe notes for tips on settings in Finale for real-time entry. General guidelines for entering mensural music in modern notation in Finale are available here: (PDF, Microsoft Word).

Filenames

Only characters for POSIX-portable filenames should be used. Allowable characters are "A" through "Z", "a" through "z", period ".", dash "-", and underscore "_".

Data filenames should be given names according to this naming convention:

Filename component	Description
Xxx	A unique three-letter identification abbreviation which identifies the composer, who is possibly spurious (see Composer codes listed below).
1234	A four-digit catalog number for the specific composer. For Josquin, the catalog number matches the NJE volume (first two digits) and work number within the volume (second two digits). If a Josquin work is not yet published in the NJE, then the first two digits are "99". For most other composers, the first digit indicates the genre (1=mass, 2=motet, 3=secular song), and the last two (or three) digits are an enumeration of the works in the genre (typically alphabetical).
[123456789]	An optional variant enumeration for the work. The variant number can be any number of digits. The primary variant will be the the one with the lowest enumeration. Typically the primary variant will not posses a variant number, or it can be explicitly given a variant number of "0" to emphasize that it is the primary variant. Works which do not posses a particular variant primacy should start numbering variants at "1". The variant number for different sections (of a mass, or other multi-section works spanning multiple files) must have matching variant numbers, unless other sections are represented by the primary variant (which should be "0" or no variant number).
[A]	An optional capitalized letter which maps to letters after work numbers in the NJE (for Josquin only).
[a]	An optional lower case letter which maps to sections of a work. This is used particularly for masses, where the common enumeration of the sections given in separate files is: a=Kyrie, b=Gloria, c=Credo, d=Sanctus, e=Agnus Dei. Note that some masses have more sections, so these are not fixed-meaning section letters.
[1]	An optional number which indicates the subsection of a section. If this number is given, then the section letter described above is also required. For example, if a data file only contains the Christe (sub)section of a mass's Kyrie section, then the section and subsection in the filename would typically be given as "a2". "a" for the first section of the mass (Kyrie), and "2" for the second section of the Kyrie (which usually has the sections Kyrie I, Christe, Kyrie II).
-	The end of the full catalog ID must be followed by a dash to separate it from the rest of the filename which follows. The catalog number before the first dash in the filename is guaranteed to be unique. The textual information after the first dash in the file may not be unique (within the works of a single composer, and definitely not unique between the works of multiple composers).
title	The title of the work. Spaces are converted to underscores. See below for more details.
[-section title]	Optional section title which must be seprated from the work title with a dash.
[[-]-edition]	Optional non-title information useful/necessary to identify the data in the file. This is typically an edition or variant name. If there is no subsection title, then there must be two dashes before the text of this component in the filename.

NJE (New Josquin Edition) volume and work numbers should be proceeded by a "0" if the number is less than 10. No dot between the volume and work number. For example Missa Gaudeamus by Josquin, NJE 4.2, first section (Kyrie) is:

   Jos0402a-Missa_Gaudeamus-Kyrie

• If a filename contains an encoding variant, then there must be a movement-level name, which could be empty, resulting in two dashes before the variant text, such as:

  Jos0402a-Missa_Gaudeaumus-Kyrie-JRP2008
  Jos0402a-Missa_Gaudeaumus--JRP2008
  Jos0402-Missa_Gaudeaumus--JRP2008

• When an NJE catalog number contains a letter, that letter is added in uppercase, with any sectional labels given in lower case letters after any NJE catalog letter.

• To encode slashes in filenames for titles, use two underscore characters to represent a slash:

  2918-Nymphes_des_bois__Requiem   for "Nymphes des bois/Requiem"

• Accented characters (such as é) be given with the accent removed. Apostrophes should also not be included in the filename. Parentheses should not be included in the filename. Spaces should not be included in the filename.

Non-NJE catalog numbers

For Josquin works which do not have an NJE volume/work number, use 99 as the volume number, and an arbitrary work number (from 01 to 99). Arbitrary work numbers are assigned in the following list, with the NJE column listing an NJE number when it becomes available:

ID	New ID	Title	Note
Jos9901		Missa Mi mi	(1) The Other Josquin, (2) Pipelare Opera omnia
Jos9902		O bone et dulcissime Jesu	2vv. Almost certainly the two "si placet" voices from the six-voice version of Jos2109 in MunBS 41 by Anonymous.
Jos9903		Regine celi	6vv, Musical Times, August 1971, supplement, ed. Noble.
Jos9904		Proch dolor	Smijers Supplement #14, pp.66-72.
Jos9905		unassigned
Jos9906		Missa Inviolata Osanna	Fragment. Lodovico Zacconi, "Prattica di Musica" (1592)
Jos9907		Omnes gentes	Fragment. Lodovico Zacconi, "Prattica di Musica" (1592)
Jos9908		Scriptum est enim	7-note fragment. Lodovico Zacconi, "Prattica di Musica" (1592)
Jos9909		In deficiendo ex me spiritum meum	Fragment. Lodovico Zacconi, "Prattica di Musica" (1592)
Jos9910		Seculum nostrum & illuminatio vultus tui	11-note fragment. Lodovico Zacconi, "Prattica di Musica" (1592)
Jos9911		Castigans castigavit me dominus	18-note fragment. Lodovico Zacconi, "Prattica di Musica" (1592)
Jos9912		Pleni	Correa de Arauxo (1626)

If any of the above works are published in the NJE, then their catalog number will change in the future to reflect the volume/work number in the NJE.

Composer codes

All data files must start with a composer code. The composer code is a unique three-letter abbreviation for the composer. The first letter of the code should be capitalized and the other two letters in lower case. However, the code is case insensitive so that "Jos", "jos", "JoS", etc. all mean Josquin.

Here is a current list of composer codes:

ID	Composer	Rest of Name	Dates	Note
Agr	Agricola	Alexander	~1445-1506/08/15
Bas	Basiron	Philippe	~1449-<1491/05/31
Bau	Bauldewyn
Bin	Binchois	Gilles	~1400-1460/09/20
Bru	Brumel	Antoine
Bus	Busnoys	Antoine	~1430-1492/11/06
Car	Caron	Firminus	~1460-1475
Com	Compre	Loyset	~1445-1518/08/16
Dom	Domarto	Petrus de	<1445-1455
Duf	Du Fay	Guillaume	1397/08/~05-1474/11/27	large repertory
Dun	Dunstaple	John	~1390-1453/12/24
Fau	Faugues	Guillaume	~1460-1475
Fry	Frye	Walter	?-<1475/06
Fva	Fvin	Antoine de	~1470-~1511
Gas	Gaspar	Gaspar van Weerbeke	~1445->1516
Ghi	Ghiselin	Johannes	<1491-1507
Isa	Isaac	Henricus	~1453-1517/03/26	large repertory
Jap	Japart	Jean	~1476-1481
Jos	Josquin	des Prez	~1476-1481	large repertory
Mar	Martini	Johannes	~1430-1440
Mou	Mouton	Jean	<1459-1522/10/30
Obr	Obrecht	Jacob	~1457-1505/08/01	large repertory
Ock	Ockeghem	Jean de	~1410-1497/02/06
Ort	de Orto
Pip	Pipelare	Matthaeus	~1450-~1515
Plu	Plummer	John	~1410-~1484
Pow	Power	Leonel	~1375-1445/06/05
Pri	Prioris	Johannes	<1485-1512
Puy	Puyllois	Johannes	?-1478/08/23
Reg	Regis	Johannes	~1425-~1496
Rue	La Rue	Pierre de	~1452-1518/11/20	large repertory
Sto	Stokem	Johannes de	~1450-1521/08/27
Tin	Tinctoris	Johannes	~1432-1511/02/09
Vaq	Vaqueras	Bertrandus	~1450-1507/04/21
Wre	Wreede	Juan de Urrede	<1451-~1482

Composer codes should ideally reflect the alphabetically ordering of the composers they represent. This will facilitate alphabetically sorting of search-results by composer by sorting the matching data files.

Spurious compositions will still be given the composer code of the spurious composer. In the database, the composition data will be linked to the alternate composer(s) by using a different catalog number.

Part names

• Each part should have a part name. The part names should be spelled the same in all files and start with a capital letter. Possible part names are: Superius, Altus, Tenor, Bassus, Contra, Discantus, Cantus, Sextus, Vagrans. If there is more than one voice for each vocal function, add a number after the name (with no space), such as Tenor1, Tenor2.

Part names are located in the MusicXML export in: score-partwise/part-list/score-part@id="P1"/part-name text. P1 is the top part on the system, P2 is the second to top part on the system, etc..

Internal Documentation

The menu option File→File Info... opens up a window which contains information about the file. The title and composer(?) field should be filled in (red fields highlighted below). The blue highlighted fields are exported into MusicXML, so they can be used for some purpose.

File Info window in Finale 2009.

• The Title: should contain the title of the work. The NJE number should be given (after the title, or in the style used for the filename above? It doesn't seem to add anything to have two naming systems.). If there is a section name, then place a space-dash-space between the title of the work and the title of the section. In MusicXML, this field maps to score-partwise/movement-title text. For example, a title might look like:

        0402d-Missa_Gaudeamus-Sanctus

• The Subtitle: field does not export into MusicXML (Finale 2009).
• The Composer: field should contain "Josquin" for those in blue, "Josquin(?)" for those in purple, and "Josquin?" for the others. Perhaps mark the certainty of the composer (e.g. spurious, attributed, suspected, etc.). In MusicXML, this field maps to score-partwise/identification/creator@type=composer text.
• The Arranger: field should contain the name of the encoder and the date of the encoding, e.g. "Jesse Rodin 2010/11/23". It maps in MusicXML to score-partwise/identification/creator@type=arranger text. If there is more than one encoder, such as when an older encoding is being reworked, add the second encoder after a semicolon, such as:

     Jesse Rodin; Victoria Chang 2011/03/28
     Jesse Rodin 2008; Victoria Chang 2011/03/28

• The Lyricist: field should contain the name of the edition used for transcription (NJE, Smijers, Davison, Finscher, etc.). It maps in MusicXML to score-partwise/identification/creator@type=lyricist text.
• The Copyright: field maps in MusicXML to score-partwise/identification/rights text (can be used for some purpose).
• The Description: field does not export into MusicXML (Finale 2009).
• The Score Name Insert: field does not export into MusicXML (Finale 2009).
• The Created: field does not export into MusicXML (Finale 2009).
• The Modified: field does not export into MusicXML (Finale 2009).

Mensural signs

• Mensural signs do not need to be indicated for the following time signatures which are assigned these mensural signs.

   3/1 means MenCircle if no mensuration sign is given
   2/1 means MenCutC if no mensuration sign is given

• Notate mensuration signs as an expression in Finale, using a CamelCase tag from the list below. The expression must be attached to the first note/rest after the mensuration sign.
• If the same mensuration sign occurs simultaneously in all voices, then it is sufficient to add a text expression to just one of the voices. If multiple mensuration signs occur simultaneously but are different, and they have the same time signatures (such as MenC and MenCutC occurring at the same time for some reason...), mark each one with a text expression. If two mensuration signs occur simultaneously, it is sufficient to mark just one voice of each kind.
• Do not hide the time signature (Otherwise, it will not be exported in MusicXML data).
• Rhythms are not reduced (see table below for Modern time signatures being used).
• Notate passages preceded by a "3" sign by changing the time signature to 3/1 and adding the text expression Men3. If a voice moves to "3" at a different time than the others, double-click its staff with the Staff Tool (the treble clef); in the Staff Attributes window that pops up, check "Time Signature" under Independent Elements. Be sure to show the new time signature by double-clicking on the relevant bar with the Measure Tool and select "Show if needed" under Time Signature.
• Notate triplets as triplets. Finale sometimes hiccups on whole-note triplets that contain "complex" rhythms such as dotted semibreves or breves: one way to do this is to enter them manually using Simple Entry: (1) un-check "Check for Extra Notes" in the Simple Entry Options window; (2) select the whole note and the triplets in the Simple Entry Palette; (3) enter your notes. If the triplet consists of a breve and a semibreve, you may have to first enter two whole notes, delete the remaining whole note rest, then go back to the first whole note and hit alt-8.
• For augmentation or diminution via, for instance, a verbal canon (e.g. "In duplo," "Decrescit"), mensuration canon (e.g. Cut-C against C), or proportion sign (e.g. "3" or "2"), enter the notes with their sounding durations. Use text expressions to indicate the canon or sign as usual. Then indicate that the notes should be displayed with a different value than their sounding duration by adding the additional text expression "rscale:[factor of augmentation/diminution]". Indicate the first note whose display duration should not differ from its sounding duration by adding the text expression "rscale:1". For example, in Missa Gaudeamus, Agnus Dei III m. 110, the altus has a "2" sign. Transcribe this in Finale as follows:

This will appear in the JRP database as:

• To indicate that a voice should have barlines more/less frequently than in the Finale transcription, use the text expression "barlines:[frequency with which barlines should appear]". For instance, if barlines should only appear every three bars, attach the text expression "barlines:3" to the beginning of that section. Once the number of desired barlines equals the number in the transcription, use "barlines:1".

Here is a list of the CamelCase mensuration sign codes:

CamelCase	Meter	Meaning
MenCircle	3/1	Perfect tempus, minor prolation
MenCircleDot	9/2	Perfect tempus, major prolation
MenC	2/1	Imperfect tempus, minor prolation (in older mensural systems MenC can instead mean imperfect tempus, major prolation)
MenCDot	6/2	Imperfect tempus, major prolation
Cut versions of above (add "Cut" just after "Men")
MenCutCircle	3/1	MenCircle in 2:1 ratio
MenCutCircleDot	9/2	MenCircleDot in 2:1 ratio
MenCutC	2/1	MenC in 2:1 ratio
MenCutCDot	6/2	MenCDot in 2:1 ratio
Mensural signs where beat is on breve rather than semi-breve
MenCircle2	3/0	perfect minor modus, imperfect tempus
MenCircle3	9/1	perfect minor modus, perfect tempus
MenC2	2/0	imperfect minor modus, imperfect tempus
MenC3	6/1	imperfect minor modus, perfect tempus
Cut versions of above
MenCutCircle2	3/0	MenCircle2 in 2:1 ratio
MenCutCircle3	9/1	MenCircle3 in 2:1 ratio
MenCutC2	2/0	MenC2 in 2:1 ratio
MenCutC3	6/1	MenC3 in 2:1 ratio
Other mensural signs
MenCReverse	2/0	4:3 proportion
Men3	3/1	3:2 proportion
Men3Over2	3/1	3:2 proportion, alternate style
Men2	2/0	2:1 proportion
MenCircleOver3	3/1
MenCutCircle3Over2	3/1	MenCutCircle symbol followed by 3/2
MenOWithinO		4:3 ratio (speed up 33%).
Alternate signs (not used in Josquin)
MenCircleTwoDot	3/1	same as MenCircle
MenCircleThreeDot	9/2	same as MenCircleDot
MenCTwoDot	2/1	same as MenC
MenCThreeDot	6/2	same as MenCDot
Italian trecento signs (not used in Josquin)
MenDivD		.d.    divisio duodenaria (12 minims per breve)
MenDivN	9/2	.n.    divisio novenaria (perfect tempus, major prolation)
MenDivO		.o.    divisio octonaria
MenDivP	3/1	.p.    divisio senaria perfecta (italica) (perfect tempus, minor prolation)
MenDivY	3/1	.y.    divisio senaria perfecta (italica) (perfect tempus, minor prolation)
MenDivSP	3/1	.s.p.  divisio senaria perfecta (italica) (perfect tempus, minor prolation)
MenDivSI	6/2	.s.i.  divisio senaria imperfecta (imperfect tempus, major prolation)
MenDivSG	6/2	.s.g.  divisio senaria imperfecta (gallica) (imperfect tempus, major prolation)
MenDivG	6/2	.g.    divisio senaria imperfecta (gallica) (imperfect tempus, major prolation)
MenDivI	6/2	.i.    divisio senaria imperfecta (gallica) (imperfect tempus, major prolation)
MenDivQ	2/1	.q.    divisio quaternaria (imperfect tempus, minor prolation)

To create and insert an expression:

1. Click on the "mf" icon (Expression Icon) in the toolbar.
2. Double click on the note/rest onto which the expression will be placed.
3. Scroll to the bottom of the expression list and click on a text expression, such as dolce or agitato.
4. Click on the button "Create Expressive Text..."
5. In the Main tab, Text: field, type one of the CamelCase mensuration signs listed above.
6. Click "OK" and then "Select" to insert the new expression (after an expression is created, you just need to select it and do not need to create another expression with the same text).
7. Can be placed above the staff, if desired.

The resulting expression will be mapped to a <direction> in the MusicXML export, also showing the note to which it was attached (which occurs immediately after it), and the modern time signature found in the attributes section before the <direction> element:

     <attributes>
       <divisions>1</divisions>
       <key>
         <fifths>0</fifths>
         <mode>major</mode>
       </key>
       
         <beats>3</beats>
         <beat-type>1</beat-type>
       
       <clef>
         <sign>G</sign>
         <line>2</line>
       </clef>
     </attributes>
     <sound tempo="120"/>
     <direction placement="below">
       <direction-type>
         <words default-y="-84" font-style="italic">MenCircle</words>
       </direction-type>
     </direction>
     <note default-x="104">
       <pitch>
         <step>C</step>
         <alter>1</alter>
         <octave>5</octave>
       </pitch>
       <duration>1</duration>
       <voice>1</voice>
       <type>quarter</type>
       <accidental parentheses="yes">sharp</accidental>
       <stem default-y="-50.5">down</stem>
     </note>

Here is what the MusicXML looks like when an expression is attached to a rest:

     <direction placement="below">
       <direction-type>
         <words default-y="-83" font-style="italic">MenC</words>
       </direction-type>
     </direction>
     <note default-x="246">
       <rest/>
       <duration>4</duration>
       <voice>1</voice>
       <type>whole</type>
     </note>

Musica ficta

• Notate musica ficta as an accidental on the staff, but with parentheses, such as (♯). This can be done in Speedy Note Entry (or Simple Note Entry) by typing p while the cursor is on the note (or the note is highlighted).
• Musica ficta markings do not need to be indicated on middle or ending notes of tied note groups.

Here is an example MusicXML note exported from Finale 2009 with a parenthesized accidental, with the attribute parentheses="yes" indicating the parentheses around the accidental:

<note default-x="106">
  <pitch>
    <step>C</step>
    <alter>1</alter>
    <octave>5</octave>
  </pitch>
  <duration>1</duration>
  <voice>1</voice>
  <type>quarter</type>
  <accidental parentheses="yes">sharp</accidental>
  <stem default-y="-50.5">down</stem>
</note>

Medial cadences

• Place double bars (not final bars) after medial cadences (any cadence followed by a double bar or fermata that is not a final cadence).

Terminal notes

Terminal notes are defined as the last note in a voice before either a double barline or at the end of a work. Terminal notes will be displayed a longs regardless of their actual durations. If you want a terminal note to be displayed with a different notehead shape (such as a breve, or as the notehead shape of the actual notated duration), add an expression text marker to indicate what notehead shape should be used instead of a long. Here is a list of the text expressions which can be used to display different noteheads. Each text expression should start with the string "shape:" (meaning notehead shape) which is used to indicate that the text refers to the notehead shape:

• shape:maxima
• shape:long
• shape:breve (double whole note)
• shape:semibreve (whole note)
• shape:minim (half note)
• shape:semiminim (quarter note)
• shape:fusa (eighth note)

Note that the above names for the noteheads should be used (minim rather than minima, or "half note"; long rather than longa).

To create a text expression, do this (Finale 2009, but should be similar or identical in other versions):

1. click on the Expression Tool
2. double click on the note to add expression
3. click on miscellaneous category in expression window which appears
4. choose the desired expression, if it exists. Otherwise, create the expression the first time it is needed:
   1. click on "Create misc expression..."
   2. set text to "shape:minim" (no spaces or quotes), for example to set the display style of the note as a minim.
   3. click ok to create new expression
   4. click select to chose expression
5. position expression vertically as you see fit, probably best underneath the note.

Here is an example screen-shot of Finale showing how

The final display of the notation will look like this:

Below is the MusicXML data which is generated for the note in the above example which should be displayed as a minim rather than a long. Note that the text is placed in a <direction> element immediately before the note to which it is attached:

<direction placement="below">
  <direction-type>
    <words default-y="-87" relative-x="4">shape:minim</words>
  </direction-type>
</direction>
<note default-x="265">
  <pitch>
    <step>E</step>
    <octave>3</octave>
  </pitch>
  <duration>2</duration>
  <voice>1</voice>
  <type>half</type>
  <stem default-y="-50.5">down</stem>
</note>

In the case where the terminal note is shorter than a full measure, such as a minim (half-note) at the start of a 2/1 measure, then the note should fill the measure (a breve in this example), and the text expression "shape:minim" attached to the note.

Old-style terminal note encoding

An older style, which is now obsolete (don't encode with this method, but be aware of it if you come across it in older data which has not been updated), used accent marks to control the style of the terminal notes:

1. > (accent) means that the original rhythmic level of the note is a long.
2. ^ (marcato, or martellato) means that the original rhythmic level of the note is a breve.

In the MusicXML export here is what an explicit long looks like (as an accent mark on the note):

   <note default-x="82">
     <pitch>
       <step>F</step>
       <octave>4</octave>
     </pitch>
     <duration>4</duration>
     <voice>1</voice>
     <type>whole</type>
     <notations>
       <articulations>
         <accent default-y="-55" placement="below"/>
       </articulations>
     </notations>
   </note>

And an explicit breve mark (as a marcato [or martellato] mark) in MusicXML (called a strong-accent):

     <note default-x="184">
       <pitch>
         <step>F</step>
         <octave>4</octave>
       </pitch>
       <duration>4</duration>
       <voice>1</voice>
       <type>whole</type>
       <notations>
         <articulations>
           <strong-accent placement="above" type="up"/>
         </articulations>
       </notations>
     </note>

Sections and inactive voices

• Indicate inactive voices with rests. (Optional: hide the staff in Finale--this is dangerous in VC's experience...)
• Indicate voice changes and other new sections within a piece with (1) a double bar at the end of the old section, (2) a new time signature at the beginning of the new section, even if it hasn't changed, and (3) a text expression attached to the first note/rest in the section, e.g. "Section: Qui venit". This text expression should include the first two or three words of the new section (or, in Kyrie or Agnus Dei settings, indicate the section via roman numerals, e.g. "Section: Kyrie II" or "Section: Agnus II"). In motets with prima, secunda, tertia pars, the text expression should say, for example, "Section: Secunda pars: Qui fuit Heli". If the section name is not clear, label it "Section:".

Humdrum translations

Encoding standards for Humdrum files translated from the MusicXML output from Finale.