New in version 1.1.
Repeat subruns in sequence according to indicators. The indicators input parameter must be a list of zero or more (start, length, count) triples. For every (start, length, count) indicator in indicators, the function copies sequence[start:start+length] and inserts count new copies of sequence[start:start+length] immediately after sequence[start:start+length] in sequence.
Note
The function reads the value of count in every (start, length, count) triple not as the total number of occurrences of sequence[start:start+length] to appear in sequence after execution, but rather as the number of new occurrences of sequence[start:start+length] to appear in sequence after execution.
Note
The function wraps newly created subruns in tuples. That is, this function returns output with one more level of nesting than given in input.
To insert 10 count of sequence[:2] at sequence[2:2]:
abjad> from abjad.tools import sequencetools
abjad> sequencetools.repeat_runs_in_sequence_to_count(range(20), [(0, 2, 10)])
[0, 1, (0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1, 0, 1),
2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19]
To insert 5 count of sequence[10:12] at sequence[12:12] and then insert 5 count of sequence[:2] at sequence[2:2]:
abjad> sequence = range(20)
abjad> sequencetools.repeat_runs_in_sequence_to_count(sequence, [(0, 2, 5), (10, 2, 5)])
[0, 1, (0, 1, 0, 1, 0, 1, 0, 1, 0, 1), 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, (10, 11, 10, 11, 10, 11, 10, 11, 10, 11), 12, 13, 14, 15, 16, 17, 18, 19]
Note
This function wraps around the end of sequence whenever len(sequence) < start + length.
To insert 2 count of [18, 19, 0, 1] at sequence[2:2]:
abjad> sequencetools.repeat_runs_in_sequence_to_count(sequence, [(18, 4, 2)])
[0, 1, (18, 19, 0, 1, 18, 19, 0, 1), 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19]
To insert 2 count of [18, 19, 0, 1, 2, 3, 4] at sequence[4:4]:
abjad> sequencetools.repeat_runs_in_sequence_to_count(sequence, [(18, 8, 2)])
[0, 1, 2, 3, 4, 5, (18, 19, 0, 1, 2, 3, 4, 5, 18, 19, 0, 1, 2, 3, 4, 5), 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19]
Todo
Implement an optional wrap keyword to specify whether this function should wrap around the ened of sequence whenever len(sequence) < start + length or not.
Todo
Reimplement this function to return a generator.
Generalizations of this function would include functions to repeat subruns in sequence to not only a certain count, as implemented here, but to a certain length, weight or sum. That is, sequencetools.repeat_subruns_to_length(), sequencetools.repeat_subruns_to_weight() and sequencetools.repeat_subruns_to_sum().
Changed in version 2.0: renamed sequencetools.repeat_subruns_to_count() to sequencetools.repeat_runs_in_sequence_to_count().