measuretools.append_spacer_skips_to_underfull_measures_in_expr

abjad.tools.measuretools.append_spacer_skips_to_underfull_measures_in_expr.append_spacer_skips_to_underfull_measures_in_expr(expr)[source]

New in version 1.1.

Append spacer skips to underfull measures in expr:

abjad> staff = Staff(Measure((3, 8), "c'8 d'8 e'8") * 3)
abjad> contexttools.detach_time_signature_marks_attached_to_component(staff[1])
(TimeSignatureMark((3, 8)),)
abjad> contexttools.TimeSignatureMark((4, 8))(staff[1])
TimeSignatureMark((4, 8))(|4/8, c'8, d'8, e'8|)
abjad> contexttools.detach_time_signature_marks_attached_to_component(staff[2])
(TimeSignatureMark((3, 8)),)
abjad> contexttools.TimeSignatureMark((5, 8))(staff[2])
TimeSignatureMark((5, 8))(|5/8, c'8, d'8, e'8|)
abjad> staff[1].is_underfull
True
abjad> staff[2].is_underfull
True
abjad> measuretools.append_spacer_skips_to_underfull_measures_in_expr(staff)
[Measure(4/8, [c'8, d'8, e'8, s1 * 1/8]), Measure(5/8, [c'8, d'8, e'8, s1 * 1/4])]
abjad> f(staff)
\new Staff {
    {
        \time 3/8
        c'8
        d'8
        e'8
    }
    {
        \time 4/8
        c'8
        d'8
        e'8
        s1 * 1/8
    }
    {
        \time 5/8
        c'8
        d'8
        e'8
        s1 * 1/4
    }
}

Return measures treated.

Changed in version 2.0: renamed measuretools.remedy_underfull_measures() to measuretools.append_spacer_skips_to_underfull_measures_in_expr().

This Page