<br />

- **Description**:

The Groove MIDI Dataset (GMD) is composed of 13.6 hours of aligned MIDI and
(synthesized) audio of human-performed, tempo-aligned expressive drumming
captured on a Roland TD-11 V-Drum electronic drum kit.

- **Additional Documentation** :
  [Explore on Papers With Code](https://paperswithcode.com/dataset/groove-midi-dataset)

- **Homepage** :
  <https://g.co/magenta/groove-dataset>

- **Source code** :
  [`tfds.datasets.groove.Builder`](https://github.com/tensorflow/datasets/tree/master/tensorflow_datasets/datasets/groove/groove_dataset_builder.py)

- **Versions**:

  - **`2.0.1`** (default): No release notes.
- **Supervised keys** (See
  [`as_supervised` doc](https://www.tensorflow.org/datasets/api_docs/python/tfds/load#args)):
  `None`

- **Figure**
  ([tfds.show_examples](https://www.tensorflow.org/datasets/api_docs/python/tfds/visualization/show_examples)):
  Not supported.

- **Citation**:

    @inproceedings{groove2019,
        Author = {Jon Gillick and Adam Roberts and Jesse Engel and Douglas Eck and David Bamman},
        Title = {Learning to Groove with Inverse Sequence Transformations},
        Booktitle   = {International Conference on Machine Learning (ICML)}
        Year = {2019},
    }

## groove/full-midionly (default config)

- **Config description**: Groove dataset without audio, unsplit.

- **Download size** : `3.11 MiB`

- **Dataset size** : `5.22 MiB`

- **Auto-cached**
  ([documentation](https://www.tensorflow.org/datasets/performances#auto-caching)):
  Yes

- **Splits**:

| Split | Examples |
|---|---|
| `'test'` | 129 |
| `'train'` | 897 |
| `'validation'` | 124 |

- **Feature structure**:

    FeaturesDict({
        'bpm': int32,
        'drummer': ClassLabel(shape=(), dtype=int64, num_classes=10),
        'id': string,
        'midi': string,
        'style': FeaturesDict({
            'primary': ClassLabel(shape=(), dtype=int64, num_classes=18),
            'secondary': string,
        }),
        'time_signature': ClassLabel(shape=(), dtype=int64, num_classes=5),
        'type': ClassLabel(shape=(), dtype=int64, num_classes=2),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| bpm | Tensor |   | int32 |   |
| drummer | ClassLabel |   | int64 |   |
| id | Tensor |   | string |   |
| midi | Tensor |   | string |   |
| style | FeaturesDict |   |   |   |
| style/primary | ClassLabel |   | int64 |   |
| style/secondary | Tensor |   | string |   |
| time_signature | ClassLabel |   | int64 |   |
| type | ClassLabel |   | int64 |   |

- **Examples** ([tfds.as_dataframe](https://www.tensorflow.org/datasets/api_docs/python/tfds/as_dataframe)):

<iframe src="https:///frame/datasets/catalog/groove_9a6bcff9fef8ef1ff84e99e67ccf2976ca1f152abc5844d22d841b068246dfa9.frame" class="framebox inherit-locale " allow="clipboard-write https://" allowfullscreen is-upgraded></iframe>

## groove/full-16000hz

- **Config description**: Groove dataset with audio, unsplit.

- **Download size** : `4.76 GiB`

- **Dataset size** : `2.33 GiB`

- **Auto-cached**
  ([documentation](https://www.tensorflow.org/datasets/performances#auto-caching)):
  No

- **Splits**:

| Split | Examples |
|---|---|
| `'test'` | 124 |
| `'train'` | 846 |
| `'validation'` | 120 |

- **Feature structure**:

    FeaturesDict({
        'audio': Audio(shape=(None,), dtype=float32),
        'bpm': int32,
        'drummer': ClassLabel(shape=(), dtype=int64, num_classes=10),
        'id': string,
        'midi': string,
        'style': FeaturesDict({
            'primary': ClassLabel(shape=(), dtype=int64, num_classes=18),
            'secondary': string,
        }),
        'time_signature': ClassLabel(shape=(), dtype=int64, num_classes=5),
        'type': ClassLabel(shape=(), dtype=int64, num_classes=2),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| audio | Audio | (None,) | float32 |   |
| bpm | Tensor |   | int32 |   |
| drummer | ClassLabel |   | int64 |   |
| id | Tensor |   | string |   |
| midi | Tensor |   | string |   |
| style | FeaturesDict |   |   |   |
| style/primary | ClassLabel |   | int64 |   |
| style/secondary | Tensor |   | string |   |
| time_signature | ClassLabel |   | int64 |   |
| type | ClassLabel |   | int64 |   |

- **Examples** ([tfds.as_dataframe](https://www.tensorflow.org/datasets/api_docs/python/tfds/as_dataframe)):

<iframe src="https:///frame/datasets/catalog/groove_0fb53b0c92a6733d085b6954b2c994bbce2dc94917deab3c93bd078ae711672e.frame" class="framebox inherit-locale " allow="clipboard-write https://" allowfullscreen is-upgraded></iframe>

## groove/2bar-midionly

- **Config description**: Groove dataset without audio, split into 2-bar
  chunks.

- **Download size** : `3.11 MiB`

- **Dataset size** : `19.59 MiB`

- **Auto-cached**
  ([documentation](https://www.tensorflow.org/datasets/performances#auto-caching)):
  Yes

- **Splits**:

| Split | Examples |
|---|---|
| `'test'` | 2,204 |
| `'train'` | 18,163 |
| `'validation'` | 2,252 |

- **Feature structure**:

    FeaturesDict({
        'bpm': int32,
        'drummer': ClassLabel(shape=(), dtype=int64, num_classes=10),
        'id': string,
        'midi': string,
        'style': FeaturesDict({
            'primary': ClassLabel(shape=(), dtype=int64, num_classes=18),
            'secondary': string,
        }),
        'time_signature': ClassLabel(shape=(), dtype=int64, num_classes=5),
        'type': ClassLabel(shape=(), dtype=int64, num_classes=2),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| bpm | Tensor |   | int32 |   |
| drummer | ClassLabel |   | int64 |   |
| id | Tensor |   | string |   |
| midi | Tensor |   | string |   |
| style | FeaturesDict |   |   |   |
| style/primary | ClassLabel |   | int64 |   |
| style/secondary | Tensor |   | string |   |
| time_signature | ClassLabel |   | int64 |   |
| type | ClassLabel |   | int64 |   |

- **Examples** ([tfds.as_dataframe](https://www.tensorflow.org/datasets/api_docs/python/tfds/as_dataframe)):

<iframe src="https:///frame/datasets/catalog/groove_3a26f8654ccec17fee071255806efce4d0956f0e9f5fa6ed1ef158162804e8a6.frame" class="framebox inherit-locale " allow="clipboard-write https://" allowfullscreen is-upgraded></iframe>

## groove/2bar-16000hz

- **Config description**: Groove dataset with audio, split into 2-bar chunks.

- **Download size** : `4.76 GiB`

- **Dataset size** : `4.61 GiB`

- **Auto-cached**
  ([documentation](https://www.tensorflow.org/datasets/performances#auto-caching)):
  No

- **Splits**:

| Split | Examples |
|---|---|
| `'test'` | 1,873 |
| `'train'` | 14,390 |
| `'validation'` | 2,034 |

- **Feature structure**:

    FeaturesDict({
        'audio': Audio(shape=(None,), dtype=float32),
        'bpm': int32,
        'drummer': ClassLabel(shape=(), dtype=int64, num_classes=10),
        'id': string,
        'midi': string,
        'style': FeaturesDict({
            'primary': ClassLabel(shape=(), dtype=int64, num_classes=18),
            'secondary': string,
        }),
        'time_signature': ClassLabel(shape=(), dtype=int64, num_classes=5),
        'type': ClassLabel(shape=(), dtype=int64, num_classes=2),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| audio | Audio | (None,) | float32 |   |
| bpm | Tensor |   | int32 |   |
| drummer | ClassLabel |   | int64 |   |
| id | Tensor |   | string |   |
| midi | Tensor |   | string |   |
| style | FeaturesDict |   |   |   |
| style/primary | ClassLabel |   | int64 |   |
| style/secondary | Tensor |   | string |   |
| time_signature | ClassLabel |   | int64 |   |
| type | ClassLabel |   | int64 |   |

- **Examples** ([tfds.as_dataframe](https://www.tensorflow.org/datasets/api_docs/python/tfds/as_dataframe)):

<iframe src="https:///frame/datasets/catalog/groove_b4ce036310d48fe39c5e42edfba389436948adff50b91029a347523fb70511b2.frame" class="framebox inherit-locale " allow="clipboard-write https://" allowfullscreen is-upgraded></iframe>

## groove/4bar-midionly

- **Config description**: Groove dataset without audio, split into 4-bar
  chunks.

- **Download size** : `3.11 MiB`

- **Dataset size** : `27.32 MiB`

- **Auto-cached**
  ([documentation](https://www.tensorflow.org/datasets/performances#auto-caching)):
  Yes

- **Splits**:

| Split | Examples |
|---|---|
| `'test'` | 2,033 |
| `'train'` | 17,261 |
| `'validation'` | 2,121 |

- **Feature structure**:

    FeaturesDict({
        'bpm': int32,
        'drummer': ClassLabel(shape=(), dtype=int64, num_classes=10),
        'id': string,
        'midi': string,
        'style': FeaturesDict({
            'primary': ClassLabel(shape=(), dtype=int64, num_classes=18),
            'secondary': string,
        }),
        'time_signature': ClassLabel(shape=(), dtype=int64, num_classes=5),
        'type': ClassLabel(shape=(), dtype=int64, num_classes=2),
    })

- **Feature documentation**:

| Feature | Class | Shape | Dtype | Description |
|---|---|---|---|---|
|   | FeaturesDict |   |   |   |
| bpm | Tensor |   | int32 |   |
| drummer | ClassLabel |   | int64 |   |
| id | Tensor |   | string |   |
| midi | Tensor |   | string |   |
| style | FeaturesDict |   |   |   |
| style/primary | ClassLabel |   | int64 |   |
| style/secondary | Tensor |   | string |   |
| time_signature | ClassLabel |   | int64 |   |
| type | ClassLabel |   | int64 |   |

- **Examples** ([tfds.as_dataframe](https://www.tensorflow.org/datasets/api_docs/python/tfds/as_dataframe)):

<iframe src="https:///frame/datasets/catalog/groove_88c3bad0736c7eea57954df5885293d877fbc1ed2d5ac7a66e021d8fd1446eb5.frame" class="framebox inherit-locale " allow="clipboard-write https://" allowfullscreen is-upgraded></iframe>