Staff — Abjad v1.1.1 documentation

### Navigation

- index
- modules |
- next |
- previous |
- Project Abjad »
- Abjad v1.1.1 documentation »
- Abjad API »

# Staff

class `abjad.` `Staff`(music=None)

  Bases: `abjad.context.context._Context`

  Abjad model of one staff in score.

  `accidental`
    Read-only reference to `AccidentalInterface`.
  `append`(component)
    Append component to the end of container. Attach no new spanners to component.
  `articulations`
    Read-only reference to `ArticulationsInterface`.
  `barline`
    Read-only reference to `BarLineInterface`.
  `barnumber`
    Read-only reference to `BarNumberInterface`.
  `beam`
    Read-only reference to `BeamInterface`.
  `brackets`
    Read-only reference to `BracketsInterface`.
  `breaks`
    Read-only reference to `BreaksInterface`.
  `clef`
    Read-only reference to `ClefInterface`.
  `comments`
    Read-only reference to `CommentsInterface`.
  `context`
  `directives`
    Read-only reference to `DirectivesInterface`.
  `dots`
    Read-only reference to `DotsInterface`.
  `duration`
    Read-only reference to class-specific duration interface.
  `dynamics`
    Read-only reference to `DynamicsInterface`.
  `extend`(expr)
    Extend container with components in ‘expr’. Change no container spanners. Return container.
  `extend_in_parent`(components)

    New in version 1.1.1.

    Extend components rightwards of self in parent.

    Do not extend edge spanners.

        abjad> t = Voice(construct.scale(3))
        abjad> Beam(t[:])
        abjad> t[-1].extend_in_parent(construct.scale(3))

        abjad> print t.format
        \new Voice {
           c'8 [
           d'8
           e'8 ]
           c'8
           d'8
           e'8
        }

  `extend_left_in_parent`(components)

    New in version 1.1.1.

    Extend components leftwards of self in parent.

    Do not extend edge spanners.

        abjad> t = Voice(construct.scale(3))
        abjad> Beam(t[:])
        abjad> t[0].extend_in_parent(construct.scale(3))

        abjad> print t.format
        \new Voice {
           c'8
           d'8
           e'8
           c'8 [
           d'8
           e'8 ]
        }

  `format`
    Read-only version of self as LilyPond input code.
  `glissando`
    Read-only reference to `GlissandoInterface`.
  `history`
    Read-only reference to `HistoryInterface`.
  `index`(component)
    Return nonnegative integer index of component in container.
  `insert`(i, component)
    Insert component ‘component’ at index ‘i’ in container. Attach spanners that dominate index ‘i’ to ‘component’.
  `instrument`
    Read-only reference to `InstrumentInterface`.
  `interfaces`
    Read-only reference to `InterfaceAggregator`.
  `leaves`

    Read-only tuple of all leaves in self.

    Changed in version 1.1.1.

  `meter`
    Read-only reference to `MeterInterface`.
  `music`
    Read-only tuple of music in self.
  `name`
    Read-write name of self. Must be string or `None`.
  `notecolumn`
    Read-only reference to `NoteColumnInterface`.
  `notehead`
    Read-only reference to `NoteHeadInterface`.
  `offset`
    Read-only reference to `OffsetInterface`.
  `parallel`
    Read / write boolean for paralllel / sequential containers.
  `parentage`
    Read-only reference to `ParentageInterface`.
  `pianopedal`
    Read-only reference to `PianoPedalInterface`.
  `pop`(i=-1)
    Find component at index ‘i’ in container. Detach component from parentage. Withdraw component from crossing spanners. Preserve spanners that component covers. Return component.
  `remove`(component)
    Assert ‘component’ in container. Detach ‘component’ from parentage. Withdraw ‘component’ from crossing spanners. Carry covered spanners forward on ‘component’. Return ‘component’.
  `rest`
    Read-only reference to `RestInterface`.
  `score`
    Read-only reference to `ScoreInterface`.
  `slur`
    Read-only reference to `SlurInterface`.
  `spacing`
    Read-only reference to `SpacingInterface`.
  `spanbar`
    Read-only reference to `SpanBarInterface`.
  `spanners`
    Read-only reference to `_ComponentSpannerAggregator`.
  `splice`(components)
    Splice components after self. Extend spanners rightwards to attach to all components in list.
  `splice_left`(components)
    Splice components before self. Extend spanners leftwards to attach to all components in list.
  `staff`
    Read-only reference to `StaffInterface`.
  `stem`
    Read-only reference to `StemInterface`.
  `tempo`
    Read-only reference to `TempoInterface`.
  `text`
    Read-only reference to `TextInterface`.
  `thread`
    Read-only reference to `ThreadInterface`.
  `tie`
    Read-only reference to `TieInterface`.
  `tremolo`
    Read-only reference to `TremoloInterface`.
  `trill`
    Read-only reference to `TrillInterface`.
  `tupletbracket`
    Read-only reference to `TupletBracketInterface`.
  `tupletnumber`
    Read-only reference to `TupletNumberInterface`.
  `voice`
    Read-only reference to `VoiceInterface`.

### Navigation

- index
- modules |
- next |
- previous |
- Project Abjad »
- Abjad v1.1.1 documentation »
- Abjad API »