QTargetBeat¶
-
class
abjadext.nauert.QTargetBeat.
QTargetBeat
(beatspan=None, offset_in_ms=None, search_tree=None, tempo=None)¶ Q-target beat.
Represents a single beat in a quantization target.
>>> beatspan = (1, 8) >>> offset_in_ms = 1500 >>> search_tree = abjadext.nauert.UnweightedSearchTree({3: None}) >>> tempo = abjad.MetronomeMark((1, 4), 56)
>>> q_target_beat = abjadext.nauert.QTargetBeat( ... beatspan=beatspan, ... offset_in_ms=offset_in_ms, ... search_tree=search_tree, ... tempo=tempo, ... )
>>> abjad.f(q_target_beat) abjadext.nauert.QTargetBeat( beatspan=abjad.Duration(1, 8), offset_in_ms=abjad.Offset(1500, 1), search_tree=abjadext.nauert.UnweightedSearchTree( definition={ 3: None, }, ), tempo=abjad.MetronomeMark( reference_duration=abjad.Duration(1, 4), units_per_minute=56, ), )
Not composer-safe.
Used internally by
Quantizer
.Attributes Summary
__call__
Calls q-target beat. __format__
Formats q-event. beatspan
Beatspan of q-target beat. distances
A list of computed distances between the QEventProxies
associated with aQTargetBeat
instance, and eachQGrid
generated for that beat.duration_in_ms
Duration in milliseconds of the q-targeg beat. offset_in_ms
Offset in milliseconds of q-target beat. q_events
A list for storing QEventProxy
instances.q_grid
The QGrid
instance selected by aHeuristic
.q_grids
A tuple of QGrids
generated by aQuantizationJob
.search_tree
Search tree of q-target beat. tempo
MetronomeMark of q-target beat. Special methods
-
__call__
(job_id)¶ Calls q-target beat.
Returns quantization job.
-
__format__
(format_specification='')¶ Formats q-event.
Set format_specification to ‘’ or ‘storage’. Interprets ‘’ equal to ‘storage’.
Returns string.
-
(
AbjadObject
).__repr__
()¶ Gets interpreter representation of Abjad object.
Returns string.
Read-only properties
-
beatspan
¶ Beatspan of q-target beat.
>>> beatspan = (1, 8) >>> offset_in_ms = 1500 >>> search_tree = abjadext.nauert.UnweightedSearchTree({3: None}) >>> tempo = abjad.MetronomeMark((1, 4), 56)
>>> q_target_beat = abjadext.nauert.QTargetBeat( ... beatspan=beatspan, ... offset_in_ms=offset_in_ms, ... search_tree=search_tree, ... tempo=tempo, ... )
>>> q_target_beat.beatspan Duration(1, 8)
Returns duration.
-
distances
¶ A list of computed distances between the
QEventProxies
associated with aQTargetBeat
instance, and eachQGrid
generated for that beat.Used internally by the
Quantizer
.Returns tuple.
-
duration_in_ms
¶ Duration in milliseconds of the q-targeg beat.
>>> beatspan = (1, 8) >>> offset_in_ms = 1500 >>> search_tree = abjadext.nauert.UnweightedSearchTree({3: None}) >>> tempo = abjad.MetronomeMark((1, 4), 56)
>>> q_target_beat = abjadext.nauert.QTargetBeat( ... beatspan=beatspan, ... offset_in_ms=offset_in_ms, ... search_tree=search_tree, ... tempo=tempo, ... )
>>> q_target_beat.duration_in_ms Duration(3750, 7)
Returns duration.
-
offset_in_ms
¶ Offset in milliseconds of q-target beat.
>>> beatspan = (1, 8) >>> offset_in_ms = 1500 >>> search_tree = abjadext.nauert.UnweightedSearchTree({3: None}) >>> tempo = abjad.MetronomeMark((1, 4), 56)
>>> q_target_beat = abjadext.nauert.QTargetBeat( ... beatspan=beatspan, ... offset_in_ms=offset_in_ms, ... search_tree=search_tree, ... tempo=tempo, ... )
>>> q_target_beat.offset_in_ms Offset(1500, 1)
Returns offset.
-
q_events
¶ A list for storing
QEventProxy
instances.Used internally by the
Quantizer
.Returns list.
-
q_grid
¶ The
QGrid
instance selected by aHeuristic
.Used internally by the
Quantizer
.Returns
QGrid
instance.
-
q_grids
¶ A tuple of
QGrids
generated by aQuantizationJob
.Used internally by the
Quantizer
.Returns tuple.
-
search_tree
¶ Search tree of q-target beat.
>>> beatspan = (1, 8) >>> offset_in_ms = 1500 >>> search_tree = abjadext.nauert.UnweightedSearchTree({3: None}) >>> tempo = abjad.MetronomeMark((1, 4), 56)
>>> q_target_beat = abjadext.nauert.QTargetBeat( ... beatspan=beatspan, ... offset_in_ms=offset_in_ms, ... search_tree=search_tree, ... tempo=tempo, ... )
>>> q_target_beat.search_tree UnweightedSearchTree(definition={3: None})
Returns search tree.
-
tempo
¶ MetronomeMark of q-target beat.
>>> beatspan = (1, 8) >>> offset_in_ms = 1500 >>> search_tree = abjadext.nauert.UnweightedSearchTree({3: None}) >>> tempo = abjad.MetronomeMark((1, 4), 56)
>>> q_target_beat = abjadext.nauert.QTargetBeat( ... beatspan=beatspan, ... offset_in_ms=offset_in_ms, ... search_tree=search_tree, ... tempo=tempo, ... )
>>> q_target_beat.tempo MetronomeMark(reference_duration=Duration(1, 4), units_per_minute=56)
Returns tempo.
-