def map_sequence_elements_to_canonic_tuples(sequence, decrease_parts_monotonically=True):
'''Partition `sequence` elements into canonic parts that decrease monotonically:
::
>>> sequencetools.map_sequence_elements_to_canonic_tuples(
... range(10))
[(0,), (1,), (2,), (3,), (4,), (4, 1), (6,), (7,), (8,), (8, 1)]
Partition `sequence` elements into canonic parts that increase monotonically:
::
>>> sequencetools.map_sequence_elements_to_canonic_tuples(
... range(10), decrease_parts_monotonically=False)
[(0,), (1,), (2,), (3,), (4,), (1, 4), (6,), (7,), (8,), (1, 8)]
Raise type error when `sequence` is not a list.
Raise value error on noninteger elements in `sequence`.
Returns list of tuples.
'''
if not isinstance(sequence, list):
raise TypeError
if not all(isinstance(x, (int, long)) for x in sequence):
raise ValueError
result = []
for x in sequence:
result.append(mathtools.partition_integer_into_canonic_parts(
x, decrease_parts_monotonically=decrease_parts_monotonically))
return result
def make_tied_leaf(
kind,
duration,
decrease_durations_monotonically=True,
forbidden_written_duration=None,
pitches=None,
tie_parts=True,
):
r'''Make tied `kind` with `duration`.
.. container:: example
**Example 1.** Make note:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(1, 2),
... pitches='C#5',
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((2, 4))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 2/4
cs''2
}
.. container:: example
**Example 2.** Make note and forbid half notes:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(1, 2),
... pitches='C#5',
... forbidden_written_duration=Duration(1, 2),
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((2, 4))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 2/4
cs''4 ~
cs''4
}
.. container:: example
**Example 3.** Make tied note with half notes forbidden and
durations decreasing monotonically:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(9, 8),
... pitches='C#5',
... forbidden_written_duration=Duration(1, 2),
... decrease_durations_monotonically=True,
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((9, 8))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 9/8
cs''4 ~
cs''4 ~
cs''4 ~
cs''4 ~
cs''8
}
.. container:: example
**Example 4.** Make tied note with half notes forbidden and
durations increasing monotonically:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(9, 8),
... pitches='C#5',
... forbidden_written_duration=Duration(1, 2),
... decrease_durations_monotonically=False,
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((9, 8))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 9/8
cs''8 ~
cs''4 ~
cs''4 ~
cs''4 ~
cs''4
}
Returns selection of unincorporated leaves.
'''
from abjad.tools import scoretools
from abjad.tools import spannertools
# check input
duration = durationtools.Duration(duration)
if forbidden_written_duration is not None:
forbidden_written_duration = \
durationtools.Duration(forbidden_written_duration)
assert forbidden_written_duration.is_assignable
assert forbidden_written_duration.numerator == 1
# find preferred numerator of written durations if necessary
if forbidden_written_duration is not None and \
forbidden_written_duration <= duration:
denominators = [
2 * forbidden_written_duration.denominator,
duration.denominator,
]
denominator = mathtools.least_common_multiple(*denominators)
forbidden_written_duration = \
mathtools.NonreducedFraction(forbidden_written_duration)
forbidden_written_duration = \
forbidden_written_duration.with_denominator(denominator)
duration = mathtools.NonreducedFraction(duration)
duration = duration.with_denominator(denominator)
forbidden_numerator = forbidden_written_duration.numerator
assert forbidden_numerator % 2 == 0
preferred_numerator = forbidden_numerator / 2
# make written duration numerators
numerators = []
parts = mathtools.partition_integer_into_canonic_parts(duration.numerator)
if forbidden_written_duration is not None and \
forbidden_written_duration <= duration:
for part in parts:
if forbidden_numerator <= part:
better_parts = \
mathtools.partition_integer_into_parts_less_than_double(
part, preferred_numerator)
numerators.extend(better_parts)
else:
numerators.append(part)
else:
numerators = parts
# reverse numerators if necessary
if not decrease_durations_monotonically:
numerators = list(reversed(numerators))
# make one leaf per written duration
result = []
for numerator in numerators:
written_duration = \
durationtools.Duration(numerator, duration.denominator)
if not pitches is None:
args = (pitches, written_duration)
else:
args = (written_duration, )
result.append(kind(*args))
# apply tie spanner if required
if tie_parts and 1 < len(result):
if not issubclass(kind, (scoretools.Rest, scoretools.Skip)):
tie = spannertools.Tie()
attach(tie, result)
# return result
result = selectiontools.Selection(result)
return result
def make_tied_leaf(
kind,
duration,
decrease_durations_monotonically=True,
forbidden_written_duration=None,
pitches=None,
tie_parts=True,
):
r'''Make tied `kind` with `duration`.
.. container:: example
**Example 1.** Make note:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(1, 2),
... pitches='C#5',
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((2, 4))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 2/4
cs''2
}
.. container:: example
**Example 2.** Make note and forbid half notes:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(1, 2),
... pitches='C#5',
... forbidden_written_duration=Duration(1, 2),
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((2, 4))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 2/4
cs''4 ~
cs''4
}
.. container:: example
**Example 3.** Make tied note with half notes forbidden and
durations decreasing monotonically:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(9, 8),
... pitches='C#5',
... forbidden_written_duration=Duration(1, 2),
... decrease_durations_monotonically=True,
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((9, 8))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 9/8
cs''4 ~
cs''4 ~
cs''4 ~
cs''4 ~
cs''8
}
.. container:: example
**Example 4.** Make tied note with half notes forbidden and
durations increasing monotonically:
::
>>> leaves = scoretools.make_tied_leaf(
... Note,
... Duration(9, 8),
... pitches='C#5',
... forbidden_written_duration=Duration(1, 2),
... decrease_durations_monotonically=False,
... )
>>> staff = Staff(leaves)
>>> time_signature = TimeSignature((9, 8))
>>> attach(time_signature, staff)
>>> show(staff) # doctest: +SKIP
.. doctest::
>>> print(format(staff))
\new Staff {
\time 9/8
cs''8 ~
cs''4 ~
cs''4 ~
cs''4 ~
cs''4
}
Returns selection of unincorporated leaves.
'''
from abjad.tools import scoretools
from abjad.tools import spannertools
# check input
duration = durationtools.Duration(duration)
if forbidden_written_duration is not None:
forbidden_written_duration = \
durationtools.Duration(forbidden_written_duration)
assert forbidden_written_duration.is_assignable
assert forbidden_written_duration.numerator == 1
# find preferred numerator of written durations if necessary
if forbidden_written_duration is not None and \
forbidden_written_duration <= duration:
denominators = [
2 * forbidden_written_duration.denominator,
duration.denominator,
]
denominator = mathtools.least_common_multiple(*denominators)
forbidden_written_duration = \
mathtools.NonreducedFraction(forbidden_written_duration)
forbidden_written_duration = \
forbidden_written_duration.with_denominator(denominator)
duration = mathtools.NonreducedFraction(duration)
duration = duration.with_denominator(denominator)
forbidden_numerator = forbidden_written_duration.numerator
assert forbidden_numerator % 2 == 0
preferred_numerator = forbidden_numerator / 2
# make written duration numerators
numerators = []
parts = mathtools.partition_integer_into_canonic_parts(duration.numerator)
if forbidden_written_duration is not None and \
forbidden_written_duration <= duration:
for part in parts:
if forbidden_numerator <= part:
better_parts = \
mathtools.partition_integer_into_parts_less_than_double(
part, preferred_numerator)
numerators.extend(better_parts)
else:
numerators.append(part)
else:
numerators = parts
# reverse numerators if necessary
if not decrease_durations_monotonically:
numerators = list(reversed(numerators))
# make one leaf per written duration
result = []
for numerator in numerators:
written_duration = \
durationtools.Duration(numerator, duration.denominator)
if not pitches is None:
args = (pitches, written_duration)
else:
args = (written_duration, )
result.append(kind(*args))
# apply tie spanner if required
if tie_parts and 1 < len(result):
if not issubclass(kind, (scoretools.Rest, scoretools.Skip)):
tie = spannertools.Tie()
attach(tie, result)
# return result
result = selectiontools.Selection(result)
return result