scoretools.Performer

class abjad.tools.scoretools.Performer.Performer.Performer(name=None, instruments=None)

New in version 2.5.

Abjad model of performer:

abjad> scoretools.Performer(name='flutist')
Performer(name='flutist', instruments=InstrumentInventory([]))

The purpose of the class is to model things like flute I doubling piccolo and alto flute.

At present the class is a list of instruments.

Read-only Properties

Performer.instrument_count

Read-only number of instruments to be played by performer:

abjad> performer = scoretools.Performer('flutist')

abjad> performer.instruments.append(instrumenttools.Flute())
abjad> performer.instruments.append(instrumenttools.Piccolo())

abjad> performer.instrument_count
2

Return nonnegative integer

Performer.is_doubling

Is performer to play more than one instrument?

abjad> performer = scoretools.Performer('flutist')

abjad> performer.instruments.append(instrumenttools.Flute())
abjad> performer.instruments.append(instrumenttools.Piccolo())

abjad> performer.is_doubling
True

Return boolean.

Performer.likely_instruments_based_on_performer_name

New in version 2.5.

Likely instruments based on performer name:

abjad> flutist = scoretools.Performer(name='flutist')
abjad> for likely_instrument in flutist.likely_instruments_based_on_performer_name:
...     likely_instrument
... 
<class 'abjad.tools.instrumenttools.AltoFlute.AltoFlute.AltoFlute'>
<class 'abjad.tools.instrumenttools.BassFlute.BassFlute.BassFlute'>
<class 'abjad.tools.instrumenttools.ContrabassFlute.ContrabassFlute.ContrabassFlute'>
<class 'abjad.tools.instrumenttools.Flute.Flute.Flute'>
<class 'abjad.tools.instrumenttools.Piccolo.Piccolo.Piccolo'>

Return list.

Performer.most_likely_instrument_based_on_performer_name

New in version 2.5.

Most likely instrument based on performer name:

abjad> flutist = scoretools.Performer(name='flutist')    
abjad> flutist.most_likely_instrument_based_on_performer_name
<class 'abjad.tools.instrumenttools.Flute.Flute.Flute'>

Return instrument class.

Read/write Properties

Performer.instruments

List of instruments to be played by performer:

abjad> performer = scoretools.Performer('flutist')

abjad> performer.instruments.append(instrumenttools.Flute())
abjad> performer.instruments.append(instrumenttools.Piccolo())

abjad> performer.instruments
InstrumentInventory([Flute(), Piccolo()])

Return list.

Performer.name

Score name of performer:

abjad> performer = scoretools.Performer('flutist')

abjad> performer.name
'flutist'

Return string.

Methods

Performer.make_performer_name_instrument_dictionary(locale=None)

New in version 2.5.

Make performer name / instrument dictionary.

Return dictionary.

Special Methods

Performer.__delattr__()

x.__delattr__(‘name’) <==> del x.name

Note

Inherited from __builtin__.object

Performer.__eq__(other)

Performer.__ge__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

Performer.__gt__(arg)

Abjad objects by default do not implement this method.

Raise exception

Note

Inherited from abctools.AbjadObject

Performer.__hash__()

Performer.__le__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

Performer.__lt__(arg)

Abjad objects by default do not implement this method.

Raise exception.

Note

Inherited from abctools.AbjadObject

Performer.__ne__(other)

Performer.__repr__()

Interpreter representation of Abjad object defaulting to class name, mandatory arguments, keyword arguments.

Return string.

Note

Inherited from abctools.AbjadObject

Performer.__setattr__()

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

Note

Inherited from __builtin__.object

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

Note

Inherited from __builtin__.object