pitchtools.permute_by_row — Abjad v1.1.1 documentation

### Navigation

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

# pitchtools.permute_by_row

`abjad.tools.pitchtools.` `permute_by_row`(pitches, row)

  Permute pitches by row.

  - pitches must be a list of zero or more Abjad `Pitch` or `Note` instances.
  - row must be a list of the twelve integers `0, ..., 11` in any order.

      abjad> notes = [Note(p, (1, 4)) for p in (17, -10, -2, 11)]
      abjad> row = [10, 0, 2, 6, 8, 7, 5, 3, 1, 9, 4, 11]
      abjad> pitchtools.permute_by_row(notes, row)
      [Note(bf, 4), Note(d, 4), Note(f'', 4), Note(b', 4)]

  This function works by reference only. No objects are cloned.

### Navigation

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