A package containing representation tools for musical purposes
Project description
pitchplots
library plotting charts for different tonal representations
Getting Started
The program consist in the following files: functions.py, reader.py, modified_music_xml.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 using our test files data_example.mxl, that is the Gymnopédie from Sati with:
import os
import pitchplots
import pitchplots.parser as ppp
example_path = os.path.join(pitchplots.__path__[0], 'data_example.mxl')
df_data_example = ppp.xml_to_csv(example_path, save_csv=True)
then you can try the static module by passing csv files or Dataframe:
import pitchplots.static as pps
pps.hexagonal_chart(df_data_example)
or
import pitchplots.static as pps
pps.hexagonal_chart('data_example.csv')
then to see all the possibilities you can look at the documentation_hexagonal_chart.ipynb for hexagonal_chart information and the documentation_pie_chart.ipynb for pie_chart information.
Authors
- Timothy Loayza, Fabian Moss - Initial work - pitchplots
Use of magenta's code
The modified_musicxml_parser.py file is taken from the magenta project and has been modified. Therefore the modifications are listed in the magenta_musicxml_code_modifications.md file and there is the magenta_LICENSE.md.
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pitchplots-0.0.15-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c0fdd04bf372d5c3fdd9e7219e8dc447b8e135ab0b61cff3ddb6656e1c508443 |
|
MD5 | 0dfc7b8e7d5c9e923d1d03c057eb8304 |
|
BLAKE2b-256 | 616d6372553658d139071dcb78c3d30987d52e9f61745ab9e3990d99d463fad6 |