JRP Work List

A structured list of works in the JRP database can be accessed through the link http://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.
[an error occurred while processing this directive]