sim-lib-pitch-set 0.2.0

Pitch-class set masks, normal forms, interval vectors, and set operations.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

//! Pitch-class set representations and operations for the SIM music libraries.
//!
//! This crate models unordered collections of pitches as compact bitmasks. A
//! [`PitchClassMask`] packs the twelve pitch classes into a `u16`, supporting
//! rotation (transposition), inversion, numeric normalization, conventional
//! normal-order and prime-form classification, complements, set inclusion,
//! symmetry, Z-relation, interval/gap forms, graph neighborhoods, and the
//! [`IntervalVector`] census used by set theory. [`analyze_set_relations`]
//! reports exact Tn/TnI operators, canonical equivalence, inclusion,
//! complements, and Z-relations without conflating conventional prime form with
//! numeric normalization. [`PitchRangeMask`] does the same across the full 128-key
//! MIDI range. [`BitChord`] pairs a mask with an optional root, and
//! [`ThirdStackSignature`] encodes chords as stacks of minor and major thirds.

#![forbid(unsafe_code)]
#![deny(missing_docs)]

mod conventional;
mod geometry;
mod model;
mod relation;

pub use conventional::*;
pub use geometry::*;
pub use model::*;
pub use relation::*;

/// Cookbook recipes for this lib, embedded at build time.
pub static RECIPES: sim_cookbook::EmbeddedDir =
    include!(concat!(env!("OUT_DIR"), "/cookbook_recipes.rs"));

#[cfg(test)]
mod tests;