measuretools.concentrate — Abjad v1.1.1 documentation

### Navigation

- index
- modules |
- next |
- previous |
- Project Abjad »
- Abjad v1.1.1 documentation »
- Abjad API »

# 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|

### Navigation

- index
- modules |
- next |
- previous |
- Project Abjad »
- Abjad v1.1.1 documentation »
- Abjad API »