def with_power_of_two_denominator(
self, contents_multiplier=1
) -> "TimeSignature":
"""
Makes new time signature equivalent to current time signature with
power-of-two denominator.
.. container:: example
Non-power-of-two denominator with power-of-two denominator:
>>> time_signature = abjad.TimeSignature((3, 12))
>>> time_signature.with_power_of_two_denominator()
TimeSignature((2, 8))
"""
contents_multiplier = Multiplier(contents_multiplier)
contents_multiplier = Multiplier(contents_multiplier)
non_power_of_two_denominator = self.denominator
if contents_multiplier == Multiplier(1):
power_of_two_denominator = mathtools.greatest_power_of_two_less_equal(
non_power_of_two_denominator
)
else:
power_of_two_denominator = mathtools.greatest_power_of_two_less_equal(
non_power_of_two_denominator, 1
)
non_power_of_two_pair = NonreducedFraction(self.pair)
power_of_two_fraction = non_power_of_two_pair.with_denominator(
power_of_two_denominator
)
power_of_two_pair = power_of_two_fraction.pair
return type(self)(power_of_two_pair)
def with_power_of_two_denominator(self,
contents_multiplier=1
) -> "TimeSignature":
"""
Makes new time signature equivalent to current time signature with
power-of-two denominator.
.. container:: example
Non-power-of-two denominator with power-of-two denominator:
>>> time_signature = abjad.TimeSignature((3, 12))
>>> time_signature.with_power_of_two_denominator()
TimeSignature((2, 8))
"""
contents_multiplier = Multiplier(contents_multiplier)
contents_multiplier = Multiplier(contents_multiplier)
non_power_of_two_denominator = self.denominator
if contents_multiplier == Multiplier(1):
power_of_two_denominator = mathtools.greatest_power_of_two_less_equal(
non_power_of_two_denominator)
else:
power_of_two_denominator = mathtools.greatest_power_of_two_less_equal(
non_power_of_two_denominator, 1)
non_power_of_two_pair = NonreducedFraction(self.pair)
power_of_two_fraction = non_power_of_two_pair.with_denominator(
power_of_two_denominator)
power_of_two_pair = power_of_two_fraction.pair
return type(self)(power_of_two_pair)
def __call__(self, pitches, durations) -> Selection:
"""
Calls note-maker on ``pitches`` and ``durations``.
"""
from .Tuplet import Tuplet
if isinstance(pitches, str):
pitches = pitches.split()
if not isinstance(pitches, collections.abc.Iterable):
pitches = [pitches]
if isinstance(durations, (numbers.Number, tuple)):
durations = [durations]
nonreduced_fractions = Sequence(
[NonreducedFraction(_) for _ in durations]
)
size = max(len(nonreduced_fractions), len(pitches))
nonreduced_fractions = nonreduced_fractions.repeat_to_length(size)
pitches = Sequence(pitches).repeat_to_length(size)
durations = Duration._group_by_implied_prolation(nonreduced_fractions)
result: typing.List[typing.Union[Note, Tuplet]] = []
for duration in durations:
# get factors in denominator of duration group duration not 1 or 2
factors = set(mathtools.factors(duration[0].denominator))
factors.discard(1)
factors.discard(2)
ps = pitches[0 : len(duration)]
pitches = pitches[len(duration) :]
if len(factors) == 0:
result.extend(
self._make_unprolated_notes(
ps,
duration,
increase_monotonic=self.increase_monotonic,
repeat_ties=self.repeat_ties,
tag=self.tag,
)
)
else:
# compute prolation
denominator = duration[0].denominator
numerator = mathtools.greatest_power_of_two_less_equal(
denominator
)
multiplier = Multiplier(numerator, denominator)
ratio = multiplier.reciprocal
duration = [ratio * Duration(d) for d in duration]
ns = self._make_unprolated_notes(
ps,
duration,
increase_monotonic=self.increase_monotonic,
repeat_ties=self.repeat_ties,
tag=self.tag,
)
tuplet = Tuplet(multiplier, ns)
result.append(tuplet)
return Selection(result)
def __call__(self, pitches, durations) -> Selection:
"""
Calls note-maker on ``pitches`` and ``durations``.
"""
from .Tuplet import Tuplet
if isinstance(pitches, str):
pitches = pitches.split()
if not isinstance(pitches, collections.abc.Iterable):
pitches = [pitches]
if isinstance(durations, (numbers.Number, tuple)):
durations = [durations]
nonreduced_fractions = Sequence(
[NonreducedFraction(_) for _ in durations]
)
size = max(len(nonreduced_fractions), len(pitches))
nonreduced_fractions = nonreduced_fractions.repeat_to_length(size)
pitches = Sequence(pitches).repeat_to_length(size)
durations = Duration._group_by_implied_prolation(nonreduced_fractions)
result: typing.List[typing.Union[Note, Tuplet]] = []
for duration in durations:
# get factors in denominator of duration group duration not 1 or 2
factors = set(mathtools.factors(duration[0].denominator))
factors.discard(1)
factors.discard(2)
ps = pitches[0 : len(duration)]
pitches = pitches[len(duration) :]
if len(factors) == 0:
result.extend(
self._make_unprolated_notes(
ps,
duration,
increase_monotonic=self.increase_monotonic,
tag=self.tag,
)
)
else:
# compute prolation
denominator = duration[0].denominator
numerator = mathtools.greatest_power_of_two_less_equal(
denominator
)
multiplier = Multiplier(numerator, denominator)
ratio = multiplier.reciprocal
duration = [ratio * Duration(d) for d in duration]
ns = self._make_unprolated_notes(
ps,
duration,
increase_monotonic=self.increase_monotonic,
tag=self.tag,
)
tuplet = Tuplet(multiplier, ns)
result.append(tuplet)
return Selection(result)
def equal_or_greater_assignable(self):
r"""
Gets assignable duration equal to or just greater than this
duration.
.. container:: example
Gets equal-or-greater assignable duration:
>>> for numerator in range(1, 16 + 1):
... duration = abjad.Duration(numerator, 16)
... result = duration.equal_or_greater_assignable
... sixteenths = duration.with_denominator(16)
... print(f'{sixteenths!s}\t{result!s}')
...
1/16 1/16
2/16 1/8
3/16 3/16
4/16 1/4
5/16 3/8
6/16 3/8
7/16 7/16
8/16 1/2
9/16 3/4
10/16 3/4
11/16 3/4
12/16 3/4
13/16 7/8
14/16 7/8
15/16 15/16
16/16 1
Returns new duration.
"""
good_denominator = mathtools.greatest_power_of_two_less_equal(
self.denominator)
current_numerator = self.numerator
candidate = type(self)(current_numerator, good_denominator)
while not candidate.is_assignable:
current_numerator += 1
candidate = type(self)(current_numerator, good_denominator)
return candidate
def equal_or_greater_assignable(self) -> "Duration":
r"""
Gets assignable duration equal to or just greater than this
duration.
.. container:: example
Gets equal-or-greater assignable duration:
>>> for numerator in range(1, 16 + 1):
... duration = abjad.Duration(numerator, 16)
... result = duration.equal_or_greater_assignable
... sixteenths = duration.with_denominator(16)
... print(f'{sixteenths!s}\t{result!s}')
...
1/16 1/16
2/16 1/8
3/16 3/16
4/16 1/4
5/16 3/8
6/16 3/8
7/16 7/16
8/16 1/2
9/16 3/4
10/16 3/4
11/16 3/4
12/16 3/4
13/16 7/8
14/16 7/8
15/16 15/16
16/16 1
"""
good_denominator = mathtools.greatest_power_of_two_less_equal(
self.denominator
)
current_numerator = self.numerator
candidate = type(self)(current_numerator, good_denominator)
while not candidate.is_assignable:
current_numerator += 1
candidate = type(self)(current_numerator, good_denominator)
return candidate
def implied_prolation(self):
r"""
Gets implied prolation.
.. container:: example
Gets implied prolation:
>>> for denominator in range(1, 16 + 1):
... duration = abjad.Duration(1, denominator)
... result = duration.implied_prolation
... print('{!s}\t{!s}'.format(duration, result))
...
1 1
1/2 1
1/3 2/3
1/4 1
1/5 4/5
1/6 2/3
1/7 4/7
1/8 1
1/9 8/9
1/10 4/5
1/11 8/11
1/12 2/3
1/13 8/13
1/14 4/7
1/15 8/15
1/16 1
Returns multipler.
"""
import abjad
numerator = mathtools.greatest_power_of_two_less_equal(
self.denominator
)
return abjad.Multiplier(numerator, self.denominator)
def implied_prolation(self):
r"""
Gets implied prolation.
.. container:: example
Gets implied prolation:
>>> for denominator in range(1, 16 + 1):
... duration = abjad.Duration(1, denominator)
... result = duration.implied_prolation
... print('{!s}\t{!s}'.format(duration, result))
...
1 1
1/2 1
1/3 2/3
1/4 1
1/5 4/5
1/6 2/3
1/7 4/7
1/8 1
1/9 8/9
1/10 4/5
1/11 8/11
1/12 2/3
1/13 8/13
1/14 4/7
1/15 8/15
1/16 1
Returns multipler.
"""
import abjad
numerator = mathtools.greatest_power_of_two_less_equal(
self.denominator)
return abjad.Multiplier(numerator, self.denominator)
def __call__(self, pitches, durations) -> Selection:
"""
Calls leaf-maker on ``pitches`` and ``durations``.
Returns selection.
"""
from .Tuplet import Tuplet
if isinstance(pitches, str):
pitches = pitches.split()
if not isinstance(pitches, collections.abc.Iterable):
pitches = [pitches]
if isinstance(durations, (numbers.Number, tuple)):
durations = [durations]
nonreduced_fractions = Sequence(
[NonreducedFraction(_) for _ in durations]
)
size = max(len(nonreduced_fractions), len(pitches))
nonreduced_fractions = nonreduced_fractions.repeat_to_length(size)
pitches = Sequence(pitches).repeat_to_length(size)
duration_groups = Duration._group_by_implied_prolation(
nonreduced_fractions
)
result: typing.List[typing.Union[Tuplet, Leaf]] = []
for duration_group in duration_groups:
# get factors in denominator of duration group other than 1, 2.
factors = mathtools.factors(duration_group[0].denominator)
factors = set(factors)
factors.discard(1)
factors.discard(2)
current_pitches = pitches[0 : len(duration_group)]
pitches = pitches[len(duration_group) :]
if len(factors) == 0:
for pitch, duration in zip(current_pitches, duration_group):
leaves = self._make_leaf_on_pitch(
pitch,
duration,
increase_monotonic=self.increase_monotonic,
forbidden_note_duration=self.forbidden_note_duration,
forbidden_rest_duration=self.forbidden_rest_duration,
repeat_ties=self.repeat_ties,
skips_instead_of_rests=self.skips_instead_of_rests,
tag=self.tag,
use_multimeasure_rests=self.use_multimeasure_rests,
)
result.extend(leaves)
else:
# compute tuplet prolation
denominator = duration_group[0].denominator
numerator = mathtools.greatest_power_of_two_less_equal(
denominator
)
multiplier = (numerator, denominator)
ratio = 1 / Duration(*multiplier)
duration_group = [
ratio * Duration(duration) for duration in duration_group
]
# make tuplet leaves
tuplet_leaves: typing.List[Leaf] = []
for pitch, duration in zip(current_pitches, duration_group):
leaves = self._make_leaf_on_pitch(
pitch,
duration,
increase_monotonic=self.increase_monotonic,
repeat_ties=self.repeat_ties,
skips_instead_of_rests=self.skips_instead_of_rests,
tag=self.tag,
use_multimeasure_rests=self.use_multimeasure_rests,
)
tuplet_leaves.extend(leaves)
tuplet = Tuplet(multiplier, tuplet_leaves)
result.append(tuplet)
return Selection(result)
def __call__(self, pitches, durations) -> Selection:
"""
Calls leaf-maker on ``pitches`` and ``durations``.
Returns selection.
"""
from .Tuplet import Tuplet
if isinstance(pitches, str):
pitches = pitches.split()
if not isinstance(pitches, collections.Iterable):
pitches = [pitches]
if isinstance(durations, (numbers.Number, tuple)):
durations = [durations]
nonreduced_fractions = Sequence(
[NonreducedFraction(_) for _ in durations])
size = max(len(nonreduced_fractions), len(pitches))
nonreduced_fractions = nonreduced_fractions.repeat_to_length(size)
pitches = Sequence(pitches).repeat_to_length(size)
duration_groups = Duration._group_by_implied_prolation(
nonreduced_fractions)
result: typing.List[typing.Union[Tuplet, Leaf]] = []
for duration_group in duration_groups:
# get factors in denominator of duration group other than 1, 2.
factors = mathtools.factors(duration_group[0].denominator)
factors = set(factors)
factors.discard(1)
factors.discard(2)
current_pitches = pitches[0:len(duration_group)]
pitches = pitches[len(duration_group):]
if len(factors) == 0:
for pitch, duration in zip(current_pitches, duration_group):
leaves = self._make_leaf_on_pitch(
pitch,
duration,
increase_monotonic=self.increase_monotonic,
forbidden_note_duration=self.forbidden_note_duration,
forbidden_rest_duration=self.forbidden_rest_duration,
repeat_ties=self.repeat_ties,
skips_instead_of_rests=self.skips_instead_of_rests,
tag=self.tag,
use_multimeasure_rests=self.use_multimeasure_rests,
)
result.extend(leaves)
else:
# compute tuplet prolation
denominator = duration_group[0].denominator
numerator = mathtools.greatest_power_of_two_less_equal(
denominator)
multiplier = (numerator, denominator)
ratio = 1 / Duration(*multiplier)
duration_group = [
ratio * Duration(duration) for duration in duration_group
]
# make tuplet leaves
tuplet_leaves: typing.List[Leaf] = []
for pitch, duration in zip(current_pitches, duration_group):
leaves = self._make_leaf_on_pitch(
pitch,
duration,
increase_monotonic=self.increase_monotonic,
repeat_ties=self.repeat_ties,
skips_instead_of_rests=self.skips_instead_of_rests,
tag=self.tag,
use_multimeasure_rests=self.use_multimeasure_rests,
)
tuplet_leaves.extend(leaves)
tuplet = Tuplet(multiplier, tuplet_leaves)
result.append(tuplet)
return Selection(result)
