Module tuningsystem

Source

Expand description

Tuning-system ratios, labels and frequency helpers.

Re-exports§

pub use equal::EqualDivision;
pub use equal::TRITAVE_CENTS;
pub use monzo::Monzo;
pub use monzo::PRIMES;
pub use monzo::Val;
pub use mos::Mos;
pub use mos::MosScale;
pub use mos::OCTAVE_CENTS;
pub use mos::moment_of_symmetry_sizes;
pub use temperament::Temperament;

Modules§

adaptive: Tuning systems whose frequencies depend on the harmonic context they sound in, rather than on a fixed table.
equal: Equal divisions of any interval, not only of the octave. Equal divisions of any interval, not only of the octave.
monzo: Monzos and vals, the vectors regular temperament theory is written in. Monzos and vals, the two vectors regular temperament theory is written in.
mos: Moments of symmetry, the scales a single generator makes. Moments of symmetry — the scales a single generator makes.
scala: Runtime parsing of Scala .scl scale files. Runtime parsing of Scala .scl scale files.
scala_bundledscala-archive: The bundled Scala scale archive, emitted by xtask emit-scala-archive.
temperament: Rank-2 regular temperaments, a period and a generator over a mapping. Regular temperaments — a period, some generators, and what they mean.

Structs§

Fraction: A ratio-like value used by tuning tables.
NamedTemperament: A regular temperament the Xenharmonic Wiki names and publishes a mapping for.
UnmodelledTemperament: A wiki page carrying a temperament infobox that this crate does not model.

Enums§

AnyTuningSystem: Either a normal tuning system or a context-sensitive adaptive tuning system.
TuningSystem: Supported tuning systems and ratio tables.

Constants§

