tiralabra-shakugenerator

Specifications

Week 1 Report

Week 2 Report

Week 3 Report

Week 4 Report

Week 5 Report

Week 6 Report

User Guide

Install dependencies with poetry:

poetry install

Use invoke rule to run program by command:

poetry run invoke start

Detailed user guide

Testing

Run unit tests with:

poetry run invoke test

Generate a html coverage report by:

poetry run invoke coverage-report

Coverage report will be generate in html format to the folder "htmlcov" located under project root.

Run lint by:

poetry run invoke lint

Details on tests

The future of the application

This application has been developed as part of a university course in the University of Helsinki. In the scope of the course, the interactive usage of the application via terminal was developed, but the application is planned to be used as a plugin for the ShakuNotator (shakuhachi sheet music notation application), also developed as university coursework, but also under continuous development after the course - for personal use. The purpose of this application (beyond coursework) is to aid musical composition for shakuhachi. As such, non-interactive usage of the program is to be developed, so as to add it as a plugin to the ShakuNotator, which will handle user interactions with the functionality of this program. The planned use is to generate one or a few measures at a time, and manually review and edit them to be more musically pleasing. Such usage will potentially improve the musical productivity of the user, providing them with melodies corresponding to the shakuhachi style of music, with some added randomness for creative sound. Markov tree musical creation is by far not able to create professional sounding, enjoyable music, but this is why this application is meant to be manually reviewed and edited by the composer, and the application is meant to be used iteratively to generate short parts of the composed music. Future versions will also include features which will verify the output against pre-existing parts of the composition when generating multi-part music, to comply with some regular harmonics of shakuhachi music. What is left to the user is - ideally - the core part of the musical work - concentrating on tweaking the music so as to allow them to reach their desired musical expression.