j_s_gan / README.md
Egorp's picture
Update README.md
a6f23b9
|
raw
history blame
1.74 kB
# Experimental GAN for Bach-like Textures
## Description
This repository contains an experimental Generative Adversarial Network (GAN) model designed to generate Bach-like textures. The model is based on the Aligned Bach Chorales Dataset, available at [this link](https://github.com/measure-map/aligned_bach_chorales).
## License
This project is licensed under the MIT License.
## Model Overview
The GAN consists of two parts: a generator and a discriminator. Both models were trained on the Aligned Bach Chorales Dataset, which represents Bach chorales in a binary matrix format.
## Installation and Requirements
To use this model, you need to have PyTorch version 2.1.0+cu121 installed. You can install PyTorch by following the instructions on the [official website](https://pytorch.org/get-started/locally/).
## Usage
1. **Clone the Repository**:
```
git clone [repository URL]
```
2. **Load the Models**:
- Use `torch.load()` to load the provided state dictionaries for both the generator and the discriminator.
3. **Convert Binary Matrices to MIDI**:
- Utilize the `binary_to_midi` notebook included in this repository to convert the binary matrices generated by the GAN into MIDI format.
## Dataset
The dataset used for training this model can be found in the folder named "np_convert". This folder contains binary representations of Bach chorales.
## Contributing
Contributions to this project are welcome. Please feel free to submit issues and pull requests.
## Contact
For any queries or discussions regarding this project, please open an issue in this repository.
## Acknowledgements
Special thanks to the creators and maintainers of the Aligned Bach Chorales Dataset for providing the data used to train this model.