atonal-util - routines for atonal composition and analysis
Prime form and APIC vector for a pitch set:
$ atonal-util basic --ly f fis c
Apply a series of transformations to a pitch set:
$ cat rules retrograde invert 6 transpose 1 $ atonal-util recipe --file=rules --ly 0 11 3 4 8 7
Routines for atonal music composition and analysis. Global options and an operating mode should be supplied, followed by any mode specific arguments and a pitch set. Pitch sets can be read as arguments or from standard input; some modes require two pitch sets that must be supplied one per line on standard input.
The output will vary depending on the mode, and may include Cope tension numbers (average, min, max tension for the pitch set).
This script currently supports the following global command line switches:
Uses flats instead of sharps in output (but only with --ly).
Displays help and exits.
Displays supported operation modes.
Show lilypond note names instead of raw pitch numbers.
Adjust the number of scale degrees (default: 12).
Most all modes accept a pitch set (list of raw pitch numbers (0..number of scale degrees) or lilypond note names (bis, c, des, etc.) either on the command line or via standard input, though there are exceptions.
The global --ly and --flats can be specified as options to modes that emit pitches. See also Music::AtonalUtil for more documentation.
Shows the prime_form and interval_class_content.
See Music::AtonalUtil.
Equivalents under transposition and inverse transposition. An optional axis of inversion (default: 0, though some forms use 6) can be supplied.
Find all Forte pitch sets in which the given pitches exist. Like findin, except iterates over all Forte pitch sets instead of just the given one.
With --exclude, omits results containing the listed pitches. With -- fn, limits the search to the mentioned forte number prefixes (the number of pitches in the set). With --root, limits matches to those with the named root pitch.
$ atonal-util findall --root=c --fn=4-5 c e g bes
Tensions may be lower than expected if the root pitch creates an open position chord versus a closed position of that set.
Answers questions such as, given a base pitch set of [0,3,7], and the notes d and bes, what pitch sets (via any transpose or transpose_invert operation) complete the base pitch set. With -- exclude, omits results containing the listed pitches. With --root, limits matches to those with the named root pitch.
[0,3,7]
$ atonal-util findin --exclude=c,ees --pitchset=5-25 d fis a
Given a Forte Number, return the corresponding pitch set.
Return a list of all Forte Numbers and corresponding pitch sets (and their interval_class_content), plus average tension, min tension, and max tension via Music::Tension::Cope.
Returns list of transpose or transpose_invert operations that have invariant pitches with the supplied pitch set, along with which pitches have not varied.
See Music::AtonalUtil. Default axis is around 0.
Given a pitch set, returns the corresponding Forte Number, if any.
Apply a series of named operations from a batch file to a pitch set, for example:
retrograde invert 6 transpose 1
See Music::AtonalUtil. The length, if supplied, must be a magnitude equal to or less than the number of pitches supplied, and probably also 2 or higher.
Returns the average, min, max, and tension values for all the tensions in the passed pitch set, from the first notes in the set up to the last. (Via Music::Tension::Cope.)
See Music::AtonalUtil. Transposes the supplied pitches by the specified integer (by default 0, or a no-op), or to the specified note.
$ atonal-util transpose --transpose=4 --ly c e g e gis b $ atonal-util transpose --transpose=e --ly c e g e gis b
See Music::AtonalUtil. Transposes supplied pitch set by the specified integer, or to the specified note. Default axis for inversion is 0 (c).
Accepts two pitch sets, one per line, via standard input.
ZSH completion script available in the zsh-compdef directory of the App::MusicTools distribution.
If the bug is in the latest version, send a report to the author. Patches that fix problems or add new features are welcome.
http://github.com/thrig/App-MusicTools
Poor naming conventions and standards of underlying music theory and any associated mistakes in understanding thereof by the author.
Music::AtonalUtil, Music::LilyPondUtil, Music::Tension::Cope
Jeremy Mates
Copyright (C) 2012 by Jeremy Mates
This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.16 or, at your option, any later version of Perl 5 you may have available.
To install App::MusicTools, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::MusicTools
CPAN shell
perl -MCPAN -e shell install App::MusicTools
For more information on module installation, please visit the detailed CPAN module installation guide.