Multiplication

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.pitch" { graph [label="abjad.pitch"]; node [color=1]; "abjad.pitch.Multiplication.Multiplication" [URL="../api/abjad/pitch/Multiplication.html#abjad.pitch.Multiplication.Multiplication", color=black, fontcolor=white, label=Multiplication, target=_top]; } subgraph "cluster_abjad.system" { graph [label="abjad.system"]; node [color=2]; "abjad.system.AbjadObject.AbjadObject" [URL="../api/abjad/pitch/../system/AbjadObject.html#abjad.system.AbjadObject.AbjadObject", label="Abjad\nObject", target=_top]; "abjad.system.AbjadValueObject.AbjadValueObject" [URL="../api/abjad/pitch/../system/AbjadValueObject.html#abjad.system.AbjadValueObject.AbjadValueObject", label="Abjad\nValue\nObject", target=_top]; "abjad.system.AbjadObject.AbjadObject" -> "abjad.system.AbjadValueObject.AbjadValueObject"; } 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" -> "abjad.pitch.Multiplication.Multiplication"; "builtins.object" -> "abjad.system.AbjadObject.AbjadObject"; }

class abjad.pitch.Multiplication.Multiplication(*, n=1)

Multiplication operator.

>>> abjad.Multiplication()
Multiplication(n=1)
>>> abjad.Multiplication(n=5)
Multiplication(n=5)

Object model of twelve-tone multiplication operator.


Attributes Summary

__add__ Composes multiplication and operator.
__call__ Calls multiplication on argument.
__radd__ Right-addition not defined on multiplication.
__str__ Gets string representation of operator.
n Gets index of multiplication.

Special methods

__add__(operator)

Composes multiplication and operator.

Example segment:

>>> items = [0, 2, 4, 5]
>>> segment = abjad.PitchClassSegment(items=items)
>>> abjad.show(segment) 

Example operators:

>>> multiplication = abjad.Multiplication(n=5)
>>> transposition = abjad.Transposition(n=3)

Transposition followed by multiplication:

>>> operator = multiplication + transposition
>>> str(operator)
'M5T3'
>>> segment_ = operator(segment)
>>> abjad.show(segment_) 

Same as above because multiplication and transposition commute:

>>> operator = transposition + multiplication
>>> str(operator)
'T3M5'
>>> segment_ = operator(segment)
>>> abjad.show(segment_) 

Returns compound operator.

__call__(argument)

Calls multiplication on argument.

Multiplies pitch-class:

>>> multiplication = abjad.Multiplication(n=5)
>>> pitch_class = abjad.NumberedPitchClass(4)
>>> multiplication(pitch_class)
NumberedPitchClass(8)

Multiplies pitch:

>>> multiplication = abjad.Multiplication(n=7)
>>> pitch = abjad.NamedPitch("f'")
>>> multiplication(pitch)
NamedPitch("b'''")

Returns new object with type equal to that of argument.

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

(AbjadValueObject).__hash__()

Hashes Abjad value object.

Returns integer.

__radd__(operator)

Right-addition not defined on multiplication.

>>> abjad.Multiplication().__radd__(abjad.Multiplication())
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Users/josiah/Source/github.com/Abjad/abjad/abjad/pitch/Multiplication.py", line 155, in __radd__
    raise NotImplementedError(message)
NotImplementedError: right-addition not defined on Multiplication.

Raises not implemented error.

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.

__str__()

Gets string representation of operator.

>>> str(abjad.Multiplication())
'M1'
>>> str(abjad.Multiplication(n=5))
'M5'

Read-only properties

n

Gets index of multiplication.

>>> multiplication = abjad.Multiplication()
>>> multiplication.n
1
>>> multiplication = abjad.Multiplication(n=5)
>>> multiplication.n
5

Set to integer or none.