InciseSpecifier

digraph InheritanceGraph { graph [bgcolor=transparent, color=lightsteelblue2, fontname=Arial, fontsize=10, outputorder=edgesfirst, overlap=prism, penwidth=2, rankdir=LR, splines=spline, style="dashed, rounded", truecolor=true]; node [colorscheme=pastel19, fontname=Arial, fontsize=10, height=0, penwidth=2, shape=box, style="filled, rounded", width=0]; edge [color=lightslategrey, penwidth=1]; subgraph "cluster_abjad.system" { graph [label="abjad.system"]; node [color=1]; "abjad.system.AbjadObject.AbjadObject" [URL="../api/abjadext/rmakers/../../abjad/system/AbjadObject.html#abjad.system.AbjadObject.AbjadObject", label="Abjad\nObject", target=_top]; "abjad.system.AbjadValueObject.AbjadValueObject" [URL="../api/abjadext/rmakers/../../abjad/system/AbjadValueObject.html#abjad.system.AbjadValueObject.AbjadValueObject", label="Abjad\nValue\nObject", target=_top]; "abjad.system.AbjadObject.AbjadObject" -> "abjad.system.AbjadValueObject.AbjadValueObject"; } subgraph "cluster_abjadext.rmakers" { graph [label="abjadext.rmakers"]; node [color=2]; "abjadext.rmakers.InciseSpecifier.InciseSpecifier" [URL="../api/abjadext/rmakers/InciseSpecifier.html#abjadext.rmakers.InciseSpecifier.InciseSpecifier", color=black, fontcolor=white, label="Incise\nSpecifier", target=_top]; } subgraph cluster_builtins { graph [label=builtins]; node [color=3]; "builtins.object" [URL="https://docs.python.org/3.6/library/functions.html#object", label=object, target=_top]; } "abjad.system.AbjadValueObject.AbjadValueObject" -> "abjadext.rmakers.InciseSpecifier.InciseSpecifier"; "builtins.object" -> "abjad.system.AbjadObject.AbjadObject"; }

class abjadext.rmakers.InciseSpecifier.InciseSpecifier(*, prefix_talea=None, prefix_counts=None, suffix_talea=None, suffix_counts=None, talea_denominator=None, body_ratio=None, fill_with_notes=True, outer_divisions_only=None)

Incise specifier.

Specifies one sixteenth rest cut out of the beginning of every division:

>>> specifier = abjadext.rmakers.InciseSpecifier(
...     prefix_talea=[-1],
...     prefix_counts=[1],
...     talea_denominator=16,
...     )

Specifies sixteenth rests cut out of the beginning and end of each division:

>>> specifier = abjadext.rmakers.InciseSpecifier(
...     prefix_talea=[-1],
...     prefix_counts=[1],
...     suffix_talea=[-1],
...     suffix_counts=[1],
...     talea_denominator=16,
...     )

Attributes Summary

__format__ Formats incise specifier.
body_ratio Gets body ratio.
fill_with_notes Is true when rhythm-maker should fill divisions with notes.
outer_divisions_only Is true when rhythm-maker should incise outer divisions only.
prefix_counts Gets prefix counts.
prefix_talea Gets prefix talea.
suffix_counts Gets suffix counts.
suffix_talea Gets suffix talea.
talea_denominator Gets talea denominator.

Special methods

(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.

__format__(format_specification='')

Formats incise specifier.

Formats incise specifier:

>>> specifier = abjadext.rmakers.InciseSpecifier(
...     prefix_talea=[-1],
...     prefix_counts=[1],
...     talea_denominator=16,
...     )
>>> abjad.f(specifier)
abjadext.rmakers.InciseSpecifier(
    prefix_talea=[-1],
    prefix_counts=[1],
    suffix_talea=(),
    suffix_counts=(),
    talea_denominator=16,
    fill_with_notes=True,
    )

Formats incise specifier:

>>> specifier = abjadext.rmakers.InciseSpecifier(
...     prefix_talea=[-1],
...     prefix_counts=[0, 1],
...     suffix_talea=[-1],
...     suffix_counts=[1],
...     talea_denominator=16,
...     )
>>> abjad.f(specifier)
abjadext.rmakers.InciseSpecifier(
    prefix_talea=[-1],
    prefix_counts=[0, 1],
    suffix_talea=[-1],
    suffix_counts=[1],
    talea_denominator=16,
    fill_with_notes=True,
    )
Return type:str
(AbjadValueObject).__hash__()

Hashes Abjad value object.

Returns integer.

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Read-only properties

body_ratio

Gets body ratio.

Divides middle part of every division 1:1:

>>> specifier = abjadext.rmakers.InciseSpecifier(
...     prefix_talea=[-1],
...     prefix_counts=[0, 1],
...     suffix_talea=[-1],
...     suffix_counts=[1],
...     talea_denominator=16,
...     body_ratio=abjad.Ratio((1, 1)),
...     )
>>> rhythm_maker = abjadext.rmakers.IncisedRhythmMaker(
...     incise_specifier=specifier,
...     )
>>> divisions = 4 * [(5, 16)]
>>> selections = rhythm_maker(divisions)
>>> lilypond_file = abjad.LilyPondFile.rhythm(
...     selections,
...     divisions,
...     )
>>> abjad.show(lilypond_file) 
Return type:Optional[Ratio]
fill_with_notes

Is true when rhythm-maker should fill divisions with notes.

Todo

Add examples.

Return type:Optional[bool]
outer_divisions_only

Is true when rhythm-maker should incise outer divisions only. Is false when rhythm-maker should incise all divisions.

Todo

Add examples.

Return type:Optional[bool]
prefix_counts

Gets prefix counts.

Todo

Add examples.

Return type:Optional[List[int]]
prefix_talea

Gets prefix talea.

Todo

Add examples.

Return type:Optional[List[int]]
suffix_counts

Gets suffix counts.

Todo

Add examples.

Return type:Optional[List[int]]
suffix_talea

Gets suffix talea.

Todo

Add examples.

Return type:Optional[List[int]]
talea_denominator

Gets talea denominator.

Todo

Add examples.

Return type:Optional[int]