dodecaphony


Namedodecaphony JSON
Version 0.2.1 PyPI version JSON
download
home_pageNone
SummaryAlgorithmic composition of modern classical music in the twelve-tone technique
upload_time2024-08-06 09:47:34
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords ai_music algorithmic_composition atonality dodecaphony serialism twelve_tone
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            [![Build Status](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml/badge.svg)](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml)
[![codecov](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony/branch/master/graph/badge.svg)](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony)
[![Maintainability](https://api.codeclimate.com/v1/badges/b83bc51361ac046bc7eb/maintainability)](https://codeclimate.com/github/Nikolay-Lysenko/dodecaphony/maintainability)
[![PyPI version](https://badge.fury.io/py/dodecaphony.svg)](https://pypi.org/project/dodecaphony/)

# Dodecaphony

## Overview

This is a configurable tool that generates music written in [the twelve-tone technique](https://nikolay-lysenko.github.io/2024/04/30/introduction-to-twelve-tone-technique). In short, this means that the output pieces are based on different principles than the vast majority of classical and popular music. If you have never listened to the twelve-tone works, you may find them not ear-pleasant, but, given enough experience, you can change your mind. Twelve-tone music is logic-oriented and has many symmetries, so it is a good choice for combinatorial optimization.

Each run of the tool results in creation of a fragment which can be used as a part of a larger composition. These fragments are stored in separate directories containing:
* MIDI file
* WAV file
* Events file in [sinethesizer](https://github.com/Nikolay-Lysenko/sinethesizer) TSV format
* PDF file with sheet music and its Lilypond source
* YAML file that can be copied to a config for a derivative fragment
* Text file with meta information (such as path to config and evaluation scores)

With this tool, I released a 26-minutes album on Spotify and many other streaming platforms. However, main melodies for the album were written manually by myself and a lot of hard work was done with configs, but, nevertheless, the package really helped to generate background melodies. To read more about the album, please visit its [official page](https://nikolay-lysenko.github.io/2024/05/31/suite-for-virtual-pipe-organ-op1).

## Installation

To install a stable version, run:
```bash
pip install dodecaphony
```

## Usage

To create a new musical fragment, run:
```bash
python -m dodecaphony [-c path_to_config]
```

[Default config](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/dodecaphony/configs/default_config.yml) is used if `-c` argument is not passed. To create your own config, please look at [this example](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/docs/config_with_explanations.yml) with detailed explanations. Also, you can read the source code — it is structured and has built-in documentation.

If you are on macOS, please make sure that [parallelism is enabled](https://stackoverflow.com/questions/50168647/multiprocessing-causes-python-to-crash-and-gives-an-error-may-have-been-in-progr).

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "dodecaphony",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "ai_music, algorithmic_composition, atonality, dodecaphony, serialism, twelve_tone",
    "author": null,
    "author_email": "Nikolay Lysenko <nikolay-lysenco@yandex.ru>",
    "download_url": "https://files.pythonhosted.org/packages/25/70/055b1f842e63930bba7fd6d42b5b09b00cd9166b89db10f492eae50a08ee/dodecaphony-0.2.1.tar.gz",
    "platform": null,
    "description": "[![Build Status](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml/badge.svg)](https://github.com/Nikolay-Lysenko/dodecaphony/actions/workflows/main.yml)\n[![codecov](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony/branch/master/graph/badge.svg)](https://codecov.io/gh/Nikolay-Lysenko/dodecaphony)\n[![Maintainability](https://api.codeclimate.com/v1/badges/b83bc51361ac046bc7eb/maintainability)](https://codeclimate.com/github/Nikolay-Lysenko/dodecaphony/maintainability)\n[![PyPI version](https://badge.fury.io/py/dodecaphony.svg)](https://pypi.org/project/dodecaphony/)\n\n# Dodecaphony\n\n## Overview\n\nThis is a configurable tool that generates music written in [the twelve-tone technique](https://nikolay-lysenko.github.io/2024/04/30/introduction-to-twelve-tone-technique). In short, this means that the output pieces are based on different principles than the vast majority of classical and popular music. If you have never listened to the twelve-tone works, you may find them not ear-pleasant, but, given enough experience, you can change your mind. Twelve-tone music is logic-oriented and has many symmetries, so it is a good choice for combinatorial optimization.\n\nEach run of the tool results in creation of a fragment which can be used as a part of a larger composition. These fragments are stored in separate directories containing:\n* MIDI file\n* WAV file\n* Events file in [sinethesizer](https://github.com/Nikolay-Lysenko/sinethesizer) TSV format\n* PDF file with sheet music and its Lilypond source\n* YAML file that can be copied to a config for a derivative fragment\n* Text file with meta information (such as path to config and evaluation scores)\n\nWith this tool, I released a 26-minutes album on Spotify and many other streaming platforms. However, main melodies for the album were written manually by myself and a lot of hard work was done with configs, but, nevertheless, the package really helped to generate background melodies. To read more about the album, please visit its [official page](https://nikolay-lysenko.github.io/2024/05/31/suite-for-virtual-pipe-organ-op1).\n\n## Installation\n\nTo install a stable version, run:\n```bash\npip install dodecaphony\n```\n\n## Usage\n\nTo create a new musical fragment, run:\n```bash\npython -m dodecaphony [-c path_to_config]\n```\n\n[Default config](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/dodecaphony/configs/default_config.yml) is used if `-c` argument is not passed. To create your own config, please look at [this example](https://github.com/Nikolay-Lysenko/dodecaphony/blob/master/docs/config_with_explanations.yml) with detailed explanations. Also, you can read the source code \u2014 it is structured and has built-in documentation.\n\nIf you are on macOS, please make sure that [parallelism is enabled](https://stackoverflow.com/questions/50168647/multiprocessing-causes-python-to-crash-and-gives-an-error-may-have-been-in-progr).\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Algorithmic composition of modern classical music in the twelve-tone technique",
    "version": "0.2.1",
    "project_urls": {
        "Homepage": "https://github.com/Nikolay-Lysenko/dodecaphony"
    },
    "split_keywords": [
        "ai_music",
        " algorithmic_composition",
        " atonality",
        " dodecaphony",
        " serialism",
        " twelve_tone"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f188d251f4bdcafc5bc51abcf79adcfa8aa371e88ec6b0c1ec69043fd42e9095",
                "md5": "fe9cf4a49ff0357413b9210624635067",
                "sha256": "81859db72d81615f8d2aa128320f66ad40f8eabdc2c4ab7ae6efe9302c21dc6c"
            },
            "downloads": -1,
            "filename": "dodecaphony-0.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fe9cf4a49ff0357413b9210624635067",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 59769,
            "upload_time": "2024-08-06T09:47:32",
            "upload_time_iso_8601": "2024-08-06T09:47:32.983081Z",
            "url": "https://files.pythonhosted.org/packages/f1/88/d251f4bdcafc5bc51abcf79adcfa8aa371e88ec6b0c1ec69043fd42e9095/dodecaphony-0.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2570055b1f842e63930bba7fd6d42b5b09b00cd9166b89db10f492eae50a08ee",
                "md5": "3c36268410859f84554426c4ea73cd24",
                "sha256": "614d0ab12fb68d01f2c1b2aabb6bddba4d94b878dfc8d3005e018ba7290624af"
            },
            "downloads": -1,
            "filename": "dodecaphony-0.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "3c36268410859f84554426c4ea73cd24",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 64664,
            "upload_time": "2024-08-06T09:47:34",
            "upload_time_iso_8601": "2024-08-06T09:47:34.762999Z",
            "url": "https://files.pythonhosted.org/packages/25/70/055b1f842e63930bba7fd6d42b5b09b00cd9166b89db10f492eae50a08ee/dodecaphony-0.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-06 09:47:34",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Nikolay-Lysenko",
    "github_project": "dodecaphony",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "lcname": "dodecaphony"
}
        
Elapsed time: 0.33818s