ChordSuspension

class tonalanalysistools.ChordSuspension(*arguments)

A chord of 9-8, 7-6, 4-3, 2-1 and other types of suspension typical of, for example, the Bach chorales.

>>> suspension = tonalanalysistools.ChordSuspension(4, 3)
>>> suspension
ChordSuspension(ScaleDegree(4), ScaleDegree(3))

Value object that can not be changed after instantiation.

Lineage

digraph InheritanceGraph { graph [background=transparent, bgcolor=transparent, color=lightslategrey, fontname=Arial, outputorder=edgesfirst, overlap=prism, penwidth=2, rankdir=LR, root="__builtin__.object", splines=spline, style="dotted, rounded", truecolor=true]; node [colorscheme=pastel19, fontname=Arial, fontsize=12, penwidth=2, style="filled, rounded"]; edge [color=lightsteelblue2, penwidth=2]; subgraph cluster_abctools { graph [label=abctools]; "abjad.tools.abctools.AbjadObject.AbjadObject" [color=1, group=0, label=AbjadObject, shape=box]; "abjad.tools.abctools.AbjadObject.AbstractBase" [color=1, group=0, label=AbstractBase, shape=box]; "abjad.tools.abctools.AbjadObject.AbstractBase" -> "abjad.tools.abctools.AbjadObject.AbjadObject"; } subgraph cluster_tonalanalysistools { graph [label=tonalanalysistools]; "abjad.tools.tonalanalysistools.ChordSuspension.ChordSuspension" [color=black, fontcolor=white, group=2, label=<<B>ChordSuspension</B>>, shape=box, style="filled, rounded"]; } subgraph cluster_builtins { graph [label=builtins]; "builtins.object" [color=2, group=1, label=object, shape=box]; } "abjad.tools.abctools.AbjadObject.AbjadObject" -> "abjad.tools.tonalanalysistools.ChordSuspension.ChordSuspension"; "builtins.object" -> "abjad.tools.abctools.AbjadObject.AbstractBase"; }

Bases

Attribute summary

chord_name Chord name of suspension.
figured_bass_pair Figured bass pair of suspension.
figured_bass_string Figured bass string.
is_empty Is true when start and stop are none.
start Start of suspension.
stop Stop of suspension.
title_string Title string of suspension.
__eq__(arg) Is true when arg is a chord suspension when start and stop equal to those of this chord suspension.
__format__([format_specification]) Formats Abjad object.
__hash__() Hashes chord suspension.
__ne__(arg) Is true when arg does not equal chord suspension.
__repr__() Gets interpreter representation of Abjad object.
__str__() String representation of chord suspension.

Read-only properties

ChordSuspension.chord_name

Chord name of suspension.

>>> suspension.chord_name
'sus4'

Returns string.

ChordSuspension.figured_bass_pair

Figured bass pair of suspension.

>>> suspension.figured_bass_pair
(4, 3)

Returns integer pair.

ChordSuspension.figured_bass_string

Figured bass string.

>>> suspension.figured_bass_string
'4-3'

Returns string.

ChordSuspension.is_empty

Is true when start and stop are none. Otherwise false.

>>> suspension.is_empty
False
ChordSuspension.start

Start of suspension.

>>> suspension.start
ScaleDegree(4)

Returns scale degree.

ChordSuspension.stop

Stop of suspension.

>>> suspension.stop
ScaleDegree(3)

Returns scale degree.

ChordSuspension.title_string

Title string of suspension.

>>> suspension.title_string
'FourThreeSuspension'

Returns string.

Special methods

ChordSuspension.__eq__(arg)

Is true when arg is a chord suspension when start and stop equal to those of this chord suspension. Otherwise false.

Returns true or false.

(AbjadObject).__format__(format_specification='')

Formats Abjad object.

Set format_specification to ‘’ or ‘storage’. Interprets ‘’ equal to ‘storage’.

Returns string.

ChordSuspension.__hash__()

Hashes chord suspension.

Required to be explicitly redefined on Python 3 if __eq__ changes.

Returns integer.

ChordSuspension.__ne__(arg)

Is true when arg does not equal chord suspension. Otherwise false.

Returns true or false.

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.

ChordSuspension.__str__()

String representation of chord suspension.

Returns string.