measuretools.concentrate

abjad.tools.measuretools.concentrate(expr, concentration_pairs, cyclic=True)

Expr may be any Abjad expression. Concentration_pairs a Python list of pairs, each of the form (spin_count, scalar_denominator). Both spin_count and scalar_denominator must be positive integers.

Iterate expr. For every measure in expr, spin measure by the spin_count element in concentration_pair and scale measure by 1/scalar_denominator element in concentration_pair.

Return Python list of transformed measures.

Example:

abjad> t = RigidMeasure((3, 16), construct.run(3, Rational(1, 16)))
abjad> print(measuretools.concentrate(t, [(3, 3)])[0])
|9/48, c'32, c'32, c'32, c'32, c'32, c'32, c'32, c'32, c'32|

Example:

abjad> t = RigidMeasure((3, 16), construct.run(3, Rational(1, 16)))
abjad> print(measuretools.concentrate(t, [(3, 2)])[0])
|9/32, c'32, c'32, c'32, c'32, c'32, c'32, c'32, c'32, c'32|

Example:

abjad> t = RigidMeasure((3, 16), construct.run(3, Rational(1, 16)))
abjad> print(measuretools.concentrate(t, [(3, 1)])[0])
|9/16, c'16, c'16, c'16, c'16, c'16, c'16, c'16, c'16, c'16|

Previous topic

measuretools.color_nonbinary

Next topic

measuretools.denominator_set

This Page