A0: Frequency of A0 in hertz.
A4: Frequency of A4 in hertz.
ABERSCHISMIC: Aberschismic (2.3.5.7), rank 3, generator 3/2, 5/4 at 702.8, 386.5 cents.
ALL_TUNING_SYSTEMS: All built-in tuning systems in canonical display order.
AMITY: Amity (2.3.5.7), rank 2, generator 243/200 at 339.4 cents.
AN1: Frequency of A-1 in hertz.
ANTONIAN: Antonian (2.3.5.7), rank 2, generator 3/2 at 743.086 cents.
ARCHYTAS: Archytas and ares (2.3.5.7.11), rank 3, generator 3/2, 5/4 at 709.7, 390.0 cents.
AUGMENTED: Augmented (temperament) (2.3.5.7.11), rank 2, generator 3/2 at 711.6 cents.
BLACKWOOD: Blackwood (2.3.5.7), rank 2, generator 5/4 at 391.1 cents.
BOHPIER: Bohpier (2.3.5.7.11.13), rank 2, generator 12/11 at 146.5 cents.
BPS: BPS (3.5.7), rank 2, generator 9/7 at 440.7 cents.
BUG: Bug and beep (2.3.5.7), rank 2, generator 5/3 at 938.0 cents.
BUNYA: Bunya (2.3.5.7.11.13), rank 2, generator 10/9 at 175.9 cents.
BUZZARD: Buzzard (2.3.5.7.11.13), rank 2, generator 21/16 at 475.7 cents.
C0: Frequency of C0 in hertz.
C4: Frequency of middle C in hertz.
CANOPUS: Canopus (3.5.7), rank 2, generator 7/5 at 583.986 cents.
CARLOS_HARMONIC: Twelve-tone harmonic-series scale (Wendy Carlos’s Harmonic).
CARLOS_HARMONIC_24: Twenty-four-tone harmonic-series scale.
CATAKLEISMIC: Catakleismic (2.3.5.7.11.13), rank 2, generator 6/5 at 316.7 cents.
CN1: Frequency of C-1 in hertz.
COLLECTED: The day the wiki was last read for this table.
COMMON_EQUAL_TEMPERAMENTS: The equal divisions of the octave that xenharmonic practice actually uses.
COMMON_TWELVE_TONE_TUNING_SYSTEMS: The common twelve-tone tuning systems useful for comparing pitch frequencies.
COMPTON: Compton (2.3.5.7), rank 2, generator 5/4 at 384.1 cents.
COTONEUM: Cotoneum (2.3.5.7.11.13.17.19), rank 2, generator 3/2 at 702.31 cents.
DECIMAL: Decimal (2.3.5.7), rank 2, generator 7/4 at 951.0 cents.
DEEPTONE: Deeptone (2.3.5.13), rank 2, generator 3/2 at 689.6 cents.
DIASCHISMIC: Diaschismic (2.3.5.7.11.13.17), rank 2, generator 3/2 at 703.9 cents.
DICOT: Dicot (2.3.5.11), rank 2, generator 6/5 at 351.1 cents.
DIDACUS: Didacus (2.5.7.11), rank 2, generator 28/25 at 194.4 cents.
DIMINISHED: Diminished (temperament) (2.3.5.7), rank 2, generator 3/2 at 696.0 cents.
DOMINANT: Dominant (temperament) (2.3.5.7), rank 2, generator 3/2 at 701.1 cents.
ELEVEN_LIMIT: Twenty-nine-tone eleven-limit tuning ratios.
ENNEALIMMAL: Ennealimmal (2.3.5.7), rank 2, generator 5/3 at 884.322 cents.
FATHER: Father (2.3.5.7), rank 2, generator 3/2 at 738.443 cents.
FIVE_LIMIT: Twelve-tone five-limit tuning ratios.
FLATTONE: Flattone (2.3.5.7.11.13), rank 2, generator 3/2 at 693.1 cents.
FORTYTHREE_TONE: Backwards-compatible alias for FORTY_THREE_TONE.
FORTY_THREE_TONE: Forty-three-tone tuning ratios.
GAMELISMIC: Gamelismic and portent (2.3.5.7.11), rank 3, generator 8/7, 5/4 at 233.8, 385.3 cents.
GARIBALDI: Garibaldi (2.3.5.7.19), rank 2, generator 3/2 at 702.1 cents.
GRAVITY: Gravity (2.3.5.11), rank 2, generator 27/20 at 516.8 cents.
GUNN: Gunn (2.3.5.7.11.13.17.19), rank 3, generator 5/4, 7/4 at 384.84, 965.14 cents.
HARRY: Harry (2.3.5.7.11.13), rank 2, generator 21/20 at 83.1 cents.
HEMIFIFTHS: Hemififths (2.3.5.7.11.13), rank 2, generator 49/40 at 351.5 cents.
HISTORICAL_TEMPERAMENTS: Historical keyboard temperaments, oldest first.
INDIAN_SCALE_22: Twenty-two-tone Indian scale ratios.
INDIAN_SCALE_NAMES: Degree labels for the seven-tone PtolemyIntenseDiatonic scale.
INDIA_SCALE_ALT: Alternate seven-tone Indian scale ratios.
JAVANESE: Five-tone Javanese equal-temperament approximation.
JOVE: Jove (2.3.5.7.11), rank 3, generator 11/9, 10/7 at 350.5, 617.9 cents.
KEEMUN: Keemun (2.3.5.7.11), rank 2, generator 6/5 at 317.6 cents.
KIRNBERGER_I: Twelve-tone Kirnberger I well temperament (1766).
KIRNBERGER_III: Twelve-tone Kirnberger III well temperament (1744).
KLEISMIC: Kleismic (2.3.5.13), rank 2, generator 6/5 at 317.1 cents.
LAKA: Laka (2.3.5.7.11.13), rank 3, generator 3/2, 5/4 at 702.6, 386.8 cents.
LEAPDAY: Leapday (2.3.5.7.11.13), rank 2, generator 3/2 at 704.2 cents.
LEHMAN_BACH: Twelve-tone Lehman-Bach temperament (2005).
LEMBA: Lemba (2.3.5.7.11.13), rank 2, generator 8/7 at 231.2 cents.
LUNA: Luna and hemithirds (2.3.5.7), rank 2, generator 28/25 at 193.2 cents.
MAGIC: Magic (2.3.5.7), rank 2, generator 5/4 at 380.5 cents.
MARVEL: Marvel (2.3.5.7.11), rank 3, generator 3/2, 5/4 at 700.6, 383.5 cents.
MAVILA: Mavila (2.3.5.11), rank 2, generator 3/2 at 679.0 cents.
MEANTONE: Meantone (2.3.5.7), rank 2, generator 3/2 at 696.7 cents.
MINTAKA: Mintaka (3.7.11), rank 2, generator 11/7 at 778.7 cents.
MIRACLE: Miracle (2.3.5.7.11), rank 2, generator 15/14 at 116.7 cents.
MISTY: Misty (2.3.5.7.17.19), rank 2, generator 3/2 at 703.1 cents.
MODUS: Modus (2.3.5.7.11.13), rank 2, generator 10/9 at 176.8 cents.
MOHAJIRA: Mohajira (2.3.5.7.11), rank 2, generator 11/9 at 348.5 cents.
MONKEY: Monkey (2.3.5.7.11.13), rank 2, generator 10/9 at 175.6 cents.
MOTHRA: Mothra (2.3.5.7), rank 2, generator 8/7 at 232.3 cents.
MUGGLES: Muggles (2.3.5.7.11.13), rank 2, generator 5/4 at 377.7 cents.
MYNA: Myna (2.3.5.7.11), rank 2, generator 6/5 at 310.1 cents.
MYSTERY: Mystery (2.3.5.7.11.13), rank 2, generator 5/4 at 387.9 cents.
NEGRI: Negri (2.3.5.7.13), rank 2, generator 16/15 at 125.4 cents.
NEIDHARDT_I: Twelve-tone Neidhardt I well temperament (1724).
NEUTROMINANT: Neutrominant (2.3.5.7.11.13), rank 2, generator 11/9 at 350.7 cents.
OCTAVE_SIZE: Default octave size for twelve-tone systems.
OCTOID: Octoid (2.3.5.7.11), rank 2, generator 7/5 at 583.948 cents.
OOLONG: Oolong (2.3.5.7.13), rank 2, generator 6/5 at 311.7 cents.
OPOSSUM: Opossum (2.3.5.7.11), rank 2, generator 11/10 at 160.5 cents.
ORWELL: Orwell (2.3.5.7.11), rank 2, generator 7/6 at 271.5 cents.
PAJARA: Pajara (2.3.5.7.11.17), rank 2, generator 3/2 at 707.4 cents.
PARAKLEISMIC: Parakleismic (2.3.5.7), rank 2, generator 5/3 at 884.81 cents.
PARAPYTH: Parapyth (2.3.7.11.13), rank 3, generator 3/2, 7/4 at 703.8, 969.2 cents.
PELE: Pele (2.3.5.7.11.13), rank 3, generator 3/2, 5/4 at 703.4, 387.8 cents.
PENTADACUS: Pentadacus (5.7.11), rank 2, generator 55/49 at 194.8 cents.
PONTIAC: Pontiac (2.3.5.7), rank 2, generator 3/2 at 701.758 cents.
PORCUPINE: Porcupine (2.3.5.7.11), rank 2, generator 10/9 at 163.0 cents.
PTOLEMY_INTENSE_DIATONIC: Ptolemy’s intense diatonic, also Zarlino’s just major scale.
PYTHAGOREAN_TUNING: Twelve-tone Pythagorean tuning ratios.
QUARTER_COMMA_MEANTONE: Twelve-tone quarter-comma meantone temperament (Aaron, 1523).
QUARTKEENLIG: Quartkeenlig (2.3.5.7.11), rank 2, generator 36/35 at 52.845 cents.
QUASISUPER: Quasisuper (2.3.5.7.11), rank 2, generator 3/2 at 708.3 cents.
RAMEAU: Twelve-tone Rameau modified meantone temperament (1725).
RODAN: Rodan (2.3.5.7.11), rank 2, generator 8/7 at 234.4 cents.
SCHISMIC: Schismic (2.3.5), rank 2, generator 3/2 at 701.731 cents.
SEMAPHORE: Semaphore and godzilla (2.3.5.7.13), rank 2, generator 7/4 at 948.0 cents.
SENSAMAGIC: Sensamagic (2.3.5.7.11), rank 3, generator 3/2, 9/7 at 703.8, 440.9 cents.
SENSI: Sensi (2.3.5.7.13), rank 2, generator 9/7 at 443.3 cents.
SEPTISCHISMIC: Septischismic (2.3.5.7.11.13.19), rank 3, generator 3/2, 5/4 at 702.2307, 386.3245 cents.
SHALLOWTONE: Shallowtone (2.3.5.7), rank 2, generator 3/2 at 681.2 cents.
SILBERMANN: Twelve-tone Gottfried Silbermann temperament no. 1 (c. 1730).
SIRIUS: Sirius (3.5.7), rank 2, generator 25/21 at 293.759 cents.
SIXTH_COMMA_MEANTONE: Twelve-tone sixth-comma meantone temperament (Salinas, 1577).
SLENDRIC: Slendric (2.3.7), rank 2, generator 8/7 at 233.7 cents.
SOURCE: The wiki this table was collected from.
SQUARES: Squares (2.3.5.7.11), rank 2, generator 9/7 at 426.0 cents.
STARLING: Starling and thrush (2.3.5.7.11), rank 3, generator 3/2, 5/4 at 701.6, 390.9 cents.
SUBMERGED: Submerged (2.3.5.7.11.13), rank 2, generator 8/5 at 827.0 cents.
SUPERKLEISMIC: Superkleismic (2.3.5.7.11.19), rank 2, generator 5/3 at 878.2 cents.
SUPERPYTH: Superpyth (2.3.5.7.11), rank 2, generator 3/2 at 710.1 cents.
TETRACOT: Tetracot (2.3.5.11.13), rank 2, generator 10/9 at 176.1 cents.
THAI: Seven-tone Thai equal-temperament approximation.
THIRD_COMMA_MEANTONE: Twelve-tone third-comma meantone temperament (Salinas, 1577).
TRISECTED: Trisected (2.3.5.7.11.13), rank 2, generator 10/7 at 635.0 cents.
TRISMEGISTUS: Mabilic and trismegistus (2.3.5.7), rank 2, generator 175/128 at 526.7 cents.
TRITIKLEISMIC: Tritikleismic (2.3.5.7.11.13.17), rank 2, generator 6/5 at 316.938 cents.
TWELVE_TONE_NAMES: Degree labels for a twelve-tone chromatic octave.
TWELVE_TONE_NAMES_FLAT: Degree labels for a twelve-tone chromatic octave using flats.
TWELVE_TONE_NAMES_SHARP: Degree labels for a twelve-tone chromatic octave using sharps.
ULTRAPYTH: Ultrapyth (2.3.5.7.13), rank 2, generator 3/2 at 713.6 cents.
UNIDEC: Unidec (2.3.5.7.11), rank 2, generator 14/11 at 416.9 cents.
UNMODELLED_TEMPERAMENTS: The wiki’s temperaments this crate does not model, and why.
VALENTINE: Valentine (2.3.5.7.11), rank 2, generator 22/21 at 77.9 cents.
VALLOTTI: Twelve-tone Vallotti well temperament (c. 1754).
VENGEANCE: Vengeance (2.5.7.17), rank 2, generator 34/25 at 527.718 cents.
WERCKMEISTER_III: Twelve-tone Werckmeister III well temperament (1681).
WERCKMEISTER_IV: Twelve-tone Werckmeister IV well temperament (1681).
WERCKMEISTER_V: Twelve-tone Werckmeister V well temperament (1681).
WHITEWOOD: Whitewood (2.3.5.7), rank 2, generator 5/4 at 392.7 cents.
WHOLE_TONE_NAMES: Degree labels for a whole-tone octave.
WIZARD: Wizard (2.3.5.7.11.17), rank 2, generator 17/15 at 216.8 cents.
WOLLEMIA: Wollemia (2.3.5.7.11.13), rank 2, generator 10/9 at 177.1 cents.
WURSCHMIDT: Würschmidt (2.3.5.23), rank 2, generator 5/4 at 387.8 cents.
XENIAL: Xenial (2.3.5.7.11.13.17.19.23), rank 2, generator 10/9 at 188.8 cents.
YOUNG_II: Twelve-tone Thomas Young well temperament no. 2 (1799).
ZEUS: Zeus (2.3.5.7.11.13), rank 3, generator 3/2, 12/11 at 701.9, 157.0 cents.

Statics§

WIKI_TEMPERAMENTS: Every regular temperament collected from the wiki, by name.

Functions§

equal_temperament: Creates an equal-temperament fraction for tone within octave_size.
equal_temperament_12: Creates a twelve-tone equal-temperament fraction.
equal_temperament_default: Creates an equal-temperament fraction using OCTAVE_SIZE.
get_cents: Returns cents offset from equal temperament for a tuning-system degree.
get_cents_at: Returns cents offset from equal temperament for a fractional degree index.
get_fraction: Returns the fraction for a tuning-system degree.
get_frequency: Returns the frequency in hertz for a tuning-system degree.
get_frequency_at: Returns the frequency in hertz for a fractional tuning-system degree.
get_label: Returns a display label for a tuning-system degree.
get_ratio: Returns the frequency ratio for a tuning-system degree.

Module tuningsystem

Module tuningsystem Copy item path

Re-exports§

Modules§

Structs§

Enums§

Constants§

Statics§

Functions§

Module tuningsystem