File size: 4,455 Bytes
89b68d9 5e790d5 b150edb 5e790d5 89b68d9 ce47774 89b68d9 404733b 89b68d9 ce47774 404733b 89b68d9 404733b 89b68d9 404733b 89b68d9 6eb3e80 89b68d9 6eb3e80 89b68d9 5e790d5 |
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 |
---
license: apache-2.0
tags:
- miditok
- music
- music generation
- piano
- classical
---
# Model card
<!-- Provide a quick summary of what the model is/does. -->
This is a generative model from the paper "*Byte Pair Encoding for Symbolic Music*" (EMNLP 2023). The model has been trained with Byte Pair Encoding (BPE) on the [Maestro dataset](https://magenta.tensorflow.org/datasets/maestro) to generate classical piano music with the TSD tokenizer.
## Model Details
### Model Description
<!-- Provide a longer summary of what this model is. -->
It has a vocabulary of 20k tokens learned with [Byte Pair Encoding (BPE)](https://arxiv.org/abs/2301.11975) using [MidiTok](https://github.com/Natooz/MidiTok).
- **Developed and shared by:** [Nathan Fradet](https://twitter.com/NathanFradet)
- **Affiliations**: [Sorbonne University (LIP6 lab)](https://www.sorbonne-universite.fr/en) and [Aubay](https://aubay.com/en/)
- **Model type:** causal autoregressive Transformer
- **Backbone model:** [GPT2](https://huggingface.co/docs/transformers/model_doc/gpt2)
- **Music genres:** Classical piano 🎹
- **License:** Apache 2.0
### Model Sources
<!-- Provide the basic links for the model. -->
- **Repository:** https://github.com/Natooz/BPE-Symbolic-Music
- **Paper:** https://arxiv.org/abs/2301.11975
## Uses
The model is designed for autoregressive music generation. It generates the continuation of a music prompt.
## How to Get Started with the Model
Use the code below to get started with the model.
You will need the `miditok` (>=v2.1.7), `transformers` and `torch` packages to make it run, that can be installed with pip.
```Python
import torch
from transformers import AutoModelForCausalLM
from miditok import TSD
from symusic import Score
torch.set_default_device("cuda")
model = AutoModelForCausalLM.from_pretrained("Natooz/Maestro-TSD-bpe20k", trust_remote_code=True, torch_dtype="auto")
tokenizer = TSD.from_pretrained("Natooz/Maestro-TSD-bpe20k")
input_midi = Score("path/to/file.mid")
input_tokens = tokenizer(input_midi)
generated_token_ids = model.generate(input_tokens.ids, max_length=500)
generated_midi = tokenizer(generated_token_ids)
generated_midi.dump_midi("path/to/continued.mid")
```
## Training Details
### Training Data
<!-- This should link to a Data Card, perhaps with a short stub of information on what the training data is all about as well as documentation related to data pre-processing or additional filtering. -->
The model has been trained on the [Maestro](https://magenta.tensorflow.org/datasets/maestro) dataset. The dataset contains about 200 hours of classical piano music. The tokenizer is trained with Byte Pair Encoding (BPE) to build a vocabulary of 20k tokens.
### Training Procedure
<!-- This relates heavily to the Technical Specifications. Content here should link to that section when it is relevant to the training procedure. -->
- **Training regime:** fp16 mixed precision on V100 PCIE 32GB GPUs
- **Compute Region:** France
### Training hyperparameters
The following hyperparameters were used during training:
- learning_rate: 0.0001
- train_batch_size: 64
- eval_batch_size: 96
- seed: 444
- optimizer: Adam with betas=(0.9,0.999) and epsilon=1e-08
- lr_scheduler_type: cosine_with_restarts
- lr_scheduler_warmup_ratio: 0.3
- training_steps: 100000
### Environmental impact
We cannot estimate reliably the amount of CO2eq emitted, as we lack data on the exact power source used during training. However, we can highlight that the cluster used is mostly powered by nuclear energy, which is a low carbon energy source ensuring a reduced direct environmental impact.
## Citation
<!-- If there is a paper or blog post introducing the model, the APA and Bibtex information for that should go in this section. -->
**BibTeX:**
```bibtex
@inproceedings{bpe-symbolic-music,
title = "Byte Pair Encoding for Symbolic Music",
author = "Fradet, Nathan and
Gutowski, Nicolas and
Chhel, Fabien and
Briot, Jean-Pierre",
editor = "Bouamor, Houda and
Pino, Juan and
Bali, Kalika",
booktitle = "Proceedings of the 2023 Conference on Empirical Methods in Natural Language Processing",
month = dec,
year = "2023",
address = "Singapore",
publisher = "Association for Computational Linguistics",
url = "https://aclanthology.org/2023.emnlp-main.123",
doi = "10.18653/v1/2023.emnlp-main.123",
pages = "2001--2020",
}
``` |