Struct StreamAligner 

pub struct StreamAligner {
    pub hasher: Hasher,
    pub hashed_target: Vec<NoteHash>,
    pub hashed_source: Vec<NoteHash>,
    pub distance_matrix: Vec<Vec<i64>>,
    pub changes: Vec<Change>,
    pub similarity_score: FloatType,
}

Two streams aligned by their notes’ hashes, the cheapest edit from one to the other: music21’s StreamAligner.

Inserting or deleting a note costs as many as the values in its hash, and changing one as many values as differ.

Fields

hasher: Hasher

How notes are hashed: by default by MIDI pitch and rounded length, each with what it was made from.

hashed_target: Vec<NoteHash>

The target’s hashes.

hashed_source: Vec<NoteHash>

The source’s hashes.

distance_matrix: Vec<Vec<i64>>

The cost of the cheapest edit from each opening of the target to each of the source.

changes: Vec<Change>

The changes, in order.

similarity_score: FloatType

The share of the changes that change nothing.

Implementations

impl StreamAligner

pub fn new() -> Self

An aligner with music21’s default hasher: pitch and length, each hash with what it was made from.

pub fn with_hasher(hasher: Hasher) -> Self

An aligner hashing notes as this hasher does.

pub fn align(&mut self, target: &Stream, source: &Stream) -> Result<()>

Aligns two streams: music21’s align.

Errors

A stream with nothing to hash, or a hash the hasher refuses.

pub fn align_hashed( &mut self, target: Vec<NoteHash>, source: Vec<NoteHash>, ) -> Result<()>

Aligns two lists of hashes already made: music21’s align with preHashed.

Errors

An empty list.

pub fn changes_count(&self, op: ChangeOp) -> usize

How many changes of each kind there are: music21’s changesCount.

Trait Implementations

impl Clone for StreamAligner

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StreamAligner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for StreamAligner

fn default() -> Self

Returns the “default value” for a type.