music-harmony-analysis


Namemusic-harmony-analysis JSON
Version 1.0.1 PyPI version JSON
download
home_page
SummaryAnalyze the harmonies in music according to a theory of harmonic perception by Franz Sauter, described in his book 'Tonal music: Anatomy of the Musical Aesthetics'
upload_time2024-01-22 14:54:52
maintainer
docs_urlNone
author
requires_python>=3.10
licenseMIT License Copyright (c) 2024 Louis Krüger Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords music music harmony music analysis music theory
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            This library implements some functions for analyzing the harmonic happenings in music. The algorithms are based on a relatively unknown theory of harmony in music by Franz Sauter, specified for implementation by Louis Krüger. This Theory is described in the book of Franz Sauter 'Tonal music: Anatomy of the Musical Aesthetics' (German: 'Die tonale Musik: Anatomie der musikalischen Ästhetik').
One interesting aspect of the theory is that modulations are defined in a way that it can be implemented in a computer program: A modulation occurs if we hear a tone which is not part of the key in which we were before. Instead, we are modulating to the key which
1. has all the tones of the new harmony we are hearing and
2. has the most tones in common with the old key we were in.


This library offers the following functions:
- calc_harmonies: This calculates the resulting harmonies of different simultaneous voices (for example different instruments playing together) in music. The result can be used for:
- analyze_harmonic_states: From the harmonies that a listener hears the 'harmonic state' in which the listener is is calculated. This term belongs to the theory and describes the key that a listener would assume as the current key in which the music is. A harmonic state can consist of multiple keys simultaneously.
- analyze_sauterian_formula: Gives back the sauterian formula for each harmony, where the harmonic state has exactly one key. This roughly corresponds to whether the scale degrees for the individual notes of the tonic, dominant and subdominant chords of a key are used in the sounding harmony.
- analyze_degree_of_dissonance: Based of the sauterian formula of a harmony this gives the degree of dissonance for this harmony: It can be consonant, 'false consonant', can ba a low, medium or high level of dissonanca or it can be an atonal harmony of one of 5 degrees, if the tones of the harmony do not occur in any key.


This library is used in a tool for automatic music harmony analysis that can be found on the website www.notenentwickler.com
Also some additional explanation of the theory can be found there.
The other modules abcjs_interface, preprocess and to_abc_strings in this package are developed for this project and are not specifically intended for general use.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "music-harmony-analysis",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": "",
    "keywords": "music,music harmony,music analysis,music theory",
    "author": "",
    "author_email": "Louis Kr\u00fcger <louiskrueger2002@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/ed/fe/0dbcf9b4dabee89175170499e43bb107016d2ba8ce77e0968ad0a775ec84/music-harmony-analysis-1.0.1.tar.gz",
    "platform": null,
    "description": "This library implements some functions for analyzing the harmonic happenings in music. The algorithms are based on a relatively unknown theory of harmony in music by Franz Sauter, specified for implementation by Louis Kr\u00fcger. This Theory is described in the book of Franz Sauter 'Tonal music: Anatomy of the Musical Aesthetics' (German: 'Die tonale Musik: Anatomie der musikalischen \u00c4sthetik').\nOne interesting aspect of the theory is that modulations are defined in a way that it can be implemented in a computer program: A modulation occurs if we hear a tone which is not part of the key in which we were before. Instead, we are modulating to the key which\n1. has all the tones of the new harmony we are hearing and\n2. has the most tones in common with the old key we were in.\n\n\nThis library offers the following functions:\n- calc_harmonies: This calculates the resulting harmonies of different simultaneous voices (for example different instruments playing together) in music. The result can be used for:\n- analyze_harmonic_states: From the harmonies that a listener hears the 'harmonic state' in which the listener is is calculated. This term belongs to the theory and describes the key that a listener would assume as the current key in which the music is. A harmonic state can consist of multiple keys simultaneously.\n- analyze_sauterian_formula: Gives back the sauterian formula for each harmony, where the harmonic state has exactly one key. This roughly corresponds to whether the scale degrees for the individual notes of the tonic, dominant and subdominant chords of a key are used in the sounding harmony.\n- analyze_degree_of_dissonance: Based of the sauterian formula of a harmony this gives the degree of dissonance for this harmony: It can be consonant, 'false consonant', can ba a low, medium or high level of dissonanca or it can be an atonal harmony of one of 5 degrees, if the tones of the harmony do not occur in any key.\n\n\nThis library is used in a tool for automatic music harmony analysis that can be found on the website www.notenentwickler.com\nAlso some additional explanation of the theory can be found there.\nThe other modules abcjs_interface, preprocess and to_abc_strings in this package are developed for this project and are not specifically intended for general use.\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2024 Louis Kr\u00fcger  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
    "summary": "Analyze the harmonies in music according to a theory of harmonic perception by Franz Sauter, described in his book 'Tonal music: Anatomy of the Musical Aesthetics'",
    "version": "1.0.1",
    "project_urls": {
        "Homepage": "https://notenentwickler.com"
    },
    "split_keywords": [
        "music",
        "music harmony",
        "music analysis",
        "music theory"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "08f20d44b1f7b4a321b6f8bbbc3ba072623f30ca2f41b95f9bad7b64161b5931",
                "md5": "4ee13f23258f7a44dd3dd82f00ba8fe2",
                "sha256": "54226275104ef78435bf86137c68010e3cc6dacff00ca8f27e5a2fb206caa396"
            },
            "downloads": -1,
            "filename": "music_harmony_analysis-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4ee13f23258f7a44dd3dd82f00ba8fe2",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 29551,
            "upload_time": "2024-01-22T14:54:50",
            "upload_time_iso_8601": "2024-01-22T14:54:50.390501Z",
            "url": "https://files.pythonhosted.org/packages/08/f2/0d44b1f7b4a321b6f8bbbc3ba072623f30ca2f41b95f9bad7b64161b5931/music_harmony_analysis-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "edfe0dbcf9b4dabee89175170499e43bb107016d2ba8ce77e0968ad0a775ec84",
                "md5": "dd09383bd8e25d9c7d799a3ed659ac2d",
                "sha256": "08750de644b44c8c2a942d5a428cbeaaac2940a1583e0c1b3732dcefc1770b7c"
            },
            "downloads": -1,
            "filename": "music-harmony-analysis-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "dd09383bd8e25d9c7d799a3ed659ac2d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 26831,
            "upload_time": "2024-01-22T14:54:52",
            "upload_time_iso_8601": "2024-01-22T14:54:52.301949Z",
            "url": "https://files.pythonhosted.org/packages/ed/fe/0dbcf9b4dabee89175170499e43bb107016d2ba8ce77e0968ad0a775ec84/music-harmony-analysis-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-22 14:54:52",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "music-harmony-analysis"
}
        
Elapsed time: 0.19676s