instruments

Instrument classes.

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=2]; "abjad.system.AbjadObject.AbjadObject" [URL="../api/abjad/system/AbjadObject.html#abjad.system.AbjadObject.AbjadObject", color=2, label="Abjad\nObject", target=_top]; "abjad.system.AbjadValueObject.AbjadValueObject" [URL="../api/abjad/system/AbjadValueObject.html#abjad.system.AbjadValueObject.AbjadValueObject", color=2, 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", color=3, label=object, target=_top]; } subgraph "cluster_abjad.instruments" { graph [label="abjad.instruments"]; node [color=1]; "abjad.instruments.Accordion" [URL="../api/abjad/instruments.html#abjad.instruments.Accordion", color=black, fontcolor=white, label=Accordion, target=_top]; "abjad.instruments.AltoFlute" [URL="../api/abjad/instruments.html#abjad.instruments.AltoFlute", color=black, fontcolor=white, label="Alto\nFlute", target=_top]; "abjad.instruments.AltoSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.AltoSaxophone", color=black, fontcolor=white, label="Alto\nSaxophone", target=_top]; "abjad.instruments.AltoTrombone" [URL="../api/abjad/instruments.html#abjad.instruments.AltoTrombone", color=black, fontcolor=white, label="Alto\nTrombone", target=_top]; "abjad.instruments.AltoVoice" [URL="../api/abjad/instruments.html#abjad.instruments.AltoVoice", color=black, fontcolor=white, label="Alto\nVoice", target=_top]; "abjad.instruments.BaritoneSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.BaritoneSaxophone", color=black, fontcolor=white, label="Baritone\nSaxophone", target=_top]; "abjad.instruments.BaritoneVoice" [URL="../api/abjad/instruments.html#abjad.instruments.BaritoneVoice", color=black, fontcolor=white, label="Baritone\nVoice", target=_top]; "abjad.instruments.BassClarinet" [URL="../api/abjad/instruments.html#abjad.instruments.BassClarinet", color=black, fontcolor=white, label="Bass\nClarinet", target=_top]; "abjad.instruments.BassFlute" [URL="../api/abjad/instruments.html#abjad.instruments.BassFlute", color=black, fontcolor=white, label="Bass\nFlute", target=_top]; "abjad.instruments.BassSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.BassSaxophone", color=black, fontcolor=white, label="Bass\nSaxophone", target=_top]; "abjad.instruments.BassTrombone" [URL="../api/abjad/instruments.html#abjad.instruments.BassTrombone", color=black, fontcolor=white, label="Bass\nTrombone", target=_top]; "abjad.instruments.BassVoice" [URL="../api/abjad/instruments.html#abjad.instruments.BassVoice", color=black, fontcolor=white, label="Bass\nVoice", target=_top]; "abjad.instruments.Bassoon" [URL="../api/abjad/instruments.html#abjad.instruments.Bassoon", color=black, fontcolor=white, label=Bassoon, target=_top]; "abjad.instruments.Cello" [URL="../api/abjad/instruments.html#abjad.instruments.Cello", color=black, fontcolor=white, label=Cello, target=_top]; "abjad.instruments.ClarinetInA" [URL="../api/abjad/instruments.html#abjad.instruments.ClarinetInA", color=black, fontcolor=white, label="Clarinet\nIn\nA", target=_top]; "abjad.instruments.ClarinetInBFlat" [URL="../api/abjad/instruments.html#abjad.instruments.ClarinetInBFlat", color=black, fontcolor=white, label="Clarinet\nIn\nBFlat", target=_top]; "abjad.instruments.ClarinetInEFlat" [URL="../api/abjad/instruments.html#abjad.instruments.ClarinetInEFlat", color=black, fontcolor=white, label="Clarinet\nIn\nEFlat", target=_top]; "abjad.instruments.Contrabass" [URL="../api/abjad/instruments.html#abjad.instruments.Contrabass", color=black, fontcolor=white, label=Contrabass, target=_top]; "abjad.instruments.ContrabassClarinet" [URL="../api/abjad/instruments.html#abjad.instruments.ContrabassClarinet", color=black, fontcolor=white, label="Contrabass\nClarinet", target=_top]; "abjad.instruments.ContrabassFlute" [URL="../api/abjad/instruments.html#abjad.instruments.ContrabassFlute", color=black, fontcolor=white, label="Contrabass\nFlute", target=_top]; "abjad.instruments.ContrabassSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.ContrabassSaxophone", color=black, fontcolor=white, label="Contrabass\nSaxophone", target=_top]; "abjad.instruments.Contrabassoon" [URL="../api/abjad/instruments.html#abjad.instruments.Contrabassoon", color=black, fontcolor=white, label=Contrabassoon, target=_top]; "abjad.instruments.EnglishHorn" [URL="../api/abjad/instruments.html#abjad.instruments.EnglishHorn", color=black, fontcolor=white, label="English\nHorn", target=_top]; "abjad.instruments.Flute" [URL="../api/abjad/instruments.html#abjad.instruments.Flute", color=black, fontcolor=white, label=Flute, target=_top]; "abjad.instruments.FrenchHorn" [URL="../api/abjad/instruments.html#abjad.instruments.FrenchHorn", color=black, fontcolor=white, label="French\nHorn", target=_top]; "abjad.instruments.Glockenspiel" [URL="../api/abjad/instruments.html#abjad.instruments.Glockenspiel", color=black, fontcolor=white, label=Glockenspiel, target=_top]; "abjad.instruments.Guitar" [URL="../api/abjad/instruments.html#abjad.instruments.Guitar", color=black, fontcolor=white, label=Guitar, target=_top]; "abjad.instruments.Harp" [URL="../api/abjad/instruments.html#abjad.instruments.Harp", color=black, fontcolor=white, label=Harp, target=_top]; "abjad.instruments.Harpsichord" [URL="../api/abjad/instruments.html#abjad.instruments.Harpsichord", color=black, fontcolor=white, label=Harpsichord, target=_top]; "abjad.instruments.Instrument" [URL="../api/abjad/instruments.html#abjad.instruments.Instrument", color=black, fontcolor=white, label=Instrument, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Accordion" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.AltoFlute" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.AltoSaxophone" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.AltoTrombone" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.AltoVoice" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.BaritoneSaxophone" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.BaritoneVoice" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.BassClarinet" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.BassFlute" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.BassSaxophone" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.BassTrombone" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.BassVoice" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.Bassoon" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.Cello" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.ClarinetInA" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.ClarinetInBFlat" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.ClarinetInEFlat" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.Contrabass" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.ContrabassClarinet" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.ContrabassFlute" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.ContrabassSaxophone" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.Contrabassoon" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.EnglishHorn" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.Flute" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.FrenchHorn" [minlen=1]; "abjad.instruments.Instrument" -> "abjad.instruments.Glockenspiel" [minlen=2]; "abjad.instruments.Instrument" -> "abjad.instruments.Guitar" [minlen=3]; "abjad.instruments.Instrument" -> "abjad.instruments.Harp" [minlen=4]; "abjad.instruments.Instrument" -> "abjad.instruments.Harpsichord" [minlen=1]; "abjad.instruments.Marimba" [URL="../api/abjad/instruments.html#abjad.instruments.Marimba", color=black, fontcolor=white, label=Marimba, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Marimba" [minlen=2]; "abjad.instruments.MezzoSopranoVoice" [URL="../api/abjad/instruments.html#abjad.instruments.MezzoSopranoVoice", color=black, fontcolor=white, label="Mezzo\nSoprano\nVoice", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.MezzoSopranoVoice" [minlen=3]; "abjad.instruments.Oboe" [URL="../api/abjad/instruments.html#abjad.instruments.Oboe", color=black, fontcolor=white, label=Oboe, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Oboe" [minlen=4]; "abjad.instruments.Percussion" [URL="../api/abjad/instruments.html#abjad.instruments.Percussion", color=black, fontcolor=white, label=Percussion, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Percussion" [minlen=1]; "abjad.instruments.Piano" [URL="../api/abjad/instruments.html#abjad.instruments.Piano", color=black, fontcolor=white, label=Piano, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Piano" [minlen=2]; "abjad.instruments.Piccolo" [URL="../api/abjad/instruments.html#abjad.instruments.Piccolo", color=black, fontcolor=white, label=Piccolo, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Piccolo" [minlen=3]; "abjad.instruments.SopraninoSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.SopraninoSaxophone", color=black, fontcolor=white, label="Sopranino\nSaxophone", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.SopraninoSaxophone" [minlen=4]; "abjad.instruments.SopranoSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.SopranoSaxophone", color=black, fontcolor=white, label="Soprano\nSaxophone", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.SopranoSaxophone" [minlen=1]; "abjad.instruments.SopranoVoice" [URL="../api/abjad/instruments.html#abjad.instruments.SopranoVoice", color=black, fontcolor=white, label="Soprano\nVoice", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.SopranoVoice" [minlen=2]; "abjad.instruments.TenorSaxophone" [URL="../api/abjad/instruments.html#abjad.instruments.TenorSaxophone", color=black, fontcolor=white, label="Tenor\nSaxophone", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.TenorSaxophone" [minlen=3]; "abjad.instruments.TenorTrombone" [URL="../api/abjad/instruments.html#abjad.instruments.TenorTrombone", color=black, fontcolor=white, label="Tenor\nTrombone", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.TenorTrombone" [minlen=4]; "abjad.instruments.TenorVoice" [URL="../api/abjad/instruments.html#abjad.instruments.TenorVoice", color=black, fontcolor=white, label="Tenor\nVoice", target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.TenorVoice" [minlen=1]; "abjad.instruments.Trumpet" [URL="../api/abjad/instruments.html#abjad.instruments.Trumpet", color=black, fontcolor=white, label=Trumpet, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Trumpet" [minlen=2]; "abjad.instruments.Tuba" [URL="../api/abjad/instruments.html#abjad.instruments.Tuba", color=black, fontcolor=white, label=Tuba, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Tuba" [minlen=3]; "abjad.instruments.Vibraphone" [URL="../api/abjad/instruments.html#abjad.instruments.Vibraphone", color=black, fontcolor=white, label=Vibraphone, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Vibraphone" [minlen=4]; "abjad.instruments.Viola" [URL="../api/abjad/instruments.html#abjad.instruments.Viola", color=black, fontcolor=white, label=Viola, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Viola" [minlen=1]; "abjad.instruments.Violin" [URL="../api/abjad/instruments.html#abjad.instruments.Violin", color=black, fontcolor=white, label=Violin, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Violin" [minlen=2]; "abjad.instruments.Xylophone" [URL="../api/abjad/instruments.html#abjad.instruments.Xylophone", color=black, fontcolor=white, label=Xylophone, target=_top]; "abjad.instruments.Instrument" -> "abjad.instruments.Xylophone" [minlen=3]; "abjad.instruments.StringNumber" [URL="../api/abjad/instruments.html#abjad.instruments.StringNumber", color=black, fontcolor=white, label="String\nNumber", target=_top]; "abjad.instruments.Tuning" [URL="../api/abjad/instruments.html#abjad.instruments.Tuning", color=black, fontcolor=white, label=Tuning, target=_top]; } "abjad.system.AbjadValueObject.AbjadValueObject" -> "abjad.instruments.Instrument"; "abjad.system.AbjadValueObject.AbjadValueObject" -> "abjad.instruments.StringNumber" [minlen=1]; "abjad.system.AbjadValueObject.AbjadValueObject" -> "abjad.instruments.Tuning" [minlen=2]; "builtins.object" -> "abjad.system.AbjadObject.AbjadObject" [minlen=1]; }


Classes

Accordion Accordion.
AltoFlute Alto flute.
AltoSaxophone Alto saxophone.
AltoTrombone Alto trombone.
AltoVoice Alto voice.
BaritoneSaxophone Baritone saxophone.
BaritoneVoice Baritone voice.
BassClarinet Bass clarinet.
BassFlute Bass flute.
BassSaxophone Bass saxophone.
BassTrombone Bass trombone.
BassVoice Bass voice.
Bassoon Bassoon.
Cello Cello.
ClarinetInA Clarinet in A.
ClarinetInBFlat Clarinet in B-flat.
ClarinetInEFlat Clarinet in E-flat.
Contrabass Contrabass.
ContrabassClarinet Contrassbass clarinet.
ContrabassFlute Contrabass flute.
ContrabassSaxophone Contrabass saxophone.
Contrabassoon Contrabassoon.
EnglishHorn English horn.
Flute Flute.
FrenchHorn French horn.
Glockenspiel Glockenspiel.
Guitar Guitar.
Harp Harp.
Harpsichord Harpsichord.
Instrument Instrument.
Marimba Marimba.
MezzoSopranoVoice Mezzo-soprano voice.
Oboe Oboe.
Percussion Percussion instrument.
Piano Piano.
Piccolo Piccolo.
SopraninoSaxophone Sopranino saxophone.
SopranoSaxophone Soprano saxophone.
SopranoVoice Soprano voice.
StringNumber String number.
TenorSaxophone Tenor saxophone.
TenorTrombone Tenor trombone.
TenorVoice Tenor voice.
Trumpet Trumpet.
Tuba Tuba.
Tuning Tuning.
Vibraphone Vibraphone.
Viola Viola.
Violin Violin.
Xylophone Xylphone.
class abjad.instruments.Accordion(*, allowable_clefs=('treble', 'bass'), context='StaffGroup', name='accordion', markup=None, middle_c_sounding_pitch=None, pitch_range='[E1, C8]', primary=True, short_markup=None, short_name='acc.')

Accordion.

>>> staff_group = abjad.StaffGroup(lilypond_type='PianoStaff')
>>> staff_group.append(abjad.Staff("c'4 d'4 e'4 f'4"))
>>> staff_group.append(abjad.Staff("c'2 b2"))
>>> accordion = abjad.Accordion()
>>> abjad.attach(accordion, staff_group[0][0])
>>> abjad.attach(abjad.Clef('bass'), staff_group[1][0])
>>> abjad.show(staff_group) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.AltoFlute(*, name='alto flute', short_name='alt. fl.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='G3', pitch_range='[G3, G6]')

Alto flute.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> alto_flute = abjad.AltoFlute()
>>> abjad.attach(alto_flute, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.AltoSaxophone(*, name='alto saxophone', short_name='alt. sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Eb3', pitch_range='[Db3, A5]', primary=True)

Alto saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> alto_saxophone = abjad.AltoSaxophone()
>>> abjad.attach(alto_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.AltoTrombone(*, name='alto trombone', short_name='alt. trb.', markup=None, short_markup=None, allowable_clefs=('bass', 'tenor'), context=None, middle_c_sounding_pitch=None, pitch_range='[A2, Bb5]')

Alto trombone.

>>> staff = abjad.Staff("c4 d4 e4 fs4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> alto_trombone = abjad.AltoTrombone()
>>> abjad.attach(alto_trombone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.AltoVoice(*, name='alto', short_name='alto', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[F3, G5]')

Alto voice.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> alto = abjad.AltoVoice()
>>> abjad.attach(alto, staff[0])
>>> abjad.show(staff) 

Attributes Summary

performer_abbreviation

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BaritoneSaxophone(*, name='baritone saxophone', short_name='bar. sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Eb2', pitch_range='[C2, Ab4]')

Baritone saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> baritone_saxophone = abjad.BaritoneSaxophone()
>>> abjad.attach(baritone_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BaritoneVoice(*, name='baritone', short_name='bar.', markup=None, short_markup=None, allowable_clefs=('bass', ), context=None, middle_c_sounding_pitch=None, pitch_range='[A2, A4]')

Baritone voice.

>>> staff = abjad.Staff("c4 d4 e4 fs4")
>>> baritone = abjad.BaritoneVoice()
>>> abjad.attach(baritone, staff[0])
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> abjad.show(staff) 

Attributes Summary

performer_abbreviation

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BassClarinet(*, name='bass clarinet', short_name='bass cl.', markup=None, short_markup=None, allowable_clefs=('treble', 'bass'), context=None, middle_c_sounding_pitch='Bb2', pitch_range='[Bb1, G5]')

Bass clarinet.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> bass_clarinet = abjad.BassClarinet()
>>> abjad.attach(bass_clarinet, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BassFlute(*, name='bass flute', short_name='bass fl.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='C3', pitch_range='[C3, C6]')

Bass flute.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> bass_flute = abjad.BassFlute()
>>> abjad.attach(bass_flute, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BassSaxophone(*, name='bass saxophone', short_name='bass sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Bb1', pitch_range='[Ab2, E4]')

Bass saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> bass_saxophone = abjad.BassSaxophone()
>>> abjad.attach(bass_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BassTrombone(*, name='bass trombone', short_name='bass trb.', markup=None, short_markup=None, allowable_clefs=('bass', ), context=None, middle_c_sounding_pitch=None, pitch_range='[C2, F4]')

Bass trombone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> bass_trombone = abjad.BassTrombone()
>>> abjad.attach(bass_trombone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.BassVoice(*, name='bass', short_name='bass', markup=None, short_markup=None, allowable_clefs=('bass', ), context=None, middle_c_sounding_pitch=None, pitch_range='[E2, F4]', primary=True)

Bass voice.

>>> staff = abjad.Staff("c4 d4 e4 fs4")
>>> bass = abjad.BassVoice()
>>> abjad.attach(bass, staff[0])
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Bassoon(*, name='bassoon', short_name='bsn.', markup=None, short_markup=None, allowable_clefs=('bass', 'tenor'), context=None, middle_c_sounding_pitch=None, pitch_range='[Bb1, Eb5]', primary=True)

Bassoon.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> bassoon = abjad.Bassoon()
>>> abjad.attach(bassoon, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Cello(*, name='cello', short_name='vc.', markup=None, short_markup=None, allowable_clefs=('bass', 'tenor', 'treble'), context=None, default_tuning=('C2', 'G2', 'D3', 'A3'), middle_c_sounding_pitch=None, pitch_range='[C2, G5]', primary=True)

Cello.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> cello = abjad.Cello()
>>> abjad.attach(cello, staff[0])
>>> abjad.show(staff) 

Attributes Summary

default_tuning Gets cello’s default tuning.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

default_tuning

Gets cello’s default tuning.

>>> cello = abjad.Cello()
>>> cello.default_tuning
Tuning(pitches=PitchSegment(['c,', 'g,', 'd', 'a']))

Returns tuning.

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.ClarinetInA(*, name='clarinet in A', short_name='cl. A \natural', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='A3', pitch_range='[Db3, A6]')

Clarinet in A.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clarinet = abjad.ClarinetInA()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.ClarinetInBFlat(*, name='clarinet in B-flat', short_name='cl. in B-flat', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Bb3', pitch_range='[D3, Bb6]', primary=True)

Clarinet in B-flat.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 

Attributes Summary

performer_abbreviation

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.ClarinetInEFlat(*, name='clarinet in E-flat', short_name='cl. E-flat', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Eb4', pitch_range='[F3, C7]')

Clarinet in E-flat.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clarinet = abjad.ClarinetInEFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Contrabass(*, name='contrabass', short_name='cb.', markup=None, short_markup=None, allowable_clefs=('bass', 'treble'), context=None, default_tuning=('C1', 'A1', 'D2', 'G2'), middle_c_sounding_pitch='C3', pitch_range='[C1, G4]', primary=True)

Contrabass.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> contrabass = abjad.Contrabass()
>>> abjad.attach(contrabass, staff[0])
>>> abjad.show(staff) 

Attributes Summary

default_tuning Gets contrabass’s default tuning.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

default_tuning

Gets contrabass’s default tuning.

>>> contrabass = abjad.Contrabass()
>>> contrabass.default_tuning
Tuning(pitches=PitchSegment(['c,,', 'a,,', 'd,', 'g,']))

Returns tuning.

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.ContrabassClarinet(*, name='contrabass clarinet', short_name='cbass. cl.', markup=None, short_markup=None, allowable_clefs=('treble', 'bass'), context=None, middle_c_sounding_pitch='Bb1', pitch_range='[Bb0, G4]')

Contrassbass clarinet.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> contrabass_clarinet = abjad.ContrabassClarinet()
>>> abjad.attach(contrabass_clarinet, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.ContrabassFlute(*, name='contrabass flute', short_name='cbass. fl.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='G2', pitch_range='[G2, G5]')

Contrabass flute.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> contrabass_flute = abjad.ContrabassFlute()
>>> abjad.attach(contrabass_flute, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.ContrabassSaxophone(*, name='contrabass saxophone', short_name='cbass. sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Eb1', pitch_range='[C1, Ab3]')

Contrabass saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> contrabass_saxophone = abjad.ContrabassSaxophone()
>>> abjad.attach(contrabass_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Contrabassoon(*, name='contrabassoon', short_name='contrabsn.', markup=None, short_markup=None, allowable_clefs=('bass', ), context=None, middle_c_sounding_pitch='C3', pitch_range='[Bb0, Bb4]')

Contrabassoon.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> contrabassoon = abjad.Contrabassoon()
>>> abjad.attach(contrabassoon, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.EnglishHorn(*, name='English horn', short_name='Eng. hn.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='F3', pitch_range='[E3, C6]')

English horn.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> english_horn = abjad.EnglishHorn()
>>> abjad.attach(english_horn, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Flute(*, name='flute', short_name='fl.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[C4, D7]', primary=True)

Flute.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> flute = abjad.Flute()
>>> abjad.attach(flute, staff[0])
>>> abjad.show(staff) 

Instrument markup can be hidden:

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> flute = abjad.Flute()
>>> abjad.attach(flute, staff[0])
>>> abjad.show(staff) 
>>> abjad.f(staff)
\new Staff
{
    c'4
    d'4
    e'4
    fs'4
}
>>> for leaf in abjad.select(staff).leaves():
...     leaf, abjad.inspect(leaf).effective(abjad.Instrument)
... 
(Note("c'4"), Flute())
(Note("d'4"), Flute())
(Note("e'4"), Flute())
(Note("fs'4"), Flute())

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.FrenchHorn(*, name='horn', short_name='hn.', markup=None, short_markup=None, allowable_clefs=('bass', 'treble'), context=None, middle_c_sounding_pitch='F3', pitch_range='[B1, F5]', primary=True)

French horn.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> french_horn = abjad.FrenchHorn()
>>> abjad.attach(french_horn, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Glockenspiel(*, name='glockenspiel', short_name='gkspl.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='C6', pitch_range='[G5, C8]')

Glockenspiel.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> glockenspiel = abjad.Glockenspiel()
>>> abjad.attach(glockenspiel, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Guitar(*, name='guitar', short_name='gt.', markup=None, short_markup=None, allowable_clefs=None, context=None, default_tuning=('E2', 'A2', 'D3', 'G3', 'B3', 'E4'), middle_c_sounding_pitch='C3', pitch_range='[E2, E5]', primary=True)

Guitar.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> guitar = abjad.Guitar()
>>> abjad.attach(guitar, staff[0])
>>> abjad.show(staff) 

Attributes Summary

default_tuning Gets guitar’s default tuning.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

default_tuning

Gets guitar’s default tuning.

>>> guitar = abjad.Guitar()
>>> guitar.default_tuning
Tuning(pitches=PitchSegment(['e,', 'a,', 'd', 'g', 'b', "e'"]))

Returns tuning.

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Harp(*, name='harp', short_name='hp.', markup=None, short_markup=None, allowable_clefs=('treble', 'bass'), context='StaffGroup', middle_c_sounding_pitch=None, pitch_range='[B0, G#7]', primary=True)

Harp.

>>> staff_group = abjad.StaffGroup(lilypond_type='PianoStaff')
>>> staff_group.append(abjad.Staff("c'4 d'4 e'4 f'4"))
>>> staff_group.append(abjad.Staff("c'2 b2"))
>>> harp = abjad.Harp()
>>> abjad.attach(harp, staff_group[0][0])
>>> abjad.attach(abjad.Clef('bass'), staff_group[1][0])
>>> abjad.show(staff_group) 

The harp targets piano staff context by default.


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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Harpsichord(*, name='harpsichord', short_name='hpschd.', markup=None, short_markup=None, allowable_clefs=('treble', 'bass'), context='StaffGroup', middle_c_sounding_pitch=None, pitch_range='[C2, C7]', primary=True)

Harpsichord.

>>> upper_staff = abjad.Staff("c'4 d'4 e'4 f'4")
>>> lower_staff = abjad.Staff("c'2 b2")
>>> staff_group = abjad.StaffGroup(
...     [upper_staff, lower_staff],
...     lilypond_type='PianoStaff',
...     )
>>> harpsichord = abjad.Harpsichord()
>>> abjad.attach(harpsichord, staff_group[0][0])
>>> abjad.attach(abjad.Clef('bass'), lower_staff[0])
>>> abjad.show(staff_group) 

The harpsichord targets piano staff context by default.


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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Instrument(*, allowable_clefs=None, context=None, markup=None, middle_c_sounding_pitch=None, name=None, pitch_range=None, primary=None, short_name=None, short_markup=None)

Instrument.

Two instruments active on a single staff:

>>> voice_1 = abjad.Voice("e'8 g'8 f'8 a'8")
>>> flute = abjad.Flute()
>>> abjad.attach(flute, voice_1[0], context='Voice')
>>> flute_markup = abjad.Markup('(flute)', direction=abjad.Up)
>>> abjad.attach(flute_markup, voice_1[0])
>>> abjad.attach(abjad.LilyPondLiteral(r'\voiceOne'), voice_1)
>>> voice_2 = abjad.Voice("c'2")
>>> abjad.attach(abjad.LilyPondLiteral(r'\voiceTwo'), voice_2)
>>> viola = abjad.Viola()
>>> abjad.attach(viola, voice_2[0], context='Voice')
>>> viola_markup = abjad.Markup('(viola)', direction=abjad.Down)
>>> abjad.attach(viola_markup, voice_2[0])
>>> staff = abjad.Staff([voice_1, voice_2], is_simultaneous=True)
>>> abjad.show(staff) 
>>> for leaf in abjad.select(voice_1).leaves():
...     leaf, abjad.inspect(leaf).effective(abjad.Instrument)
... 
(Note("e'8"), Flute())
(Note("g'8"), Flute())
(Note("f'8"), Flute())
(Note("a'8"), Flute())
>>> for leaf in abjad.select(voice_2).leaves():
...     leaf, abjad.inspect(leaf).effective(abjad.Instrument)
... 
(Note("c'2"), Viola())

Attributes Summary

allowable_clefs Gets allowable clefs.
context Gets (historically conventional) context of instrument.
latent Is true for all instruments.
markup Gets instrument name markup.
middle_c_sounding_pitch Gets sounding pitch of written middle C.
name Gets instrument name.
parameter Is set to 'INSTRUMENT' for all instruments.
pitch_range Gets pitch range.
primary Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).
redraw Is true for all instruments.
short_markup Gets short instrument name markup.
short_name Gets short instrument name.
transpose_from_sounding_pitch Transpose notes and chords in argument from sounding pitch to written pitch:
transpose_from_written_pitch Transposes notes and chords in argument from sounding pitch to written pitch.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

allowable_clefs

Gets allowable clefs.

Returns clef list.

context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

latent

Is true for all instruments.

Class constant.

Returns true.

markup

Gets instrument name markup.

Returns markup.

middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

name

Gets instrument name.

Returns string.

parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
pitch_range

Gets pitch range.

Returns pitch range.

primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

redraw

Is true for all instruments.

Class constant.

Returns true.

short_markup

Gets short instrument name markup.

Returns markup.

short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Marimba(*, name='marimba', short_name='mb.', markup=None, short_markup=None, allowable_clefs=('treble', 'bass'), context=None, middle_c_sounding_pitch=None, pitch_range='[F2, C7]')

Marimba.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> marimba = abjad.Marimba()
>>> abjad.attach(marimba, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.MezzoSopranoVoice(*, name='mezzo-soprano', short_name='mezz.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[A3, C6]', primary=True)

Mezzo-soprano voice.

>>> staff = abjad.Staff("c''4 d''4 e''4 fs''4")
>>> mezzo_soprano = abjad.MezzoSopranoVoice()
>>> abjad.attach(mezzo_soprano, staff[0])
>>> abjad.show(staff) 

Attributes Summary

performer_abbreviation

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Oboe(*, name='oboe', short_name='ob.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[Bb3, A6]', primary=True)

Oboe.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> oboe = abjad.Oboe()
>>> abjad.attach(oboe, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Percussion(*, name='percussion', short_name='perc.', markup=None, short_markup=None, allowable_clefs=('percussion', ), context=None, middle_c_sounding_pitch=None, pitch_range=None)

Percussion instrument.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> percussion = abjad.Percussion()
>>> abjad.attach(percussion, staff[0])
>>> abjad.show(staff) 

Attributes Summary

known_percussion

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Piano(*, name='piano', short_name='pf.', markup=None, short_markup=None, allowable_clefs=('treble', 'bass'), context='StaffGroup', middle_c_sounding_pitch=None, pitch_range='[A0, C8]', primary=True)

Piano.

>>> staff_group = abjad.StaffGroup(lilypond_type='PianoStaff')
>>> staff_group.append(abjad.Staff("c'4 d'4 e'4 f'4"))
>>> staff_group.append(abjad.Staff("c'2 b2"))
>>> piano = abjad.Piano()
>>> abjad.attach(piano, staff_group[0][0])
>>> abjad.attach(abjad.Clef('bass'), staff_group[1][0])
>>> abjad.show(staff_group) 

The piano targets piano staff context by default.


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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Piccolo(*, name='piccolo', short_name='picc.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='C5', pitch_range='[D5, C8]')

Piccolo.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> piccolo = abjad.Piccolo()
>>> abjad.attach(piccolo, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.SopraninoSaxophone(*, name='sopranino saxophone', short_name='sopranino sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Eb4', pitch_range='[Db4, F#6]')

Sopranino saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> sopranino_saxophone = abjad.SopraninoSaxophone()
>>> abjad.attach(sopranino_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.SopranoSaxophone(*, name='soprano saxophone', short_name='sop. sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Bb3', pitch_range='[Ab3, E6]')

Soprano saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> soprano_saxophone = abjad.SopranoSaxophone()
>>> abjad.attach(soprano_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.SopranoVoice(*, name='soprano', short_name='sop.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[C4, E6]', primary=True)

Soprano voice.

>>> staff = abjad.Staff("c''4 d''4 e''4 fs''4")
>>> soprano = abjad.SopranoVoice()
>>> abjad.attach(soprano, staff[0])
>>> abjad.show(staff) 

Attributes Summary

performer_abbreviation

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.StringNumber(numbers=None)

String number.

String I:

>>> indicator = abjad.StringNumber(1)
>>> abjad.f(indicator)
abjad.StringNumber(
    numbers=(1,),
    )

Strings II and III:

>>> indicator = abjad.StringNumber((2, 3))
>>> abjad.f(indicator)
abjad.StringNumber(
    numbers=(2, 3),
    )

Attributes Summary

numbers Gets numbers.
roman_numerals Gets roman numerals of string number indicator.
tweaks Are not implemented on string number.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Read-only properties

numbers

Gets numbers.

String I:

>>> indicator = abjad.StringNumber(1)
>>> indicator.numbers
(1,)
>>> indicator = abjad.StringNumber((2, 3))
>>> indicator.numbers
(2, 3)
Return type:Tuple[int, …]
roman_numerals

Gets roman numerals of string number indicator.

String I:

>>> indicator = abjad.StringNumber(1)
>>> indicator.roman_numerals
('i',)

Strings II and III:

>>> indicator = abjad.StringNumber((2, 3))
>>> indicator.roman_numerals
('ii', 'iii')
Return type:Tuple[str, …]
tweaks

Are not implemented on string number.

Return type:None
class abjad.instruments.TenorSaxophone(*, name='tenor saxophone', short_name='ten. sax.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch='Bb2', pitch_range='[Ab2, E5]')

Tenor saxophone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> tenor_saxophone = abjad.TenorSaxophone()
>>> abjad.attach(tenor_saxophone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.TenorTrombone(*, name='tenor trombone', short_name='ten. trb.', markup=None, short_markup=None, allowable_clefs=('tenor', 'bass'), context=None, middle_c_sounding_pitch=None, pitch_range='[E2, Eb5]', primary=True)

Tenor trombone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> tenor_trombone = abjad.TenorTrombone()
>>> abjad.attach(tenor_trombone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.TenorVoice(*, name='tenor', short_name='ten.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[C3, D5]', primary=True)

Tenor voice.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> tenor = abjad.TenorVoice()
>>> abjad.attach(tenor, staff[0])
>>> abjad.show(staff) 

Attributes Summary

performer_abbreviation

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Trumpet(*, name='trumpet', short_name='tp.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[F#3, D6]', primary=True)

Trumpet.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> trumpet = abjad.Trumpet()
>>> abjad.attach(trumpet, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Tuba(*, name='tuba', short_name='tb.', markup=None, short_markup=None, allowable_clefs=('bass', ), context=None, middle_c_sounding_pitch=None, pitch_range='[D1, F4]', primary=True)

Tuba.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('bass')
>>> abjad.attach(clef, staff[0])
>>> tuba = abjad.Tuba()
>>> abjad.attach(tuba, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Tuning(pitches=None)

Tuning.

Violin tuning:

>>> indicator = abjad.Tuning(pitches=('G3', 'D4', 'A4', 'E5'))
>>> abjad.f(indicator)
abjad.Tuning(
    pitches=abjad.PitchSegment(
        (
            abjad.NamedPitch('g'),
            abjad.NamedPitch("d'"),
            abjad.NamedPitch("a'"),
            abjad.NamedPitch("e''"),
            ),
        item_class=abjad.NamedPitch,
        ),
    )

Attributes Summary

get_pitch_ranges_by_string_number Gets tuning pitch ranges by string number.
get_pitches_by_string_number Gets tuning pitches by string number.
pitch_ranges Gets two-octave pitch-ranges for each pitch in this tuning.
pitches Gets pitches of tuning.
tweaks Are not implemented on tuning.
voice_pitch_classes Voices pitch_classes.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Methods

get_pitch_ranges_by_string_number(string_number)

Gets tuning pitch ranges by string number.

Violin tuning:

>>> tuning = abjad.Tuning(('G3', 'D4', 'A4', 'E5'))
>>> string_number = abjad.StringNumber((2, 3))
>>> tuning.get_pitch_ranges_by_string_number(string_number)
(PitchRange('[A4, A6]'), PitchRange('[D4, D6]'))
Return type:Tuple[PitchRange, …]
get_pitches_by_string_number(string_number)

Gets tuning pitches by string number.

Violin tuning:

>>> tuning = abjad.Tuning(('G3', 'D4', 'A4', 'E5'))
>>> string_number = abjad.StringNumber((2, 3))
>>> tuning.get_pitches_by_string_number(string_number)
(NamedPitch("a'"), NamedPitch("d'"))
Return type:Tuple[NamedPitch, …]
voice_pitch_classes(pitch_classes, allow_open_strings=True)

Voices pitch_classes.

>>> tuning = abjad.Tuning(('G3', 'D4', 'A4', 'E5'))
>>> voicings = tuning.voice_pitch_classes(('a',))
>>> for voicing in voicings:
...     voicing
... 
(NamedPitch('a'), None, None, None)
(None, None, None, NamedPitch("a''"))
(None, None, None, NamedPitch("a'''"))
(None, None, NamedPitch("a'"), None)
(None, None, NamedPitch("a''"), None)
(None, None, NamedPitch("a'''"), None)
(None, NamedPitch("a'"), None, None)
(None, NamedPitch("a''"), None, None)
(NamedPitch("a'"), None, None, None)
>>> voicings = tuning.voice_pitch_classes(
...     ('a', 'd'),
...     allow_open_strings=False,
...     )
>>> for voicing in voicings:
...     voicing
... 
(NamedPitch('a'), None, None, NamedPitch("d'''"))
(NamedPitch('a'), None, None, NamedPitch("d''''"))
(NamedPitch('a'), None, NamedPitch("d''"), None)
(NamedPitch('a'), None, NamedPitch("d'''"), None)
(NamedPitch('a'), NamedPitch("d''"), None, None)
(NamedPitch('a'), NamedPitch("d'''"), None, None)
(None, None, NamedPitch("d''"), NamedPitch("a''"))
(None, None, NamedPitch("d''"), NamedPitch("a'''"))
(None, None, NamedPitch("a''"), NamedPitch("d'''"))
(None, None, NamedPitch("a''"), NamedPitch("d''''"))
(None, None, NamedPitch("d'''"), NamedPitch("a''"))
(None, None, NamedPitch("d'''"), NamedPitch("a'''"))
(None, None, NamedPitch("a'''"), NamedPitch("d'''"))
(None, None, NamedPitch("a'''"), NamedPitch("d''''"))
(None, NamedPitch("a'"), None, NamedPitch("d'''"))
(None, NamedPitch("a'"), None, NamedPitch("d''''"))
(None, NamedPitch("a'"), NamedPitch("d''"), None)
(None, NamedPitch("a'"), NamedPitch("d'''"), None)
(None, NamedPitch("d''"), None, NamedPitch("a''"))
(None, NamedPitch("d''"), None, NamedPitch("a'''"))
(None, NamedPitch("d''"), NamedPitch("a''"), None)
(None, NamedPitch("d''"), NamedPitch("a'''"), None)
(None, NamedPitch("a''"), None, NamedPitch("d'''"))
(None, NamedPitch("a''"), None, NamedPitch("d''''"))
(None, NamedPitch("a''"), NamedPitch("d''"), None)
(None, NamedPitch("a''"), NamedPitch("d'''"), None)
(None, NamedPitch("d'''"), None, NamedPitch("a''"))
(None, NamedPitch("d'''"), None, NamedPitch("a'''"))
(None, NamedPitch("d'''"), NamedPitch("a''"), None)
(None, NamedPitch("d'''"), NamedPitch("a'''"), None)
(NamedPitch("d'"), None, None, NamedPitch("a''"))
(NamedPitch("d'"), None, None, NamedPitch("a'''"))
(NamedPitch("d'"), None, NamedPitch("a''"), None)
(NamedPitch("d'"), None, NamedPitch("a'''"), None)
(NamedPitch("d'"), NamedPitch("a'"), None, None)
(NamedPitch("d'"), NamedPitch("a''"), None, None)
(NamedPitch("a'"), None, None, NamedPitch("d'''"))
(NamedPitch("a'"), None, None, NamedPitch("d''''"))
(NamedPitch("a'"), None, NamedPitch("d''"), None)
(NamedPitch("a'"), None, NamedPitch("d'''"), None)
(NamedPitch("a'"), NamedPitch("d''"), None, None)
(NamedPitch("a'"), NamedPitch("d'''"), None, None)
(NamedPitch("d''"), None, None, NamedPitch("a''"))
(NamedPitch("d''"), None, None, NamedPitch("a'''"))
(NamedPitch("d''"), None, NamedPitch("a''"), None)
(NamedPitch("d''"), None, NamedPitch("a'''"), None)
(NamedPitch("d''"), NamedPitch("a'"), None, None)
(NamedPitch("d''"), NamedPitch("a''"), None, None)

Read-only properties

pitch_ranges

Gets two-octave pitch-ranges for each pitch in this tuning.

>>> indicator = abjad.Tuning(pitches=('G3', 'D4', 'A4', 'E5'))
>>> for range_ in indicator.pitch_ranges:
...     range_
... 
PitchRange('[G3, G5]')
PitchRange('[D4, D6]')
PitchRange('[A4, A6]')
PitchRange('[E5, E7]')
Return type:List[PitchRange]
pitches

Gets pitches of tuning.

>>> indicator = abjad.Tuning(pitches=('G3', 'D4', 'A4', 'E5'))
>>> pitches = indicator.pitches
>>> abjad.f(pitches)
abjad.PitchSegment(
    (
        abjad.NamedPitch('g'),
        abjad.NamedPitch("d'"),
        abjad.NamedPitch("a'"),
        abjad.NamedPitch("e''"),
        ),
    item_class=abjad.NamedPitch,
    )
Return type:Optional[PitchSegment]
tweaks

Are not implemented on tuning.

Return type:None
class abjad.instruments.Vibraphone(*, name='vibraphone', short_name='vibr.', markup=None, short_markup=None, allowable_clefs=None, context=None, middle_c_sounding_pitch=None, pitch_range='[F3, F6]')

Vibraphone.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> vibraphone = abjad.Vibraphone()
>>> abjad.attach(vibraphone, staff[0])
>>> abjad.show(staff) 

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_sounding_pitch(staff)
>>> abjad.show(staff) 

Returns none.

static (Instrument).transpose_from_written_pitch(argument)

Transposes notes and chords in argument from sounding pitch to written pitch.

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff) 
>>> abjad.Instrument.transpose_from_written_pitch(staff)
>>> abjad.show(staff) 

Returns none.


Read-only properties

(Instrument).allowable_clefs

Gets allowable clefs.

Returns clef list.

(Instrument).context

Gets (historically conventional) context of instrument.

Defaults to 'Staff'.

Returns lilypond type of context.

Override with abjad.attach(..., context='...').

(Instrument).latent

Is true for all instruments.

Class constant.

Returns true.

(Instrument).markup

Gets instrument name markup.

Returns markup.

(Instrument).middle_c_sounding_pitch

Gets sounding pitch of written middle C.

Returns named pitch.

(Instrument).name

Gets instrument name.

Returns string.

(Instrument).parameter

Is set to 'INSTRUMENT' for all instruments.

Class constant.

Return type:str
(Instrument).pitch_range

Gets pitch range.

Returns pitch range.

(Instrument).primary

Is true when instrument is historically conventional primary instrument (eg, flute) rather than doubling (eg, piccolo).

(Instrument).redraw

Is true for all instruments.

Class constant.

Returns true.

(Instrument).short_markup

Gets short instrument name markup.

Returns markup.

(Instrument).short_name

Gets short instrument name.

Returns string.

class abjad.instruments.Viola(*, name='viola', short_name='va.', markup=None, short_markup=None, allowable_clefs=('alto', 'treble'), context=None, default_tuning=('C3', 'G3', 'D4', 'A4'), middle_c_sounding_pitch=None, pitch_range='[C3, D6]', primary=True)

Viola.

>>> staff = abjad.Staff("c'4 d'4 e'4 fs'4")
>>> clef = abjad.Clef('alto')
>>> abjad.attach(clef, staff[0])
>>> viola = abjad.Viola()
>>> abjad.attach(viola, staff[0])
>>> abjad.show(staff) 

Attributes Summary

default_tuning Gets viola’s default tuning.

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.

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

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Class & static methods

static (Instrument).transpose_from_sounding_pitch(argument)

Transpose notes and chords in argument from sounding pitch to written pitch:

>>> staff = abjad.Staff("<c' e' g'>4 d'4 r4 e'4")
>>> clarinet = abjad.ClarinetInBFlat()
>>> abjad.attach(clarinet, staff[0])
>>> abjad.show(staff)