New in version 2.0.
Divide tie_chain into fixed-duration tuplet according to arbitrary integer proportions.
Interpret proportions as a ratio. That is, reduce integers in proportions relative to each other.
Return non-trivial tuplet as augmentation.
Where proportions[i] == 1 for i < len(proportions), allow tupletted notes to carry dots.
abjad> staff = Staff([Note(0, (1, 8)), Note(0, (1, 16)), Note(0, (1, 16))])
abjad> tietools.TieSpanner(staff[:2])
TieSpanner(c'8, c'16)
abjad> spannertools.BeamSpanner(staff[:])
BeamSpanner(c'8, c'16, c'16)
abjad> tie_chain = tietools.get_tie_chain(staff[0])
abjad> tietools.tie_chain_to_augmented_tuplet_with_proportions_and_encourage_dots(tie_chain, [1])
FixedDurationTuplet(3/16, [c'8.])
abjad> f(staff)
\new Staff {
{
c'8. [
}
c'16 ]
}
abjad> staff = Staff([Note(0, (1, 8)), Note(0, (1, 16)), Note(0, (1, 16))])
abjad> tietools.TieSpanner(staff[:2])
TieSpanner(c'8, c'16)
abjad> spannertools.BeamSpanner(staff[:])
BeamSpanner(c'8, c'16, c'16)
abjad> tie_chain = tietools.get_tie_chain(staff[0])
abjad> tietools.tie_chain_to_augmented_tuplet_with_proportions_and_encourage_dots(tie_chain, [1, 2])
FixedDurationTuplet(3/16, [c'16, c'8])
abjad> f(staff)
\new Staff {
{
c'16 [
c'8
}
c'16 ]
}
abjad> staff = Staff([Note(0, (1, 8)), Note(0, (1, 16)), Note(0, (1, 16))])
abjad> tietools.TieSpanner(staff[:2])
TieSpanner(c'8, c'16)
abjad> spannertools.BeamSpanner(staff[:])
BeamSpanner(c'8, c'16, c'16)
abjad> tie_chain = tietools.get_tie_chain(staff[0])
abjad> tietools.tie_chain_to_augmented_tuplet_with_proportions_and_encourage_dots(tie_chain, [1, 2, 2])
FixedDurationTuplet(3/16, [c'64., c'32., c'32.])
abjad> f(staff)
\new Staff {
\fraction \times 8/5 {
c'64. [
c'32.
c'32.
}
c'16 ]
}
Changed in version 2.0: renamed divide.tie_chain_into_arbitrary_augmentation_dotted() to tietools.tie_chain_to_augmented_tuplet_with_proportions_and_encourage_dots().