StringOrchestraScoreTemplate

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.segments" { graph [label="abjad.segments"]; node [color=1]; "abjad.segments.ScoreTemplate.ScoreTemplate" [URL="../api/abjad/segments/ScoreTemplate.html#abjad.segments.ScoreTemplate.ScoreTemplate", label="Score\nTemplate", shape=oval, style=bold, target=_top]; "abjad.segments.StringOrchestraScoreTemplate.StringOrchestraScoreTemplate" [URL="../api/abjad/segments/StringOrchestraScoreTemplate.html#abjad.segments.StringOrchestraScoreTemplate.StringOrchestraScoreTemplate", color=black, fontcolor=white, label="String\nOrchestra\nScore\nTemplate", target=_top]; "abjad.segments.ScoreTemplate.ScoreTemplate" -> "abjad.segments.StringOrchestraScoreTemplate.StringOrchestraScoreTemplate"; } subgraph "cluster_abjad.system" { graph [label="abjad.system"]; node [color=2]; "abjad.system.AbjadObject.AbjadObject" [URL="../api/abjad/segments/../system/AbjadObject.html#abjad.system.AbjadObject.AbjadObject", label="Abjad\nObject", target=_top]; "abjad.system.AbjadValueObject.AbjadValueObject" [URL="../api/abjad/segments/../system/AbjadValueObject.html#abjad.system.AbjadValueObject.AbjadValueObject", 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", label=object, target=_top]; } "abjad.system.AbjadValueObject.AbjadValueObject" -> "abjad.segments.ScoreTemplate.ScoreTemplate"; "builtins.object" -> "abjad.system.AbjadObject.AbjadObject"; }

class abjad.segments.StringOrchestraScoreTemplate.StringOrchestraScoreTemplate(violin_count=6, viola_count=4, cello_count=3, contrabass_count=2, split_hands=True, use_percussion_clefs=False)

String orchestra score template.

