instrumenttools.Viola

class abjad.tools.instrumenttools.Viola.Viola.Viola(**kwargs)

New in version 2.0.

Abjad model of the viola:

abjad> staff = Staff("c'8 d'8 e'8 f'8")
abjad> contexttools.ClefMark('alto')(staff)
ClefMark('alto')(Staff{4})

abjad> instrumenttools.Viola()(staff)
Viola()(Staff{4})

abjad> f(staff)
\new Staff {
    \clef "alto"
    \set Staff.instrumentName = \markup { Viola }
    \set Staff.shortInstrumentName = \markup { Va. }
    c'8
    d'8
    e'8
    f'8
}

The viola targets staff context by default.

Read-only Properties

Viola.default_instrument_name

Read-only default instrument name.

Return string.

Note

Inherited from contexttools.InstrumentMark

Viola.default_short_instrument_name

Read-only default short instrument name.

Return string.

Note

Inherited from contexttools.InstrumentMark

Viola.effective_context

Read-only reference to effective context of context mark:

abjad> note = Note("c'4")
abjad> context_mark = contexttools.ContextMark()(note)

abjad> context_mark.effective_context is None
True

Return context mark or none.

Note

Inherited from contexttools.ContextMark

Viola.format

Read-only LilyPond input format of instrument mark:

abjad> instrument = contexttools.InstrumentMark('Flute', 'Fl.')
abjad> instrument.format
['\set Staff.instrumentName = \markup { Flute }', '\set Staff.shortInstrumentName = \markup { Fl. }']

Return list.

Note

Inherited from contexttools.InstrumentMark

Viola.interval_of_transposition

Read-only interval of transposition.

Return melodic diatonic interval.

Note

Inherited from instrumenttools._Instrument

Viola.is_primary_instrument

Note

Inherited from instrumenttools._Instrument

Viola.is_secondary_instrument

Note

Inherited from instrumenttools._Instrument

Viola.is_transposing

True when instrument is transposing. False otherwise.

Return boolean.

Note

Inherited from instrumenttools._Instrument

Viola.start_component

Read-only reference to mark start component:

abjad> note = Note("c'4")
abjad> mark = marktools.Mark()(note)

abjad> mark.start_component
Note("c'4")

Return component or none.

Note

Inherited from marktools.Mark

Viola.target_context

Read-only reference to target context of context mark:

abjad> note = Note("c'4")
abjad> context_mark = contexttools.ContextMark()(note)

abjad> context_mark.target_context is None
True

Return context mark or none.

Note

Inherited from contexttools.ContextMark

Viola.traditional_pitch_range

Read-only traditional pitch range.

Return pitch range.

Note

Inherited from instrumenttools._Instrument

Read/write Properties

Viola.all_clefs

Note

Inherited from instrumenttools._Instrument

Viola.instrument_name

Get instrument name:

abjad> instrument = contexttools.InstrumentMark('Flute', 'Fl.')
abjad> instrument.instrument_name
'Flute'

Set instrument name:

abjad> instrument.instrument_name = 'Alto Flute'
abjad> instrument.instrument_name
'Alto Flute'

Return string.

Note

Inherited from contexttools.InstrumentMark

Viola.instrument_name_markup

Get instrument name:

abjad> instrument = contexttools.InstrumentMark('Flute', 'Fl.')
abjad> instrument.instrument_name_markup
Markup('Flute')

Set instrument name:

abjad> instrument.instrument_name_markup = 'Alto Flute'
abjad> instrument.instrument_name_markup
Markup('Alto Flute')

Return markup.

Note

Inherited from contexttools.InstrumentMark

Viola.pitch_range

Note

Inherited from instrumenttools._Instrument

Viola.primary_clefs

Note

Inherited from instrumenttools._Instrument

Viola.short_instrument_name

Get short instrument name:

abjad> instrument = contexttools.InstrumentMark('Flute', 'Fl.')
abjad> instrument.short_instrument_name
'Fl.'

Set short instrument name:

abjad> instrument.short_instrument_name = 'Alto Fl.'
abjad> instrument.short_instrument_name
'Alto Fl.'

Return string.

Note

Inherited from contexttools.InstrumentMark

Viola.short_instrument_name_markup

Get short instrument name:

abjad> instrument = contexttools.InstrumentMark('Flute', 'Fl.')
abjad> instrument.short_instrument_name_markup
Markup('Fl.')

Set short instrument name:

abjad> instrument.short_instrument_name_markup = 'Alto Fl.'
abjad> instrument.short_instrument_name_markup
Markup('Alto Fl.')

Return markup.

Note

Inherited from contexttools.InstrumentMark

Viola.sounding_pitch_of_fingered_middle_c

Note

Inherited from instrumenttools._Instrument

Methods

Viola.attach(start_component)

Make sure no context mark of same type is already attached to start component.

Note

Inherited from contexttools.ContextMark

Viola.detach()

Detach mark:

abjad> note = Note("c'4")
abjad> context_mark = contexttools.ContextMark()(note)

abjad> context_mark.start_component
Note("c'4")

abjad> context_mark.detach()
ContextMark()

abjad> context_mark.start_component is None
True

Return context mark.

Note

Inherited from contexttools.ContextMark

Viola.get_default_performer_name(locale=None)

New in version 2.5.

Get default player name.

Available values for locale are 'en-us' and 'en-uk'.

Note

Inherited from instrumenttools._Instrument

Viola.get_performer_names()

New in version 2.5.

Get performer names.

Note

Inherited from instrumenttools._Instrument

Special Methods

Viola.__call__(*args)

Note

Inherited from marktools.Mark

Viola.__delattr__(*args)

Note

Inherited from marktools.Mark

Viola.__eq__(arg)

Note

Inherited from contexttools.InstrumentMark

Viola.__ge__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

Viola.__gt__(arg)

Abjad objects by default do not implement this method.

Raise exception

Note

Inherited from abctools.AbjadObject

Viola.__hash__()

Note

Inherited from contexttools.InstrumentMark

Viola.__le__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

Viola.__lt__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

Viola.__ne__(arg)

Note

Inherited from marktools.Mark

Viola.__repr__()

Note

Inherited from marktools.Mark

Viola.__setattr__()

x.__setattr__(‘name’, value) <==> x.name = value

Note

Inherited from __builtin__.object

Viola.__str__() <==> str(x)

Note

Inherited from __builtin__.object