DOI: 10.5281/zenodo.14984776
title: François Couperin – L'art de toucher le clavecin (A corpus of annotated scores)

description: This is a README file for a data repository originating from the DCML corpus initiative
and serves as welcome page for both



the GitHub repo https://github.com/DCMLab/couperin_clavecin and the corresponding

documentation page https://dcmlab.github.io/couperin_clavecin


For information on how to obtain and use the dataset, please refer to this documentation page.

François Couperin – L'art de toucher le clavecin

This corpus of annotated MuseScore files has been created within
the DCML corpus initiative and employs
the DCML harmony annotation standard. It represents nine pieces found in François
Couperin's 1717 treatise on harpsichord fingering, ornamentation, and interpretation. This work was intended to provide
a study supplement to Couperin's own 1713 Pieces de clavecin, published upon a grant of privilege by King Louis XIV.
This courtly and didactic music represents an elegant and archetypical example of the Baroque harmonic technique, and
our annotations stress the precision of contrapuntal detail that permeates this music. These annotations will provide
considerable support to future quantitative study of Baroque ornamentation and contrapuntal figuration.

Getting the data



download repository as a ZIP file

download a Frictionless Datapackage that includes concatenations
of the TSV files in the four folders (measures, notes, chords, and harmonies) and a JSON descriptor:


couperin_clavecin.zip

couperin_clavecin.datapackage.json



clone the repo: git clone https://github.com/DCMLab/couperin_clavecin.git


Data Formats

Each piece in this corpus is represented by five files with identical name prefixes, each in its own folder.
For example, the Allemande has the following files:



MS3/00_allemande.mscx: Uncompressed MuseScore 3.6.2 file including the music and annotation labels.

notes/00_allemande.notes.tsv: A table of all note heads contained in the score and their relevant features (not each of them represents an onset, some are tied together)

measures/00_allemande.measures.tsv: A table with relevant information about the measures in the score.

chords/00_allemande.chords.tsv: A table containing layer-wise unique onset positions with the musical markup (such as dynamics, articulation, lyrics, figured bass, etc.).

harmonies/00_allemande.harmonies.tsv: A table of the included harmony labels (including cadences and phrases) with their positions in the score.


Each TSV file comes with its own JSON descriptor that describes the meanings and datatypes of the columns ("fields") it contains,
follows the Frictionless specification,
and can be used to validate and correctly load the described file.

Opening Scores

After navigating to your local copy, you can open the scores in the folder MS3 with the free and open source score
editor MuseScore. Please note that the scores have been edited, annotated and tested with
MuseScore 3.6.2.
MuseScore 4 has since been released which renders them correctly but cannot store them back in the same format.

Opening TSV files in a spreadsheet

Tab-separated value (TSV) files are like Comma-separated value (CSV) files and can be opened with most modern text
editors. However, for correctly displaying the columns, you might want to use a spreadsheet or an addon for your
favourite text editor. When you use a spreadsheet such as Excel, it might annoy you by interpreting fractions as
dates. This can be circumvented by using Data --> From Text/CSV or the free alternative
LibreOffice Calc. Other than that, TSV data can be loaded with
every modern programming language.

Loading TSV files in Python

Since the TSV files contain null values, lists, fractions, and numbers that are to be treated as strings, you may want
to use this code to load any TSV files related to this repository (provided you're doing it in Python). After a quick
pip install -U ms3 (requires Python 3.10) you'll be able to load any TSV like this:

import ms3

labels = ms3.load_tsv("harmonies/00_allemande.harmonies.tsv")
notes = ms3.load_tsv("notes/00_allemande.notes.tsv"")


Version history

See the GitHub releases.

Questions, Suggestions, Corrections, Bug Reports

Please create an issue and/or feel free to fork and submit pull requests.

Cite as

Johannes Hentschel, Yannis Rammos, Markus Neuwirth, & Martin Rohrmeier. (2025). François Couperin – L'art de toucher le clavecin (v2.2) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.14984598

License

Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).