wayne391 / lead-sheet-dataset

:headphones: lead sheet datasets in various formats

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Lead-Sheet-Dataset

The collection of lead sheets in three different formats.

Latest Update:

  • Codes: 2018/10/21
  • Sample Dataset: 2018/8/1

Source: Link (4.9 G).
MIDI: Link (11 MB)

The following diagram illustrates the process and available formats: image

The source of the current dataset is from Theorytab. However, under this framework, users can easily extend this dataset by incorporating other resources. All utilities and resources are only for academic purposes.

Formats for Symbolic Domain Analysis

In symbolic domain researches, there are two common formats to represent music: events and pinorolls.

  • Event
    a list of event tuples
    (tag, event_on, event_off) or (tag, event_on, duration)

  • Pianoroll
    a tensor whose size is timesteps x pitches

In event-based works, when analyzing 'chords', there are two common approaches: Roman Analysis (roman) or Chord Names and Symbols (symbol). The former one is usually used for music theorists or students to analyze the harmony of pieces, and the latter one is frequently used in pop music. Fortunately, Theorytab has abundant chord notations in roman, so applying some transformationa, we can get two different notatinos for further researches.

The pianorolls and corresponding midi files are rendered afterwards. When transforming notations into scores, the voicing or the arrangement is also an art. Here, I only adopt some simple polices (ex: omit 5 in 9-th chords). Users can get desired resultsby comstomized the functions.

In summary, there are two major folers:

  • event

    • 'roman_key': roman, original key
    • 'roman_nokey': roman, C key
    • 'symbol_key': symbol, original key
    • 'symbol_nokey': symbol, C key
  • pianoroll

    • key: original key (with midi)
    • no key: C key (with midi)
    • The .npz file and the figure are all from 'no key'.
      The beat resolution is 24 for all pianorolls.

Sample Pianoroll: image


Citation

@article{ahu61,
   author={Yin-Cheng Yeh, Wen-Yi Hsiao, Satoru Fukayama, Tetsuro Kitahara, Benjamin Genchel, Hao-Min Liu, Hao-Wen Dong, Yian Chen, Terence Leong, and Yi-Hsuan Yang, },
   title={Automatic melody harmonization with triad chords: A comparative study},
   journal={Journal of New Music Research (JNMR)},
   volume={50},
   number={1},
   year={2021},
   pages={37-51}
}

How to Create the Dataset

cd lead_sheet_dataset/src
python theorytab_crawler.py
python main.py

The generated data will be placed at 'datasets' folder. For sanity check, you can refer to notebooks to test every individual file.

  • 4956 artists
  • 11380 songs
  • 18843 succesfully parsed files in 18986 sections

How to Incorporate Other Resources

Current accessible resources of lead sheets are almost in symbol format. Users can use 'to_pianoroll.py' to do the conversion. Please be sure the format is identical.

About

:headphones: lead sheet datasets in various formats


Languages

Language:Jupyter Notebook 71.0%Language:Python 29.0%