sim-lib-pitch-serial 0.1.0

Strict twelve-tone rows, total row operations, and explicit label conventions for SIM.
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

//! Boulez-style block multiplication over row partitions.

use sim_lib_pitch_core::PitchClass;
use sim_lib_pitch_set::PitchClassMask;

use crate::{
    BlockProjection, BlockProjectionSource, OrderedPitchBlock, PitchReservoir, RowPartition,
    ToneRow,
};

/// A block-product reservoir with its exact source partitions.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct BlockProductReservoir {
    /// The ordered reservoir produced by block multiplication.
    pub reservoir: PitchReservoir,
    /// Partition providing anchor pitches.
    pub anchor_partition: RowPartition,
    /// Partition providing interval content.
    pub interval_partition: RowPartition,
}

/// Projects each interval block onto each anchor block in declaration order.
pub fn multiply_partitions(
    row: &ToneRow,
    anchor_partition: &RowPartition,
    interval_partition: &RowPartition,
) -> BlockProductReservoir {
    let mut blocks = Vec::new();
    let mut provenance = Vec::new();
    for (anchor_block_index, anchor_block) in anchor_partition.blocks().iter().enumerate() {
        let anchor_pitches = anchor_block.pitch_classes(row);
        for (interval_block_index, interval_block) in interval_partition.blocks().iter().enumerate()
        {
            let interval_pitches = interval_block.pitch_classes(row);
            let interval_content = interval_content(&interval_pitches);
            let pitch_classes = anchor_pitches
                .iter()
                .flat_map(|anchor_pitch| {
                    interval_content
                        .iter()
                        .map(move |interval| anchor_pitch.transpose(i32::from(*interval)))
                })
                .collect::<Vec<_>>();
            let block_index = blocks.len();
            blocks.push(OrderedPitchBlock {
                mask: PitchClassMask::from_pitch_classes(&pitch_classes),
                pitch_classes,
            });
            provenance.push(BlockProjection {
                block_index,
                source: BlockProjectionSource::BlockMultiplication {
                    anchor_block_index,
                    anchor_ordinals: anchor_block.ordinals().to_vec(),
                    interval_block_index,
                    interval_ordinals: interval_block.ordinals().to_vec(),
                    interval_content,
                },
            });
        }
    }
    BlockProductReservoir {
        reservoir: PitchReservoir::new(blocks, provenance),
        anchor_partition: anchor_partition.clone(),
        interval_partition: interval_partition.clone(),
    }
}

fn interval_content(block: &[PitchClass]) -> Vec<u8> {
    let first = block[0];
    block
        .iter()
        .map(|pitch_class| pitch_class.value().wrapping_add(12) - first.value())
        .map(|delta| delta % 12)
        .collect()
}