Commit 8145626
authored
Updated paradata (#79)
This is a README file for a data repository originating from the [DCML corpus initiative](https://github.com/DCMLab/dcml_corpora)
and serves as welcome page for both
* the GitHub repo [https://github.com/DCMLab/cpe_bach_keyboard](https://github.com/DCMLab/cpe_bach_keyboard) and the corresponding
* documentation page [https://dcmlab.github.io/cpe_bach_keyboard](https://dcmlab.github.io/cpe_bach_keyboard)
For information on how to obtain and use the dataset, please refer to [this documentation page](https://dcmlab.github.io/cpe_bach_keyboard/introduction).
When you use (parts of) this dataset in your work, please read and cite the accompanying data report:
_Hentschel, J., Rammos, Y., Neuwirth, M., & Rohrmeier, M. (2025). A corpus and a modular infrastructure for the
empirical study of (an)notated music. Scientific Data, 12(1), 685. https://doi.org/10.1038/s41597-025-04976-z_
# Carl Philipp Emanuel Bach – Works for Keyboard (A corpus of annotated scores)
This corpus of annotated [MuseScore](https://musescore.org) files has been created within
the [DCML corpus initiative](https://github.com/DCMLab/dcml_corpora) and employs
the [DCML harmony annotation standard](https://github.com/DCMLab/standards).
The second surviving son of Johann Sebastian Bach, Carl Philipp Emanuel Bach charted his own course as an innovative
composer in the "Empfindsamer Stil" (Sentimental Style) on the cusp of Baroque and Classical practice, and for a time,
his fame surpassed his father's. Emanuel Bach's style is characterized by rapid, urgent, and often shocking
juxtapositions of mood within a single movement; it is not hard to see why this music held a particular influence on a
young Ludwig van Beethoven. This repository reflects a selection both of longer sonatas and rondos (including both
single-movement and multi-movement sonatas) and of freeform Fantasias in order to reflect a cross-section of this
composer's unique practice.
Wq. 50 is a didactic group of "Sonaten mit veränderten Reprisen" (Sonatas with Varied Reprises) intended to instruct
the performer in the proper method of ornamenting a repeated section. Wq. 55 through 57 come from Bach's "Kenner und
Liebhaber" (Connoisseurs and Amateurs) series, whose wide circulation Bach supervised himself, and whose title is
somewhat ironic given the virtuosity on showcase in these works. The remaining pieces in this repository are a
selection of Free Fantasias, all of which are found in volumes that combine keyboard works in a variety of genres,
such as Wq. 112, "Clavierstücke verschiedener Art" (Piano Pieces of Various Kinds). These Fantasias -- which, as
their name implies, are not bound by formal conventions -- are themselves divided between concise etude-like
miniatures like Wq. 113/3 and extended unmeasured soliloquies like Wq. 117/13.
These scores were typeset especially for this project by Anna Yuferova following the critical editions from the
Packard Institute, with the exception of Wq. 117/12 and 55/4, which were downloaded from the MuseScore catalogue.
## Getting the data
* download repository as a [ZIP file](https://github.com/DCMLab/cpe_bach_keyboard/archive/main.zip)
* download a [Frictionless Datapackage](https://specs.frictionlessdata.io/data-package/) that includes concatenations
of the TSV files in the four folders (`measures`, `notes`, `chords`, and `harmonies`) and a JSON descriptor:
* [cpe_bach_keyboard.zip](https://github.com/DCMLab/cpe_bach_keyboard/releases/latest/download/cpe_bach_keyboard.zip)
* [cpe_bach_keyboard.datapackage.json](https://github.com/DCMLab/cpe_bach_keyboard/releases/latest/download/cpe_bach_keyboard.datapackage.json)
* clone the repo: `git clone https://github.com/DCMLab/cpe_bach_keyboard.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 first movement of the *Sonata in F Major*, Wq.50/1, has the following files:
* `MS3/wq50n01a.mscx`: Uncompressed MuseScore 3.6.2 file including the music and annotation labels.
* `notes/wq50n01a.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/wq50n01a.measures.tsv`: A table with relevant information about the measures in the score.
* `chords/wq50n01a.chords.tsv`: A table containing layer-wise unique onset positions with the musical markup (such as dynamics, articulation, lyrics, figured bass, etc.).
* `harmonies/wq50n01a.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](https://specs.frictionlessdata.io/tabular-data-resource/),
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](https://musescore.org). Please note that the scores have been edited, annotated and tested with
[MuseScore 3.6.2](https://github.com/musescore/MuseScore/releases/tag/v3.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](https://www.libreoffice.org/download/download/). 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 or later) you'll be able to load any TSV like this:
```python
import ms3
labels = ms3.load_tsv("harmonies/wq50n01a.harmonies.tsv")
notes = ms3.load_tsv("notes/wq50n01a.notes.tsv")
```
## Version history
See the [GitHub releases](https://github.com/DCMLab/cpe_bach_keyboard/releases).
## Questions, Suggestions, Corrections, Bug Reports
Please [create an issue](https://github.com/DCMLab/cpe_bach_keyboard/issues) and/or feel free to fork and submit pull requests.
## Cite as
> Hentschel, J., Rammos, Y., Neuwirth, M., & Rohrmeier, M. (2025). A corpus and a modular infrastructure for the empirical study of (an)notated music. Scientific Data, 12(1), 685. https://doi.org/10.1038/s41597-025-04976-z
## License
Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License ([CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)).3 files changed
+149
-17
lines changed| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
6 | | - | |
7 | | - | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
8 | 8 | | |
9 | 9 | | |
10 | | - | |
11 | | - | |
12 | | - | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
13 | 13 | | |
14 | 14 | | |
15 | | - | |
16 | | - | |
17 | | - | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
18 | 18 | | |
19 | 19 | | |
20 | | - | |
21 | | - | |
22 | | - | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
23 | 23 | | |
24 | 24 | | |
25 | | - | |
| 25 | + | |
26 | 26 | | |
27 | | - | |
| 27 | + | |
28 | 28 | | |
29 | 29 | | |
30 | | - | |
| 30 | + | |
31 | 31 | | |
32 | | - | |
| 32 | + | |
33 | 33 | | |
34 | 34 | | |
35 | 35 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
12 | 12 | | |
13 | 13 | | |
14 | 14 | | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
15 | 20 | | |
16 | 21 | | |
17 | 22 | | |
| |||
105 | 110 | | |
106 | 111 | | |
107 | 112 | | |
108 | | - | |
| 113 | + | |
109 | 114 | | |
110 | 115 | | |
111 | 116 | | |
| |||
0 commit comments