mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-22 14:32:29 +01:00
New subproject porting Luke Haas's "Music Theory for Programmers" section by section into typed Python: pitch (MIDI <-> Hz), tuning (harmonic series, the Pythagorean comma, brute-forced "why twelve"), scales as step arrays with modes as rotations, chords stacked in thirds with Roman numerals and the V7 -> I resolution, named progressions, a numpy synth (waveforms, ADSR, low-pass), a bar-exact sequencer, and a seeded Recipe -> WAV composer. `degrade` is the same piece ruined by a 0..1 amount, so an ending can be the opening destroyed on the same seed; filtering runs LAST because filtering first measured brighter than the clean render. 17 demos (`python -m music_theory demo all`) each print the article's numbers -- the comma is 1.013643, the tempered fifth is 0.113 % flat, twelve is the first acceptable division -- and the FFT of the render, so the claims are tested rather than asserted. 157 tests, 100 % branch coverage, ruff ALL, mypy strict, pylint 10. Consumed next by roadside-assistance for its three world-state beds. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VC17zymxkeiUcHrMvt8W5W
18 lines
688 B
Python
18 lines
688 B
Python
# Copyright (c) 2026 Krzysztof Rudnicki
|
|
"""Music theory from first principles, as code.
|
|
|
|
Follows Luke Haas's "Music Theory for Programmers"
|
|
(https://runjs.app/blog/music-theory-for-programmers) section by section:
|
|
a sound is a number changing over time, pitch is multiplicative, the tuning
|
|
everyone wants cannot exist, so equal temperament trades purity for a
|
|
system that works in every key. Scales, chords and progressions are then
|
|
plain arrays of integers on top of that.
|
|
|
|
Every module is pure and typed; ``synth``/``sequencer``/``compose`` turn
|
|
the integers into audio with numpy so each idea can be heard, not just read.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
__version__ = "0.1.0"
|