tuplettools.subsume — Abjad v1.1.1 documentation

### Navigation

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

# tuplettools.subsume

`abjad.tools.tuplettools.` `subsume`(tuplet)

  Scale `tuplet` contents and then bequeath in-score position of `tuplet` to contents.

  Return orphaned `tuplet` emptied of all contents.

      abjad> t = Staff(FixedDurationTuplet((3, 8), construct.scale(2)) * 2)
      abjad> Beam(t.leaves)
      abjad> print t.format
      \new Staff {
              \fraction \times 3/2 {
                      c'8 [
                      d'8
              }
              \fraction \times 3/2 {
                      c'8
                      d'8 ]
              }
      }

      abjad> tuplettools.subsume(t[0])
      FixedDurationTuplet(3/8, [ ])
      abjad> print t.format
      \new Staff {
              c'8. [
              d'8.
              \fraction \times 3/2 {
                      c'8
                      d'8 ]
              }
      }

  Note

  This function should probably be called `scale_contents_and_bequeath( )`.

  Note

  `bequeath( )` should probably be called something else, too.

### Navigation

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