JRP Work List

A structured list of works in the JRP database can be accessed through the link https://josquin.stanford.edu/data?a=worklist-json

This list is in the JSON format and is used to communicate the index of works between the JRP server and the user's web browser. The list is used to generate the contents of the Browse page, as well as provide information about works to other pages on the website, such as Work pages and the Census page.

The top level of the worklist is an array of repertory objects, sorted alphabetically, but with anonymous works listed first. Each Repertory will posses a list of works, which in turn may contain a list of work-sections:

Repertory object parameters

Each repertory entry in the base array of the worklist is represented by an object which contains the following parameters.

repid: Abbreviated name of the repertory. This is always a three-letter code starting with a capital letter, and it forms the first component of a JRP ID.
reprole: The role of the repertory: either "composer" if the repertory represents the works of a single composer, or "repertory" if the repertory contains the works of multiple composers (who are named in each work object).
replong: The full name of the repertory, if the reprole is "repertory".
repshort: The short name of the repertory, if the reprole is "repertory".
comlong: The full name of the default composer for the repertory. Used if reprole is "composer".
comshort: The short name for the default composer of the repertory. Used if repreole is "composer". Typically the name under which the composer will be alphabetized, such as "Josquin" for the full name "Josquin des Prez" or "Brumel" for "Antoine Brumel".
comdates: The birth and death dates (if known) for the composer.
repwork: The number of works in the data base for the repertory.
genres: An array of the work genres for the given repertory.
liststyle: Sorting method for the works entry; either "alphabetical" or "genre". Short repertory worklists are given alphabetically by title, while longer lists are sorted first by genre and then alphabetically within each genre.
notecount: The total number of notes in all works for the given repertory.
sec: The nominal performance time in seconds of all works in the repertory.
pg: The number of PDF pages for all works in the repertory.
works: An array of works for the repertory which are available in the JRP database.

The genres parameter of a repertory object is an array of genres present in the given repertory worklist. The parameters of a genre object are:

name: The name of a genre present in the worklist for the given repertory: mass, motet or song.
count: The number of the repertory's works which have this genre label.
notecount: The number notes in works of this genre in the repertory.
sec: The nominal performance time in seconds of all works in the given genre for the repertory.
pg: The number of PDF pages for all works in the given genre for the repertory.

Repertory → work object parameters (single section works)

A work object can occur in two formats: one for single-section works, and another for multi-section works (masses). Here are the parameters for a single section work object:

id: The JRP ID for the work.
title: The title of the work.
variant: Textual information about a work variant. Anonymous works use this parameter to indicate the manuscript source.
fragment: If the work is incomplete, this parameter is set to true.
attr: An attribution level, only given for works by/attributed to Josquin des Prez. Currently the levels are 1=securely attributed, 2=less securely attributed, 3=not securely attributed to Josquin. These levels are based on manuscript sources for the works, with secure attributions requiring at least two independent manuscripts indicating Josquin as the composer. Less securely attributed works generally have one early manuscript source citing Josquin as the composer. Not securely attributed works are typically given for works with no manuscript attributions to Josquin, or attributions to Josquin are only found in printed editions.
comlong: The full name of the composer of the work if it is different from the default composer in the parent repertory object.
comshort: The short name for the default composer of the work if it is different from the default composer in the parent repertory object. Typically it is the name under which the composer will be alphabetized, such as "Josquin" for the full name "Josquin des Prez" or "Brumel" for "Antoine Brumel".
comdates: The birth and death dates (if known) for the composer.
genre: The genre of the work.
notecount: The number of notes in the work.
sec: The nominal performance time in seconds of the work.
pg: The number of PDF pages for the work.
voices: The number of voices in the work. May not be an integer, such as "?" if the work is a fragment, and the original number of voices is unknown.
vname: Array of names for the voices in the work, listed from highest to lowest on the system. Example: Superius, Altus, Tenor, Bassus.
vabbr: Array of voice name abbreviations. Example: S, A, T, B.
vnotecount: Array of the number of notes occurring within each voice in the work.
ih: Incipit height; the pixel height of the incipit image. This parameter is used to calculate page layout before an image arrives from the server.
ad: The Add Date for the work: the date on which the work was added to the JRP database. Date is an integer in the format YYYYMMDD.
ud: The Update Date for the work: the date that the work was last (substantially) edited.

Repertory → work object parameters (multi-section works)

If a work has more than one section (movement), then additional information is given about each section in a parameter called sections which is an array of section objects, and several parameters are moved from the work level to the section level:

id: The JRP ID for the work. Does not map to a specific data file.
title: The title of the work.
variant: Textual information about a work variant. Anonymous works use this parameter to indicate the manuscript source. Variant information may also be found at the section level.
fragment: Set to true if the work is incomplete.
attr: Work attribution level (Josquin works only)
genre: The genre of the work.
notecount: The number of notes in the work (all sections).
sec: The nominal performance time in seconds of the work, summing the performance duration of all sections.
pg: The number of PDF pages for the section.
voices: The number of voices in the work. May be a range of numbers if the sections contain a variable number of voices.
vname: Not used at the work level for multi-sectioned works.
vabbr: Not used at the work level for multi-sectioned works.
vnotecount: Not used at the work level for multi-sectioned works.
ih: Not used at the work level for multi-sectioned works.
ad: The Add Date for the work. This is the most recent add date of any individual section in the work.
ud: The Update Date for the work. This is the most recent update date of any individual section in the work.
sections: An array of work section (movement) objects.

Repertory → work → section object parameters (multi-section works only)

If a work contains multiple sections, there will be a sections parameter for the work object which contains an array of section objects which contain the following parameters:

id: The JRP ID for the section. The initial portion of the ID will match the work-level ID, and then add a lower-case letter indicating the section sequence, typically "a" for Kyrie, "b" for Gloria, "c" for Credo, "d" for Sanctus, and "e" for Agnus Dei.
stitle: The title of the section, such as "Kyrie".
variant: Textual information about a section variant. Anonymous works use this parameter to indicate the manuscript source.
nc: The number of notes (note count) in the section. Similar to the work-level notecount parameter.
sec: The nominal performance time in seconds of the section.
v: The number of voices in the section. Similar to the work-level voices parameter.
vname: Array of notes for the voices in the section, listed from highest to lowest on the system. Similar to the work-level vname parameter.
vabbr: Array of voice name abbreviations in the section. Similar to the work-level vabbr parameter.
vnc: Array of the number of notes occurring within each voice in the section. Similar to the work-level vnotecount parameter.
ih: Incipit height; the pixel height of the incipit image. This parameter is used to calculate page layout before the image arrives from the server.
ad: The date on which the section was added to the JRP database. Similar to the work-level ad parameter.
ud: The date on which the section was last (substantially) changed. Similar to the work-level ud parameter.