Utilities to work with pitches, convert between midinotes, frequency and notenames
Project description
pitchtools provides a set of functions to work with musical pitches.
Features
convert between frequencies, midinotes and notenames
microtones are fully supported
split a pitch into its multiple components (pitch class, octave, microtonal deviation, etc.)
transpose a pitch taking its spelling into consideration
create custom pitch converters to work with custom reference frequencies, or modify the reference frequency globally
Documentation
Examples
Convert some note names to frequencies
>>> from pitchtools import *
>>> eflat_scale = "4Eb 4F 4G 4Ab 4Bb 5C 5D".split()
>>> for note in eflat_scale:
... # convert notename to frequency using the default reference frequency (442 Hz)
... freq = n2f(note)
... # convert frequency to midi
... midinote = f2m(freq)
... print(f"{note} = {freq:.1f}Hz (midi = {midinote})")
4Eb = 312.5 Hz (midi = 63.0)
4F = 350.8 Hz (midi = 65.0)
4G = 393.7 Hz (midi = 67.0)
4Ab = 417.2 Hz (midi = 68.0)
4Bb = 468.3 Hz (midi = 70.0)
5C = 525.6 Hz (midi = 72.0)
5D = 590.0 Hz (midi = 74.0)
The same but with a different reference frequency
from pitchtools import *
ebscale = "4Eb 4F 4G 4Ab 4Bb 5C 5D".split()
cnv = PitchConverter(a4=435)
for note in ebscale:
# Convert to frequency with default a4=442 Hz
freq = cnv.n2f(note)
midinote = cnv.[Of2m(freq)
print(f"{note} = {freq} Hz (midinote = {midinote})")
Microtones
Microtones are fully supported, either as fractional midinotes or as notenames.
>>> from pitchtools import *
>>> n2m("4C+")
60.5
>>> n2m("4Db-10")
60.9
>>> m2n(61.2)
4C#+20
Microtonal notation
Midinote |
Notename |
---|---|
60.25 |
4C+25 / 4C> |
60.45 |
4C+45 |
60.5 |
4C |
60.75 |
4Db-25 |
61.5 |
4D- |
61.80 |
4D-20 |
63 |
4D# |
63.5 |
4D#+ |
63.7 |
4E-30 |
Installation
pip install pitchtools
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 Distributions
Built Distribution
Hashes for pitchtools-1.14.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ac58eff9818f1ed72f1ddf18d1852ab89406c1b23a7ff289a9393b6f1bb91102 |
|
MD5 | 89c6563f8cb962d4ba0156597456554a |
|
BLAKE2b-256 | 6d6026710e9b05662453aead0dd47080de14eddb819bc62685005ede23d3d829 |