TiliaDictStore

loader.alignment.tilia.TiliaDictStore(data=None, kind_map=None)

DictStore subclass with convenience properties for TiLiA timeline types.

Each property returns the concatenation of all EventData tables whose TiLiA kind matches the requested type. If no tables of that type exist, an empty EventData is returned.

The type of each entry is tracked via a kind_map that maps store keys to short type names (beat, harmony, hierarchy, marker, pdf).

Examples

>>> loader = TiliaJsonLoader()
>>> loader.load("Bruckner5_Scherzo.json")
>>> loader.store.hierarchy  # all hierarchy tables concatenated
>>> loader.store.marker     # all marker tables concatenated
>>> loader.store.beat       # all beat tables concatenated

See Also

timetoalign.storage.store.DictStore

Attributes

Name Description
beat All beat timeline tables concatenated.
harmony All harmony timeline tables concatenated.
hierarchy All hierarchy timeline tables concatenated.
kind_map Mapping from store keys to TiLiA type names.
marker All marker timeline tables concatenated.
pdf All PDF timeline tables concatenated.

Methods

Name Description
add Add or replace a named EventData table with optional kind tracking.

add

loader.alignment.tilia.TiliaDictStore.add(name, events, kind=None)

Add or replace a named EventData table with optional kind tracking.

Parameters

Name Type Description Default
name str The name for this data (e.g., "HIERARCHY_TIMELINE_0"). required
events EventData The EventData to store. required
kind str | None The TiLiA type name ("beat", "hierarchy", etc.). If None, the kind is inferred from the name if possible. None