TomRB22 commited on
Commit
65a5c7f
1 Parent(s): 6702bb9

Added sources

Browse files
Files changed (1) hide show
  1. README.md +9 -6
README.md CHANGED
@@ -27,13 +27,16 @@ By the use of the aforementioned autoencoder, it allows the user to encode piano
27
  - **Model type:** Variational autoencoder
28
  - **License:** MIT
29
 
30
- ### Model Sources [optional]
31
 
32
  <!-- Provide the basic links for the model. -->
33
 
34
- - **Repository:** [More Information Needed]
35
- - **Paper [optional]:** [More Information Needed]
36
- - **Demo [optional]:** [More Information Needed]
 
 
 
37
 
38
  ## Uses
39
  <!-- MENTION COLAB HERE -->
@@ -45,7 +48,7 @@ By the use of the aforementioned autoencoder, it allows the user to encode piano
45
 
46
  <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
47
 
48
- If you prefered directly using or testing the model without the need to install it, you can use the following colab notebook and follow its instructions. Moreover, this serves as an example of use.
49
  [colab link]
50
 
51
  [More Information Needed]
@@ -98,7 +101,7 @@ The first one will clone the repository. Then, fluidsynth, a real-time MIDI synt
98
 
99
  ## Training Details
100
 
101
- Pivaenist was trained on the [MAESTRO v2.0.0 dataset](https://magenta.tensorflow.org/datasets/maestro){:target="_blank"}, which contains 1282 midi files [check it in colab]. Their preprocessing involves splitting each note in pitch, duration and step, which compose a column of a 3xN matrix (which we call song map), where N is the number of notes and a row represents sequentially the different pitches, durations and steps. The VAE's objective is to reconstruct these matrices, making it then possible to generate random maps by sampling from the distribution, and then convert them to a MIDI file.
102
 
103
  ### Training Data
104
 
 
27
  - **Model type:** Variational autoencoder
28
  - **License:** MIT
29
 
30
+ ### Sources
31
 
32
  <!-- Provide the basic links for the model. -->
33
 
34
+ - **Code:** Some of the code of this repository includes modifications (not the entire code, due to the differences in the architecture) from the following sites:
35
+ 1. [Tensorflow tutorial where pretty-midi is used](https://www.tensorflow.org/tutorials/audio/music_generation)
36
+ 2. [VAE explanation and code](https://towardsdatascience.com/vae-with-tensorflow-6-ways-9c689cb76829)
37
+ 3. [Microsoft article on the KL training schedule which was applied in this model](https://www.microsoft.com/en-us/research/blog/less-pain-more-gain-a-simple-method-for-vae-training-with-less-of-that-kl-vanishing-agony/)
38
+
39
+ There might be acknowledgments missing. If you find some other resemblance to a site's code, please notify me and I will make sure of including it.
40
 
41
  ## Uses
42
  <!-- MENTION COLAB HERE -->
 
48
 
49
  <!-- This section is for the model use without fine-tuning or plugging into a larger ecosystem/app. -->
50
 
51
+ If you preferred directly using or testing the model without the need to install it, you can use the following colab notebook and follow its instructions. Moreover, this serves as an example of use.
52
  [colab link]
53
 
54
  [More Information Needed]
 
101
 
102
  ## Training Details
103
 
104
+ Pivaenist was trained on the [MAESTRO v2.0.0 dataset](https://magenta.tensorflow.org/datasets/maestro), which contains 1282 midi files [check it in colab]. Their preprocessing involves splitting each note in pitch, duration and step, which compose a column of a 3xN matrix (which we call song map), where N is the number of notes and a row represents sequentially the different pitches, durations and steps. The VAE's objective is to reconstruct these matrices, making it then possible to generate random maps by sampling from the distribution, and then convert them to a MIDI file.
105
 
106
  ### Training Data
107