Tutorials
Learn TimeToAlign! step by step
These tutorials take you from zero to a working multimodal alignment, introducing one concept at a time. Each notebook uses real-world data from the project’s specimen collection and can be run locally after installing the library with pip install "timetoalign[tutorial]".
Prerequisites: Python 3.11+, basic familiarity with Jupyter notebooks.
Tutorial Notebooks
| Title | Description |
|---|---|
| Quickstart | A five-minute tour of Timelines |
| Timelines, Events, and Maps | Loading, EventStore, Coordinate, ConversionMap |
| Children, Regions, and Timestamps | Hierarchy, cross-section queries |
| Timeline Groups and Commensurability | TimelineGroup, coordinate transfer, partial alignment |
| Alignment Bundles | MatchfileLoader, AlignmentBundle, cross-group transfer |
| Flow Control and Grids | BeatGrid, repeats, metrical structure |
| DataFields and Layered EventData | The Protocol/Scalar/Field triple, raw Layer 0 fields, default and self-built semantic fields, discovery, and Parquet-embedded metadata |
| Pitch and Harmony across Formats | Cross-format pitch equivalence: the same note from ms3 TSV, music21, partitura, MIDI, and parangonada; the SpecificPitch vs EnharmonicPitch/MidiPitch affordance; the same triple for harmony |
No matching items
Topics at a Glance
The tutorials are designed to be followed in order, grouped into the same four topics used throughout the documentation:
Timelines, Events & Maps
- Quickstart — A five-minute tour of Timelines, Groups, Bundles, and Grids.
- Timelines, Events, and Maps — Loading, EventStore, Coordinate, and ConversionMap.
- Children, Regions, and Timestamps — Hierarchy and cross-section queries.
TimelineGroups
- Timeline Groups and Commensurability — TimelineGroup, coordinate transfer, and partial alignment.
AlignmentBundles
- Alignment Bundles — MatchfileLoader, AlignmentBundle, and cross-group transfer.
In-depth Topics
- Flow Control and Grids — BeatGrid, repeats, and metrical structure.
Data & Type Model
- DataFields and Layered EventData — The Protocol/Scalar/Field triple, raw and semantic fields, discovery, and Parquet-embedded metadata.
- Pitch and Harmony across Formats — Cross-format pitch equivalence and the typed view each format affords, applied to pitch and harmony.