Updated paradata (#8)

johentsch · web-flow · commit 750953b9e793 · 2025-04-27T21:25:16.000+02:00
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/schumann_liederkreis](https://github.com/DCMLab/schumann_liederkreis) and the corresponding * documentation page [https://dcmlab.github.io/schumann_liederkreis](https://dcmlab.github.io/schumann_liederkreis) For information on how to obtain and use the dataset, please refer to [this documentation page](https://dcmlab.github.io/schumann_liederkreis/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_ # Robert Schumann – Liederkreis (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). Robert Schumann's op. 39 Liederkreis is one of two works bearing that same title, both of which Schumann wrote during his 1840 "Liederjahr" (Year of Song); incidentally, 1840 was the same year of Schumann's marriage to Clara Wieck. Other vocal works from Schumann's "Liederjahr" include the famous Dichterliebe and Frauenliebe und Leben. Incidentally, these works are Schumann's first published works not for solo piano, his only known chamber work prior to 1840 being the posthumously published C minor Piano Quartet of 1829. It was, in fact, Clara who encouraged Robert to branch out beyond solo-piano genres, and the height of emotion showcased in these 1840 songs speaks to a primed sensitivity already latent in Robert's practice. Op. 39, the "Eichendorff Liederkreis," sets excerpts from Joseph von Eichendorff's collection Intermezzo. Unlike most other song cycles in Schumann's oeuvre, these poems do not directly convey a narrative, instead portraying a series of landscapes and nature images shot through with intense and abrupt emotional outbursts. Schumann's piano writing is tightly conjoined with melodic figuration, showcasing a logical early extension of his solo-piano technique in a vocal context. Our annotations reveal the harmonic framework that supports the rich polyphonic details present in this voice-and-piano texture. ## Getting the data * download repository as a [ZIP file](https://github.com/DCMLab/schumann_liederkreis/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: * [schumann_liederkreis.zip](https://github.com/DCMLab/schumann_liederkreis/releases/latest/download/schumann_liederkreis.zip) * [schumann_liederkreis.datapackage.json](https://github.com/DCMLab/schumann_liederkreis/releases/latest/download/schumann_liederkreis.datapackage.json) * clone the repo: `git clone https://github.com/DCMLab/schumann_liederkreis.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 song, *In der Fremde*, has the following files: * `MS3/op39n01.mscx`: Uncompressed MuseScore 3.6.2 file including the music and annotation labels. * `notes/op39n01.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/op39n01.measures.tsv`: A table with relevant information about the measures in the score. * `chords/op39n01.chords.tsv`: A table containing layer-wise unique onset positions with the musical markup (such as dynamics, articulation, lyrics, figured bass, etc.). * `harmonies/op39n01.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/op39n01.harmonies.tsv") notes = ms3.load_tsv("notes/op39n01.notes.tsv") ``` ## Version history See the [GitHub releases](https://github.com/DCMLab/schumann_liederkreis/releases). ## Questions, Suggestions, Corrections, Bug Reports Please [create an issue](https://github.com/DCMLab/schumann_liederkreis/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/)).
diff --git a/.zenodo.json b/.zenodo.json
@@ -2,27 +2,27 @@
     "license": "CC-BY-NC-SA-4.0",
     "contributors": [
         {
-            "type": "DataCollector",
-            "name": "Adrian Nagel"
+            "name": "Nagel, Adrian",
+            "type": "Annotator"
         },
         {
-            "type": "DataCollector",
-            "name": "Uli Kneisel"
+            "name": "Kneisel, Uli",
+            "type": "Annotator"
         },
         {
-            "orcid": "0000-0002-6329-7492",
+            "name": "Brey, Amelia",
             "type": "DataCurator",
-            "name": "Amelia Brey"
+            "orcid": "0000-0002-6329-7492"
         },
         {
-            "orcid": "0000-0002-2105-525X",
+            "name": "Becker, Hanné",
             "type": "DataCurator",
-            "name": "Hanné Becker"
+            "orcid": "0000-0002-2105-525X"
         },
         {
-            "orcid": "0000-0002-1986-9545",
+            "name": "Hentschel, Johannes",
             "type": "DataCurator",
-            "name": "Johannes Hentschel"
+            "orcid": "0000-0002-1986-9545"
         }
     ],
     "title": "Robert Schumann – Liederkreis (A corpus of annotated scores)",
diff --git a/CITATION.cff b/CITATION.cff
@@ -0,0 +1,127 @@
+cff-version: 1.2.0
+title: 'Robert Schumann – Liederkreis (A corpus of annotated scores)'
+message: >-
+  Please cite this dataset using the metadata from
+  'preferred-citation'.
+type: dataset
+authors:
+  - given-names: Johannes
+    family-names: Hentschel
+    email: johannes.hentschel@bruckneruni.at
+    affiliation: Anton Bruckner University Linz
+    orcid: 'https://orcid.org/0000-0002-1986-9545'
+  - given-names: Yannis
+    family-names: Rammos
+    email: yannis.rammos@epfl.ch
+    affiliation: École Polytechnique Fédérale de Lausanne
+    orcid: 'https://orcid.org/0000-0003-1455-5990'
+  - given-names: Markus
+    family-names: Neuwirth
+    email: markus.neuwirth@bruckneruni.at
+    affiliation: Anton Bruckner University Linz
+    orcid: 'https://orcid.org/0000-0003-1990-052X'
+  - given-names: Martin
+    family-names: Rohrmeier
+    email: martin.rohrmeier@epfl.ch
+    affiliation: École Polytechnique Fédérale de Lausanne
+    orcid: 'https://orcid.org/0000-0002-4323-7257'
+identifiers:
+  - type: doi
+    value: 10.5281/zenodo.14997104
+  - type: url
+    value: 'https://zenodo.org/doi/10.5281/zenodo.14997104'
+url: 'https://zenodo.org/doi/10.5281/zenodo.14997104'
+doi: 10.5281/zenodo.14997104
+repository: 'https://github.com/DCMLab/schumann_liederkreis'
+abstract: >-
+  <jats:p>This corpus of annotated MuseScore files has been
+  created within the DCML corpus initiative and employs the
+  DCML harmony annotation standard. It is one out of ~40
+  similar corpora that have been grouped together to the
+  "Distant Listening Corpus" which comes with the data
+  report "A corpus and a modular infrastructure for the
+  empirical study of (an)notated music":
+  https://doi.org/10.1038/s41597-025-04976-z</jats:p>
+keywords:
+  - expert-annotated dataset
+  - tonal harmony
+  - music research
+  - music theory
+  - music analysis
+  - music history
+  - computational musicology
+  - corpus studies
+  - corpora
+  - symbolic dataset
+  - scores
+  - annotated dataset
+  - harmony
+  - key annotations
+  - chord annotations
+  - phrase annotations
+  - cadence annotations
+  - common practice
+  - research data management
+license: CC-BY-NC-4.0
+version: v2.4
+date-released: '2025-03-15'
+preferred-citation:
+  authors:
+    - given-names: Johannes
+      family-names: Hentschel
+      email: johannes.hentschel@bruckneruni.at
+      affiliation: Anton Bruckner University Linz
+      orcid: 'https://orcid.org/0000-0002-1986-9545'
+    - given-names: Yannis
+      family-names: Rammos
+      email: yannis.rammos@epfl.ch
+      affiliation: École Polytechnique Fédérale de Lausanne
+      orcid: 'https://orcid.org/0000-0003-1455-5990'
+    - given-names: Markus
+      family-names: Neuwirth
+      email: markus.neuwirth@bruckneruni.at
+      affiliation: Anton Bruckner University Linz
+      orcid: 'https://orcid.org/0000-0003-1990-052X'
+    - given-names: Martin
+      family-names: Rohrmeier
+      email: martin.rohrmeier@epfl.ch
+      affiliation: École Polytechnique Fédérale de Lausanne
+      orcid: 'https://orcid.org/0000-0002-4323-7257'
+  title: >-
+    A corpus and a modular infrastructure for the empirical study of (an)notated
+    music
+  doi: 10.1038/s41597-025-04976-z
+  url: 'https://doi.org/10.1038/s41597-025-04976-z'
+  identifiers:
+    - type: doi
+      value: 10.1038/s41597-025-04976-z
+    - type: url
+      value: 'https://doi.org/10.1038/s41597-025-04976-z'
+    - type: other
+      value: 'urn:issn:2052-4463'
+  type: article
+  journal: Scientific Data
+  issn: 2052-4463
+  publisher:
+    name: Springer Nature
+  volume: 12
+  issue: 1
+  year: 2025
+  month: 4
+  start: 685
+  abstract: >-
+    <jats:p>The present corpus is the outcome of a long-term collaborative effort 
+    to produce analytically annotated music scores suitable for the
+    computer-assisted study of European compositions since 1600. With 1283
+    analytically annotated, symbolically encoded music scores by 36 composers,
+    our corpus amounts to one of the largest published resources of its kind. At
+    the same time, it provides a modular digital infrastructure for the
+    accountable, collaborative curation of annotated scores (“sheet music”). All
+    annotations were created and reviewed by a team of trained music theorists,
+    who collaborated online using the git version control software according to
+    a formally codified workflow. To improve the consistency of analytical
+    practices given the diversity of represented eras and genres, the corpus has
+    been automatically parsed for notational well-formedness and cross-reviewed
+    by annotators for adherence to our music-analytical guidelines. The
+    computational infrastructure has been designed with “data persistence” and
+    open access in mind.</jats:p>
diff --git a/README.md b/README.md
@@ -12,6 +12,11 @@ and serves as welcome page for both
 
 For information on how to obtain and use the dataset, please refer to [this documentation page](https://dcmlab.github.io/schumann_liederkreis/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_
+
 # Robert Schumann – Liederkreis (A corpus of annotated scores)
 
 This corpus of annotated [MuseScore](https://musescore.org) files has been created within  
@@ -101,7 +106,7 @@ Please [create an issue](https://github.com/DCMLab/schumann_liederkreis/issues)
 
 ## Cite as
 
-> Johannes Hentschel, Yannis Rammos, Markus Neuwirth, & Martin Rohrmeier. (2025). Robert Schumann – Liederkreis (A corpus of annotated scores) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.14997104
+> 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
 
