sequencetools.flatten_sequence

abjad.tools.sequencetools.flatten_sequence.flatten_sequence(sequence, klasses=None, depth=-1)[source]

New in version 1.1.

Flatten sequence:

abjad> from abjad.tools import sequencetools
abjad> sequencetools.flatten_sequence([1, [2, 3, [4]], 5, [6, 7, [8]]])
[1, 2, 3, 4, 5, 6, 7, 8]

Flatten sequence to depth 1:

abjad> sequencetools.flatten_sequence([1, [2, 3, [4]], 5, [6, 7, [8]]], depth = 1)
[1, 2, 3, [4], 5, 6, 7, [8]]

Flatten sequence to depth 2:

abjad> sequencetools.flatten_sequence([1, [2, 3, [4]], 5, [6, 7, [8]]], depth = 2)
[1, 2, 3, 4, 5, 6, 7, 8]

Leave sequence unchanged.

Return newly constructed sequence object.

Changed in version 2.0: renamed listtools.flatten() to sequencetools.flatten_sequence().

This Page