Talea¶

class abjadext.rmakers.Talea.Talea(*, counts=(1, ), denominator=16, preamble=None)¶

Talea.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     preamble=[1, 1, 1, 1],
...     )

>>> abjad.f(talea)
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1, 1, 1, 1],
    )

Attributes Summary

`__contains__`	Is true when talea contains `argument`.
`__getitem__`	Gets item or slice identified by `argument`.
`__iter__`	Iterates talea.
`__len__`	Gets length.
`advance`	Advances talea by `weight`.
`counts`	Gets counts.
`denominator`	Gets denominator.
`period`	Gets period of talea.
`preamble`	Gets preamble.

Special methods

__contains__(argument)¶

Is true when talea contains argument.

With preamble:

>>> talea = abjadext.rmakers.Talea(
...     counts=[10],
...     denominator=16,
...     preamble=[1, -1, 1],
...     )

>>> for i in range(1, 23 + 1):
...     i, i in talea
...
(1, True)
(2, True)
(3, True)
(4, False)
(5, False)
(6, False)
(7, False)
(8, False)
(9, False)
(10, False)
(11, False)
(12, False)
(13, True)
(14, False)
(15, False)
(16, False)
(17, False)
(18, False)
(19, False)
(20, False)
(21, False)
(22, False)
(23, True)

Return type:	`bool`

(AbjadValueObject).__copy__(*arguments)¶

Copies Abjad value object.

Returns new Abjad value object.

(AbjadValueObject).__eq__(argument)¶

Is true when all initialization values of Abjad value object equal the initialization values of argument.

Returns true or false.

(AbjadObject).__format__(format_specification='')¶

Formats Abjad object.

Set format_specification to '' or 'storage'. Interprets '' equal to 'storage'.

Returns string.

__getitem__(argument)¶

Gets item or slice identified by argument.

Gets item at index:

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     preamble=[1, 1, 1, 1],
...     )

>>> talea[0]
NonreducedFraction(1, 16)

>>> talea[1]
NonreducedFraction(1, 16)

Gets items in slice:

>>> for duration in talea[:6]:
...     duration
...
NonreducedFraction(1, 16)
NonreducedFraction(1, 16)
NonreducedFraction(1, 16)
NonreducedFraction(1, 16)
NonreducedFraction(2, 16)
NonreducedFraction(1, 16)

>>> for duration in talea[2:8]:
...     duration
...
NonreducedFraction(1, 16)
NonreducedFraction(1, 16)
NonreducedFraction(2, 16)
NonreducedFraction(1, 16)
NonreducedFraction(3, 16)
NonreducedFraction(2, 16)

Return type:	`Union`[`NonreducedFraction`, `List`[`NonreducedFraction`]]

(AbjadValueObject).__hash__()¶

Hashes Abjad value object.

Returns integer.

__iter__()¶

Iterates talea.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     preamble=[1, 1, 1, 1],
...     )

>>> for duration in talea:
...     duration
...
Duration(1, 16)
Duration(1, 16)
Duration(1, 16)
Duration(1, 16)
Duration(1, 8)
Duration(1, 16)
Duration(3, 16)
Duration(1, 8)
Duration(1, 4)
Duration(1, 16)
Duration(1, 16)

Return type:	`Generator`[+T_co, -T_contra, +V_co]

__len__()¶

Gets length.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     )

>>> len(talea)
7

Defined equal to length of counts.

Return type:	`int`

(AbjadObject).__repr__()¶

Gets interpreter representation of Abjad object.

Returns string.

Methods

advance(weight)¶

Advances talea by weight.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     preamble=[1, 1, 1, 1],
...     )

>>> abjad.f(talea.advance(0))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1, 1, 1, 1],
    )

>>> abjad.f(talea.advance(1))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1, 1, 1],
    )

>>> abjad.f(talea.advance(2))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1, 1],
    )

>>> abjad.f(talea.advance(3))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1],
    )

>>> abjad.f(talea.advance(4))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    )

>>> abjad.f(talea.advance(5))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1, 1, 3, 2, 4, 1, 1],
    )

>>> abjad.f(talea.advance(6))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[1, 3, 2, 4, 1, 1],
    )

>>> abjad.f(talea.advance(7))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[3, 2, 4, 1, 1],
    )

>>> abjad.f(talea.advance(8))
abjadext.rmakers.Talea(
    counts=[2, 1, 3, 2, 4, 1, 1],
    denominator=16,
    preamble=[2, 2, 4, 1, 1],
    )

REGRESSION. Works when talea advances by period of talea:

>>> talea = abjadext.rmakers.Talea(
...     counts=[1, 2, 3, 4],
...     denominator=16,
...     )

>>> abjad.f(talea.advance(10))
abjadext.rmakers.Talea(
    counts=[1, 2, 3, 4],
    denominator=16,
    )

>>> abjad.f(talea.advance(20))
abjadext.rmakers.Talea(
    counts=[1, 2, 3, 4],
    denominator=16,
    )

Return type:	`Talea`

Read-only properties

counts¶

Gets counts.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     )

>>> talea.counts
[2, 1, 3, 2, 4, 1, 1]

Return type:	`Optional`[`List`[`int`]]

denominator¶

Gets denominator.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     )

>>> talea.denominator
16

Set to nonnegative integer power of two.

Defaults to 16.

Return type:	`int`

period¶

Gets period of talea.

Equal to weight of counts:

>>> talea = abjadext.rmakers.Talea(
...     counts=[1, 2, 3, 4],
...     denominator=16,
...     )

>>> talea.period
10

Rests make no difference:

>>> talea = abjadext.rmakers.Talea(
...     counts=[1, 2, -3, 4],
...     denominator=16,
...     )

>>> talea.period
10

Denominator makes no difference:

>>> talea = abjadext.rmakers.Talea(
...     counts=[1, 2, -3, 4],
...     denominator=32,
...     )

>>> talea.period
10

Preamble makes no difference:

>>> talea = abjadext.rmakers.Talea(
...     counts=[1, 2, -3, 4],
...     denominator=32,
...     preamble=[1, 1, 1],
...     )

>>> talea.period
10

Return type:	`int`

preamble¶

Gets preamble.

>>> talea = abjadext.rmakers.Talea(
...     counts=[2, 1, 3, 2, 4, 1, 1],
...     denominator=16,
...     preamble=[1, 1, 1, 1],
...     )

>>> talea.preamble
[1, 1, 1, 1]

>>> talea = abjadext.rmakers.Talea(
...     counts=[16, -4, 16],
...     denominator=16,
...     preamble=[1],
...     )

>>> for i, duration in enumerate(talea):
...     duration
...
Duration(1, 16)
Duration(1, 1)
Duration(-1, 4)
Duration(1, 1)

Return type:	`Optional`[`List`[`int`]]