Metadata-Version: 2.1
Name: pitchplots
Version: 1.4.2
Summary: A package containing representation tools for musical purposes
Home-page: https://github.com/DCMLab/pitchplots
Author: Fabian Moss
Author-email: fabian.moss@epfl.ch
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: matplotlib (>=3.0.1)
Requires-Dist: pandas (>=0.23.4)
Requires-Dist: numpy (>=1.15.3)

# pitchplots

library plotting charts for different tonal representations

## Getting Started

The program consist in the following files: functions.py, reader.py, modified_musicxml_parser.py, parser.py and static.py 

### Prerequisites

What things you need to install the software and how to install them

```
You will need python on your computer and the following libaries: matplotlib, pandas and numpy
```

note that if you are using anaconda, these libraries are already installed

### Installing

You can download the pitchplots package on pypi with pip using the following command in the prompt:

```
python3 -m pip install pitchplots
```

or if you're using anaconda prompt

```
pip install pitchplots
```

## Running the tests

you can first try to parse xml/musicScore xml files to csv or DataFrame, that is the GymnopÃ©die from Sati with:

```python
import pitchplots.parser as ppp

# If no filepath is specified, will automatically charge data_example.mxl
df_data_example = ppp.xml_to_csv(save_csv=True)
```

then you can try the static module by passing csv files or Dataframe:

```
import pitchplots.static as pps

pps.tonnetz(df_data_example)
```
or
```
import pitchplots.static as pps

pps.circle('csv/data_example.csv')
```

to try the dynamic videos:
```
import pitchplots.dynamic as ppd

ppd.tonnetz_animation(df_data_example)
```

## Authors

* **Timothy Loayza**, **Fabian Moss**

## Use of magenta's code

The [modified_musicxml_parser.py](modified_musicxml_parser.py) file is taken from the [magenta](https://github.com/tensorflow/magenta) project and has been modified. Therefore the modifications are listed in the [magenta_musicxml_code_modifications.md](magenta_musicxml_code_modifications.md) file and there is the [magenta_LICENSE.md](magenta_LICENSE.md).

## License

This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details


