ChordSuspension

class tonalanalysistools.ChordSuspension(figured_bass_string='4-3')

Chord suspension.

>>> from abjad.tools import tonalanalysistools

Initializes from numbers:

>>> tonalanalysistools.ChordSuspension('4-b3')
ChordSuspension('4-b3')

Initializes from other suspension:

>>> suspension = tonalanalysistools.ChordSuspension('4-3')
>>> tonalanalysistools.ChordSuspension(suspension)
ChordSuspension('4-3')

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

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.AbjadValueObject.AbjadValueObject" [color=1, group=0, label=AbjadValueObject, shape=box]; "abjad.tools.abctools.AbjadObject.AbjadObject" -> "abjad.tools.abctools.AbjadValueObject.AbjadValueObject"; "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.AbjadValueObject.AbjadValueObject" -> "abjad.tools.tonalanalysistools.ChordSuspension.ChordSuspension"; "builtins.object" -> "abjad.tools.abctools.AbjadObject.AbstractBase"; }

Bases

Attribute summary

chord_name Gets chord name.
figured_bass_pair Gets figured bass pair.
figured_bass_string Gets figured bass string.
start Gets start.
stop Gets stop.
title_string Gets title string.
__copy__(*arguments) Copies Abjad value object.
__eq__(argument) Is true when argument 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__(argument) Is true when Abjad object does not equal argument.
__repr__() Gets interpreter representation of Abjad object.
__str__() Gets string representation of chord suspension.

Read-only properties

ChordSuspension.chord_name

Gets chord name.

>>> tonalanalysistools.ChordSuspension('4-b3').chord_name
'sus4'
>>> tonalanalysistools.ChordSuspension('b2-1').chord_name
'susb2'

Returns string.

ChordSuspension.figured_bass_pair

Gets figured bass pair.

>>> tonalanalysistools.ChordSuspension('4-b3').figured_bass_pair
('4', 'b3')
>>> tonalanalysistools.ChordSuspension('b2-1').figured_bass_pair
('b2', '1')

Returns integer pair.

ChordSuspension.figured_bass_string

Gets figured bass string.

>>> tonalanalysistools.ChordSuspension('4-b3').figured_bass_string
'4-b3'
>>> tonalanalysistools.ChordSuspension('b2-1').figured_bass_string
'b2-1'

Returns string.

ChordSuspension.start

Gets start.

:: .. container:: example

>>> tonalanalysistools.ChordSuspension('4-b3').start
ScaleDegree('4')
>>> tonalanalysistools.ChordSuspension('b2-1').start
ScaleDegree('b2')

Returns scale degree.

ChordSuspension.stop

Gets stop.

>>> tonalanalysistools.ChordSuspension('4-b3').stop
ScaleDegree('b3')
>>> tonalanalysistools.ChordSuspension('b2-1').stop
ScaleDegree('1')

Returns scale degree.

ChordSuspension.title_string

Gets title string.

>>> tonalanalysistools.ChordSuspension('4-b3').title_string
'FourFlatThreeSuspension'
>>> tonalanalysistools.ChordSuspension('b2-1').title_string
'FlatTwoOneSuspension'

Returns string.

Special methods

(AbjadValueObject).__copy__(*arguments)

Copies Abjad value object.

Returns new Abjad value object.

ChordSuspension.__eq__(argument)

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

>>> suspension_1 = tonalanalysistools.ChordSuspension('4-3')
>>> suspension_2 = tonalanalysistools.ChordSuspension('4-3')
>>> suspension_3 = tonalanalysistools.ChordSuspension('2-1')
>>> suspension_1 == suspension_1
True
>>> suspension_1 == suspension_2
True
>>> suspension_1 == suspension_3
False
>>> suspension_2 == suspension_1
True
>>> suspension_2 == suspension_2
True
>>> suspension_2 == suspension_3
False
>>> suspension_3 == suspension_1
False
>>> suspension_3 == suspension_2
False
>>> suspension_3 == suspension_3
True

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.

(AbjadObject).__ne__(argument)

Is true when Abjad object does not equal argument. Otherwise false.

Returns true or false.

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.

ChordSuspension.__str__()

Gets string representation of chord suspension.

Returns string.