>>> template = abjad.StringOrchestraScoreTemplate()
>>> abjad.show(template) 
>>> abjad.f(template.__illustrate__()[abjad.Score])
\context Score = "Score"
<<
    \tag #'(Violin1 Violin2 Violin3 Violin4 Violin5 Violin6 Viola1 Viola2 Viola3 Viola4 Cello1 Cello2 Cello3 Contrabass1 Contrabass2)
    \context GlobalContext = "GlobalContext"
    {
    }
    \context StaffGroup = "Outer Staff Group"
    <<
        \context ViolinStaffGroup = "Violin Staff Group"
        <<
            \tag #'Violin1
            \context StringPerformerStaffGroup = "Violin 1 Staff Group"
            <<
                \context BowingStaff = "Violin 1 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 1 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 1 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 1 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Violin2
            \context StringPerformerStaffGroup = "Violin 2 Staff Group"
            <<
                \context BowingStaff = "Violin 2 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 2 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 2 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 2 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Violin3
            \context StringPerformerStaffGroup = "Violin 3 Staff Group"
            <<
                \context BowingStaff = "Violin 3 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 3 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 3 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 3 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Violin4
            \context StringPerformerStaffGroup = "Violin 4 Staff Group"
            <<
                \context BowingStaff = "Violin 4 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 4 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 4 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 4 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Violin5
            \context StringPerformerStaffGroup = "Violin 5 Staff Group"
            <<
                \context BowingStaff = "Violin 5 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 5 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 5 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 5 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Violin6
            \context StringPerformerStaffGroup = "Violin 6 Staff Group"
            <<
                \context BowingStaff = "Violin 6 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 6 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 6 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 6 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
        >>
        \context ViolaStaffGroup = "Viola Staff Group"
        <<
            \tag #'Viola1
            \context StringPerformerStaffGroup = "Viola 1 Staff Group"
            <<
                \context BowingStaff = "Viola 1 Bowing Staff"
                <<
                    \context BowingVoice = "Viola 1 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Viola 1 Fingering Staff"
                <<
                    \context FingeringVoice = "Viola 1 Fingering Voice"
                    {
                        \clef "alto" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Viola2
            \context StringPerformerStaffGroup = "Viola 2 Staff Group"
            <<
                \context BowingStaff = "Viola 2 Bowing Staff"
                <<
                    \context BowingVoice = "Viola 2 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Viola 2 Fingering Staff"
                <<
                    \context FingeringVoice = "Viola 2 Fingering Voice"
                    {
                        \clef "alto" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Viola3
            \context StringPerformerStaffGroup = "Viola 3 Staff Group"
            <<
                \context BowingStaff = "Viola 3 Bowing Staff"
                <<
                    \context BowingVoice = "Viola 3 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Viola 3 Fingering Staff"
                <<
                    \context FingeringVoice = "Viola 3 Fingering Voice"
                    {
                        \clef "alto" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Viola4
            \context StringPerformerStaffGroup = "Viola 4 Staff Group"
            <<
                \context BowingStaff = "Viola 4 Bowing Staff"
                <<
                    \context BowingVoice = "Viola 4 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Viola 4 Fingering Staff"
                <<
                    \context FingeringVoice = "Viola 4 Fingering Voice"
                    {
                        \clef "alto" %! ST3
                        s1
                    }
                >>
            >>
        >>
        \context CelloStaffGroup = "Cello Staff Group"
        <<
            \tag #'Cello1
            \context StringPerformerStaffGroup = "Cello 1 Staff Group"
            <<
                \context BowingStaff = "Cello 1 Bowing Staff"
                <<
                    \context BowingVoice = "Cello 1 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Cello 1 Fingering Staff"
                <<
                    \context FingeringVoice = "Cello 1 Fingering Voice"
                    {
                        \clef "bass" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Cello2
            \context StringPerformerStaffGroup = "Cello 2 Staff Group"
            <<
                \context BowingStaff = "Cello 2 Bowing Staff"
                <<
                    \context BowingVoice = "Cello 2 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Cello 2 Fingering Staff"
                <<
                    \context FingeringVoice = "Cello 2 Fingering Voice"
                    {
                        \clef "bass" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Cello3
            \context StringPerformerStaffGroup = "Cello 3 Staff Group"
            <<
                \context BowingStaff = "Cello 3 Bowing Staff"
                <<
                    \context BowingVoice = "Cello 3 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Cello 3 Fingering Staff"
                <<
                    \context FingeringVoice = "Cello 3 Fingering Voice"
                    {
                        \clef "bass" %! ST3
                        s1
                    }
                >>
            >>
        >>
        \context ContrabassStaffGroup = "Contrabass Staff Group"
        <<
            \tag #'Contrabass1
            \context StringPerformerStaffGroup = "Contrabass 1 Staff Group"
            <<
                \context BowingStaff = "Contrabass 1 Bowing Staff"
                <<
                    \context BowingVoice = "Contrabass 1 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Contrabass 1 Fingering Staff"
                <<
                    \context FingeringVoice = "Contrabass 1 Fingering Voice"
                    {
                        \clef "bass_8" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Contrabass2
            \context StringPerformerStaffGroup = "Contrabass 2 Staff Group"
            <<
                \context BowingStaff = "Contrabass 2 Bowing Staff"
                <<
                    \context BowingVoice = "Contrabass 2 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Contrabass 2 Fingering Staff"
                <<
                    \context FingeringVoice = "Contrabass 2 Fingering Voice"
                    {
                        \clef "bass_8" %! ST3
                        s1
                    }
                >>
            >>
        >>
    >>
>>

As a string quartet:

>>> template = abjad.StringOrchestraScoreTemplate(
...     violin_count=2,
...     viola_count=1,
...     cello_count=1,
...     contrabass_count=0,
...     )
>>> abjad.show(template) 
>>> abjad.f(template.__illustrate__()[abjad.Score])
\context Score = "Score"
<<
    \tag #'(Violin1 Violin2 Viola Cello)
    \context GlobalContext = "GlobalContext"
    {
    }
    \context StaffGroup = "Outer Staff Group"
    <<
        \context ViolinStaffGroup = "Violin Staff Group"
        <<
            \tag #'Violin1
            \context StringPerformerStaffGroup = "Violin 1 Staff Group"
            <<
                \context BowingStaff = "Violin 1 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 1 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 1 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 1 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
            \tag #'Violin2
            \context StringPerformerStaffGroup = "Violin 2 Staff Group"
            <<
                \context BowingStaff = "Violin 2 Bowing Staff"
                <<
                    \context BowingVoice = "Violin 2 Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Violin 2 Fingering Staff"
                <<
                    \context FingeringVoice = "Violin 2 Fingering Voice"
                    {
                        \clef "treble" %! ST3
                        s1
                    }
                >>
            >>
        >>
        \context ViolaStaffGroup = "Viola Staff Group"
        <<
            \tag #'Viola
            \context StringPerformerStaffGroup = "Viola Staff Group"
            <<
                \context BowingStaff = "Viola Bowing Staff"
                <<
                    \context BowingVoice = "Viola Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Viola Fingering Staff"
                <<
                    \context FingeringVoice = "Viola Fingering Voice"
                    {
                        \clef "alto" %! ST3
                        s1
                    }
                >>
            >>
        >>
        \context CelloStaffGroup = "Cello Staff Group"
        <<
            \tag #'Cello
            \context StringPerformerStaffGroup = "Cello Staff Group"
            <<
                \context BowingStaff = "Cello Bowing Staff"
                <<
                    \context BowingVoice = "Cello Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Cello Fingering Staff"
                <<
                    \context FingeringVoice = "Cello Fingering Voice"
                    {
                        \clef "bass" %! ST3
                        s1
                    }
                >>
            >>
        >>
    >>
>>

As a cello solo:

>>> template = abjad.StringOrchestraScoreTemplate(
...     violin_count=0,
...     viola_count=0,
...     cello_count=1,
...     contrabass_count=0,
...     )
>>> abjad.show(template) 
>>> abjad.f(template.__illustrate__()[abjad.Score])
\context Score = "Score"
<<
    \tag #'(Cello)
    \context GlobalContext = "GlobalContext"
    {
    }
    \context StaffGroup = "Outer Staff Group"
    <<
        \context CelloStaffGroup = "Cello Staff Group"
        <<
            \tag #'Cello
            \context StringPerformerStaffGroup = "Cello Staff Group"
            <<
                \context BowingStaff = "Cello Bowing Staff"
                <<
                    \context BowingVoice = "Cello Bowing Voice"
                    {
                        s1
                    }
                >>
                \context FingeringStaff = "Cello Fingering Staff"
                <<
                    \context FingeringVoice = "Cello Fingering Voice"
                    {
                        \clef "bass" %! ST3
                        s1
                    }
                >>
            >>
        >>
    >>
>>

Attributes Summary

__call__ Calls string orchestra template.
cello_count Number of cellos in string orchestra.
contrabass_count Number of contrabasses in string orchestra.
split_hands Is true if each performer’s hand receives a separate staff.
use_percussion_clefs Is true if each staff should use a percussion clef rather than the normal clef for that instrument.
viola_count Number of violas in string orcestra.
violin_count Number of violins in string orchestra.

Special methods

__call__()

Calls string orchestra template.

Returns score.

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

(ScoreTemplate).__illustrate__(default_paper_size=None, global_staff_size=None, includes=None)

Illustrates score template.

(AbjadObject).__repr__()

Gets interpreter representation of Abjad object.

Returns string.


Methods

(ScoreTemplate).allows_instrument(staff_name, instrument)

Is true when staff_name allows instrument.

To be implemented by concrete score template classes.

Return type:bool
(ScoreTemplate).allows_part_assignment(voice_name, part_assignment)

Is true when voice_name allows part_assignment.

Return type:bool
(ScoreTemplate).attach_defaults(argument)

Attaches defaults to all staff and staff group contexts in argument when argument is a score.

Attaches defaults to argument (without iterating argument) when argument is a staff or staff group.

Returns list of one wrapper for every indicator attached.

Return type:List[~T]

Read-only properties

(ScoreTemplate).always_make_global_rests

Is true when score template always makes global rests.

Return type:bool
cello_count

Number of cellos in string orchestra.

Returns nonnegative integer.

contrabass_count

Number of contrabasses in string orchestra.

Returns nonnegative integer.

(ScoreTemplate).do_not_require_margin_markup

Is true when score template does not require margin markup.

Conventionally, solos do not require margin markup.

Return type:bool
(ScoreTemplate).part_manifest

Gets part manifest.

Return type:Optional[PartManifest]
split_hands

Is true if each performer’s hand receives a separate staff.

use_percussion_clefs

Is true if each staff should use a percussion clef rather than the normal clef for that instrument.

viola_count

Number of violas in string orcestra.

Returns nonnegative integer.

violin_count

Number of violins in string orchestra.

Returns nonnegative integer.

(ScoreTemplate).voice_abbreviations

Gets voice abbreviations.

Return type:OrderedDict