Crate acorde_analysis 

Deterministic, explainable music analysis over acorde_core::Score.

Structs

AnalysisCache

A deterministic, bounded cache for complete analysis results.

AnalysisCacheStats

Counters for measuring analysis-cache reuse.

AnalysisChangeExplanation

A score diff together with the explanations affected at one source address.

AnalysisCounts

Predicted category counts used by the benchmark report.

AnalysisDiff

Deterministic category-level diff between two analysis results.

AnalysisEditResult

Analysis result and its deterministic diff from a previous result.

AnalysisPassResult

Result of one registered extension pass.

AnalysisProvenance

One deterministic explanation attached to a source note address.

AnalysisRefreshPlan

Dependency-aware refresh plan for a score edit.

AnalysisRegion

A changed part/staff measure interval used by incremental editor planning.

AnalysisResult

Deterministic output of the chord-analysis pass.

BenchmarkCase

One benchmark fixture and its hand-verified expectation.

BenchmarkCaseReport

Precision, recall, and explanation-completeness for one benchmark case.

BenchmarkExpectation

Hand-verified expected counts for one analysis benchmark fixture.

BenchmarkFailure

A category-level benchmark mismatch.

BenchmarkSuiteReport

Aggregate results for a deterministic benchmark suite.

CadenceCandidate

A cadence transition inferred only from adjacent, explicitly labeled chords.

ChordLabel

A chord label with source evidence and the rule that produced it.

IntervalObservation

A consecutive melodic interval with addresses for both source notes.

KeyEstimate

A deterministic key candidate ranked by duration-weighted diatonic pitch coverage.

MotifOccurrence

One source span matching a motif pattern.

MotifPattern

A repeated melodic interval pattern with all matching source occurrences.

PhraseBoundary

A phrase boundary supported by an explicit rest at the end of a measure.

SatbDiagnostic

A typed SATB constraint finding with source addresses for UI selection.

VoiceLeadingObservation

Voice-leading observation for two adjacent voices at an aligned event.

Enums

AnalysisCacheError

Errors returned when configuring the bounded analysis cache.

AnalysisCategory

One complete-analysis category that can change between two results.

AnalysisPassError

Validation failures for a registered analysis pass set.

BenchmarkCategory

An analysis category that can be compared in a benchmark report.

CadenceKind

Supported cadence transition families.

PhraseBoundaryReason

Evidence categories for phrase boundaries.

SatbDiagnosticKind

SATB constraint families reported by the deterministic pass.

SatbSeverity

User-facing seriousness of a SATB diagnostic.

Constants

ANALYSIS_SCHEMA_VERSION

Version of the serialized analysis result contract.

Traits

AnalysisPass

A host- or application-provided deterministic analysis extension.

Functions

affected_categories_for_change_hint

Return the complete-analysis categories that a dirty engine hint may affect.

analysis_cache_key

Return the current schema-versioned cache key without running the analysis passes.

analysis_provenance

Return every analysis finding whose evidence contains the supplied source address.

analysis_refresh_plan

Build a conservative refresh plan from an engine change hint.

analyze_batch

Analyze a finite batch in input order.

analyze_cadences

Find explicit cadence transitions in the order they occur within each voice.

analyze_chords

Backwards-compatible name for the complete score analysis pass.

analyze_chords_in_region

Analyze chord labels only inside an optional part/staff measure region.

analyze_intervals

Analyze adjacent pitched notes in every voice without inferring missing events.

analyze_intervals_in_region

Analyze intervals whose endpoints touch an optional part/staff measure region.

analyze_motifs

Find repeated three-note melodic interval patterns, resetting at rests.

analyze_phrase_boundaries

Report measure-ending rests as explicit, conservative phrase boundaries.

analyze_satb

Analyze SATB constraints using the same aligned voice events as voice-leading analysis.

analyze_satb_in_region

Analyze SATB diagnostics inside an optional part/staff measure region.

analyze_score

Analyze every voice that contains at least two pitched notes in a measure.

analyze_selected_categories

Recompute only the requested categories and carry forward the remaining categories.

analyze_selected_categories_in_region

Recompute selected categories with an optional bounded region for local passes.

analyze_stream

Analyze scores lazily, one result per input score.

analyze_voice_leading

Check aligned notes in adjacent voices for motion and parallel perfect intervals.

analyze_voice_leading_in_region

Analyze voice-leading observations inside an optional part/staff measure region.

benchmark_case

Run one offline benchmark case using count-based hand-verified annotations.

chord_name

Return the stable chord spelling as a compact human-readable label.

diff_analysis

Compare two complete results in stable category order.

estimate_keys

Estimate major/minor keys from pitch coverage, preserving tied candidates.

explain_analysis_change

Compare two analysis results and explain the findings attached to one source address.

run_analysis_passes

Run extension passes in stable ID order after validating their identifiers.

run_benchmark

Run benchmark cases in input order; no filesystem or network access is used.

run_benchmark_suite

Run a benchmark suite and aggregate its case-level metrics.

score_fingerprint

Return a deterministic, non-cryptographic fingerprint for a canonical score.