In this repository, we propose a Python3 implementation of the Tonal Pitch Space Distance as described in (De Haas et al., 2008) and (De Haas et al., 2013)
The content of this repository is in no way attributable to the authors of the above-mentioned papers.
The implementation of the Tonal Pitch Step Distance (TPSD) has been split into three main modules that implement the * TPS*, the comparison between two TPS distances and the TPSD, respectively.
All chords and keys are expressed in the Harte notation (as described in Harte et al., 2005). For this, we reuse the chord-labels library.
For running all the scripts Python 3.10 is required.
TPS implements the Tonal Pitch Space (TPS), as described in (Lerdahl F., 2005) .
TPS takes in input a chord and a key:
from src.tps import Tps
chord = Tps(chord='C', key='C:maj')Some methods were implemented to compute the different TPS levels, both individually and piled together in the same list:
from src.tps import Tps
chord = Tps(chord='C', key='C:maj')
diatonic_level = chord.diatonic_level()
triadic_level = chord.triadic_level()
fifth_level = chord.fifth_level()
root_level = chord.root_level()
all_levels = chord.get_levels()Moreover, a method for visualising the extracted levels has been implemented:
chord.show_table()Which plots a table having this shape:
TPDS provides some methods for comparing different chords. It takes as input two chords and their keys and returns different distance metrics as implemented in the original TPSD:
from src.tps_comparison import TpsComparison
tps_comparison = TpsComparison(chord_a='C', key_a='C:maj', chord_b='E', key_b='E:maj')
circle_of_fifth_rule = tps_comparison.circle_fifth_rule()
chord_distance_rule = tps_comparison.chord_distance_rule()
tpsd_distance = tps_comparison.distance()Moreover, a method for visualising the TPSD distance has been implemented:
tps_comparison.plot()Which returns a table representing the two chords stacked, where the non-overlapping tones are highlighted in red:
Development in progress
Two different unit tests have been implemented containing all the examples provided in the TPSD papers, i.e. (De Haas et al., 2008) and (De Haas et al., 2013)
MIT License
Copyright (c) 2022 Andrea Poltronieri, Jacopo de Berardinis
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.