XMLELEMENT

Warning

This documentation is still under construction!

class musicxml.xmlelement.xmlelement.XMLElement(value_='', xsd_check=True, **kwargs)[source]

Bases: Tree

Parent class of all xml elements.

add_child(child: XMLElement, forward: int | None = None) → XMLElement[source]

Parameters:

child – chlild of type XMLElement to be added to XMLElement’s XMLChildContainer and _unordered_children.
forward – If there are more than one XSDElement leaves in child_container_tree, forward can be used to determine manually which of these equivocal xsd elements is going to be used to attach the child.

Returns:

Added child.

find_child(name: XMLElement | str, ordered: bool = False) → XMLElement[source]

Parameters:

name – XMLElement child or it’s name as string.
ordered – get_children ordered mode to be used to find first appearance of child.

Returns:

found child of type XMLElement.

find_children(name: XMLElement | str, ordered: bool = False) → List[XMLElement][source]

Parameters:

name – A child of type XMLElement or it’s name as string.
ordered – get_children ordered mode to be used to find children.

Returns:

found children of type XMLElement.

get_children(ordered: bool = True) → List[XMLElement][source]

Parameters:: ordered (bool) – With (True) or without (False) using XMLChildContainer .
Returns:: XMLElement added children. If ordered is False the _unordered_children is returned as a more light weighted way of getting children instead of using the leaves of XMLChildContainer.

get_children_of_type(type) → List[Tree]

Tree method

Returns:: list of added children of type.
Return type:: List[Tree]

get_coordinates_in_tree() → str

Tree method

Returns:: 0 for root. 1, 2, … for layer 1. Other layers: x.y.z…. Example: 3.2.2 => third child of secod child of second child of the root.
Return type:: str

>>> class TestTree(Tree):
...   def _check_child_to_be_added(self, child):
...      return True
>>> root = TestTree()
>>> root.get_coordinates_in_tree()
'0'
>>> child1 = root.add_child(TestTree())
>>> child2 = root.add_child(TestTree())
>>> grandchild1 = child2.add_child(TestTree())
>>> grandchild2 = child2.add_child(TestTree())
>>> child1.get_coordinates_in_tree()
'1'
>>> child2.get_coordinates_in_tree()
'2'
>>> grandchild1.get_coordinates_in_tree()
'2.1'
>>> grandchild2.get_coordinates_in_tree()
'2.2'

get_indentation() → str

Tree method

Returns:: indentation according to level (layer number). As default it is used for creating tabs in tree_representation
Return type:: str

get_layer(level: int, key: Callable | None = None) → list

Tree method

Parameters:

level – layer number where 0 is the root.
key – An optional callable for each node in the layer.

Returns:

All nodes on this level. The leaves of branches which are shorter than the given level will be repeated on this and all following layers.

Return type:

list

get_leaves(key: Callable | None = None) → list

Tree method

Parameters:: key – An optional callable to be called on each leaf.
Returns:: nested list of leaves or values of key(leaf) for each leaf
Return type:: nested list of Tree

get_parent() → Tree

Tree method

Returns:: parent. None for root.
Return type:: Tree

get_root() → Tree

Tree method

Returns:: root (upmost node of a tree which has no parent)
Return type:: Tree

classmethod get_xsd()[source]

Returns:: Snippet of MusicXML xsd file which is relevant for this XMLElement.

iterate_leaves() → Iterator[Tree]

Tree method

Returns:: A generator iterating over all leaves.

remove(child: XMLElement) → None[source]

Parameters:: child – child of type XMLElement to be removed. This method must be used to remove a child properly from XMLChildContainer and reset its behaviour.
Returns:: None

remove_children() → None

Tree method

Calls remove() on all children.

Returns:: None

replace_child(old: XMLElement | Callable, new: XMLElement, index: int = 0) → XMLElement[source]

Parameters:

old – A child of type XMLElement or a function which is used to find a child to be replaced.
new – Child of type XMLElement to be replaced with.
index (int) – index of old in list of old appearances

Returns:

new xml element

Return type:

XMLElement

reversed_path_to_root() → Iterator[Tree]

Tree method

Returns:: path from self upwards through all ancestors up to the root.

to_string(intelligent_choice: bool = False) → str[source]

Parameters:: intelligent_choice (bool) – Set to True if you wish to use intelligent choice in final checks to be able to change the attachment order of XMLElement children in child_container_tree if an Exception was raised and other choices can still be checked. (NO GUARANTEE!)
Returns:: String in xml format.

traverse() → Iterator[Tree]

Tree method

Traverse all tree nodes.

Returns:: generator

tree_representation(key: Callable | None = None, tab: Callable | None = None) → str

Tree method

Parameters:

key – An optional callable if None compact_repr property of each node is called.
tab – An optional callable if None get_indentation() method of each node is called.

Returns:

a representation of all nodes as string in tree form.

Return type:

str

TYPE = None

XSD_TREE = None

property attributes

Returns:: a dictionary of attributes like {‘font-family’: ‘Arial’}

>>> t = XMLText(value_='hello', font_family = 'Arial')
>>> t.attributes
{'font-family': 'Arial'}
>>> t.to_string()
<text font-family="Arial">hello</text>

property child_container_tree

Returns:: A XMLChildContainer object which is used to manage and control XMLElement`’s children. The nodes of a XMLChildContainer have a core content property of types XSDSequence, XSDChoice, XSDGroup or XSDElement. XSDElement is the content type of XMLChildContainer leaves where one or more XMLElements of a single type (depending on maxOccur attribute of element) can be added to its xml_elements list. An interaction of xsd indicators (sequence, choice and group) with xsd elements makes it possible to add XMLElement’s Children in the right order and control all xsd rules which apply to MusicXML. A variety of exceptions help user to control the xml structure of the exported file which they are intending to use as a MusicXML format file.

property compact_repr: str

Tree property

Returns:: compact representation of a node. Default is the string representation. This property is used as default in the tree_representation method and can be customized in subclasses to get the most appropriate representation.
Return type:: str

property et_xml_element

Returns:: A xml.etree.ElementTree.Element which is used to write the MusicXML file.

property is_leaf: bool

Tree property

Returns:: True if self has no children. False if self has one or more children.
Return type:: bool

property is_root: bool

Tree property

Returns:: True if self has no parent, else False.
Return type:: bool

property level: int

Tree property

Returns:: 0 for root, 1, 2 etc. for each layer of children
Return type:: nonnegative int

>>> class TestTree(Tree):
...   def _check_child_to_be_added(self, child):
...      return True
>>> root = TestTree()
>>> root.level
0
>>> ch = root.add_child(TestTree()).add_child(TestTree()).add_child(TestTree())
>>> ch.level
3

property name

Returns:: XSD_TREE.name

property next: Tree | None

Tree property

Returns:: next sibling. None if this is the last current child of the parent.
Return type:: Tree

property possible_children_names: If child_container_tree of type XMLChildContainer exists content.name of each leave will be returned in a set

property previous: Tree | None

Tree property

Returns:: previous sibling. None if this is the first child of the parent.
Return type:: Tree

property up: Tree

Tree property

Returns:: get_parent()
Return type:: Tree

property value_

Returns:: A validated value of XMLElement` which will be translated to its text in xml format.

property xsd_check: bool

Set and get xsd_check property. Default is True. If set to False method’s add_child() and to_string() run no xsd checking.

Returns:: bool

class musicxml.xmlelement.xmlelement.XMLAccent(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The accent element indicates a regular horizontal accent mark.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=accent type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLAccidental(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The accidental type represents actual notated accidentals. Editorial and cautionary indications are indicated by attributes. Values for these attributes are “no” if not present. Specific graphic display such as parentheses, brackets, and size are controlled by the level-display attribute group.

simpleContent: The accidental-value type represents notated accidentals supported by MusicXML. In the MusicXML 2.0 DTD this was a string with values that could be included. The XSD strengthens the data typing to an enumerated list. The quarter- and three-quarters- accidentals are Tartini-style quarter-tone accidentals. The -down and -up accidentals are quarter-tone accidentals that include arrows pointing down or up. The slash- accidentals are used in Turkish classical music. The numbered sharp and flat accidentals are superscripted versions of the accidental signs, used in Turkish folk music. The sori and koron accidentals are microtonal sharp and flat accidentals used in Iranian and Persian music. The other accidental covers accidentals other than those listed here. It is usually used in combination with the smufl attribute to specify a particular SMuFL accidental. The smufl attribute may be used with any accidental value to help specify the appearance of symbols that share the same MusicXML semantics.

Permitted Values: 'sharp', 'natural', 'flat', 'double-sharp', 'sharp-sharp', 'flat-flat', 'natural-sharp', 'natural-flat', 'quarter-flat', 'quarter-sharp', 'three-quarters-flat', 'three-quarters-sharp', 'sharp-down', 'sharp-up', 'natural-down', 'natural-up', 'flat-down', 'flat-up', 'double-sharp-down', 'double-sharp-up', 'flat-flat-down', 'flat-flat-up', 'arrow-down', 'arrow-up', 'triple-sharp', 'triple-flat', 'slash-quarter-sharp', 'slash-sharp', 'slash-flat', 'double-slash-flat', 'sharp-1', 'sharp-2', 'sharp-3', 'sharp-5', 'flat-1', 'flat-2', 'flat-3', 'flat-4', 'sori', 'koron', 'other'

Possible attributes: bracket@ XSDSimpleTypeYesNo, cautionary@ XSDSimpleTypeYesNo, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, editorial@ XSDSimpleTypeYesNo, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, parentheses@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, size@ XSDSimpleTypeSymbolSize, smufl@ XSDSimpleTypeSmuflAccidentalGlyphName

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeAccidental

XSD_TREE = XSDTree(tag=element, name=accidental type=accidental minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLAccidentalMark(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: An accidental-mark can be used as a separate notation or as part of an ornament. When used in an ornament, position and placement are relative to the ornament, not relative to the note.

simpleContent: The accidental-value type represents notated accidentals supported by MusicXML. In the MusicXML 2.0 DTD this was a string with values that could be included. The XSD strengthens the data typing to an enumerated list. The quarter- and three-quarters- accidentals are Tartini-style quarter-tone accidentals. The -down and -up accidentals are quarter-tone accidentals that include arrows pointing down or up. The slash- accidentals are used in Turkish classical music. The numbered sharp and flat accidentals are superscripted versions of the accidental signs, used in Turkish folk music. The sori and koron accidentals are microtonal sharp and flat accidentals used in Iranian and Persian music. The other accidental covers accidentals other than those listed here. It is usually used in combination with the smufl attribute to specify a particular SMuFL accidental. The smufl attribute may be used with any accidental value to help specify the appearance of symbols that share the same MusicXML semantics.

Permitted Values: 'sharp', 'natural', 'flat', 'double-sharp', 'sharp-sharp', 'flat-flat', 'natural-sharp', 'natural-flat', 'quarter-flat', 'quarter-sharp', 'three-quarters-flat', 'three-quarters-sharp', 'sharp-down', 'sharp-up', 'natural-down', 'natural-up', 'flat-down', 'flat-up', 'double-sharp-down', 'double-sharp-up', 'flat-flat-down', 'flat-flat-up', 'arrow-down', 'arrow-up', 'triple-sharp', 'triple-flat', 'slash-quarter-sharp', 'slash-sharp', 'slash-flat', 'double-slash-flat', 'sharp-1', 'sharp-2', 'sharp-3', 'sharp-5', 'flat-1', 'flat-2', 'flat-3', 'flat-4', 'sori', 'koron', 'other'

Possible attributes: bracket@ XSDSimpleTypeYesNo, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, parentheses@ XSDSimpleTypeYesNo, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, size@ XSDSimpleTypeSymbolSize, smufl@ XSDSimpleTypeSmuflAccidentalGlyphName

Possible parents:XMLNotations, XMLOrnaments

TYPE: alias of XSDComplexTypeAccidentalMark

XSD_TREE = XSDTree(tag=element, name=accidental-mark type=accidental-mark minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLAccidentalText(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The accidental-text type represents an element with an accidental value and text-formatting attributes.

simpleContent: The accidental-value type represents notated accidentals supported by MusicXML. In the MusicXML 2.0 DTD this was a string with values that could be included. The XSD strengthens the data typing to an enumerated list. The quarter- and three-quarters- accidentals are Tartini-style quarter-tone accidentals. The -down and -up accidentals are quarter-tone accidentals that include arrows pointing down or up. The slash- accidentals are used in Turkish classical music. The numbered sharp and flat accidentals are superscripted versions of the accidental signs, used in Turkish folk music. The sori and koron accidentals are microtonal sharp and flat accidentals used in Iranian and Persian music. The other accidental covers accidentals other than those listed here. It is usually used in combination with the smufl attribute to specify a particular SMuFL accidental. The smufl attribute may be used with any accidental value to help specify the appearance of symbols that share the same MusicXML semantics.

Permitted Values: 'sharp', 'natural', 'flat', 'double-sharp', 'sharp-sharp', 'flat-flat', 'natural-sharp', 'natural-flat', 'quarter-flat', 'quarter-sharp', 'three-quarters-flat', 'three-quarters-sharp', 'sharp-down', 'sharp-up', 'natural-down', 'natural-up', 'flat-down', 'flat-up', 'double-sharp-down', 'double-sharp-up', 'flat-flat-down', 'flat-flat-up', 'arrow-down', 'arrow-up', 'triple-sharp', 'triple-flat', 'slash-quarter-sharp', 'slash-sharp', 'slash-flat', 'double-slash-flat', 'sharp-1', 'sharp-2', 'sharp-3', 'sharp-5', 'flat-1', 'flat-2', 'flat-3', 'flat-4', 'sori', 'koron', 'other'

Possible parents:XMLGroupAbbreviationDisplay, XMLGroupNameDisplay, XMLNoteheadText, XMLPartAbbreviationDisplay, XMLPartNameDisplay

TYPE: alias of XSDComplexTypeAccidentalText

XSD_TREE = XSDTree(tag=element, name=accidental-text type=accidental-text)

class musicxml.xmlelement.xmlelement.XMLAccord(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The accord type represents the tuning of a single string in the scordatura element. It uses the same group of elements as the staff-tuning element. Strings are numbered from high to low.

Possible attributes: string@ XSDSimpleTypeStringNumber

Possible children: XMLTuningAlter, XMLTuningOctave, XMLTuningStep

XSD structure:
Group@name=tuning@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=tuning-step@minOccurs=1@maxOccurs=1
        Element@name=tuning-alter@minOccurs=0@maxOccurs=1
        Element@name=tuning-octave@minOccurs=1@maxOccurs=1

Possible parents:XMLScordatura

TYPE: alias of XSDComplexTypeAccord

XSD_TREE = XSDTree(tag=element, name=accord type=accord maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLAccordionHigh(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The accordion-high element indicates the presence of a dot in the high (4’) section of the registration symbol. This element is omitted if no dot is present.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLAccordionRegistration

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=accordion-high type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLAccordionLow(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The accordion-low element indicates the presence of a dot in the low (16’) section of the registration symbol. This element is omitted if no dot is present.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLAccordionRegistration

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=accordion-low type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLAccordionMiddle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The accordion-middle element indicates the presence of 1 to 3 dots in the middle (8’) section of the registration symbol. This element is omitted if no dots are present.

simpleType: The accordion-middle type may have values of 1, 2, or 3, corresponding to having 1 to 3 dots in the middle section of the accordion registration symbol. This type is not used if no dots are present.

Possible parents:XMLAccordionRegistration

TYPE: alias of XSDSimpleTypeAccordionMiddle

XSD_TREE = XSDTree(tag=element, name=accordion-middle type=accordion-middle minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLAccordionRegistration(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The accordion-registration type is used for accordion registration symbols. These are circular symbols divided horizontally into high, middle, and low sections that correspond to 4’, 8’, and 16’ pipes. Each accordion-high, accordion-middle, and accordion-low element represents the presence of one or more dots in the registration diagram. An accordion-registration element needs to have at least one of the child elements present.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible children: XMLAccordionHigh, XMLAccordionLow, XMLAccordionMiddle

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=accordion-high@minOccurs=0@maxOccurs=1
    Element@name=accordion-middle@minOccurs=0@maxOccurs=1
    Element@name=accordion-low@minOccurs=0@maxOccurs=1

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeAccordionRegistration

XSD_TREE = XSDTree(tag=element, name=accordion-registration type=accordion-registration)

class musicxml.xmlelement.xmlelement.XMLActualNotes(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The actual-notes element describes how many notes are played in the time usually occupied by the number in the normal-notes element.

Possible parents:XMLMetronomeTuplet, XMLTimeModification

TYPE: alias of XSDSimpleTypeNonNegativeInteger

XSD_TREE = XSDTree(tag=element, name=actual-notes type=xs:nonNegativeInteger)

class musicxml.xmlelement.xmlelement.XMLAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible parents:XMLPitch

TYPE: alias of XSDSimpleTypeSemitones

XSD_TREE = XSDTree(tag=element, name=alter type=semitones minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLAppearance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The appearance type controls general graphical settings for the music’s final form appearance on a printed page of display. This includes support for line widths, definitions for note sizes, and standard distances between notation elements, plus an extension element for other aspects of appearance.

Possible children: XMLDistance, XMLGlyph, XMLLineWidth, XMLNoteSize, XMLOtherAppearance

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=line-width@minOccurs=0@maxOccurs=unbounded
    Element@name=note-size@minOccurs=0@maxOccurs=unbounded
    Element@name=distance@minOccurs=0@maxOccurs=unbounded
    Element@name=glyph@minOccurs=0@maxOccurs=unbounded
    Element@name=other-appearance@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeAppearance

XSD_TREE = XSDTree(tag=element, name=appearance type=appearance minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLArpeggiate(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The arpeggiate type indicates that this note is part of an arpeggiated chord. The number attribute can be used to distinguish between two simultaneous chords arpeggiated separately (different numbers) or together (same number). The direction attribute is used if there is an arrow on the arpeggio sign. By default, arpeggios go from the lowest to highest note. The length of the sign can be determined from the position attributes for the arpeggiate elements used with the top and bottom notes of the arpeggiated chord. If the unbroken attribute is set to yes, it indicates that the arpeggio continues onto another staff within the part. This serves as a hint to applications and is not required for cross-staff arpeggios.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, direction@ XSDSimpleTypeUpDown, id@ XSDSimpleTypeID, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, unbroken@ XSDSimpleTypeYesNo

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeArpeggiate

XSD_TREE = XSDTree(tag=element, name=arpeggiate type=arpeggiate)

class musicxml.xmlelement.xmlelement.XMLArrow(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The arrow element represents an arrow used for a musical technical indication. It can represent both Unicode and SMuFL arrows. The presence of an arrowhead element indicates that only the arrowhead is displayed, not the arrow stem. The smufl attribute distinguishes different SMuFL glyphs that have an arrow appearance such as arrowBlackUp, guitarStrumUp, or handbellsSwingUp. The specified glyph should match the descriptive representation.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible children: XMLArrowDirection, XMLArrowStyle, XMLArrowhead, XMLCircularArrow

XSD structure:
Choice@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=arrow-direction@minOccurs=1@maxOccurs=1
        Element@name=arrow-style@minOccurs=0@maxOccurs=1
        Element@name=arrowhead@minOccurs=0@maxOccurs=1
    Element@name=circular-arrow@minOccurs=1@maxOccurs=1

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeArrow

XSD_TREE = XSDTree(tag=element, name=arrow type=arrow)

class musicxml.xmlelement.xmlelement.XMLArrowDirection(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The arrow-direction type represents the direction in which an arrow points, using Unicode arrow terminology.

Permitted Values: 'left', 'up', 'right', 'down', 'northwest', 'northeast', 'southeast', 'southwest', 'left right', 'up down', 'northwest southeast', 'northeast southwest', 'other'

Possible parents:XMLArrow

TYPE: alias of XSDSimpleTypeArrowDirection

XSD_TREE = XSDTree(tag=element, name=arrow-direction type=arrow-direction)

class musicxml.xmlelement.xmlelement.XMLArrowStyle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The arrow-style type represents the style of an arrow, using Unicode arrow terminology. Filled and hollow arrows indicate polygonal single arrows. Paired arrows are duplicate single arrows in the same direction. Combined arrows apply to double direction arrows like left right, indicating that an arrow in one direction should be combined with an arrow in the other direction.

Permitted Values: 'single', 'double', 'filled', 'hollow', 'paired', 'combined', 'other'

Possible parents:XMLArrow

TYPE: alias of XSDSimpleTypeArrowStyle

XSD_TREE = XSDTree(tag=element, name=arrow-style type=arrow-style minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLArrowhead(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLArrow

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=arrowhead type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLArticulations(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Articulations and accents are grouped together here.

Possible attributes: id@ XSDSimpleTypeID

Possible children: XMLAccent, XMLBreathMark, XMLCaesura, XMLDetachedLegato, XMLDoit, XMLFalloff, XMLOtherArticulation, XMLPlop, XMLScoop, XMLSoftAccent, XMLSpiccato, XMLStaccatissimo, XMLStaccato, XMLStress, XMLStrongAccent, XMLTenuto, XMLUnstress

XSD structure:

Choice@minOccurs=0@maxOccurs=unbounded
    Element@name=accent@minOccurs=1@maxOccurs=1
    Element@name=strong-accent@minOccurs=1@maxOccurs=1
    Element@name=staccato@minOccurs=1@maxOccurs=1
    Element@name=tenuto@minOccurs=1@maxOccurs=1
    Element@name=detached-legato@minOccurs=1@maxOccurs=1
    Element@name=staccatissimo@minOccurs=1@maxOccurs=1
    Element@name=spiccato@minOccurs=1@maxOccurs=1
    Element@name=scoop@minOccurs=1@maxOccurs=1
    Element@name=plop@minOccurs=1@maxOccurs=1
    Element@name=doit@minOccurs=1@maxOccurs=1
    Element@name=falloff@minOccurs=1@maxOccurs=1
    Element@name=breath-mark@minOccurs=1@maxOccurs=1
    Element@name=caesura@minOccurs=1@maxOccurs=1
    Element@name=stress@minOccurs=1@maxOccurs=1
    Element@name=unstress@minOccurs=1@maxOccurs=1
    Element@name=soft-accent@minOccurs=1@maxOccurs=1
    Element@name=other-articulation@minOccurs=1@maxOccurs=1

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeArticulations

XSD_TREE = XSDTree(tag=element, name=articulations type=articulations)

class musicxml.xmlelement.xmlelement.XMLArtificial(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The artificial element indicates that this is an artificial harmonic.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLHarmonic

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=artificial type=empty)

class musicxml.xmlelement.xmlelement.XMLAssess(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: By default, an assessment application should assess all notes without a cue child element, and not assess any note with a cue child element. The assess type allows this default assessment to be overridden for individual notes. The optional player and time-only attributes restrict the type to apply to a single player or set of times through a repeated section, respectively. If missing, the type applies to all players or all times through the repeated section, respectively. The player attribute references the id attribute of a player element defined within the matching score-part.

Possible attributes: player@ XSDSimpleTypeIDREF, time_only@ XSDSimpleTypeTimeOnly, type@ XSDSimpleTypeYesNo@required

Possible parents:XMLListen

TYPE: alias of XSDComplexTypeAssess

XSD_TREE = XSDTree(tag=element, name=assess type=assess)

class musicxml.xmlelement.xmlelement.XMLAttributes(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The attributes element contains musical information that typically changes on measure boundaries. This includes key and time signatures, clefs, transpositions, and staving. When attributes are changed mid-measure, it affects the music in score order, not in MusicXML document order.

Possible children: XMLClef, XMLDirective, XMLDivisions, XMLFootnote, XMLForPart, XMLInstruments, XMLKey, XMLLevel, XMLMeasureStyle, XMLPartSymbol, XMLStaffDetails, XMLStaves, XMLTime, XMLTranspose

XSD structure:

Sequence@minOccurs=1@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
    Element@name=divisions@minOccurs=0@maxOccurs=1
    Element@name=key@minOccurs=0@maxOccurs=unbounded
    Element@name=time@minOccurs=0@maxOccurs=unbounded
    Element@name=staves@minOccurs=0@maxOccurs=1
    Element@name=part-symbol@minOccurs=0@maxOccurs=1
    Element@name=instruments@minOccurs=0@maxOccurs=1
    Element@name=clef@minOccurs=0@maxOccurs=unbounded
    Element@name=staff-details@minOccurs=0@maxOccurs=unbounded
    Choice@minOccurs=1@maxOccurs=1
        Element@name=transpose@minOccurs=0@maxOccurs=unbounded
        Element@name=for-part@minOccurs=0@maxOccurs=unbounded
    Element@name=directive@minOccurs=0@maxOccurs=unbounded
    Element@name=measure-style@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeAttributes

XSD_TREE = XSDTree(tag=element, name=attributes type=attributes)

class musicxml.xmlelement.xmlelement.XMLBackup(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The backup and forward elements are required to coordinate multiple voices in one part, including music on multiple staves. The backup type is generally used to move between voices and staves. Thus the backup element does not include voice or staff elements. Duration values should always be positive, and should not cross measure boundaries or mid-measure changes in the divisions value.

Possible children: XMLDuration, XMLFootnote, XMLLevel

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Group@name=duration@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=duration@minOccurs=1@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeBackup

XSD_TREE = XSDTree(tag=element, name=backup type=backup)

class musicxml.xmlelement.xmlelement.XMLBarStyle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The bar-style-color type contains barline style and color information.

simpleContent: The bar-style type represents barline style information. Choices are regular, dotted, dashed, heavy, light-light, light-heavy, heavy-light, heavy-heavy, tick (a short stroke through the top line), short (a partial barline between the 2nd and 4th lines), and none.

Permitted Values: 'regular', 'dotted', 'dashed', 'heavy', 'light-light', 'light-heavy', 'heavy-light', 'heavy-heavy', 'tick', 'short', 'none'

Possible attributes: color@ XSDSimpleTypeColor

Possible parents:XMLBarline

TYPE: alias of XSDComplexTypeBarStyleColor

XSD_TREE = XSDTree(tag=element, name=bar-style type=bar-style-color minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLBarline(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: If a barline is other than a normal single barline, it should be represented by a barline type that describes it. This includes information about repeats and multiple endings, as well as line style. Barline data is on the same level as the other musical data in a score - a child of a measure in a partwise score, or a part in a timewise score. This allows for barlines within measures, as in dotted barlines that subdivide measures in complex meters. The two fermata elements allow for fermatas on both sides of the barline (the lower one inverted).

Barlines have a location attribute to make it easier to process barlines independently of the other musical data in a score. It is often easier to set up measures separately from entering notes. The location attribute must match where the barline element occurs within the rest of the musical data in the score. If location is left, it should be the first element in the measure, aside from the print, bookmark, and link elements. If location is right, it should be the last element, again with the possible exception of the print, bookmark, and link elements. If no location is specified, the right barline is the default. The segno, coda, and divisions attributes work the same way as in the sound element. They are used for playback when barline elements contain segno or coda child elements.

Possible attributes: coda@ XSDSimpleTypeToken, divisions@ XSDSimpleTypeDivisions, id@ XSDSimpleTypeID, location@ XSDSimpleTypeRightLeftMiddle, segno@ XSDSimpleTypeToken

Possible children: XMLBarStyle, XMLCoda, XMLEnding, XMLFermata, XMLFootnote, XMLLevel, XMLRepeat, XMLSegno, XMLWavyLine

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=bar-style@minOccurs=0@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
    Element@name=wavy-line@minOccurs=0@maxOccurs=1
    Element@name=segno@minOccurs=0@maxOccurs=1
    Element@name=coda@minOccurs=0@maxOccurs=1
    Element@name=fermata@minOccurs=0@maxOccurs=2
    Element@name=ending@minOccurs=0@maxOccurs=1
    Element@name=repeat@minOccurs=0@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeBarline

XSD_TREE = XSDTree(tag=element, name=barline type=barline)

class musicxml.xmlelement.xmlelement.XMLBarre(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The barre element indicates placing a finger over multiple strings on a single fret. The type is “start” for the lowest pitched string (e.g., the string with the highest MusicXML number) and is “stop” for the highest pitched string.

Possible attributes: color@ XSDSimpleTypeColor, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLFrameNote

TYPE: alias of XSDComplexTypeBarre

XSD_TREE = XSDTree(tag=element, name=barre type=barre minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLBasePitch(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The base pitch is the pitch at which the string is played before touching to create the harmonic.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLHarmonic

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=base-pitch type=empty)

class musicxml.xmlelement.xmlelement.XMLBass(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The bass type is used to indicate a bass note in popular music chord symbols, e.g. G/C. It is generally not used in functional harmony, as inversion is generally not used in pop chord symbols. As with root, it is divided into step and alter elements, similar to pitches. The arrangement attribute specifies where the bass is displayed relative to what precedes it.

Possible attributes: arrangement@ XSDSimpleTypeHarmonyArrangement

Possible children: XMLBassAlter, XMLBassSeparator, XMLBassStep

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=bass-separator@minOccurs=0@maxOccurs=1
    Element@name=bass-step@minOccurs=1@maxOccurs=1
    Element@name=bass-alter@minOccurs=0@maxOccurs=1

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeBass

XSD_TREE = XSDTree(tag=element, name=bass type=bass minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLBassAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The bass-alter element represents the chromatic alteration of the bass of the current chord within the harmony element. In some chord styles, the text for the bass-step element may include bass-alter information. In that case, the print-object attribute of the bass-alter element can be set to no. The location attribute indicates whether the alteration should appear to the left or the right of the bass-step; it is right if not specified.

complexType: The harmony-alter type represents the chromatic alteration of the root, numeral, or bass of the current harmony-chord group within the harmony element. In some chord styles, the text of the preceding element may include alteration information. In that case, the print-object attribute of this type can be set to no. The location attribute indicates whether the alteration should appear to the left or the right of the preceding element. Its default value varies by element.

simpleContent: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, location@ XSDSimpleTypeLeftRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLBass

TYPE: alias of XSDComplexTypeHarmonyAlter

XSD_TREE = XSDTree(tag=element, name=bass-alter type=harmony-alter minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLBassSeparator(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The optional bass-separator element indicates that text, rather than a line or slash, separates the bass from what precedes it.

complexType: The style-text type represents a text element with a print-style attribute group.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLBass

TYPE: alias of XSDComplexTypeStyleText

XSD_TREE = XSDTree(tag=element, name=bass-separator type=style-text minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLBassStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The bass-step type represents the pitch step of the bass of the current chord within the harmony element. The text attribute indicates how the bass should appear in a score if not using the element contents.

simpleContent: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, text@ XSDSimpleTypeToken

Possible parents:XMLBass

TYPE: alias of XSDComplexTypeBassStep

XSD_TREE = XSDTree(tag=element, name=bass-step type=bass-step)

class musicxml.xmlelement.xmlelement.XMLBeam(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Beam values include begin, continue, end, forward hook, and backward hook. Up to eight concurrent beams are available to cover up to 1024th notes. Each beam in a note is represented with a separate beam element, starting with the eighth note beam using a number attribute of 1.

Note that the beam number does not distinguish sets of beams that overlap, as it does for slur and other elements. Beaming groups are distinguished by being in different voices and/or the presence or absence of grace and cue elements.

Beams that have a begin value can also have a fan attribute to indicate accelerandos and ritardandos using fanned beams. The fan attribute may also be used with a continue value if the fanning direction changes on that note. The value is “none” if not specified.

The repeater attribute has been deprecated in MusicXML 3.0. Formerly used for tremolos, it needs to be specified with a “yes” value for each beam using it.

simpleContent: The beam-value type represents the type of beam associated with each of 8 beam levels (up to 1024th notes) available for each note.

Permitted Values: 'begin', 'continue', 'end', 'forward hook', 'backward hook'

Possible attributes: color@ XSDSimpleTypeColor, fan@ XSDSimpleTypeFan, id@ XSDSimpleTypeID, number@ XSDSimpleTypeBeamLevel, repeater@ XSDSimpleTypeYesNo

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeBeam

XSD_TREE = XSDTree(tag=element, name=beam type=beam minOccurs=0 maxOccurs=8)

class musicxml.xmlelement.xmlelement.XMLBeatRepeat(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The beat-repeat type is used to indicate that a single beat (but possibly many notes) is repeated. The slashes attribute specifies the number of slashes to use in the symbol. The use-dots attribute indicates whether or not to use dots as well (for instance, with mixed rhythm patterns). The value for slashes is 1 and the value for use-dots is no if not specified.

The stop type indicates the first beat where the repeats are no longer displayed. Both the start and stop of the beat being repeated should be specified unless the repeats are displayed through the end of the part.

The beat-repeat element specifies a notation style for repetitions. The actual music being repeated needs to be repeated within the MusicXML file. This element specifies the notation that indicates the repeat.

Possible attributes: slashes@ XSDSimpleTypePositiveInteger, type@ XSDSimpleTypeStartStop@required, use_dots@ XSDSimpleTypeYesNo

Possible children: XMLExceptVoice, XMLSlashDot, XMLSlashType

XSD structure:
Group@name=slash@minOccurs=0@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=0@maxOccurs=1
            Element@name=slash-type@minOccurs=1@maxOccurs=1
            Element@name=slash-dot@minOccurs=0@maxOccurs=unbounded
        Element@name=except-voice@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLMeasureStyle

TYPE: alias of XSDComplexTypeBeatRepeat

XSD_TREE = XSDTree(tag=element, name=beat-repeat type=beat-repeat)

class musicxml.xmlelement.xmlelement.XMLBeatType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The beat-type element indicates the beat unit, as found in the denominator of a time signature.

Possible parents:XMLInterchangeable, XMLTime

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=beat-type type=xs:string)

class musicxml.xmlelement.xmlelement.XMLBeatUnit(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The beat-unit element indicates the graphical note type to use in a metronome mark.

simpleType: The note-type-value type is used for the MusicXML type element and represents the graphic note type, from 1024th (shortest) to maxima (longest).

Permitted Values: '1024th', '512th', '256th', '128th', '64th', '32nd', '16th', 'eighth', 'quarter', 'half', 'whole', 'breve', 'long', 'maxima'

Possible parents:XMLBeatUnitTied, XMLMetronome

TYPE: alias of XSDSimpleTypeNoteTypeValue

XSD_TREE = XSDTree(tag=element, name=beat-unit type=note-type-value)

class musicxml.xmlelement.xmlelement.XMLBeatUnitDot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The beat-unit-dot element is used to specify any augmentation dots for a metronome mark note.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLBeatUnitTied, XMLMetronome

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=beat-unit-dot type=empty minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLBeatUnitTied(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The beat-unit-tied type indicates a beat-unit within a metronome mark that is tied to the preceding beat-unit. This allows two or more tied notes to be associated with a per-minute value in a metronome mark, whereas the metronome-tied element is restricted to metric relationship marks.

Possible children: XMLBeatUnitDot, XMLBeatUnit

XSD structure:
Group@name=beat-unit@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=beat-unit@minOccurs=1@maxOccurs=1
        Element@name=beat-unit-dot@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLMetronome

TYPE: alias of XSDComplexTypeBeatUnitTied

XSD_TREE = XSDTree(tag=element, name=beat-unit-tied type=beat-unit-tied minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLBeater(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The beater type represents pictograms for beaters, mallets, and sticks that do not have different materials represented in the pictogram.

simpleContent: The beater-value type represents pictograms for beaters, mallets, and sticks that do not have different materials represented in the pictogram. The finger and hammer values are in addition to Stone’s list.

Permitted Values: 'bow', 'chime hammer', 'coin', 'drum stick', 'finger', 'fingernail', 'fist', 'guiro scraper', 'hammer', 'hand', 'jazz stick', 'knitting needle', 'metal hammer', 'slide brush on gong', 'snare stick', 'spoon mallet', 'superball', 'triangle beater', 'triangle beater plain', 'wire brush'

Possible attributes: tip@ XSDSimpleTypeTipDirection

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeBeater

XSD_TREE = XSDTree(tag=element, name=beater type=beater)

class musicxml.xmlelement.xmlelement.XMLBeats(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The beats element indicates the number of beats, as found in the numerator of a time signature.

Possible parents:XMLInterchangeable, XMLTime

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=beats type=xs:string)

class musicxml.xmlelement.xmlelement.XMLBend(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The bend type is used in guitar notation and tablature. A single note with a bend and release will contain two bend elements: the first to represent the bend and the second to represent the release. The shape attribute distinguishes between the angled bend symbols commonly used in standard notation and the curved bend symbols commonly used in both tablature and standard notation.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, first_beat@ XSDSimpleTypePercent, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, shape@ XSDSimpleTypeBendShape

Possible children: XMLBendAlter, XMLPreBend, XMLRelease, XMLWithBar

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=bend-alter@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=1
        Element@name=pre-bend@minOccurs=1@maxOccurs=1
        Element@name=release@minOccurs=1@maxOccurs=1
    Element@name=with-bar@minOccurs=0@maxOccurs=1

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeBend

XSD_TREE = XSDTree(tag=element, name=bend type=bend)

class musicxml.xmlelement.xmlelement.XMLBendAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The bend-alter element indicates the number of semitones in the bend, similar to the alter element. As with the alter element, numbers like 0.5 can be used to indicate microtones. Negative values indicate pre-bends or releases. The pre-bend and release elements are used to distinguish what is intended. Because the bend-alter element represents the number of steps in the bend, a release after a bend has a negative bend-alter value, not a zero value.

simpleType: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible parents:XMLBend

TYPE: alias of XSDSimpleTypeSemitones

XSD_TREE = XSDTree(tag=element, name=bend-alter type=semitones)

class musicxml.xmlelement.xmlelement.XMLBookmark(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The bookmark type serves as a well-defined target for an incoming simple XLink.

Possible attributes: element@ XSDSimpleTypeNMTOKEN, id@ XSDSimpleTypeID@required, name@ XSDSimpleTypeToken, position@ XSDSimpleTypePositiveInteger

Possible parents:XMLCredit, XMLMeasure

TYPE: alias of XSDComplexTypeBookmark

XSD_TREE = XSDTree(tag=element, name=bookmark type=bookmark)

class musicxml.xmlelement.xmlelement.XMLBottomMargin(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLPageMargins

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=bottom-margin type=tenths)

class musicxml.xmlelement.xmlelement.XMLBracket(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Brackets are combined with words in a variety of modern directions. The line-end attribute specifies if there is a jog up or down (or both), an arrow, or nothing at the start or end of the bracket. If the line-end is up or down, the length of the jog can be specified using the end-length attribute. The line-type is solid if not specified.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, end_length@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, line_end@ XSDSimpleTypeLineEnd@required, line_type@ XSDSimpleTypeLineType, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStopContinue@required

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeBracket

XSD_TREE = XSDTree(tag=element, name=bracket type=bracket)

class musicxml.xmlelement.xmlelement.XMLBrassBend(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The brass-bend element represents the u-shaped bend symbol used in brass notation, distinct from the bend element used in guitar music.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=brass-bend type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLBreathMark(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The breath-mark element indicates a place to take a breath.

simpleContent: The breath-mark-value type represents the symbol used for a breath mark.

Permitted Values: '', 'comma', 'tick', 'upbow', 'salzedo'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeBreathMark

XSD_TREE = XSDTree(tag=element, name=breath-mark type=breath-mark)

class musicxml.xmlelement.xmlelement.XMLCaesura(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The caesura element indicates a slight pause. It is notated using a “railroad tracks” symbol or other variations specified in the element content.

simpleContent: The caesura-value type represents the shape of the caesura sign.

Permitted Values: 'normal', 'thick', 'short', 'curved', 'single', ''

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeCaesura

XSD_TREE = XSDTree(tag=element, name=caesura type=caesura)

class musicxml.xmlelement.xmlelement.XMLCancel(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: A cancel element indicates that the old key signature should be cancelled before the new one appears. This will always happen when changing to C major or A minor and need not be specified then. The cancel value matches the fifths value of the cancelled key signature (e.g., a cancel of -2 will provide an explicit cancellation for changing from B flat major to F major). The optional location attribute indicates where the cancellation appears relative to the new key signature.

simpleContent: The fifths type represents the number of flats or sharps in a traditional key signature. Negative numbers are used for flats and positive numbers for sharps, reflecting the key’s placement within the circle of fifths (hence the type name).

Possible attributes: location@ XSDSimpleTypeCancelLocation

Possible parents:XMLKey

TYPE: alias of XSDComplexTypeCancel

XSD_TREE = XSDTree(tag=element, name=cancel type=cancel minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLCapo(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The capo element indicates at which fret a capo should be placed on a fretted instrument. This changes the open tuning of the strings specified by staff-tuning by the specified number of half-steps.

Possible parents:XMLStaffDetails

TYPE: alias of XSDSimpleTypeNonNegativeInteger

XSD_TREE = XSDTree(tag=element, name=capo type=xs:nonNegativeInteger minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLChord(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The chord element indicates that this note is an additional chord tone with the preceding note.

The duration of a chord note does not move the musical position within a measure. That is done by the duration of the first preceding note without a chord element. Thus the duration of a chord note cannot be longer than the preceding note.

In most cases the duration will be the same as the preceding note. However it can be shorter in situations such as multiple stops for string instruments.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=chord type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLChromatic(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The chromatic element represents the number of semitones needed to get from written to sounding pitch. This value does not include octave-change values; the values for both elements need to be added to the written pitch to get the correct sounding pitch.

simpleType: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible parents:XMLPartTranspose, XMLTranspose

TYPE: alias of XSDSimpleTypeSemitones

XSD_TREE = XSDTree(tag=element, name=chromatic type=semitones)

class musicxml.xmlelement.xmlelement.XMLCircularArrow(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The circular-arrow type represents the direction in which a circular arrow points, using Unicode arrow terminology.

Permitted Values: 'clockwise', 'anticlockwise'

Possible parents:XMLArrow

TYPE: alias of XSDSimpleTypeCircularArrow

XSD_TREE = XSDTree(tag=element, name=circular-arrow type=circular-arrow)

class musicxml.xmlelement.xmlelement.XMLClef(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Clefs are represented by a combination of sign, line, and clef-octave-change elements.

complexType: Clefs are represented by a combination of sign, line, and clef-octave-change elements. The optional number attribute refers to staff numbers within the part. A value of 1 is assumed if not present.

Sometimes clefs are added to the staff in non-standard line positions, either to indicate cue passages, or when there are multiple clefs present simultaneously on one staff. In this situation, the additional attribute is set to “yes” and the line value is ignored. The size attribute is used for clefs where the additional attribute is “yes”. It is typically used to indicate cue clefs.

Sometimes clefs at the start of a measure need to appear after the barline rather than before, as for cues or for use after a repeated section. The after-barline attribute is set to “yes” in this situation. The attribute is ignored for mid-measure clefs.

Clefs appear at the start of each system unless the print-object attribute has been set to “no” or the additional attribute has been set to “yes”.

Possible attributes: additional@ XSDSimpleTypeYesNo, after_barline@ XSDSimpleTypeYesNo, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, number@ XSDSimpleTypeStaffNumber, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, size@ XSDSimpleTypeSymbolSize

Possible children: XMLClefOctaveChange, XMLLine, XMLSign

XSD structure:
Group@name=clef@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=sign@minOccurs=1@maxOccurs=1
        Element@name=line@minOccurs=0@maxOccurs=1
        Element@name=clef-octave-change@minOccurs=0@maxOccurs=1

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeClef

XSD_TREE = XSDTree(tag=element, name=clef type=clef minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLClefOctaveChange(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The clef-octave-change element is used for transposing clefs. A treble clef for tenors would have a value of -1.

Possible parents:XMLClef, XMLPartClef

TYPE: alias of XSDSimpleTypeInteger

XSD_TREE = XSDTree(tag=element, name=clef-octave-change type=xs:integer minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLCoda(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The coda type is the visual indicator of a coda sign. The exact glyph can be specified with the smufl attribute. A sound element is also needed to guide playback applications reliably.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflCodaGlyphName, valign@ XSDSimpleTypeValign

Possible parents:XMLBarline, XMLDirectionType

TYPE: alias of XSDComplexTypeCoda

XSD_TREE = XSDTree(tag=element, name=coda type=coda maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLConcertScore(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The presence of a concert-score element indicates that a score is displayed in concert pitch. It is used for scores that contain parts for transposing instruments.

A document with a concert-score element may not contain any transpose elements that have non-zero values for either the diatonic or chromatic elements. Concert scores may include octave transpositions, so transpose elements with a double element or a non-zero octave-change element value are permitted.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=concert-score type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLCreator(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The creator element is borrowed from Dublin Core. It is used for the creators of the score. The type attribute is used to distinguish different creative contributions. Thus, there can be multiple creators within an identification. Standard type values are composer, lyricist, and arranger. Other type values may be used for different types of creative roles. The type attribute should usually be used even if there is just a single creator element. The MusicXML format does not use the creator / contributor distinction from Dublin Core.

complexType: The typed-text type represents a text element with a type attribute.

Possible attributes: type@ XSDSimpleTypeToken

Possible parents:XMLIdentification

TYPE: alias of XSDComplexTypeTypedText

XSD_TREE = XSDTree(tag=element, name=creator type=typed-text minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLCredit(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The credit type represents the appearance of the title, composer, arranger, lyricist, copyright, dedication, and other text, symbols, and graphics that commonly appear on the first page of a score. The credit-words, credit-symbol, and credit-image elements are similar to the words, symbol, and image elements for directions. However, since the credit is not part of a measure, the default-x and default-y attributes adjust the origin relative to the bottom left-hand corner of the page. The enclosure for credit-words and credit-symbol is none by default.

By default, a series of credit-words and credit-symbol elements within a single credit element follow one another in sequence visually. Non-positional formatting attributes are carried over from the previous element by default.

The page attribute for the credit element specifies the page number where the credit should appear. This is an integer value that starts with 1 for the first page. Its value is 1 by default. Since credits occur before the music, these page numbers do not refer to the page numbering specified by the print element’s page-number attribute.

The credit-type element indicates the purpose behind a credit. Multiple types of data may be combined in a single credit, so multiple elements may be used. Standard values include page number, title, subtitle, composer, arranger, lyricist, rights, and part name.

Possible attributes: id@ XSDSimpleTypeID, page@ XSDSimpleTypePositiveInteger

Possible children: XMLBookmark, XMLCreditImage, XMLCreditSymbol, XMLCreditType, XMLCreditWords, XMLLink

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=credit-type@minOccurs=0@maxOccurs=unbounded
    Element@name=link@minOccurs=0@maxOccurs=unbounded
    Element@name=bookmark@minOccurs=0@maxOccurs=unbounded
    Choice@minOccurs=1@maxOccurs=1
        Element@name=credit-image@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Choice@minOccurs=1@maxOccurs=1
                Element@name=credit-words@minOccurs=1@maxOccurs=1
                Element@name=credit-symbol@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=0@maxOccurs=unbounded
                Element@name=link@minOccurs=0@maxOccurs=unbounded
                Element@name=bookmark@minOccurs=0@maxOccurs=unbounded
                Choice@minOccurs=1@maxOccurs=1
                    Element@name=credit-words@minOccurs=1@maxOccurs=1
                    Element@name=credit-symbol@minOccurs=1@maxOccurs=1

Possible parents:XMLScorePartwise

TYPE: alias of XSDComplexTypeCredit

XSD_TREE = XSDTree(tag=element, name=credit type=credit minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLCreditImage(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The image type is used to include graphical images in a score.

Possible parents:XMLCredit

TYPE: alias of XSDComplexTypeImage

XSD_TREE = XSDTree(tag=element, name=credit-image type=image)

class musicxml.xmlelement.xmlelement.XMLCreditSymbol(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The formatted-symbol-id type represents a SMuFL musical symbol element with formatting and id attributes.

simpleContent: The smufl-glyph-name type is used for attributes that reference a specific Standard Music Font Layout (SMuFL) character. The value is a SMuFL canonical glyph name, not a code point. For instance, the value for a standard piano pedal mark would be keyboardPedalPed, not U+E650.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, dir@ XSDSimpleTypeTextDirection, enclosure@ XSDSimpleTypeEnclosureShape, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, justify@ XSDSimpleTypeLeftCenterRight, letter_spacing@ XSDSimpleTypeNumberOrNormal, line_height@ XSDSimpleTypeNumberOrNormal, line_through@ XSDSimpleTypeNumberOfLines, overline@ XSDSimpleTypeNumberOfLines, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, rotation@ XSDSimpleTypeRotationDegrees, underline@ XSDSimpleTypeNumberOfLines, valign@ XSDSimpleTypeValign

Possible parents:XMLCredit

TYPE: alias of XSDComplexTypeFormattedSymbolId

XSD_TREE = XSDTree(tag=element, name=credit-symbol type=formatted-symbol-id)

class musicxml.xmlelement.xmlelement.XMLCreditType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLCredit

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=credit-type type=xs:string minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLCreditWords(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The formatted-text-id type represents a text element with text-formatting and id attributes.

Possible parents:XMLCredit

TYPE: alias of XSDComplexTypeFormattedTextId

XSD_TREE = XSDTree(tag=element, name=credit-words type=formatted-text-id)

class musicxml.xmlelement.xmlelement.XMLCue(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The cue element indicates the presence of a cue note. In MusicXML, a cue note is a silent note with no playback. Normal notes that play can be specified as cue size using the type element. A cue note that is specified as full size using the type element will still remain silent.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=cue type=empty)

class musicxml.xmlelement.xmlelement.XMLDamp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The damp element specifies a harp damping mark.

complexType: The empty-print-style-align-id type represents an empty element with print-style-align and optional-unique-id attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeEmptyPrintStyleAlignId

XSD_TREE = XSDTree(tag=element, name=damp type=empty-print-style-align-id)

class musicxml.xmlelement.xmlelement.XMLDampAll(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The damp-all element specifies a harp damping mark for all strings.

complexType: The empty-print-style-align-id type represents an empty element with print-style-align and optional-unique-id attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeEmptyPrintStyleAlignId

XSD_TREE = XSDTree(tag=element, name=damp-all type=empty-print-style-align-id)

class musicxml.xmlelement.xmlelement.XMLDashes(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The dashes type represents dashes, used for instance with cresc. and dim. marks.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStopContinue@required

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeDashes

XSD_TREE = XSDTree(tag=element, name=dashes type=dashes)

class musicxml.xmlelement.xmlelement.XMLDefaults(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The defaults type specifies score-wide defaults for scaling; whether or not the file is a concert score; layout; and default values for the music font, word font, lyric font, and lyric language. Except for the concert-score element, if any defaults are missing, the choice of what to use is determined by the application.

Possible children: XMLAppearance, XMLConcertScore, XMLLyricFont, XMLLyricLanguage, XMLMusicFont, XMLPageLayout, XMLScaling, XMLStaffLayout, XMLSystemLayout, XMLWordFont

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=scaling@minOccurs=0@maxOccurs=1
    Element@name=concert-score@minOccurs=0@maxOccurs=1
    Group@name=layout@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=page-layout@minOccurs=0@maxOccurs=1
            Element@name=system-layout@minOccurs=0@maxOccurs=1
            Element@name=staff-layout@minOccurs=0@maxOccurs=unbounded
    Element@name=appearance@minOccurs=0@maxOccurs=1
    Element@name=music-font@minOccurs=0@maxOccurs=1
    Element@name=word-font@minOccurs=0@maxOccurs=1
    Element@name=lyric-font@minOccurs=0@maxOccurs=unbounded
    Element@name=lyric-language@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLScorePartwise

TYPE: alias of XSDComplexTypeDefaults

XSD_TREE = XSDTree(tag=element, name=defaults type=defaults minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLDegree(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The degree type is used to add, alter, or subtract individual notes in the chord. The print-object attribute can be used to keep the degree from printing separately when it has already taken into account in the text attribute of the kind element. The degree-value and degree-type text attributes specify how the value and type of the degree should be displayed.

A harmony of kind “other” can be spelled explicitly by using a series of degree elements together with a root.

Possible attributes: print_object@ XSDSimpleTypeYesNo

Possible children: XMLDegreeAlter, XMLDegreeType, XMLDegreeValue

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=degree-value@minOccurs=1@maxOccurs=1
    Element@name=degree-alter@minOccurs=1@maxOccurs=1
    Element@name=degree-type@minOccurs=1@maxOccurs=1

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeDegree

XSD_TREE = XSDTree(tag=element, name=degree type=degree minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLDegreeAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The degree-alter type represents the chromatic alteration for the current degree. If the degree-type value is alter or subtract, the degree-alter value is relative to the degree already in the chord based on its kind element. If the degree-type value is add, the degree-alter is relative to a dominant chord (major and perfect intervals except for a minor seventh). The plus-minus attribute is used to indicate if plus and minus symbols should be used instead of sharp and flat symbols to display the degree alteration. It is no if not specified.

simpleContent: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, plus_minus@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLDegree

TYPE: alias of XSDComplexTypeDegreeAlter

XSD_TREE = XSDTree(tag=element, name=degree-alter type=degree-alter)

class musicxml.xmlelement.xmlelement.XMLDegreeType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The degree-type type indicates if this degree is an addition, alteration, or subtraction relative to the kind of the current chord. The value of the degree-type element affects the interpretation of the value of the degree-alter element. The text attribute specifies how the type of the degree should be displayed.

simpleContent: The degree-type-value type indicates whether the current degree element is an addition, alteration, or subtraction to the kind of the current chord in the harmony element.

Permitted Values: 'add', 'alter', 'subtract'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, text@ XSDSimpleTypeToken

Possible parents:XMLDegree

TYPE: alias of XSDComplexTypeDegreeType

XSD_TREE = XSDTree(tag=element, name=degree-type type=degree-type)

class musicxml.xmlelement.xmlelement.XMLDegreeValue(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The content of the degree-value type is a number indicating the degree of the chord (1 for the root, 3 for third, etc). The text attribute specifies how the value of the degree should be displayed. The symbol attribute indicates that a symbol should be used in specifying the degree. If the symbol attribute is present, the value of the text attribute follows the symbol.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, symbol@ XSDSimpleTypeDegreeSymbolValue, text@ XSDSimpleTypeToken

Possible parents:XMLDegree

TYPE: alias of XSDComplexTypeDegreeValue

XSD_TREE = XSDTree(tag=element, name=degree-value type=degree-value)

class musicxml.xmlelement.xmlelement.XMLDelayedInvertedTurn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The delayed-inverted-turn element indicates an inverted turn that is delayed until the end of the current note.

complexType: The horizontal-turn type represents turn elements that are horizontal rather than vertical. These are empty elements with print-style, placement, trill-sound, and slash attributes. If the slash attribute is yes, then a vertical line is used to slash the turn. It is no if not specified.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, slash@ XSDSimpleTypeYesNo, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeHorizontalTurn

XSD_TREE = XSDTree(tag=element, name=delayed-inverted-turn type=horizontal-turn)

class musicxml.xmlelement.xmlelement.XMLDelayedTurn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The delayed-turn element indicates a normal turn that is delayed until the end of the current note.

complexType: The horizontal-turn type represents turn elements that are horizontal rather than vertical. These are empty elements with print-style, placement, trill-sound, and slash attributes. If the slash attribute is yes, then a vertical line is used to slash the turn. It is no if not specified.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, slash@ XSDSimpleTypeYesNo, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeHorizontalTurn

XSD_TREE = XSDTree(tag=element, name=delayed-turn type=horizontal-turn)

class musicxml.xmlelement.xmlelement.XMLDetachedLegato(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The detached-legato element indicates the combination of a tenuto line and staccato dot symbol.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=detached-legato type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLDiatonic(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The diatonic element specifies the number of pitch steps needed to go from written to sounding pitch. This allows for correct spelling of enharmonic transpositions. This value does not include octave-change values; the values for both elements need to be added to the written pitch to get the correct sounding pitch.

Possible parents:XMLPartTranspose, XMLTranspose

TYPE: alias of XSDSimpleTypeInteger

XSD_TREE = XSDTree(tag=element, name=diatonic type=xs:integer minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLDirection(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: A direction is a musical indication that is not necessarily attached to a specific note. Two or more may be combined to indicate words followed by the start of a dashed line, the end of a wedge followed by dynamics, etc. For applications where a specific direction is indeed attached to a specific note, the direction element can be associated with the first note element that follows it in score order that is not in a different voice.

By default, a series of direction-type elements and a series of child elements of a direction-type within a single direction element follow one another in sequence visually. For a series of direction-type children, non-positional formatting attributes are carried over from the previous element by default.

Possible attributes: directive@ XSDSimpleTypeYesNo, id@ XSDSimpleTypeID, placement@ XSDSimpleTypeAboveBelow, system@ XSDSimpleTypeSystemRelation

Possible children: XMLDirectionType, XMLFootnote, XMLLevel, XMLListening, XMLOffset, XMLSound, XMLStaff, XMLVoice

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=direction-type@minOccurs=1@maxOccurs=unbounded
    Element@name=offset@minOccurs=0@maxOccurs=1
    Group@name=editorial-voice-direction@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
            Group@name=voice@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=voice@minOccurs=1@maxOccurs=1
    Group@name=staff@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=staff@minOccurs=1@maxOccurs=1
    Element@name=sound@minOccurs=0@maxOccurs=1
    Element@name=listening@minOccurs=0@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeDirection

XSD_TREE = XSDTree(tag=element, name=direction type=direction)

class musicxml.xmlelement.xmlelement.XMLDirectionType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Textual direction types may have more than 1 component due to multiple fonts. The dynamics element may also be used in the notations element. Attribute groups related to print suggestions apply to the individual direction-type, not to the overall direction.

Possible attributes: id@ XSDSimpleTypeID

Possible children: XMLAccordionRegistration, XMLBracket, XMLCoda, XMLDampAll, XMLDamp, XMLDashes, XMLDynamics, XMLEyeglasses, XMLHarpPedals, XMLImage, XMLMetronome, XMLOctaveShift, XMLOtherDirection, XMLPedal, XMLPercussion, XMLPrincipalVoice, XMLRehearsal, XMLScordatura, XMLSegno, XMLStaffDivide, XMLStringMute, XMLSymbol, XMLWedge, XMLWords

XSD structure:

Choice@minOccurs=1@maxOccurs=1
    Element@name=rehearsal@minOccurs=1@maxOccurs=unbounded
    Element@name=segno@minOccurs=1@maxOccurs=unbounded
    Element@name=coda@minOccurs=1@maxOccurs=unbounded
    Choice@minOccurs=1@maxOccurs=unbounded
        Element@name=words@minOccurs=1@maxOccurs=1
        Element@name=symbol@minOccurs=1@maxOccurs=1
    Element@name=wedge@minOccurs=1@maxOccurs=1
    Element@name=dynamics@minOccurs=1@maxOccurs=unbounded
    Element@name=dashes@minOccurs=1@maxOccurs=1
    Element@name=bracket@minOccurs=1@maxOccurs=1
    Element@name=pedal@minOccurs=1@maxOccurs=1
    Element@name=metronome@minOccurs=1@maxOccurs=1
    Element@name=octave-shift@minOccurs=1@maxOccurs=1
    Element@name=harp-pedals@minOccurs=1@maxOccurs=1
    Element@name=damp@minOccurs=1@maxOccurs=1
    Element@name=damp-all@minOccurs=1@maxOccurs=1
    Element@name=eyeglasses@minOccurs=1@maxOccurs=1
    Element@name=string-mute@minOccurs=1@maxOccurs=1
    Element@name=scordatura@minOccurs=1@maxOccurs=1
    Element@name=image@minOccurs=1@maxOccurs=1
    Element@name=principal-voice@minOccurs=1@maxOccurs=1
    Element@name=percussion@minOccurs=1@maxOccurs=unbounded
    Element@name=accordion-registration@minOccurs=1@maxOccurs=1
    Element@name=staff-divide@minOccurs=1@maxOccurs=1
    Element@name=other-direction@minOccurs=1@maxOccurs=1

Possible parents:XMLDirection

TYPE: alias of XSDComplexTypeDirectionType

XSD_TREE = XSDTree(tag=element, name=direction-type type=direction-type maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLDirective(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Directives are like directions, but can be grouped together with attributes for convenience. This is typically used for tempo markings at the beginning of a piece of music. This element was deprecated in Version 2.0 in favor of the direction element’s directive attribute. Language names come from ISO 639, with optional country subcodes from ISO 3166.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, lang@ XSDSimpleTypeLanguage, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeDirective

XSD_TREE = XSDTree(tag=element, name=directive minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLDisplayOctave(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: Octaves are represented by the numbers 0 to 9, where 4 indicates the octave started by middle C.

Possible parents:XMLRest, XMLUnpitched

TYPE: alias of XSDSimpleTypeOctave

XSD_TREE = XSDTree(tag=element, name=display-octave type=octave)

class musicxml.xmlelement.xmlelement.XMLDisplayStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible parents:XMLRest, XMLUnpitched

TYPE: alias of XSDSimpleTypeStep

XSD_TREE = XSDTree(tag=element, name=display-step type=step)

class musicxml.xmlelement.xmlelement.XMLDisplayText(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The formatted-text type represents a text element with text-formatting attributes.

Possible parents:XMLGroupAbbreviationDisplay, XMLGroupNameDisplay, XMLNoteheadText, XMLPartAbbreviationDisplay, XMLPartNameDisplay

TYPE: alias of XSDComplexTypeFormattedText

XSD_TREE = XSDTree(tag=element, name=display-text type=formatted-text)

class musicxml.xmlelement.xmlelement.XMLDistance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The distance element represents standard distances between notation elements in tenths. The type attribute defines what type of distance is being defined. Valid values include hyphen (for hyphens in lyrics) and beam.

simpleContent: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible attributes: type@ XSDSimpleTypeDistanceType@required

Possible parents:XMLAppearance

TYPE: alias of XSDComplexTypeDistance

XSD_TREE = XSDTree(tag=element, name=distance type=distance minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLDivisions(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Musical notation duration is commonly represented as fractions. The divisions element indicates how many divisions per quarter note are used to indicate a note’s duration. For example, if duration = 1 and divisions = 2, this is an eighth note duration. Duration and divisions are used directly for generating sound output, so they must be chosen to take tuplets into account. Using a divisions element lets us use just one number to represent a duration for each note in the score, while retaining the full power of a fractional representation. If maximum compatibility with Standard MIDI 1.0 files is important, do not have the divisions value exceed 16383.

simpleType: The positive-divisions type restricts divisions values to positive numbers.

Possible parents:XMLAttributes

TYPE: alias of XSDSimpleTypePositiveDivisions

XSD_TREE = XSDTree(tag=element, name=divisions type=positive-divisions minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLDoit(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The doit element is an indeterminate slide attached to a single note. The doit appears after the main note and goes above the main pitch.

complexType: The empty-line type represents an empty element with line-shape, line-type, line-length, dashed-formatting, print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, line_length@ XSDSimpleTypeLineLength, line_shape@ XSDSimpleTypeLineShape, line_type@ XSDSimpleTypeLineType, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyLine

XSD_TREE = XSDTree(tag=element, name=doit type=empty-line)

class musicxml.xmlelement.xmlelement.XMLDot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

One dot element is used for each dot of prolongation. The placement attribute is used to specify whether the dot should appear above or below the staff line. It is ignored for notes that appear on a staff space.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=dot type=empty-placement minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLDouble(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

If the double element is present, it indicates that the music is doubled one octave from what is currently written.

complexType: The double type indicates that the music is doubled one octave from what is currently written. If the above attribute is set to yes, the doubling is one octave above what is written, as for mixed flute / piccolo parts in band literature. Otherwise the doubling is one octave below what is written, as for mixed cello / bass parts in orchestral literature.

Possible attributes: above@ XSDSimpleTypeYesNo

Possible parents:XMLPartTranspose, XMLTranspose

TYPE: alias of XSDComplexTypeDouble

XSD_TREE = XSDTree(tag=element, name=double type=double minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLDoubleTongue(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The double-tongue element represents the double tongue symbol (two dots arranged horizontally).

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=double-tongue type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLDownBow(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The down-bow element represents the symbol that is used both for down-bowing on bowed instruments, and down-stroke on plucked instruments.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=down-bow type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLDuration(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Duration is a positive number specified in division units. This is the intended duration vs. notated duration (for instance, differences in dotted notes in Baroque-era music). Differences in duration specific to an interpretation or performance should be represented using the note element’s attack and release attributes.

The duration element moves the musical position when used in backup elements, forward elements, and note elements that do not contain a chord child element.

simpleType: The positive-divisions type restricts divisions values to positive numbers.

Possible parents:XMLBackup, XMLFiguredBass, XMLForward, XMLNote

TYPE: alias of XSDSimpleTypePositiveDivisions

XSD_TREE = XSDTree(tag=element, name=duration type=positive-divisions)

class musicxml.xmlelement.xmlelement.XMLDynamics(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Dynamics can be associated either with a note or a general musical direction. To avoid inconsistencies between and amongst the letter abbreviations for dynamics (what is sf vs. sfz, standing alone or with a trailing dynamic that is not always piano), we use the actual letters as the names of these dynamic elements. The other-dynamics element allows other dynamic marks that are not covered here. Dynamics elements may also be combined to create marks not covered by a single element, such as sfmp.

These letter dynamic symbols are separated from crescendo, decrescendo, and wedge indications. Dynamic representation is inconsistent in scores. Many things are assumed by the composer and left out, such as returns to original dynamics. The MusicXML format captures what is in the score, but does not try to be optimal for analysis or synthesis of dynamics.

The placement attribute is used when the dynamics are associated with a note. It is ignored when the dynamics are associated with a direction. In that case the direction element’s placement attribute is used instead.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, enclosure@ XSDSimpleTypeEnclosureShape, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, line_through@ XSDSimpleTypeNumberOfLines, overline@ XSDSimpleTypeNumberOfLines, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, underline@ XSDSimpleTypeNumberOfLines, valign@ XSDSimpleTypeValign

Possible children: XMLF, XMLFf, XMLFff, XMLFfff, XMLFffff, XMLFfffff, XMLFp, XMLFz, XMLMf, XMLMp, XMLN, XMLOtherDynamics, XMLP, XMLPf, XMLPp, XMLPpp, XMLPppp, XMLPpppp, XMLPppppp, XMLRf, XMLRfz, XMLSf, XMLSffz, XMLSfp, XMLSfpp, XMLSfz, XMLSfzp

XSD structure:
Choice@minOccurs=0@maxOccurs=unbounded
    Element@name=p@minOccurs=1@maxOccurs=1
    Element@name=pp@minOccurs=1@maxOccurs=1
    Element@name=ppp@minOccurs=1@maxOccurs=1
    Element@name=pppp@minOccurs=1@maxOccurs=1
    Element@name=ppppp@minOccurs=1@maxOccurs=1
    Element@name=pppppp@minOccurs=1@maxOccurs=1
    Element@name=f@minOccurs=1@maxOccurs=1
    Element@name=ff@minOccurs=1@maxOccurs=1
    Element@name=fff@minOccurs=1@maxOccurs=1
    Element@name=ffff@minOccurs=1@maxOccurs=1
    Element@name=fffff@minOccurs=1@maxOccurs=1
    Element@name=ffffff@minOccurs=1@maxOccurs=1
    Element@name=mp@minOccurs=1@maxOccurs=1
    Element@name=mf@minOccurs=1@maxOccurs=1
    Element@name=sf@minOccurs=1@maxOccurs=1
    Element@name=sfp@minOccurs=1@maxOccurs=1
    Element@name=sfpp@minOccurs=1@maxOccurs=1
    Element@name=fp@minOccurs=1@maxOccurs=1
    Element@name=rf@minOccurs=1@maxOccurs=1
    Element@name=rfz@minOccurs=1@maxOccurs=1
    Element@name=sfz@minOccurs=1@maxOccurs=1
    Element@name=sffz@minOccurs=1@maxOccurs=1
    Element@name=fz@minOccurs=1@maxOccurs=1
    Element@name=n@minOccurs=1@maxOccurs=1
    Element@name=pf@minOccurs=1@maxOccurs=1
    Element@name=sfzp@minOccurs=1@maxOccurs=1
    Element@name=other-dynamics@minOccurs=1@maxOccurs=1

Possible parents:XMLDirectionType, XMLNotations

TYPE: alias of XSDComplexTypeDynamics

XSD_TREE = XSDTree(tag=element, name=dynamics type=dynamics)

class musicxml.xmlelement.xmlelement.XMLEffect(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The effect type represents pictograms for sound effect percussion instruments. The smufl attribute is used to distinguish different SMuFL stylistic alternates.

simpleContent: The effect-value type represents pictograms for sound effect percussion instruments. The cannon, lotus flute, and megaphone values are in addition to Stone’s list.

Permitted Values: 'anvil', 'auto horn', 'bird whistle', 'cannon', 'duck call', 'gun shot', 'klaxon horn', 'lions roar', 'lotus flute', 'megaphone', 'police whistle', 'siren', 'slide whistle', 'thunder sheet', 'wind machine', 'wind whistle'

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeEffect

XSD_TREE = XSDTree(tag=element, name=effect type=effect)

class musicxml.xmlelement.xmlelement.XMLElevation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The elevation and pan elements allow placing of sound in a 3-D space relative to the listener. Both are expressed in degrees ranging from -180 to 180. For elevation, 0 is level with the listener, 90 is directly above, and -90 is directly below.

simpleType: The rotation-degrees type specifies rotation, pan, and elevation values in degrees. Values range from -180 to 180.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeRotationDegrees

XSD_TREE = XSDTree(tag=element, name=elevation type=rotation-degrees minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLElision(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The elision type represents an elision between lyric syllables. The text content specifies the symbol used to display the elision. Common values are a no-break space (Unicode 00A0), an underscore (Unicode 005F), or an undertie (Unicode 203F). If the text content is empty, the smufl attribute is used to specify the symbol to use. Its value is a SMuFL canonical glyph name that starts with lyrics. The SMuFL attribute is ignored if the elision glyph is already specified by the text content. If neither text content nor a smufl attribute are present, the elision glyph is application-specific.

Possible attributes: color@ XSDSimpleTypeColor, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, smufl@ XSDSimpleTypeSmuflLyricsGlyphName

Possible parents:XMLLyric

TYPE: alias of XSDComplexTypeElision

XSD_TREE = XSDTree(tag=element, name=elision type=elision)

class musicxml.xmlelement.xmlelement.XMLEncoder(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The typed-text type represents a text element with a type attribute.

Possible attributes: type@ XSDSimpleTypeToken

Possible parents:XMLEncoding

TYPE: alias of XSDComplexTypeTypedText

XSD_TREE = XSDTree(tag=element, name=encoder type=typed-text)

class musicxml.xmlelement.xmlelement.XMLEncoding(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The encoding element contains information about who did the digital encoding, when, with what software, and in what aspects. Standard type values for the encoder element are music, words, and arrangement, but other types may be used. The type attribute is only needed when there are multiple encoder elements.

Possible children: XMLEncoder, XMLEncodingDate, XMLEncodingDescription, XMLSoftware, XMLSupports

XSD structure:
Choice@minOccurs=0@maxOccurs=unbounded
    Element@name=encoding-date@minOccurs=1@maxOccurs=1
    Element@name=encoder@minOccurs=1@maxOccurs=1
    Element@name=software@minOccurs=1@maxOccurs=1
    Element@name=encoding-description@minOccurs=1@maxOccurs=1
    Element@name=supports@minOccurs=1@maxOccurs=1

Possible parents:XMLIdentification

TYPE: alias of XSDComplexTypeEncoding

XSD_TREE = XSDTree(tag=element, name=encoding type=encoding minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLEncodingDate(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: Calendar dates are represented yyyy-mm-dd format, following ISO 8601. This is a W3C XML Schema date type, but without the optional timezone data.

Pattern: [^:Z]*

Possible parents:XMLEncoding

TYPE: alias of XSDSimpleTypeYyyyMmDd

XSD_TREE = XSDTree(tag=element, name=encoding-date type=yyyy-mm-dd)

class musicxml.xmlelement.xmlelement.XMLEncodingDescription(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLEncoding

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=encoding-description type=xs:string)

class musicxml.xmlelement.xmlelement.XMLEndLine(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The end-line element comes from RP-017 for Standard MIDI File Lyric meta-events. It facilitates lyric display for Karaoke and similar applications.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLLyric

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=end-line type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLEndParagraph(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The end-paragraph element comes from RP-017 for Standard MIDI File Lyric meta-events. It facilitates lyric display for Karaoke and similar applications.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLLyric

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=end-paragraph type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLEnding(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The ending type represents multiple (e.g. first and second) endings. Typically, the start type is associated with the left barline of the first measure in an ending. The stop and discontinue types are associated with the right barline of the last measure in an ending. Stop is used when the ending mark concludes with a downward jog, as is typical for first endings. Discontinue is used when there is no downward jog, as is typical for second endings that do not conclude a piece. The length of the jog can be specified using the end-length attribute. The text-x and text-y attributes are offsets that specify where the baseline of the start of the ending text appears, relative to the start of the ending line.

The number attribute indicates which times the ending is played, similar to the time-only attribute used by other elements. While this often represents the numeric values for what is under the ending line, it can also indicate whether an ending is played during a larger dal segno or da capo repeat. Single endings such as “1” or comma-separated multiple endings such as “1,2” may be used. The ending element text is used when the text displayed in the ending is different than what appears in the number attribute. The print-object attribute is used to indicate when an ending is present but not printed, as is often the case for many parts in a full score.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, end_length@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, number@ XSDSimpleTypeEndingNumber@required, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, system@ XSDSimpleTypeSystemRelation, text_x@ XSDSimpleTypeTenths, text_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStopDiscontinue@required

Possible parents:XMLBarline

TYPE: alias of XSDComplexTypeEnding

XSD_TREE = XSDTree(tag=element, name=ending type=ending minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLEnsemble(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The ensemble element is present if performance is intended by an ensemble such as an orchestral section. The text of the ensemble element contains the size of the section, or is empty if the ensemble size is not specified.

simpleType: The positive-integer-or-empty values can be either a positive integer or an empty string.

Todo

Better documentation.

Possible parents:XMLInstrumentChange, XMLScoreInstrument

TYPE: alias of XSDSimpleTypePositiveIntegerOrEmpty

XSD_TREE = XSDTree(tag=element, name=ensemble type=positive-integer-or-empty)

class musicxml.xmlelement.xmlelement.XMLExceptVoice(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The except-voice element is used to specify a combination of slash notation and regular notation. Any note elements that are in voices specified by the except-voice elements are displayed in normal notation, in addition to the slash notation that is always displayed.

Possible parents:XMLBeatRepeat, XMLSlash

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=except-voice type=xs:string minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLExtend(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The extend type represents lyric word extension / melisma lines as well as figured bass extensions. The optional type and position attributes are added in Version 3.0 to provide better formatting control.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStopContinue

Possible parents:XMLFigure, XMLLyric

TYPE: alias of XSDComplexTypeExtend

XSD_TREE = XSDTree(tag=element, name=extend type=extend)

class musicxml.xmlelement.xmlelement.XMLEyeglasses(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The eyeglasses element represents the eyeglasses symbol, common in commercial music.

complexType: The empty-print-style-align-id type represents an empty element with print-style-align and optional-unique-id attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeEmptyPrintStyleAlignId

XSD_TREE = XSDTree(tag=element, name=eyeglasses type=empty-print-style-align-id)

class musicxml.xmlelement.xmlelement.XMLF(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=f type=empty)

class musicxml.xmlelement.xmlelement.XMLFalloff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The falloff element is an indeterminate slide attached to a single note. The falloff appears after the main note and goes below the main pitch.

complexType: The empty-line type represents an empty element with line-shape, line-type, line-length, dashed-formatting, print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, line_length@ XSDSimpleTypeLineLength, line_shape@ XSDSimpleTypeLineShape, line_type@ XSDSimpleTypeLineType, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyLine

XSD_TREE = XSDTree(tag=element, name=falloff type=empty-line)

class musicxml.xmlelement.xmlelement.XMLFeature(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The feature type is a part of the grouping element used for musical analysis. The type attribute represents the type of the feature and the element content represents its value. This type is flexible to allow for different analyses.

Possible attributes: type@ XSDSimpleTypeToken

Possible parents:XMLGrouping

TYPE: alias of XSDComplexTypeFeature

XSD_TREE = XSDTree(tag=element, name=feature type=feature minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLFermata(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The fermata text content represents the shape of the fermata sign. An empty fermata element represents a normal fermata. The fermata type is upright if not specified.

simpleContent: The fermata-shape type represents the shape of the fermata sign. The empty value is equivalent to the normal value.

Permitted Values: 'normal', 'angled', 'square', 'double-angled', 'double-square', 'double-dot', 'half-curve', 'curlew', ''

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeUprightInverted

Possible parents:XMLBarline, XMLNotations

TYPE: alias of XSDComplexTypeFermata

XSD_TREE = XSDTree(tag=element, name=fermata type=fermata)

class musicxml.xmlelement.xmlelement.XMLFf(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=ff type=empty)

class musicxml.xmlelement.xmlelement.XMLFff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=fff type=empty)

class musicxml.xmlelement.xmlelement.XMLFfff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=ffff type=empty)

class musicxml.xmlelement.xmlelement.XMLFffff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=fffff type=empty)

class musicxml.xmlelement.xmlelement.XMLFfffff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=ffffff type=empty)

class musicxml.xmlelement.xmlelement.XMLFifths(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The fifths type represents the number of flats or sharps in a traditional key signature. Negative numbers are used for flats and positive numbers for sharps, reflecting the key’s placement within the circle of fifths (hence the type name).

Possible parents:XMLKey

TYPE: alias of XSDSimpleTypeFifths

XSD_TREE = XSDTree(tag=element, name=fifths type=fifths)

class musicxml.xmlelement.xmlelement.XMLFigure(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The figure type represents a single figure within a figured-bass element.

Possible children: XMLExtend, XMLFigureNumber, XMLFootnote, XMLLevel, XMLPrefix, XMLSuffix

XSD structure:

Sequence@minOccurs=1@maxOccurs=1
    Element@name=prefix@minOccurs=0@maxOccurs=1
    Element@name=figure-number@minOccurs=0@maxOccurs=1
    Element@name=suffix@minOccurs=0@maxOccurs=1
    Element@name=extend@minOccurs=0@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1

Possible parents:XMLFiguredBass

TYPE: alias of XSDComplexTypeFigure

XSD_TREE = XSDTree(tag=element, name=figure type=figure maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLFigureNumber(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

A figure-number is a number. Overstrikes of the figure number are represented in the suffix element.

complexType: The style-text type represents a text element with a print-style attribute group.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLFigure

TYPE: alias of XSDComplexTypeStyleText

XSD_TREE = XSDTree(tag=element, name=figure-number type=style-text minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLFiguredBass(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The figured-bass element represents figured bass notation. Figured bass elements take their position from the first regular note (not a grace note or chord note) that follows in score order. The optional duration element is used to indicate changes of figures under a note.

Figures are ordered from top to bottom. The value of parentheses is “no” if not present.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, parentheses@ XSDSimpleTypeYesNo, placement@ XSDSimpleTypeAboveBelow, print_dot@ XSDSimpleTypeYesNo, print_lyric@ XSDSimpleTypeYesNo, print_object@ XSDSimpleTypeYesNo, print_spacing@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible children: XMLDuration, XMLFigure, XMLFootnote, XMLLevel

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=figure@minOccurs=1@maxOccurs=unbounded
    Group@name=duration@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=duration@minOccurs=1@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeFiguredBass

XSD_TREE = XSDTree(tag=element, name=figured-bass type=figured-bass)

class musicxml.xmlelement.xmlelement.XMLFingering(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Fingering is typically indicated 1,2,3,4,5. Multiple fingerings may be given, typically to substitute fingerings in the middle of a note. The substitution and alternate values are “no” if the attribute is not present. For guitar and other fretted instruments, the fingering element represents the fretting finger; the pluck element represents the plucking finger.

Possible attributes: alternate@ XSDSimpleTypeYesNo, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, substitution@ XSDSimpleTypeYesNo

Possible parents:XMLFrameNote, XMLTechnical

TYPE: alias of XSDComplexTypeFingering

XSD_TREE = XSDTree(tag=element, name=fingering type=fingering)

class musicxml.xmlelement.xmlelement.XMLFingernails(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The fingernails element is used in notation for harp and other plucked string instruments.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=fingernails type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLFirst(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLSwing

TYPE: alias of XSDSimpleTypePositiveInteger

XSD_TREE = XSDTree(tag=element, name=first type=xs:positiveInteger)

class musicxml.xmlelement.xmlelement.XMLFirstFret(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The first-fret type indicates which fret is shown in the top space of the frame; it is fret 1 if the element is not present. The optional text attribute indicates how this is represented in the fret diagram, while the location attribute indicates whether the text appears to the left or right of the frame.

Possible attributes: location@ XSDSimpleTypeLeftRight, text@ XSDSimpleTypeToken

Possible parents:XMLFrame

TYPE: alias of XSDComplexTypeFirstFret

XSD_TREE = XSDTree(tag=element, name=first-fret type=first-fret minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLFlip(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The flip element represents the flip symbol used in brass notation.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=flip type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLFootnote(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The formatted-text type represents a text element with text-formatting attributes.

Possible parents:XMLAttributes, XMLBackup, XMLBarline, XMLDirection, XMLFigure, XMLFiguredBass, XMLForward, XMLHarmony, XMLLyric, XMLNotations, XMLNote, XMLPartGroup

TYPE: alias of XSDComplexTypeFormattedText

XSD_TREE = XSDTree(tag=element, name=footnote type=formatted-text)

class musicxml.xmlelement.xmlelement.XMLForPart(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The for-part element is used in a concert score to indicate the transposition for a transposed part created from that score. It is only used in score files that contain a concert-score element in the defaults. This allows concert scores with transposed parts to be represented in a single uncompressed MusicXML file.

complexType: The for-part type is used in a concert score to indicate the transposition for a transposed part created from that score. It is only used in score files that contain a concert-score element in the defaults. This allows concert scores with transposed parts to be represented in a single uncompressed MusicXML file.

The optional number attribute refers to staff numbers, from top to bottom on the system. If absent, the child elements apply to all staves in the created part.

Possible attributes: id@ XSDSimpleTypeID, number@ XSDSimpleTypeStaffNumber

Possible children: XMLPartClef, XMLPartTranspose

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=part-clef@minOccurs=0@maxOccurs=1
    Element@name=part-transpose@minOccurs=1@maxOccurs=1

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeForPart

XSD_TREE = XSDTree(tag=element, name=for-part type=for-part minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLForward(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The backup and forward elements are required to coordinate multiple voices in one part, including music on multiple staves. The forward element is generally used within voices and staves. Duration values should always be positive, and should not cross measure boundaries or mid-measure changes in the divisions value.

Possible children: XMLDuration, XMLFootnote, XMLLevel, XMLStaff, XMLVoice

XSD structure:

Sequence@minOccurs=1@maxOccurs=1
    Group@name=duration@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=duration@minOccurs=1@maxOccurs=1
    Group@name=editorial-voice@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
            Group@name=voice@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=voice@minOccurs=1@maxOccurs=1
    Group@name=staff@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=staff@minOccurs=1@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeForward

XSD_TREE = XSDTree(tag=element, name=forward type=forward)

class musicxml.xmlelement.xmlelement.XMLFp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=fp type=empty)

class musicxml.xmlelement.xmlelement.XMLFrame(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The frame type represents a frame or fretboard diagram used together with a chord symbol. The representation is based on the NIFF guitar grid with additional information. The frame type’s unplayed attribute indicates what to display above a string that has no associated frame-note element. Typical values are x and the empty string. If the attribute is not present, the display of the unplayed string is application-defined.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, halign@ XSDSimpleTypeLeftCenterRight, height@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, unplayed@ XSDSimpleTypeToken, valign@ XSDSimpleTypeValignImage, width@ XSDSimpleTypeTenths

Possible children: XMLFirstFret, XMLFrameFrets, XMLFrameNote, XMLFrameStrings

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=frame-strings@minOccurs=1@maxOccurs=1
    Element@name=frame-frets@minOccurs=1@maxOccurs=1
    Element@name=first-fret@minOccurs=0@maxOccurs=1
    Element@name=frame-note@minOccurs=1@maxOccurs=unbounded

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeFrame

XSD_TREE = XSDTree(tag=element, name=frame type=frame minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLFrameFrets(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The frame-frets element gives the overall size of the frame in horizontal spaces (frets).

Possible parents:XMLFrame

TYPE: alias of XSDSimpleTypePositiveInteger

XSD_TREE = XSDTree(tag=element, name=frame-frets type=xs:positiveInteger)

class musicxml.xmlelement.xmlelement.XMLFrameNote(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The frame-note type represents each note included in the frame. An open string will have a fret value of 0, while a muted string will not be associated with a frame-note element.

Possible children: XMLBarre, XMLFingering, XMLFret, XMLString

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=string@minOccurs=1@maxOccurs=1
    Element@name=fret@minOccurs=1@maxOccurs=1
    Element@name=fingering@minOccurs=0@maxOccurs=1
    Element@name=barre@minOccurs=0@maxOccurs=1

Possible parents:XMLFrame

TYPE: alias of XSDComplexTypeFrameNote

XSD_TREE = XSDTree(tag=element, name=frame-note type=frame-note maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLFrameStrings(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The frame-strings element gives the overall size of the frame in vertical lines (strings).

Possible parents:XMLFrame

TYPE: alias of XSDSimpleTypePositiveInteger

XSD_TREE = XSDTree(tag=element, name=frame-strings type=xs:positiveInteger)

class musicxml.xmlelement.xmlelement.XMLFret(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The fret element is used with tablature notation and chord diagrams. Fret numbers start with 0 for an open string and 1 for the first fret.

Possible attributes: color@ XSDSimpleTypeColor, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLFrameNote, XMLTechnical

TYPE: alias of XSDComplexTypeFret

XSD_TREE = XSDTree(tag=element, name=fret type=fret)

class musicxml.xmlelement.xmlelement.XMLFunction(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The function element represents classical functional harmony with an indication like I, II, III rather than C, D, E. It represents the Roman numeral part of a functional harmony rather than the complete function itself. It has been deprecated as of MusicXML 4.0 in favor of the numeral element.

complexType: The style-text type represents a text element with a print-style attribute group.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeStyleText

XSD_TREE = XSDTree(tag=element, name=function type=style-text)

class musicxml.xmlelement.xmlelement.XMLFz(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=fz type=empty)

class musicxml.xmlelement.xmlelement.XMLGlass(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The glass type represents pictograms for glass percussion instruments. The smufl attribute is used to distinguish different SMuFL glyphs for wind chimes in the Chimes pictograms range, including those made of materials other than glass.

simpleContent: The glass-value type represents pictograms for glass percussion instruments.

Permitted Values: 'glass harmonica', 'glass harp', 'wind chimes'

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeGlass

XSD_TREE = XSDTree(tag=element, name=glass type=glass)

class musicxml.xmlelement.xmlelement.XMLGlissando(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Glissando and slide types both indicate rapidly moving from one pitch to the other so that individual notes are not discerned. A glissando sounds the distinct notes in between the two pitches and defaults to a wavy line. The optional text is printed alongside the line.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, line_type@ XSDSimpleTypeLineType, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeGlissando

XSD_TREE = XSDTree(tag=element, name=glissando type=glissando)

class musicxml.xmlelement.xmlelement.XMLGlyph(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The glyph element represents what SMuFL glyph should be used for different variations of symbols that are semantically identical. The type attribute specifies what type of glyph is being defined. The element value specifies what SMuFL glyph to use, including recommended stylistic alternates. The SMuFL glyph name should match the type. For instance, a type of quarter-rest would use values restQuarter, restQuarterOld, or restQuarterZ. A type of g-clef-ottava-bassa would use values gClef8vb, gClef8vbOld, or gClef8vbCClef. A type of octave-shift-up-8 would use values ottava, ottavaBassa, ottavaBassaBa, ottavaBassaVb, or octaveBassa.

simpleContent: The smufl-glyph-name type is used for attributes that reference a specific Standard Music Font Layout (SMuFL) character. The value is a SMuFL canonical glyph name, not a code point. For instance, the value for a standard piano pedal mark would be keyboardPedalPed, not U+E650.

Possible attributes: type@ XSDSimpleTypeGlyphType@required

Possible parents:XMLAppearance

TYPE: alias of XSDComplexTypeGlyph

XSD_TREE = XSDTree(tag=element, name=glyph type=glyph minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLGolpe(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The golpe element represents the golpe symbol that is used for tapping the pick guard in guitar music.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=golpe type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLGrace(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The grace type indicates the presence of a grace note. The slash attribute for a grace note is yes for slashed grace notes. The steal-time-previous attribute indicates the percentage of time to steal from the previous note for the grace note. The steal-time-following attribute indicates the percentage of time to steal from the following note for the grace note, as for appoggiaturas. The make-time attribute indicates to make time, not steal time; the units are in real-time divisions for the grace note.

Possible attributes: make_time@ XSDSimpleTypeDivisions, slash@ XSDSimpleTypeYesNo, steal_time_following@ XSDSimpleTypePercent, steal_time_previous@ XSDSimpleTypePercent

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeGrace

XSD_TREE = XSDTree(tag=element, name=grace type=grace)

class musicxml.xmlelement.xmlelement.XMLGroup(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The group element allows the use of different versions of the part for different purposes. Typical values include score, parts, sound, and data. Ordering information can be derived from the ordering within a MusicXML score or opus.

Possible parents:XMLScorePart

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=group type=xs:string minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLGroupAbbreviation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The group-name type describes the name or abbreviation of a part-group element. Formatting attributes in the group-name type are deprecated in Version 2.0 in favor of the new group-name-display and group-abbreviation-display elements.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, justify@ XSDSimpleTypeLeftCenterRight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeGroupName

XSD_TREE = XSDTree(tag=element, name=group-abbreviation type=group-name minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGroupAbbreviationDisplay(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Formatting specified in the group-abbreviation-display element overrides formatting specified in the group-abbreviation element.

complexType: The name-display type is used for exact formatting of multi-font text in part and group names to the left of the system. The print-object attribute can be used to determine what, if anything, is printed at the start of each system. Enclosure for the display-text element is none by default. Language for the display-text element is Italian (“it”) by default.

Possible attributes: print_object@ XSDSimpleTypeYesNo

Possible children: XMLAccidentalText, XMLDisplayText

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Element@name=display-text@minOccurs=1@maxOccurs=1
        Element@name=accidental-text@minOccurs=1@maxOccurs=1

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeNameDisplay

XSD_TREE = XSDTree(tag=element, name=group-abbreviation-display type=name-display minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGroupBarline(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The group-barline type indicates if the group should have common barlines.

simpleContent: The group-barline-value type indicates if the group should have common barlines.

Permitted Values: 'yes', 'no', 'Mensurstrich'

Possible attributes: color@ XSDSimpleTypeColor

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeGroupBarline

XSD_TREE = XSDTree(tag=element, name=group-barline type=group-barline minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGroupLink(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Multiple part-link elements can reference different types of linked documents, such as parts and condensed score. The optional group-link elements identify the groups used in the linked document. The content of a group-link element should match the content of a group element in the linked document.

Possible parents:XMLPartLink

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=group-link type=xs:string minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLGroupName(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The group-name type describes the name or abbreviation of a part-group element. Formatting attributes in the group-name type are deprecated in Version 2.0 in favor of the new group-name-display and group-abbreviation-display elements.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, justify@ XSDSimpleTypeLeftCenterRight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeGroupName

XSD_TREE = XSDTree(tag=element, name=group-name type=group-name minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGroupNameDisplay(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Formatting specified in the group-name-display element overrides formatting specified in the group-name element.

complexType: The name-display type is used for exact formatting of multi-font text in part and group names to the left of the system. The print-object attribute can be used to determine what, if anything, is printed at the start of each system. Enclosure for the display-text element is none by default. Language for the display-text element is Italian (“it”) by default.

Possible attributes: print_object@ XSDSimpleTypeYesNo

Possible children: XMLAccidentalText, XMLDisplayText

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Element@name=display-text@minOccurs=1@maxOccurs=1
        Element@name=accidental-text@minOccurs=1@maxOccurs=1

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeNameDisplay

XSD_TREE = XSDTree(tag=element, name=group-name-display type=name-display minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGroupSymbol(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The group-symbol type indicates how the symbol for a group is indicated in the score. It is none if not specified.

simpleContent: The group-symbol-value type indicates how the symbol for a group or multi-staff part is indicated in the score.

Permitted Values: 'none', 'brace', 'line', 'bracket', 'square'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeGroupSymbol

XSD_TREE = XSDTree(tag=element, name=group-symbol type=group-symbol minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGroupTime(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The group-time element indicates that the displayed time signatures should stretch across all parts and staves in the group.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLPartGroup

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=group-time type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLGrouping(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The grouping type is used for musical analysis. When the type attribute is “start” or “single”, it usually contains one or more feature elements. The number attribute is used for distinguishing between overlapping and hierarchical groupings. The member-of attribute allows for easy distinguishing of what grouping elements are in what hierarchy. Feature elements contained within a “stop” type of grouping may be ignored.

This element is flexible to allow for different types of analyses. Future versions of the MusicXML format may add elements that can represent more standardized categories of analysis data, allowing for easier data sharing.

Possible attributes: id@ XSDSimpleTypeID, member_of@ XSDSimpleTypeToken, number@ XSDSimpleTypeToken, type@ XSDSimpleTypeStartStopSingle@required

Possible children: XMLFeature

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=feature@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeGrouping

XSD_TREE = XSDTree(tag=element, name=grouping type=grouping)

class musicxml.xmlelement.xmlelement.XMLHalfMuted(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The half-muted element represents the half-muted symbol, which looks like a circle with a plus sign inside. The smufl attribute can be used to distinguish different SMuFL glyphs that have a similar appearance such as brassMuteHalfClosed and guitarHalfOpenPedal. If not present, the default glyph is brassMuteHalfClosed.

complexType: The empty-placement-smufl type represents an empty element with print-style, placement, and smufl attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacementSmufl

XSD_TREE = XSDTree(tag=element, name=half-muted type=empty-placement-smufl)

class musicxml.xmlelement.xmlelement.XMLHammerOn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The hammer-on and pull-off elements are used in guitar and fretted instrument notation. Since a single slur can be marked over many notes, the hammer-on and pull-off elements are separate so the individual pair of notes can be specified. The element content can be used to specify how the hammer-on or pull-off should be notated. An empty element leaves this choice up to the application.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHammerOnPullOff

XSD_TREE = XSDTree(tag=element, name=hammer-on type=hammer-on-pull-off)

class musicxml.xmlelement.xmlelement.XMLHandbell(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The handbell element represents notation for various techniques used in handbell and handchime music.

simpleContent: The handbell-value type represents the type of handbell technique being notated.

Permitted Values: 'belltree', 'damp', 'echo', 'gyro', 'hand martellato', 'mallet lift', 'mallet table', 'martellato', 'martellato lift', 'muted martellato', 'pluck lift', 'swing'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHandbell

XSD_TREE = XSDTree(tag=element, name=handbell type=handbell)

class musicxml.xmlelement.xmlelement.XMLHarmonClosed(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The harmon-closed type represents whether the harmon mute is closed, open, or half-open. The optional location attribute indicates which portion of the symbol is filled in when the element value is half.

simpleContent: The harmon-closed-value type represents whether the harmon mute is closed, open, or half-open.

Permitted Values: 'yes', 'no', 'half'

Possible attributes: location@ XSDSimpleTypeHarmonClosedLocation

Possible parents:XMLHarmonMute

TYPE: alias of XSDComplexTypeHarmonClosed

XSD_TREE = XSDTree(tag=element, name=harmon-closed type=harmon-closed)

class musicxml.xmlelement.xmlelement.XMLHarmonMute(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The harmon-mute type represents the symbols used for harmon mutes in brass notation.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible children: XMLHarmonClosed

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=harmon-closed@minOccurs=1@maxOccurs=1

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHarmonMute

XSD_TREE = XSDTree(tag=element, name=harmon-mute type=harmon-mute)

class musicxml.xmlelement.xmlelement.XMLHarmonic(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The harmonic type indicates natural and artificial harmonics. Allowing the type of pitch to be specified, combined with controls for appearance/playback differences, allows both the notation and the sound to be represented. Artificial harmonics can add a notated touching pitch; artificial pinch harmonics will usually not notate a touching pitch. The attributes for the harmonic element refer to the use of the circular harmonic symbol, typically but not always used with natural harmonics.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible children: XMLArtificial, XMLBasePitch, XMLNatural, XMLSoundingPitch, XMLTouchingPitch

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=1
        Element@name=natural@minOccurs=1@maxOccurs=1
        Element@name=artificial@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=1
        Element@name=base-pitch@minOccurs=1@maxOccurs=1
        Element@name=touching-pitch@minOccurs=1@maxOccurs=1
        Element@name=sounding-pitch@minOccurs=1@maxOccurs=1

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHarmonic

XSD_TREE = XSDTree(tag=element, name=harmonic type=harmonic)

class musicxml.xmlelement.xmlelement.XMLHarmony(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The harmony type represents harmony analysis, including chord symbols in popular music as well as functional harmony analysis in classical music.

If there are alternate harmonies possible, this can be specified using multiple harmony elements differentiated by type. Explicit harmonies have all note present in the music; implied have some notes missing but implied; alternate represents alternate analyses.

The print-object attribute controls whether or not anything is printed due to the harmony element. The print-frame attribute controls printing of a frame or fretboard diagram. The print-style attribute group sets the default for the harmony, but individual elements can override this with their own print-style values. The arrangement attribute specifies how multiple harmony-chord groups are arranged relative to each other. Harmony-chords with vertical arrangement are separated by horizontal lines. Harmony-chords with diagonal or horizontal arrangement are separated by diagonal lines or slashes.

Possible attributes: arrangement@ XSDSimpleTypeHarmonyArrangement, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, placement@ XSDSimpleTypeAboveBelow, print_frame@ XSDSimpleTypeYesNo, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, system@ XSDSimpleTypeSystemRelation, type@ XSDSimpleTypeHarmonyType

Possible children: XMLBass, XMLDegree, XMLFootnote, XMLFrame, XMLFunction, XMLInversion, XMLKind, XMLLevel, XMLNumeral, XMLOffset, XMLRoot, XMLStaff

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Group@name=harmony-chord@minOccurs=1@maxOccurs=unbounded
        Sequence@minOccurs=1@maxOccurs=1
            Choice@minOccurs=1@maxOccurs=1
                Element@name=root@minOccurs=1@maxOccurs=1
                Element@name=numeral@minOccurs=1@maxOccurs=1
                Element@name=function@minOccurs=1@maxOccurs=1
            Element@name=kind@minOccurs=1@maxOccurs=1
            Element@name=inversion@minOccurs=0@maxOccurs=1
            Element@name=bass@minOccurs=0@maxOccurs=1
            Element@name=degree@minOccurs=0@maxOccurs=unbounded
    Element@name=frame@minOccurs=0@maxOccurs=1
    Element@name=offset@minOccurs=0@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
    Group@name=staff@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=staff@minOccurs=1@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeHarmony

XSD_TREE = XSDTree(tag=element, name=harmony type=harmony)

class musicxml.xmlelement.xmlelement.XMLHarpPedals(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The harp-pedals type is used to create harp pedal diagrams. The pedal-step and pedal-alter elements use the same values as the step and alter elements. For easiest reading, the pedal-tuning elements should follow standard harp pedal order, with pedal-step values of D, C, B, E, F, G, and A.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible children: XMLPedalTuning

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=pedal-tuning@minOccurs=1@maxOccurs=unbounded

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeHarpPedals

XSD_TREE = XSDTree(tag=element, name=harp-pedals type=harp-pedals)

class musicxml.xmlelement.xmlelement.XMLHaydn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The haydn element represents the Haydn ornament. This is defined in SMuFL as ornamentHaydn.

complexType: The empty-trill-sound type represents an empty element with print-style, placement, and trill-sound attributes.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeEmptyTrillSound

XSD_TREE = XSDTree(tag=element, name=haydn type=empty-trill-sound)

class musicxml.xmlelement.xmlelement.XMLHeel(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The heel and toe elements are used with organ pedals. The substitution value is “no” if the attribute is not present.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, substitution@ XSDSimpleTypeYesNo

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHeelToe

XSD_TREE = XSDTree(tag=element, name=heel type=heel-toe)

class musicxml.xmlelement.xmlelement.XMLHole(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The hole type represents the symbols used for woodwind and brass fingerings as well as other notations.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible children: XMLHoleClosed, XMLHoleShape, XMLHoleType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=hole-type@minOccurs=0@maxOccurs=1
    Element@name=hole-closed@minOccurs=1@maxOccurs=1
    Element@name=hole-shape@minOccurs=0@maxOccurs=1

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHole

XSD_TREE = XSDTree(tag=element, name=hole type=hole)

class musicxml.xmlelement.xmlelement.XMLHoleClosed(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The hole-closed type represents whether the hole is closed, open, or half-open. The optional location attribute indicates which portion of the hole is filled in when the element value is half.

simpleContent: The hole-closed-value type represents whether the hole is closed, open, or half-open.

Permitted Values: 'yes', 'no', 'half'

Possible attributes: location@ XSDSimpleTypeHoleClosedLocation

Possible parents:XMLHole

TYPE: alias of XSDComplexTypeHoleClosed

XSD_TREE = XSDTree(tag=element, name=hole-closed type=hole-closed)

class musicxml.xmlelement.xmlelement.XMLHoleShape(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The optional hole-shape element indicates the shape of the hole symbol; the default is a circle.

Possible parents:XMLHole

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=hole-shape type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLHoleType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The content of the optional hole-type element indicates what the hole symbol represents in terms of instrument fingering or other techniques.

Possible parents:XMLHole

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=hole-type type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLHumming(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The humming element represents a humming voice.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLLyric

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=humming type=empty)

class musicxml.xmlelement.xmlelement.XMLIdentification(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Identification contains basic metadata about the score. It includes information that may apply at a score-wide, movement-wide, or part-wide level. The creator, rights, source, and relation elements are based on Dublin Core.

Possible children: XMLCreator, XMLEncoding, XMLMiscellaneous, XMLRelation, XMLRights, XMLSource

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=creator@minOccurs=0@maxOccurs=unbounded
    Element@name=rights@minOccurs=0@maxOccurs=unbounded
    Element@name=encoding@minOccurs=0@maxOccurs=1
    Element@name=source@minOccurs=0@maxOccurs=1
    Element@name=relation@minOccurs=0@maxOccurs=unbounded
    Element@name=miscellaneous@minOccurs=0@maxOccurs=1

Possible parents:XMLScorePart, XMLScorePartwise

TYPE: alias of XSDComplexTypeIdentification

XSD_TREE = XSDTree(tag=element, name=identification type=identification minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLImage(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The image type is used to include graphical images in a score.

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeImage

XSD_TREE = XSDTree(tag=element, name=image type=image)

class musicxml.xmlelement.xmlelement.XMLInstrument(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The instrument type distinguishes between score-instrument elements in a score-part. The id attribute is an IDREF back to the score-instrument ID. If multiple score-instruments are specified in a score-part, there should be an instrument element for each note in the part. Notes that are shared between multiple score-instruments can have more than one instrument element.

Possible attributes: id@ XSDSimpleTypeIDREF@required

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeInstrument

XSD_TREE = XSDTree(tag=element, name=instrument type=instrument minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLInstrumentAbbreviation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The optional instrument-abbreviation element is typically used within a software application, rather than appearing on the printed page of a score.

Possible parents:XMLScoreInstrument

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=instrument-abbreviation type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLInstrumentChange(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The instrument-change element type represents a change to the virtual instrument sound for a given score-instrument. The id attribute refers to the score-instrument affected by the change. All instrument-change child elements can also be initially specified within the score-instrument element.

Possible attributes: id@ XSDSimpleTypeIDREF@required

Possible children: XMLEnsemble, XMLInstrumentSound, XMLSolo, XMLVirtualInstrument

XSD structure:
Group@name=virtual-instrument-data@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=instrument-sound@minOccurs=0@maxOccurs=1
        Choice@minOccurs=0@maxOccurs=1
            Element@name=solo@minOccurs=1@maxOccurs=1
            Element@name=ensemble@minOccurs=1@maxOccurs=1
        Element@name=virtual-instrument@minOccurs=0@maxOccurs=1

Possible parents:XMLSound

TYPE: alias of XSDComplexTypeInstrumentChange

XSD_TREE = XSDTree(tag=element, name=instrument-change type=instrument-change minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLInstrumentLink(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Multiple part-link elements can link a condensed part within a score file to multiple MusicXML parts files. For example, a “Clarinet 1 and 2” part in a score file could link to separate “Clarinet 1” and “Clarinet 2” part files. The instrument-link type distinguish which of the score-instruments within a score-part are in which part file. The instrument-link id attribute refers to a score-instrument id attribute.

Possible attributes: id@ XSDSimpleTypeIDREF@required

Possible parents:XMLPartLink

TYPE: alias of XSDComplexTypeInstrumentLink

XSD_TREE = XSDTree(tag=element, name=instrument-link type=instrument-link minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLInstrumentName(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The instrument-name element is typically used within a software application, rather than appearing on the printed page of a score.

Possible parents:XMLScoreInstrument

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=instrument-name type=xs:string)

class musicxml.xmlelement.xmlelement.XMLInstrumentSound(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The instrument-sound element describes the default timbre of the score-instrument. This description is independent of a particular virtual or MIDI instrument specification and allows playback to be shared more easily between applications and libraries.

Possible parents:XMLInstrumentChange, XMLScoreInstrument

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=instrument-sound type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLInstruments(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The instruments element is only used if more than one instrument is represented in the part (e.g., oboe I and II where they play together most of the time). If absent, a value of 1 is assumed.

Possible parents:XMLAttributes

TYPE: alias of XSDSimpleTypeNonNegativeInteger

XSD_TREE = XSDTree(tag=element, name=instruments type=xs:nonNegativeInteger minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLInterchangeable(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The interchangeable type is used to represent the second in a pair of interchangeable dual time signatures, such as the 6/8 in 3/4 (6/8). A separate symbol attribute value is available compared to the time element’s symbol attribute, which applies to the first of the dual time signatures.

Possible attributes: separator@ XSDSimpleTypeTimeSeparator, symbol@ XSDSimpleTypeTimeSymbol

Possible children: XMLBeatType, XMLBeats, XMLTimeRelation

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=time-relation@minOccurs=0@maxOccurs=1
    Group@name=time-signature@minOccurs=1@maxOccurs=unbounded
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=beats@minOccurs=1@maxOccurs=1
            Element@name=beat-type@minOccurs=1@maxOccurs=1

Possible parents:XMLTime

TYPE: alias of XSDComplexTypeInterchangeable

XSD_TREE = XSDTree(tag=element, name=interchangeable type=interchangeable minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLInversion(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The inversion type represents harmony inversions. The value is a number indicating which inversion is used: 0 for root position, 1 for first inversion, etc. The text attribute indicates how the inversion should be displayed in a score.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, text@ XSDSimpleTypeToken

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeInversion

XSD_TREE = XSDTree(tag=element, name=inversion type=inversion minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLInvertedMordent(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The inverted-mordent element represents the sign without the vertical line. The choice of which mordent is inverted differs between MusicXML and SMuFL. The long attribute is “no” by default.

complexType: The mordent type is used for both represents the mordent sign with the vertical line and the inverted-mordent sign without the line. The long attribute is “no” by default. The approach and departure attributes are used for compound ornaments, indicating how the beginning and ending of the ornament look relative to the main part of the mordent.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, approach@ XSDSimpleTypeAboveBelow, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, departure@ XSDSimpleTypeAboveBelow, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, long@ XSDSimpleTypeYesNo, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeMordent

XSD_TREE = XSDTree(tag=element, name=inverted-mordent type=mordent)

class musicxml.xmlelement.xmlelement.XMLInvertedTurn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The inverted-turn element has the shape which goes down and then up.

complexType: The horizontal-turn type represents turn elements that are horizontal rather than vertical. These are empty elements with print-style, placement, trill-sound, and slash attributes. If the slash attribute is yes, then a vertical line is used to slash the turn. It is no if not specified.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, slash@ XSDSimpleTypeYesNo, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeHorizontalTurn

XSD_TREE = XSDTree(tag=element, name=inverted-turn type=horizontal-turn)

class musicxml.xmlelement.xmlelement.XMLInvertedVerticalTurn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The inverted-vertical-turn element has the turn symbol shape arranged vertically going from upper right to lower left.

complexType: The empty-trill-sound type represents an empty element with print-style, placement, and trill-sound attributes.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeEmptyTrillSound

XSD_TREE = XSDTree(tag=element, name=inverted-vertical-turn type=empty-trill-sound)

class musicxml.xmlelement.xmlelement.XMLIpa(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The ipa element represents International Phonetic Alphabet (IPA) sounds for vocal music. String content is limited to IPA 2015 symbols represented in Unicode 13.0.

Possible parents:XMLPlay

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=ipa type=xs:string)

class musicxml.xmlelement.xmlelement.XMLKey(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The key element represents a key signature. Both traditional and non-traditional key signatures are supported. The optional number attribute refers to staff numbers. If absent, the key signature applies to all staves in the part.

complexType: The key type represents a key signature. Both traditional and non-traditional key signatures are supported. The optional number attribute refers to staff numbers. If absent, the key signature applies to all staves in the part. Key signatures appear at the start of each system unless the print-object attribute has been set to “no”.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, number@ XSDSimpleTypeStaffNumber, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible children: XMLCancel, XMLFifths, XMLKeyAccidental, XMLKeyAlter, XMLKeyOctave, XMLKeyStep, XMLMode

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=1@maxOccurs=1
        Group@name=traditional-key@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=cancel@minOccurs=0@maxOccurs=1
                Element@name=fifths@minOccurs=1@maxOccurs=1
                Element@name=mode@minOccurs=0@maxOccurs=1
        Group@name=non-traditional-key@minOccurs=0@maxOccurs=unbounded
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=key-step@minOccurs=1@maxOccurs=1
                Element@name=key-alter@minOccurs=1@maxOccurs=1
                Element@name=key-accidental@minOccurs=0@maxOccurs=1
    Element@name=key-octave@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeKey

XSD_TREE = XSDTree(tag=element, name=key type=key minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLKeyAccidental(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Non-traditional key signatures are represented using a list of altered tones. The key-accidental element indicates the accidental to be displayed in the key signature, represented in the same manner as the accidental element. It is used for disambiguating microtonal accidentals.

complexType: The key-accidental type indicates the accidental to be displayed in a non-traditional key signature, represented in the same manner as the accidental type without the formatting attributes.

simpleContent: The accidental-value type represents notated accidentals supported by MusicXML. In the MusicXML 2.0 DTD this was a string with values that could be included. The XSD strengthens the data typing to an enumerated list. The quarter- and three-quarters- accidentals are Tartini-style quarter-tone accidentals. The -down and -up accidentals are quarter-tone accidentals that include arrows pointing down or up. The slash- accidentals are used in Turkish classical music. The numbered sharp and flat accidentals are superscripted versions of the accidental signs, used in Turkish folk music. The sori and koron accidentals are microtonal sharp and flat accidentals used in Iranian and Persian music. The other accidental covers accidentals other than those listed here. It is usually used in combination with the smufl attribute to specify a particular SMuFL accidental. The smufl attribute may be used with any accidental value to help specify the appearance of symbols that share the same MusicXML semantics.

Permitted Values: 'sharp', 'natural', 'flat', 'double-sharp', 'sharp-sharp', 'flat-flat', 'natural-sharp', 'natural-flat', 'quarter-flat', 'quarter-sharp', 'three-quarters-flat', 'three-quarters-sharp', 'sharp-down', 'sharp-up', 'natural-down', 'natural-up', 'flat-down', 'flat-up', 'double-sharp-down', 'double-sharp-up', 'flat-flat-down', 'flat-flat-up', 'arrow-down', 'arrow-up', 'triple-sharp', 'triple-flat', 'slash-quarter-sharp', 'slash-sharp', 'slash-flat', 'double-slash-flat', 'sharp-1', 'sharp-2', 'sharp-3', 'sharp-5', 'flat-1', 'flat-2', 'flat-3', 'flat-4', 'sori', 'koron', 'other'

Possible attributes: smufl@ XSDSimpleTypeSmuflAccidentalGlyphName

Possible parents:XMLKey

TYPE: alias of XSDComplexTypeKeyAccidental

XSD_TREE = XSDTree(tag=element, name=key-accidental type=key-accidental minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLKeyAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Non-traditional key signatures are represented using a list of altered tones. The key-alter element represents the alteration for a given pitch step, represented with semitones in the same manner as the alter element.

simpleType: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible parents:XMLKey

TYPE: alias of XSDSimpleTypeSemitones

XSD_TREE = XSDTree(tag=element, name=key-alter type=semitones)

class musicxml.xmlelement.xmlelement.XMLKeyOctave(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The optional list of key-octave elements is used to specify in which octave each element of the key signature appears.

complexType: The key-octave type specifies in which octave an element of a key signature appears. The content specifies the octave value using the same values as the display-octave element. The number attribute is a positive integer that refers to the key signature element in left-to-right order. If the cancel attribute is set to yes, then this number refers to the canceling key signature specified by the cancel element in the parent key element. The cancel attribute cannot be set to yes if there is no corresponding cancel element within the parent key element. It is no by default.

simpleContent: Octaves are represented by the numbers 0 to 9, where 4 indicates the octave started by middle C.

Possible attributes: cancel@ XSDSimpleTypeYesNo, number@ XSDSimpleTypePositiveInteger@required

Possible parents:XMLKey

TYPE: alias of XSDComplexTypeKeyOctave

XSD_TREE = XSDTree(tag=element, name=key-octave type=key-octave minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLKeyStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Non-traditional key signatures are represented using a list of altered tones. The key-step element indicates the pitch step to be altered, represented using the same names as in the step element.

simpleType: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible parents:XMLKey

TYPE: alias of XSDSimpleTypeStep

XSD_TREE = XSDTree(tag=element, name=key-step type=step)

class musicxml.xmlelement.xmlelement.XMLKind(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Kind indicates the type of chord. Degree elements can then add, subtract, or alter from these starting points

The attributes are used to indicate the formatting of the symbol. Since the kind element is the constant in all the harmony-chord groups that can make up a polychord, many formatting attributes are here.

The use-symbols attribute is yes if the kind should be represented when possible with harmony symbols rather than letters and numbers. These symbols include:

major: a triangle, like Unicode 25B3 minor: -, like Unicode 002D augmented: +, like Unicode 002B diminished: °, like Unicode 00B0 half-diminished: ø, like Unicode 00F8

For the major-minor kind, only the minor symbol is used when use-symbols is yes. The major symbol is set using the symbol attribute in the degree-value element. The corresponding degree-alter value will usually be 0 in this case.

The text attribute describes how the kind should be spelled in a score. If use-symbols is yes, the value of the text attribute follows the symbol. The stack-degrees attribute is yes if the degree elements should be stacked above each other. The parentheses-degrees attribute is yes if all the degrees should be in parentheses. The bracket-degrees attribute is yes if all the degrees should be in a bracket. If not specified, these values are implementation-specific. The alignment attributes are for the entire harmony-chord group of which this kind element is a part.

The text attribute may use strings such as “13sus” that refer to both the kind and one or more degree elements. In this case, the corresponding degree elements should have the print-object attribute set to “no” to keep redundant alterations from being displayed.

simpleContent: A kind-value indicates the type of chord. Degree elements can then add, subtract, or alter from these starting points. Values include:

Triads:
major (major third, perfect fifth) minor (minor third, perfect fifth) augmented (major third, augmented fifth) diminished (minor third, diminished fifth)

Sevenths:
dominant (major triad, minor seventh) major-seventh (major triad, major seventh) minor-seventh (minor triad, minor seventh) diminished-seventh (diminished triad, diminished seventh) augmented-seventh (augmented triad, minor seventh) half-diminished (diminished triad, minor seventh) major-minor (minor triad, major seventh)

Sixths:
major-sixth (major triad, added sixth) minor-sixth (minor triad, added sixth)

Ninths:
dominant-ninth (dominant-seventh, major ninth) major-ninth (major-seventh, major ninth) minor-ninth (minor-seventh, major ninth)

11ths (usually as the basis for alteration):
dominant-11th (dominant-ninth, perfect 11th) major-11th (major-ninth, perfect 11th) minor-11th (minor-ninth, perfect 11th)

13ths (usually as the basis for alteration):
dominant-13th (dominant-11th, major 13th) major-13th (major-11th, major 13th) minor-13th (minor-11th, major 13th)

Suspended:
suspended-second (major second, perfect fifth) suspended-fourth (perfect fourth, perfect fifth)

Functional sixths:
Neapolitan Italian French German

Other:
pedal (pedal-point bass) power (perfect fifth) Tristan

The “other” kind is used when the harmony is entirely composed of add elements.

The “none” kind is used to explicitly encode absence of chords or functional harmony. In this case, the root, numeral, or function element has no meaning. When using the root or numeral element, the root-step or numeral-step text attribute should be set to the empty string to keep the root or numeral from being displayed.

Permitted Values: 'major', 'minor', 'augmented', 'diminished', 'dominant', 'major-seventh', 'minor-seventh', 'diminished-seventh', 'augmented-seventh', 'half-diminished', 'major-minor', 'major-sixth', 'minor-sixth', 'dominant-ninth', 'major-ninth', 'minor-ninth', 'dominant-11th', 'major-11th', 'minor-11th', 'dominant-13th', 'major-13th', 'minor-13th', 'suspended-second', 'suspended-fourth', 'Neapolitan', 'Italian', 'French', 'German', 'pedal', 'power', 'Tristan', 'other', 'none'

Possible attributes: bracket_degrees@ XSDSimpleTypeYesNo, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, parentheses_degrees@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, stack_degrees@ XSDSimpleTypeYesNo, text@ XSDSimpleTypeToken, use_symbols@ XSDSimpleTypeYesNo, valign@ XSDSimpleTypeValign

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeKind

XSD_TREE = XSDTree(tag=element, name=kind type=kind)

class musicxml.xmlelement.xmlelement.XMLLaughing(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The laughing element represents a laughing voice.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLLyric

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=laughing type=empty)

class musicxml.xmlelement.xmlelement.XMLLeftDivider(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty-print-style-align-object type represents an empty element with print-object and print-style-align attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible parents:XMLSystemDividers

TYPE: alias of XSDComplexTypeEmptyPrintObjectStyleAlign

XSD_TREE = XSDTree(tag=element, name=left-divider type=empty-print-object-style-align)

class musicxml.xmlelement.xmlelement.XMLLeftMargin(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLPageMargins, XMLSystemMargins

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=left-margin type=tenths)

class musicxml.xmlelement.xmlelement.XMLLevel(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The level type is used to specify editorial information for different MusicXML elements. The content contains identifying and/or descriptive text about the editorial status of the parent element.

If the reference attribute is yes, this indicates editorial information that is for display only and should not affect playback. For instance, a modern edition of older music may set reference=”yes” on the attributes containing the music’s original clef, key, and time signature. It is no if not specified.

The type attribute indicates whether the editorial information applies to the start of a series of symbols, the end of a series of symbols, or a single symbol. It is single if not specified for compatibility with earlier MusicXML versions.

Possible attributes: bracket@ XSDSimpleTypeYesNo, parentheses@ XSDSimpleTypeYesNo, reference@ XSDSimpleTypeYesNo, size@ XSDSimpleTypeSymbolSize, type@ XSDSimpleTypeStartStopSingle

Possible parents:XMLAttributes, XMLBackup, XMLBarline, XMLDirection, XMLFigure, XMLFiguredBass, XMLForward, XMLHarmony, XMLLyric, XMLNotations, XMLNote, XMLPartGroup

TYPE: alias of XSDComplexTypeLevel

XSD_TREE = XSDTree(tag=element, name=level type=level)

class musicxml.xmlelement.xmlelement.XMLLine(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Line numbers are counted from the bottom of the staff. They are only needed with the G, F, and C signs in order to position a pitch correctly on the staff. Standard values are 2 for the G sign (treble clef), 4 for the F sign (bass clef), and 3 for the C sign (alto clef). Line values can be used to specify positions outside the staff, such as a C clef positioned in the middle of a grand staff.

simpleType: The staff-line-position type indicates the line position on a given staff. Staff lines are numbered from bottom to top, with 1 being the bottom line on a staff. A staff-line-position value can extend beyond the range of the lines on the current staff.

Possible parents:XMLClef, XMLPartClef

TYPE: alias of XSDSimpleTypeStaffLinePosition

XSD_TREE = XSDTree(tag=element, name=line type=staff-line-position minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLLineDetail(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: If the staff-lines element is present, the appearance of each line may be individually specified with a line-detail type. Staff lines are numbered from bottom to top. The print-object attribute allows lines to be hidden within a staff. This is used in special situations such as a widely-spaced percussion staff where a note placed below the higher line is distinct from a note placed above the lower line. Hidden staff lines are included when specifying clef lines and determining display-step / display-octave values, but are not counted as lines for the purposes of the system-layout and staff-layout elements.

Possible attributes: color@ XSDSimpleTypeColor, line_type@ XSDSimpleTypeLineType, line@ XSDSimpleTypeStaffLine@required, print_object@ XSDSimpleTypeYesNo, width@ XSDSimpleTypeTenths

Possible parents:XMLStaffDetails

TYPE: alias of XSDComplexTypeLineDetail

XSD_TREE = XSDTree(tag=element, name=line-detail type=line-detail minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLLineWidth(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The line-width type indicates the width of a line type in tenths. The type attribute defines what type of line is being defined. Values include beam, bracket, dashes, enclosure, ending, extend, heavy barline, leger, light barline, octave shift, pedal, slur middle, slur tip, staff, stem, tie middle, tie tip, tuplet bracket, and wedge. The text content is expressed in tenths.

simpleContent: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible attributes: type@ XSDSimpleTypeLineWidthType@required

Possible parents:XMLAppearance

TYPE: alias of XSDComplexTypeLineWidth

XSD_TREE = XSDTree(tag=element, name=line-width type=line-width minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLLink(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The link type serves as an outgoing simple XLink. If a relative link is used within a document that is part of a compressed MusicXML file, the link is relative to the root folder of the zip file.

Possible parents:XMLCredit, XMLMeasure

TYPE: alias of XSDComplexTypeLink

XSD_TREE = XSDTree(tag=element, name=link type=link)

class musicxml.xmlelement.xmlelement.XMLListen(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The listen and listening types, new in Version 4.0, specify different ways that a score following or machine listening application can interact with a performer. The listen type handles interactions that are specific to a note. If multiple child elements of the same type are present, they should have distinct player and/or time-only attributes.

Possible children: XMLAssess, XMLOtherListen, XMLWait

XSD structure:
Choice@minOccurs=1@maxOccurs=unbounded
    Element@name=assess@minOccurs=1@maxOccurs=1
    Element@name=wait@minOccurs=1@maxOccurs=1
    Element@name=other-listen@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeListen

XSD_TREE = XSDTree(tag=element, name=listen type=listen minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLListening(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The listen and listening types, new in Version 4.0, specify different ways that a score following or machine listening application can interact with a performer. The listening type handles interactions that change the state of the listening application from the specified point in the performance onward. If multiple child elements of the same type are present, they should have distinct player and/or time-only attributes.

The offset element is used to indicate that the listening change takes place offset from the current score position. If the listening element is a child of a direction element, the listening offset element overrides the direction offset element if both elements are present. Note that the offset reflects the intended musical position for the change in state. It should not be used to compensate for latency issues in particular hardware configurations.

Possible children: XMLOffset, XMLOtherListening, XMLSync

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=1@maxOccurs=unbounded
        Element@name=sync@minOccurs=1@maxOccurs=1
        Element@name=other-listening@minOccurs=1@maxOccurs=1
    Element@name=offset@minOccurs=0@maxOccurs=1

Possible parents:XMLDirection, XMLMeasure

TYPE: alias of XSDComplexTypeListening

XSD_TREE = XSDTree(tag=element, name=listening type=listening)

class musicxml.xmlelement.xmlelement.XMLLyric(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The lyric type represents text underlays for lyrics. Two text elements that are not separated by an elision element are part of the same syllable, but may have different text formatting. The MusicXML XSD is more strict than the DTD in enforcing this by disallowing a second syllabic element unless preceded by an elision element. The lyric number indicates multiple lines, though a name can be used as well. Common name examples are verse and chorus.

Justification is center by default; placement is below by default. Vertical alignment is to the baseline of the text and horizontal alignment matches justification. The print-object attribute can override a note’s print-lyric attribute in cases where only some lyrics on a note are printed, as when lyrics for later verses are printed in a block of text rather than with each note. The time-only attribute precisely specifies which lyrics are to be sung which time through a repeated section.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, justify@ XSDSimpleTypeLeftCenterRight, name@ XSDSimpleTypeToken, number@ XSDSimpleTypeNMTOKEN, placement@ XSDSimpleTypeAboveBelow, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, time_only@ XSDSimpleTypeTimeOnly

Possible children: XMLElision, XMLEndLine, XMLEndParagraph, XMLExtend, XMLFootnote, XMLHumming, XMLLaughing, XMLLevel, XMLSyllabic, XMLText

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=syllabic@minOccurs=0@maxOccurs=1
            Element@name=text@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=0@maxOccurs=unbounded
                Sequence@minOccurs=0@maxOccurs=1
                    Element@name=elision@minOccurs=1@maxOccurs=1
                    Element@name=syllabic@minOccurs=0@maxOccurs=1
                Element@name=text@minOccurs=1@maxOccurs=1
            Element@name=extend@minOccurs=0@maxOccurs=1
        Element@name=extend@minOccurs=1@maxOccurs=1
        Element@name=laughing@minOccurs=1@maxOccurs=1
        Element@name=humming@minOccurs=1@maxOccurs=1
    Element@name=end-line@minOccurs=0@maxOccurs=1
    Element@name=end-paragraph@minOccurs=0@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeLyric

XSD_TREE = XSDTree(tag=element, name=lyric type=lyric minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLLyricFont(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The lyric-font type specifies the default font for a particular name and number of lyric.

Possible attributes: font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, name@ XSDSimpleTypeToken, number@ XSDSimpleTypeNMTOKEN

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeLyricFont

XSD_TREE = XSDTree(tag=element, name=lyric-font type=lyric-font minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLLyricLanguage(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The lyric-language type specifies the default language for a particular name and number of lyric.

Possible attributes: lang@ XSDSimpleTypeLanguage, name@ XSDSimpleTypeToken, number@ XSDSimpleTypeNMTOKEN

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeLyricLanguage

XSD_TREE = XSDTree(tag=element, name=lyric-language type=lyric-language minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMeasure(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible attributes: id@ XSDSimpleTypeID, implicit@ XSDSimpleTypeYesNo, non_controlling@ XSDSimpleTypeYesNo, number@ XSDSimpleTypeToken@required, text@ XSDSimpleTypeMeasureText, width@ XSDSimpleTypeTenths

Possible children: XMLAttributes, XMLBackup, XMLBarline, XMLBookmark, XMLDirection, XMLFiguredBass, XMLForward, XMLGrouping, XMLHarmony, XMLLink, XMLListening, XMLNote, XMLPrint, XMLSound

XSD structure:

Group@name=music-data@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Choice@minOccurs=0@maxOccurs=unbounded
            Element@name=note@minOccurs=1@maxOccurs=1
            Element@name=backup@minOccurs=1@maxOccurs=1
            Element@name=forward@minOccurs=1@maxOccurs=1
            Element@name=direction@minOccurs=1@maxOccurs=1
            Element@name=attributes@minOccurs=1@maxOccurs=1
            Element@name=harmony@minOccurs=1@maxOccurs=1
            Element@name=figured-bass@minOccurs=1@maxOccurs=1
            Element@name=print@minOccurs=1@maxOccurs=1
            Element@name=sound@minOccurs=1@maxOccurs=1
            Element@name=listening@minOccurs=1@maxOccurs=1
            Element@name=barline@minOccurs=1@maxOccurs=1
            Element@name=grouping@minOccurs=1@maxOccurs=1
            Element@name=link@minOccurs=1@maxOccurs=1
            Element@name=bookmark@minOccurs=1@maxOccurs=1

Possible parents:XMLPart

TYPE: alias of XSDComplexTypeMeasure

XSD_TREE = XSDTree(tag=element, name=measure maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMeasureDistance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The measure-distance element specifies the horizontal distance from the previous measure. This value is only used for systems where there is horizontal whitespace in the middle of a system, as in systems with codas. To specify the measure width, use the width attribute of the measure element.

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLMeasureLayout

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=measure-distance type=tenths minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMeasureLayout(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The measure-layout type includes the horizontal distance from the previous measure. It applies to the current measure only.

Possible children: XMLMeasureDistance

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=measure-distance@minOccurs=0@maxOccurs=1

Possible parents:XMLPrint

TYPE: alias of XSDComplexTypeMeasureLayout

XSD_TREE = XSDTree(tag=element, name=measure-layout type=measure-layout minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMeasureNumbering(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The measure-numbering type describes how frequently measure numbers are displayed on this part. The text attribute from the measure element is used for display, or the number attribute if the text attribute is not present. Measures with an implicit attribute set to “yes” never display a measure number, regardless of the measure-numbering setting.

The optional staff attribute refers to staff numbers within the part, from top to bottom on the system. It indicates which staff is used as the reference point for vertical positioning. A value of 1 is assumed if not present.

The optional multiple-rest-always and multiple-rest-range attributes describe how measure numbers are shown on multiple rests when the measure-numbering value is not set to none. The multiple-rest-always attribute is set to yes when the measure number should always be shown, even if the multiple rest starts midway through a system when measure numbering is set to system level. The multiple-rest-range attribute is set to yes when measure numbers on multiple rests display the range of numbers for the first and last measure, rather than just the number of the first measure.

simpleContent: The measure-numbering-value type describes how measure numbers are displayed on this part: no numbers, numbers every measure, or numbers every system.

Permitted Values: 'none', 'measure', 'system'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, multiple_rest_always@ XSDSimpleTypeYesNo, multiple_rest_range@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, staff@ XSDSimpleTypeStaffNumber, system@ XSDSimpleTypeSystemRelationNumber, valign@ XSDSimpleTypeValign

Possible parents:XMLPrint

TYPE: alias of XSDComplexTypeMeasureNumbering

XSD_TREE = XSDTree(tag=element, name=measure-numbering type=measure-numbering minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMeasureRepeat(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The measure-repeat type is used for both single and multiple measure repeats. The text of the element indicates the number of measures to be repeated in a single pattern. The slashes attribute specifies the number of slashes to use in the repeat sign. It is 1 if not specified. The text of the element is ignored when the type is stop.

The stop type indicates the first measure where the repeats are no longer displayed. Both the start and the stop of the measure-repeat should be specified unless the repeats are displayed through the end of the part.

The measure-repeat element specifies a notation style for repetitions. The actual music being repeated needs to be repeated within each measure of the MusicXML file. This element specifies the notation that indicates the repeat.

Possible attributes: slashes@ XSDSimpleTypePositiveInteger, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLMeasureStyle

TYPE: alias of XSDComplexTypeMeasureRepeat

XSD_TREE = XSDTree(tag=element, name=measure-repeat type=measure-repeat)

class musicxml.xmlelement.xmlelement.XMLMeasureStyle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

A measure-style indicates a special way to print partial to multiple measures within a part. This includes multiple rests over several measures, repeats of beats, single, or multiple measures, and use of slash notation.

complexType: A measure-style indicates a special way to print partial to multiple measures within a part. This includes multiple rests over several measures, repeats of beats, single, or multiple measures, and use of slash notation.

The multiple-rest and measure-repeat elements indicate the number of measures covered in the element content. The beat-repeat and slash elements can cover partial measures. All but the multiple-rest element use a type attribute to indicate starting and stopping the use of the style. The optional number attribute specifies the staff number from top to bottom on the system, as with clef.

Possible attributes: color@ XSDSimpleTypeColor, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, number@ XSDSimpleTypeStaffNumber

Possible children: XMLBeatRepeat, XMLMeasureRepeat, XMLMultipleRest, XMLSlash

XSD structure:
Choice@minOccurs=1@maxOccurs=1
    Element@name=multiple-rest@minOccurs=1@maxOccurs=1
    Element@name=measure-repeat@minOccurs=1@maxOccurs=1
    Element@name=beat-repeat@minOccurs=1@maxOccurs=1
    Element@name=slash@minOccurs=1@maxOccurs=1

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeMeasureStyle

XSD_TREE = XSDTree(tag=element, name=measure-style type=measure-style minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMembrane(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The membrane type represents pictograms for membrane percussion instruments. The smufl attribute is used to distinguish different SMuFL stylistic alternates.

simpleContent: The membrane-value type represents pictograms for membrane percussion instruments.

Permitted Values: 'bass drum', 'bass drum on side', 'bongos', 'Chinese tomtom', 'conga drum', 'cuica', 'goblet drum', 'Indo-American tomtom', 'Japanese tomtom', 'military drum', 'snare drum', 'snare drum snares off', 'tabla', 'tambourine', 'tenor drum', 'timbales', 'tomtom'

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeMembrane

XSD_TREE = XSDTree(tag=element, name=membrane type=membrane)

class musicxml.xmlelement.xmlelement.XMLMetal(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The metal type represents pictograms for metal percussion instruments. The smufl attribute is used to distinguish different SMuFL stylistic alternates.

simpleContent: The metal-value type represents pictograms for metal percussion instruments. The hi-hat value refers to a pictogram like Stone’s high-hat cymbals but without the long vertical line at the bottom.

Permitted Values: 'agogo', 'almglocken', 'bell', 'bell plate', 'bell tree', 'brake drum', 'cencerro', 'chain rattle', 'Chinese cymbal', 'cowbell', 'crash cymbals', 'crotale', 'cymbal tongs', 'domed gong', 'finger cymbals', 'flexatone', 'gong', 'hi-hat', 'high-hat cymbals', 'handbell', 'jaw harp', 'jingle bells', 'musical saw', 'shell bells', 'sistrum', 'sizzle cymbal', 'sleigh bells', 'suspended cymbal', 'tam tam', 'tam tam with beater', 'triangle', 'Vietnamese hat'

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeMetal

XSD_TREE = XSDTree(tag=element, name=metal type=metal)

class musicxml.xmlelement.xmlelement.XMLMetronome(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The metronome type represents metronome marks and other metric relationships. The beat-unit group and per-minute element specify regular metronome marks. The metronome-note and metronome-relation elements allow for the specification of metric modulations and other metric relationships, such as swing tempo marks where two eighths are equated to a quarter note / eighth note triplet. Tied notes can be represented in both types of metronome marks by using the beat-unit-tied and metronome-tied elements. The parentheses attribute indicates whether or not to put the metronome mark in parentheses; its value is no if not specified. The print-object attribute is set to no in cases where the metronome element represents a relationship or range that is not displayed in the music notation.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, justify@ XSDSimpleTypeLeftCenterRight, parentheses@ XSDSimpleTypeYesNo, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible children: XMLBeatUnitDot, XMLBeatUnitTied, XMLBeatUnit, XMLMetronomeArrows, XMLMetronomeNote, XMLMetronomeRelation, XMLPerMinute

XSD structure:
Choice@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Group@name=beat-unit@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=beat-unit@minOccurs=1@maxOccurs=1
                Element@name=beat-unit-dot@minOccurs=0@maxOccurs=unbounded
        Element@name=beat-unit-tied@minOccurs=0@maxOccurs=unbounded
        Choice@minOccurs=1@maxOccurs=1
            Element@name=per-minute@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=1@maxOccurs=1
                Group@name=beat-unit@minOccurs=1@maxOccurs=1
                    Sequence@minOccurs=1@maxOccurs=1
                        Element@name=beat-unit@minOccurs=1@maxOccurs=1
                        Element@name=beat-unit-dot@minOccurs=0@maxOccurs=unbounded
                Element@name=beat-unit-tied@minOccurs=0@maxOccurs=unbounded
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=metronome-arrows@minOccurs=0@maxOccurs=1
        Element@name=metronome-note@minOccurs=1@maxOccurs=unbounded
        Sequence@minOccurs=0@maxOccurs=1
            Element@name=metronome-relation@minOccurs=1@maxOccurs=1
            Element@name=metronome-note@minOccurs=1@maxOccurs=unbounded

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeMetronome

XSD_TREE = XSDTree(tag=element, name=metronome type=metronome)

class musicxml.xmlelement.xmlelement.XMLMetronomeArrows(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

If the metronome-arrows element is present, it indicates that metric modulation arrows are displayed on both sides of the metronome mark.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLMetronome

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=metronome-arrows type=empty minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMetronomeBeam(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The metronome-beam type works like the beam type in defining metric relationships, but does not include all the attributes available in the beam type.

simpleContent: The beam-value type represents the type of beam associated with each of 8 beam levels (up to 1024th notes) available for each note.

Permitted Values: 'begin', 'continue', 'end', 'forward hook', 'backward hook'

Possible attributes: number@ XSDSimpleTypeBeamLevel

Possible parents:XMLMetronomeNote

TYPE: alias of XSDComplexTypeMetronomeBeam

XSD_TREE = XSDTree(tag=element, name=metronome-beam type=metronome-beam minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMetronomeDot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The metronome-dot element works like the dot element in defining metric relationships.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLMetronomeNote

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=metronome-dot type=empty minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMetronomeNote(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The metronome-note type defines the appearance of a note within a metric relationship mark.

Possible children: XMLMetronomeBeam, XMLMetronomeDot, XMLMetronomeTied, XMLMetronomeTuplet, XMLMetronomeType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=metronome-type@minOccurs=1@maxOccurs=1
    Element@name=metronome-dot@minOccurs=0@maxOccurs=unbounded
    Element@name=metronome-beam@minOccurs=0@maxOccurs=unbounded
    Element@name=metronome-tied@minOccurs=0@maxOccurs=1
    Element@name=metronome-tuplet@minOccurs=0@maxOccurs=1

Possible parents:XMLMetronome

TYPE: alias of XSDComplexTypeMetronomeNote

XSD_TREE = XSDTree(tag=element, name=metronome-note type=metronome-note maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMetronomeRelation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The metronome-relation element describes the relationship symbol that goes between the two sets of metronome-note elements. The currently allowed value is equals, but this may expand in future versions. If the element is empty, the equals value is used.

Possible parents:XMLMetronome

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=metronome-relation type=xs:string)

class musicxml.xmlelement.xmlelement.XMLMetronomeTied(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The metronome-tied indicates the presence of a tie within a metric relationship mark. As with the tied element, both the start and stop of the tie should be specified, in this case within separate metronome-note elements.

Possible attributes: type@ XSDSimpleTypeStartStop@required

Possible parents:XMLMetronomeNote

TYPE: alias of XSDComplexTypeMetronomeTied

XSD_TREE = XSDTree(tag=element, name=metronome-tied type=metronome-tied minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMetronomeTuplet(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The metronome-tuplet type uses the same element structure as the time-modification element along with some attributes from the tuplet element.

Possible attributes: bracket@ XSDSimpleTypeYesNo, show_number@ XSDSimpleTypeShowTuplet, type@ XSDSimpleTypeStartStop@required

Possible children: XMLActualNotes, XMLNormalDot, XMLNormalNotes, XMLNormalType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=actual-notes@minOccurs=1@maxOccurs=1
    Element@name=normal-notes@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=0@maxOccurs=1
        Element@name=normal-type@minOccurs=1@maxOccurs=1
        Element@name=normal-dot@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLMetronomeNote

TYPE: alias of XSDComplexTypeMetronomeTuplet

XSD_TREE = XSDTree(tag=element, name=metronome-tuplet type=metronome-tuplet minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMetronomeType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The metronome-type element works like the type element in defining metric relationships.

simpleType: The note-type-value type is used for the MusicXML type element and represents the graphic note type, from 1024th (shortest) to maxima (longest).

Permitted Values: '1024th', '512th', '256th', '128th', '64th', '32nd', '16th', 'eighth', 'quarter', 'half', 'whole', 'breve', 'long', 'maxima'

Possible parents:XMLMetronomeNote

TYPE: alias of XSDSimpleTypeNoteTypeValue

XSD_TREE = XSDTree(tag=element, name=metronome-type type=note-type-value)

class musicxml.xmlelement.xmlelement.XMLMf(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=mf type=empty)

class musicxml.xmlelement.xmlelement.XMLMidiBank(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The midi-bank element specifies a MIDI 1.0 bank number ranging from 1 to 16,384.

simpleType: The midi-16384 type is used to express MIDI 1.0 values that range from 1 to 16,384.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeMidi16384

XSD_TREE = XSDTree(tag=element, name=midi-bank type=midi-16384 minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMidiChannel(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The midi-channel element specifies a MIDI 1.0 channel numbers ranging from 1 to 16.

simpleType: The midi-16 type is used to express MIDI 1.0 values that range from 1 to 16.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeMidi16

XSD_TREE = XSDTree(tag=element, name=midi-channel type=midi-16 minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMidiDevice(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The midi-device type corresponds to the DeviceName meta event in Standard MIDI Files. The optional port attribute is a number from 1 to 16 that can be used with the unofficial MIDI 1.0 port (or cable) meta event. Unlike the DeviceName meta event, there can be multiple midi-device elements per MusicXML part. The optional id attribute refers to the score-instrument assigned to this device. If missing, the device assignment affects all score-instrument elements in the score-part.

Possible attributes: id@ XSDSimpleTypeIDREF, port@ XSDSimpleTypeMidi16

Possible parents:XMLScorePart, XMLSound

TYPE: alias of XSDComplexTypeMidiDevice

XSD_TREE = XSDTree(tag=element, name=midi-device type=midi-device minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMidiInstrument(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The midi-instrument type defines MIDI 1.0 instrument playback. The midi-instrument element can be a part of either the score-instrument element at the start of a part, or the sound element within a part. The id attribute refers to the score-instrument affected by the change.

Possible attributes: id@ XSDSimpleTypeIDREF@required

Possible children: XMLElevation, XMLMidiBank, XMLMidiChannel, XMLMidiName, XMLMidiProgram, XMLMidiUnpitched, XMLPan, XMLVolume

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=midi-channel@minOccurs=0@maxOccurs=1
    Element@name=midi-name@minOccurs=0@maxOccurs=1
    Element@name=midi-bank@minOccurs=0@maxOccurs=1
    Element@name=midi-program@minOccurs=0@maxOccurs=1
    Element@name=midi-unpitched@minOccurs=0@maxOccurs=1
    Element@name=volume@minOccurs=0@maxOccurs=1
    Element@name=pan@minOccurs=0@maxOccurs=1
    Element@name=elevation@minOccurs=0@maxOccurs=1

Possible parents:XMLScorePart, XMLSound

TYPE: alias of XSDComplexTypeMidiInstrument

XSD_TREE = XSDTree(tag=element, name=midi-instrument type=midi-instrument minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMidiName(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The midi-name element corresponds to a ProgramName meta-event within a Standard MIDI File.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=midi-name type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMidiProgram(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The midi-program element specifies a MIDI 1.0 program number ranging from 1 to 128.

simpleType: The midi-128 type is used to express MIDI 1.0 values that range from 1 to 128.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeMidi128

XSD_TREE = XSDTree(tag=element, name=midi-program type=midi-128 minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMidiUnpitched(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

For unpitched instruments, the midi-unpitched element specifies a MIDI 1.0 note number ranging from 1 to 128. It is usually used with MIDI banks for percussion. Note that MIDI 1.0 note numbers are generally specified from 0 to 127 rather than the 1 to 128 numbering used in this element.

simpleType: The midi-128 type is used to express MIDI 1.0 values that range from 1 to 128.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeMidi128

XSD_TREE = XSDTree(tag=element, name=midi-unpitched type=midi-128 minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMillimeters(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The millimeters type is a number representing millimeters. This is used in the scaling element to provide a default scaling from tenths to physical units.

Possible parents:XMLScaling

TYPE: alias of XSDSimpleTypeMillimeters

XSD_TREE = XSDTree(tag=element, name=millimeters type=millimeters)

class musicxml.xmlelement.xmlelement.XMLMiscellaneous(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: If a program has other metadata not yet supported in the MusicXML format, it can go in the miscellaneous element. The miscellaneous type puts each separate part of metadata into its own miscellaneous-field type.

Possible children: XMLMiscellaneousField

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=miscellaneous-field@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLIdentification

TYPE: alias of XSDComplexTypeMiscellaneous

XSD_TREE = XSDTree(tag=element, name=miscellaneous type=miscellaneous minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMiscellaneousField(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: If a program has other metadata not yet supported in the MusicXML format, each type of metadata can go in a miscellaneous-field element. The required name attribute indicates the type of metadata the element content represents.

Possible attributes: name@ XSDSimpleTypeToken@required

Possible parents:XMLMiscellaneous

TYPE: alias of XSDComplexTypeMiscellaneousField

XSD_TREE = XSDTree(tag=element, name=miscellaneous-field type=miscellaneous-field minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLMode(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The mode type is used to specify major/minor and other mode distinctions. Valid mode values include major, minor, dorian, phrygian, lydian, mixolydian, aeolian, ionian, locrian, and none.

Possible parents:XMLKey

TYPE: alias of XSDSimpleTypeMode

XSD_TREE = XSDTree(tag=element, name=mode type=mode minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMordent(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The mordent element represents the sign with the vertical line. The choice of which mordent sign is inverted differs between MusicXML and SMuFL. The long attribute is “no” by default.

complexType: The mordent type is used for both represents the mordent sign with the vertical line and the inverted-mordent sign without the line. The long attribute is “no” by default. The approach and departure attributes are used for compound ornaments, indicating how the beginning and ending of the ornament look relative to the main part of the mordent.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, approach@ XSDSimpleTypeAboveBelow, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, departure@ XSDSimpleTypeAboveBelow, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, long@ XSDSimpleTypeYesNo, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeMordent

XSD_TREE = XSDTree(tag=element, name=mordent type=mordent)

class musicxml.xmlelement.xmlelement.XMLMovementNumber(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The movement-number element specifies the number of a movement.

Possible parents:XMLScorePartwise

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=movement-number type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMovementTitle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The movement-title element specifies the title of a movement, not including its number.

Possible parents:XMLScorePartwise

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=movement-title type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=mp type=empty)

class musicxml.xmlelement.xmlelement.XMLMultipleRest(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The text of the multiple-rest type indicates the number of measures in the multiple rest. Multiple rests may use the 1-bar / 2-bar / 4-bar rest symbols, or a single shape. The use-symbols attribute indicates which to use; it is no if not specified.

Possible attributes: use_symbols@ XSDSimpleTypeYesNo

Possible parents:XMLMeasureStyle

TYPE: alias of XSDComplexTypeMultipleRest

XSD_TREE = XSDTree(tag=element, name=multiple-rest type=multiple-rest)

class musicxml.xmlelement.xmlelement.XMLMusicFont(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty-font type represents an empty element with font attributes.

Possible attributes: font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeEmptyFont

XSD_TREE = XSDTree(tag=element, name=music-font type=empty-font minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLMute(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The mute type represents muting for different instruments, including brass, winds, and strings. The on and off values are used for undifferentiated mutes. The remaining values represent specific mutes.

Permitted Values: 'on', 'off', 'straight', 'cup', 'harmon-no-stem', 'harmon-stem', 'bucket', 'plunger', 'hat', 'solotone', 'practice', 'stop-mute', 'stop-hand', 'echo', 'palm'

Possible parents:XMLPlay

TYPE: alias of XSDSimpleTypeMute

XSD_TREE = XSDTree(tag=element, name=mute type=mute)

class musicxml.xmlelement.xmlelement.XMLN(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=n type=empty)

class musicxml.xmlelement.xmlelement.XMLNatural(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The natural element indicates that this is a natural harmonic. These are usually notated at base pitch rather than sounding pitch.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLHarmonic

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=natural type=empty)

class musicxml.xmlelement.xmlelement.XMLNonArpeggiate(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The non-arpeggiate type indicates that this note is at the top or bottom of a bracket indicating to not arpeggiate these notes. Since this does not involve playback, it is only used on the top or bottom notes, not on each note as for the arpeggiate type.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeTopBottom@required

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeNonArpeggiate

XSD_TREE = XSDTree(tag=element, name=non-arpeggiate type=non-arpeggiate)

class musicxml.xmlelement.xmlelement.XMLNormalDot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The normal-dot element is used to specify dotted normal tuplet types.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLMetronomeTuplet, XMLTimeModification

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=normal-dot type=empty minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLNormalNotes(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The normal-notes element describes how many notes are usually played in the time occupied by the number in the actual-notes element.

Possible parents:XMLMetronomeTuplet, XMLTimeModification

TYPE: alias of XSDSimpleTypeNonNegativeInteger

XSD_TREE = XSDTree(tag=element, name=normal-notes type=xs:nonNegativeInteger)

class musicxml.xmlelement.xmlelement.XMLNormalType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

If the type associated with the number in the normal-notes element is different than the current note type (e.g., a quarter note within an eighth note triplet), then the normal-notes type (e.g. eighth) is specified in the normal-type and normal-dot elements.

simpleType: The note-type-value type is used for the MusicXML type element and represents the graphic note type, from 1024th (shortest) to maxima (longest).

Permitted Values: '1024th', '512th', '256th', '128th', '64th', '32nd', '16th', 'eighth', 'quarter', 'half', 'whole', 'breve', 'long', 'maxima'

Possible parents:XMLMetronomeTuplet, XMLTimeModification

TYPE: alias of XSDSimpleTypeNoteTypeValue

XSD_TREE = XSDTree(tag=element, name=normal-type type=note-type-value)

class musicxml.xmlelement.xmlelement.XMLNotations(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Notations refer to musical notations, not XML notations. Multiple notations are allowed in order to represent multiple editorial levels. The print-object attribute, added in Version 3.0, allows notations to represent details of performance technique, such as fingerings, without having them appear in the score.

Possible attributes: id@ XSDSimpleTypeID, print_object@ XSDSimpleTypeYesNo

Possible children: XMLAccidentalMark, XMLArpeggiate, XMLArticulations, XMLDynamics, XMLFermata, XMLFootnote, XMLGlissando, XMLLevel, XMLNonArpeggiate, XMLOrnaments, XMLOtherNotation, XMLSlide, XMLSlur, XMLTechnical, XMLTied, XMLTuplet

XSD structure:

Sequence@minOccurs=1@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Element@name=tied@minOccurs=1@maxOccurs=1
        Element@name=slur@minOccurs=1@maxOccurs=1
        Element@name=tuplet@minOccurs=1@maxOccurs=1
        Element@name=glissando@minOccurs=1@maxOccurs=1
        Element@name=slide@minOccurs=1@maxOccurs=1
        Element@name=ornaments@minOccurs=1@maxOccurs=1
        Element@name=technical@minOccurs=1@maxOccurs=1
        Element@name=articulations@minOccurs=1@maxOccurs=1
        Element@name=dynamics@minOccurs=1@maxOccurs=1
        Element@name=fermata@minOccurs=1@maxOccurs=1
        Element@name=arpeggiate@minOccurs=1@maxOccurs=1
        Element@name=non-arpeggiate@minOccurs=1@maxOccurs=1
        Element@name=accidental-mark@minOccurs=1@maxOccurs=1
        Element@name=other-notation@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeNotations

XSD_TREE = XSDTree(tag=element, name=notations type=notations minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLNote(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Notes are the most common type of MusicXML data. The MusicXML format distinguishes between elements used for sound information and elements used for notation information (e.g., tie is used for sound, tied for notation). Thus grace notes do not have a duration element. Cue notes have a duration element, as do forward elements, but no tie elements. Having these two types of information available can make interchange easier, as some programs handle one type of information more readily than the other.

The print-leger attribute is used to indicate whether leger lines are printed. Notes without leger lines are used to indicate indeterminate high and low notes. By default, it is set to yes. If print-object is set to no, print-leger is interpreted to also be set to no if not present. This attribute is ignored for rests.

The dynamics and end-dynamics attributes correspond to MIDI 1.0’s Note On and Note Off velocities, respectively. They are expressed in terms of percentages of the default forte value (90 for MIDI 1.0).

The attack and release attributes are used to alter the starting and stopping time of the note from when it would otherwise occur based on the flow of durations - information that is specific to a performance. They are expressed in terms of divisions, either positive or negative. A note that starts a tie should not have a release attribute, and a note that stops a tie should not have an attack attribute. The attack and release attributes are independent of each other. The attack attribute only changes the starting time of a note, and the release attribute only changes the stopping time of a note.

If a note is played only particular times through a repeat, the time-only attribute shows which times to play the note.

The pizzicato attribute is used when just this note is sounded pizzicato, vs. the pizzicato element which changes overall playback between pizzicato and arco.

Possible attributes: attack@ XSDSimpleTypeDivisions, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, dynamics@ XSDSimpleTypeNonNegativeDecimal, end_dynamics@ XSDSimpleTypeNonNegativeDecimal, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, pizzicato@ XSDSimpleTypeYesNo, print_dot@ XSDSimpleTypeYesNo, print_leger@ XSDSimpleTypeYesNo, print_lyric@ XSDSimpleTypeYesNo, print_object@ XSDSimpleTypeYesNo, print_spacing@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, release@ XSDSimpleTypeDivisions, time_only@ XSDSimpleTypeTimeOnly

Possible children: XMLAccidental, XMLBeam, XMLChord, XMLCue, XMLDot, XMLDuration, XMLFootnote, XMLGrace, XMLInstrument, XMLLevel, XMLListen, XMLLyric, XMLNotations, XMLNoteheadText, XMLNotehead, XMLPitch, XMLPlay, XMLRest, XMLStaff, XMLStem, XMLTie, XMLTimeModification, XMLType, XMLUnpitched, XMLVoice

XSD structure:

Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=full-note@minOccurs=1@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=chord@minOccurs=0@maxOccurs=1
                    Choice@minOccurs=1@maxOccurs=1
                        Element@name=pitch@minOccurs=1@maxOccurs=1
                        Element@name=unpitched@minOccurs=1@maxOccurs=1
                        Element@name=rest@minOccurs=1@maxOccurs=1
            Group@name=duration@minOccurs=1@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=duration@minOccurs=1@maxOccurs=1
            Element@name=tie@minOccurs=0@maxOccurs=2
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=cue@minOccurs=1@maxOccurs=1
            Group@name=full-note@minOccurs=1@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=chord@minOccurs=0@maxOccurs=1
                    Choice@minOccurs=1@maxOccurs=1
                        Element@name=pitch@minOccurs=1@maxOccurs=1
                        Element@name=unpitched@minOccurs=1@maxOccurs=1
                        Element@name=rest@minOccurs=1@maxOccurs=1
            Group@name=duration@minOccurs=1@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=duration@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=grace@minOccurs=1@maxOccurs=1
            Choice@minOccurs=1@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Group@name=full-note@minOccurs=1@maxOccurs=1
                        Sequence@minOccurs=1@maxOccurs=1
                            Element@name=chord@minOccurs=0@maxOccurs=1
                            Choice@minOccurs=1@maxOccurs=1
                                Element@name=pitch@minOccurs=1@maxOccurs=1
                                Element@name=unpitched@minOccurs=1@maxOccurs=1
                                Element@name=rest@minOccurs=1@maxOccurs=1
                    Element@name=tie@minOccurs=0@maxOccurs=2
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=cue@minOccurs=1@maxOccurs=1
                    Group@name=full-note@minOccurs=1@maxOccurs=1
                        Sequence@minOccurs=1@maxOccurs=1
                            Element@name=chord@minOccurs=0@maxOccurs=1
                            Choice@minOccurs=1@maxOccurs=1
                                Element@name=pitch@minOccurs=1@maxOccurs=1
                                Element@name=unpitched@minOccurs=1@maxOccurs=1
                                Element@name=rest@minOccurs=1@maxOccurs=1
    Element@name=instrument@minOccurs=0@maxOccurs=unbounded
    Group@name=editorial-voice@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1
            Group@name=voice@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=voice@minOccurs=1@maxOccurs=1
    Element@name=type@minOccurs=0@maxOccurs=1
    Element@name=dot@minOccurs=0@maxOccurs=unbounded
    Element@name=accidental@minOccurs=0@maxOccurs=1
    Element@name=time-modification@minOccurs=0@maxOccurs=1
    Element@name=stem@minOccurs=0@maxOccurs=1
    Element@name=notehead@minOccurs=0@maxOccurs=1
    Element@name=notehead-text@minOccurs=0@maxOccurs=1
    Group@name=staff@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=staff@minOccurs=1@maxOccurs=1
    Element@name=beam@minOccurs=0@maxOccurs=8
    Element@name=notations@minOccurs=0@maxOccurs=unbounded
    Element@name=lyric@minOccurs=0@maxOccurs=unbounded
    Element@name=play@minOccurs=0@maxOccurs=1
    Element@name=listen@minOccurs=0@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypeNote

XSD_TREE = XSDTree(tag=element, name=note type=note)

class musicxml.xmlelement.xmlelement.XMLNoteSize(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The note-size type indicates the percentage of the regular note size to use for notes with a cue and large size as defined in the type element. The grace type is used for notes of cue size that that include a grace element. The cue type is used for all other notes with cue size, whether defined explicitly or implicitly via a cue element. The large type is used for notes of large size. The text content represent the numeric percentage. A value of 100 would be identical to the size of a regular note as defined by the music font.

simpleContent: The non-negative-decimal type specifies a non-negative decimal value.

Possible attributes: type@ XSDSimpleTypeNoteSizeType@required

Possible parents:XMLAppearance

TYPE: alias of XSDComplexTypeNoteSize

XSD_TREE = XSDTree(tag=element, name=note-size type=note-size minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLNotehead(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The notehead type indicates shapes other than the open and closed ovals associated with note durations.

The smufl attribute can be used to specify a particular notehead, allowing application interoperability without requiring every SMuFL glyph to have a MusicXML element equivalent. This attribute can be used either with the “other” value, or to refine a specific notehead value such as “cluster”. Noteheads in the SMuFL Note name noteheads and Note name noteheads supplement ranges (U+E150–U+E1AF and U+EEE0–U+EEFF) should not use the smufl attribute or the “other” value, but instead use the notehead-text element.

For the enclosed shapes, the default is to be hollow for half notes and longer, and filled otherwise. The filled attribute can be set to change this if needed.

If the parentheses attribute is set to yes, the notehead is parenthesized. It is no by default.

simpleContent: The notehead-value type indicates shapes other than the open and closed ovals associated with note durations.

The values do, re, mi, fa, fa up, so, la, and ti correspond to Aikin’s 7-shape system. The fa up shape is typically used with upstems; the fa shape is typically used with downstems or no stems.

The arrow shapes differ from triangle and inverted triangle by being centered on the stem. Slashed and back slashed notes include both the normal notehead and a slash. The triangle shape has the tip of the triangle pointing up; the inverted triangle shape has the tip of the triangle pointing down. The left triangle shape is a right triangle with the hypotenuse facing up and to the left.

The other notehead covers noteheads other than those listed here. It is usually used in combination with the smufl attribute to specify a particular SMuFL notehead. The smufl attribute may be used with any notehead value to help specify the appearance of symbols that share the same MusicXML semantics. Noteheads in the SMuFL Note name noteheads and Note name noteheads supplement ranges (U+E150–U+E1AF and U+EEE0–U+EEFF) should not use the smufl attribute or the “other” value, but instead use the notehead-text element.

Permitted Values: 'slash', 'triangle', 'diamond', 'square', 'cross', 'x', 'circle-x', 'inverted triangle', 'arrow down', 'arrow up', 'circled', 'slashed', 'back slashed', 'normal', 'cluster', 'circle dot', 'left triangle', 'rectangle', 'none', 'do', 're', 'mi', 'fa', 'fa up', 'so', 'la', 'ti', 'other'

Possible attributes: color@ XSDSimpleTypeColor, filled@ XSDSimpleTypeYesNo, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, parentheses@ XSDSimpleTypeYesNo, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeNotehead

XSD_TREE = XSDTree(tag=element, name=notehead type=notehead minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLNoteheadText(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The notehead-text type represents text that is displayed inside a notehead, as is done in some educational music. It is not needed for the numbers used in tablature or jianpu notation. The presence of a TAB or jianpu clefs is sufficient to indicate that numbers are used. The display-text and accidental-text elements allow display of fully formatted text and accidentals.

Possible children: XMLAccidentalText, XMLDisplayText

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=1@maxOccurs=unbounded
        Element@name=display-text@minOccurs=1@maxOccurs=1
        Element@name=accidental-text@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeNoteheadText

XSD_TREE = XSDTree(tag=element, name=notehead-text type=notehead-text minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLNumeral(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The numeral type represents the Roman numeral or Nashville number part of a harmony. It requires that the key be specified in the encoding, either with a key or numeral-key element.

Possible children: XMLNumeralAlter, XMLNumeralKey, XMLNumeralRoot

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=numeral-root@minOccurs=1@maxOccurs=1
    Element@name=numeral-alter@minOccurs=0@maxOccurs=1
    Element@name=numeral-key@minOccurs=0@maxOccurs=1

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeNumeral

XSD_TREE = XSDTree(tag=element, name=numeral type=numeral)

class musicxml.xmlelement.xmlelement.XMLNumeralAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The numeral-alter element represents an alteration to the numeral-root, similar to the alter element for a pitch. The print-object attribute can be used to hide an alteration in cases such as when the MusicXML encoding of a 6 or 7 numeral-root in a minor key requires an alteration that is not displayed. The location attribute indicates whether the alteration should appear to the left or the right of the numeral-root. It is left by default.

complexType: The harmony-alter type represents the chromatic alteration of the root, numeral, or bass of the current harmony-chord group within the harmony element. In some chord styles, the text of the preceding element may include alteration information. In that case, the print-object attribute of this type can be set to no. The location attribute indicates whether the alteration should appear to the left or the right of the preceding element. Its default value varies by element.

simpleContent: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, location@ XSDSimpleTypeLeftRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLNumeral

TYPE: alias of XSDComplexTypeHarmonyAlter

XSD_TREE = XSDTree(tag=element, name=numeral-alter type=harmony-alter minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLNumeralFifths(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The fifths type represents the number of flats or sharps in a traditional key signature. Negative numbers are used for flats and positive numbers for sharps, reflecting the key’s placement within the circle of fifths (hence the type name).

Possible parents:XMLNumeralKey

TYPE: alias of XSDSimpleTypeFifths

XSD_TREE = XSDTree(tag=element, name=numeral-fifths type=fifths)

class musicxml.xmlelement.xmlelement.XMLNumeralKey(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The numeral-key type is used when the key for the numeral is different than the key specified by the key signature. The numeral-fifths element specifies the key in the same way as the fifths element. The numeral-mode element specifies the mode similar to the mode element, but with a restricted set of values

Possible attributes: print_object@ XSDSimpleTypeYesNo

Possible children: XMLNumeralFifths, XMLNumeralMode

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=numeral-fifths@minOccurs=1@maxOccurs=1
    Element@name=numeral-mode@minOccurs=1@maxOccurs=1

Possible parents:XMLNumeral

TYPE: alias of XSDComplexTypeNumeralKey

XSD_TREE = XSDTree(tag=element, name=numeral-key type=numeral-key minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLNumeralMode(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The numeral-mode type specifies the mode similar to the mode type, but with a restricted set of values. The different minor values are used to interpret numeral-root values of 6 and 7 when present in a minor key. The harmonic minor value sharpens the 7 and the melodic minor value sharpens both 6 and 7. If a minor mode is used without qualification, either in the mode or numeral-mode elements, natural minor is used.

Permitted Values: 'major', 'minor', 'natural minor', 'melodic minor', 'harmonic minor'

Possible parents:XMLNumeralKey

TYPE: alias of XSDSimpleTypeNumeralMode

XSD_TREE = XSDTree(tag=element, name=numeral-mode type=numeral-mode)

class musicxml.xmlelement.xmlelement.XMLNumeralRoot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The numeral-root type represents the Roman numeral or Nashville number as a positive integer from 1 to 7. The text attribute indicates how the numeral should appear in the score. A numeral-root value of 5 with a kind of major would have a text attribute of “V” if displayed as a Roman numeral, and “5” if displayed as a Nashville number. If the text attribute is not specified, the display is application-dependent.

simpleContent: The numeral-value type represents a Roman numeral or Nashville number value as a positive integer from 1 to 7.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, text@ XSDSimpleTypeToken

Possible parents:XMLNumeral

TYPE: alias of XSDComplexTypeNumeralRoot

XSD_TREE = XSDTree(tag=element, name=numeral-root type=numeral-root)

class musicxml.xmlelement.xmlelement.XMLOctave(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: Octaves are represented by the numbers 0 to 9, where 4 indicates the octave started by middle C.

Possible parents:XMLPitch

TYPE: alias of XSDSimpleTypeOctave

XSD_TREE = XSDTree(tag=element, name=octave type=octave)

class musicxml.xmlelement.xmlelement.XMLOctaveChange(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The octave-change element indicates how many octaves to add to get from written pitch to sounding pitch. The octave-change element should be included when using transposition intervals of an octave or more, and should not be present for intervals of less than an octave.

Possible parents:XMLPartTranspose, XMLTranspose

TYPE: alias of XSDSimpleTypeInteger

XSD_TREE = XSDTree(tag=element, name=octave-change type=xs:integer minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLOctaveShift(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The octave shift type indicates where notes are shifted up or down from their true pitched values because of printing difficulty. Thus a treble clef line noted with 8va will be indicated with an octave-shift down from the pitch data indicated in the notes. A size of 8 indicates one octave; a size of 15 indicates two octaves.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, size@ XSDSimpleTypePositiveInteger, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeUpDownStopContinue@required

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeOctaveShift

XSD_TREE = XSDTree(tag=element, name=octave-shift type=octave-shift)

class musicxml.xmlelement.xmlelement.XMLOffset(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: An offset is represented in terms of divisions, and indicates where the direction will appear relative to the current musical location. The current musical location is always within the current measure, even at the end of a measure.

The offset affects the visual appearance of the direction. If the sound attribute is “yes”, then the offset affects playback and listening too. If the sound attribute is “no”, then any sound or listening associated with the direction takes effect at the current location. The sound attribute is “no” by default for compatibility with earlier versions of the MusicXML format. If an element within a direction includes a default-x attribute, the offset value will be ignored when determining the appearance of that element.

simpleContent: The divisions type is used to express values in terms of the musical divisions defined by the divisions element. It is preferred that these be integer values both for MIDI interoperability and to avoid roundoff errors.

Possible attributes: sound@ XSDSimpleTypeYesNo

Possible parents:XMLDirection, XMLHarmony, XMLListening, XMLSound

TYPE: alias of XSDComplexTypeOffset

XSD_TREE = XSDTree(tag=element, name=offset type=offset minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLOpen(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The open element represents the open symbol, which looks like a circle. The smufl attribute can be used to distinguish different SMuFL glyphs that have a similar appearance such as brassMuteOpen and guitarOpenPedal. If not present, the default glyph is brassMuteOpen.

complexType: The empty-placement-smufl type represents an empty element with print-style, placement, and smufl attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacementSmufl

XSD_TREE = XSDTree(tag=element, name=open type=empty-placement-smufl)

class musicxml.xmlelement.xmlelement.XMLOpenString(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The open-string element represents the zero-shaped open string symbol.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=open-string type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLOpus(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The opus type represents a link to a MusicXML opus document that composes multiple MusicXML scores into a collection.

Possible parents:XMLWork

TYPE: alias of XSDComplexTypeOpus

XSD_TREE = XSDTree(tag=element, name=opus type=opus minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLOrnaments(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Ornaments can be any of several types, followed optionally by accidentals. The accidental-mark element’s content is represented the same as an accidental element, but with a different name to reflect the different musical meaning.

Possible attributes: id@ XSDSimpleTypeID

Possible children: XMLAccidentalMark, XMLDelayedInvertedTurn, XMLDelayedTurn, XMLHaydn, XMLInvertedMordent, XMLInvertedTurn, XMLInvertedVerticalTurn, XMLMordent, XMLOtherOrnament, XMLSchleifer, XMLShake, XMLTremolo, XMLTrillMark, XMLTurn, XMLVerticalTurn, XMLWavyLine

XSD structure:

Sequence@minOccurs=0@maxOccurs=unbounded
    Choice@minOccurs=1@maxOccurs=1
        Element@name=trill-mark@minOccurs=1@maxOccurs=1
        Element@name=turn@minOccurs=1@maxOccurs=1
        Element@name=delayed-turn@minOccurs=1@maxOccurs=1
        Element@name=inverted-turn@minOccurs=1@maxOccurs=1
        Element@name=delayed-inverted-turn@minOccurs=1@maxOccurs=1
        Element@name=vertical-turn@minOccurs=1@maxOccurs=1
        Element@name=inverted-vertical-turn@minOccurs=1@maxOccurs=1
        Element@name=shake@minOccurs=1@maxOccurs=1
        Element@name=wavy-line@minOccurs=1@maxOccurs=1
        Element@name=mordent@minOccurs=1@maxOccurs=1
        Element@name=inverted-mordent@minOccurs=1@maxOccurs=1
        Element@name=schleifer@minOccurs=1@maxOccurs=1
        Element@name=tremolo@minOccurs=1@maxOccurs=1
        Element@name=haydn@minOccurs=1@maxOccurs=1
        Element@name=other-ornament@minOccurs=1@maxOccurs=1
    Element@name=accidental-mark@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeOrnaments

XSD_TREE = XSDTree(tag=element, name=ornaments type=ornaments)

class musicxml.xmlelement.xmlelement.XMLOtherAppearance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-appearance type is used to define any graphical settings not yet in the current version of the MusicXML format. This allows extended representation, though without application interoperability.

Possible attributes: type@ XSDSimpleTypeToken@required

Possible parents:XMLAppearance

TYPE: alias of XSDComplexTypeOtherAppearance

XSD_TREE = XSDTree(tag=element, name=other-appearance type=other-appearance minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLOtherArticulation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The other-articulation element is used to define any articulations not yet in the MusicXML format. The smufl attribute can be used to specify a particular articulation, allowing application interoperability without requiring every SMuFL articulation to have a MusicXML element equivalent. Using the other-articulation element without the smufl attribute allows for extended representation, though without application interoperability.

complexType: The other-placement-text type represents a text element with print-style, placement, and smufl attribute groups. This type is used by MusicXML notation extension elements to allow specification of specific SMuFL glyphs without needed to add every glyph as a MusicXML element.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeOtherPlacementText

XSD_TREE = XSDTree(tag=element, name=other-articulation type=other-placement-text)

class musicxml.xmlelement.xmlelement.XMLOtherDirection(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-direction type is used to define any direction symbols not yet in the MusicXML format. The smufl attribute can be used to specify a particular direction symbol, allowing application interoperability without requiring every SMuFL glyph to have a MusicXML element equivalent. Using the other-direction type without the smufl attribute allows for extended representation, though without application interoperability.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeOtherDirection

XSD_TREE = XSDTree(tag=element, name=other-direction type=other-direction)

class musicxml.xmlelement.xmlelement.XMLOtherDynamics(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-text type represents a text element with a smufl attribute group. This type is used by MusicXML direction extension elements to allow specification of specific SMuFL glyphs without needed to add every glyph as a MusicXML element.

Possible attributes: smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeOtherText

XSD_TREE = XSDTree(tag=element, name=other-dynamics type=other-text)

class musicxml.xmlelement.xmlelement.XMLOtherListen(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-listening type represents other types of listening control and interaction. The required type attribute indicates the type of listening to which the element content applies. The optional player and time-only attributes restrict the element to apply to a single player or set of times through a repeated section, respectively.

Possible attributes: player@ XSDSimpleTypeIDREF, time_only@ XSDSimpleTypeTimeOnly, type@ XSDSimpleTypeToken@required

Possible parents:XMLListen

TYPE: alias of XSDComplexTypeOtherListening

XSD_TREE = XSDTree(tag=element, name=other-listen type=other-listening)

class musicxml.xmlelement.xmlelement.XMLOtherListening(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-listening type represents other types of listening control and interaction. The required type attribute indicates the type of listening to which the element content applies. The optional player and time-only attributes restrict the element to apply to a single player or set of times through a repeated section, respectively.

Possible attributes: player@ XSDSimpleTypeIDREF, time_only@ XSDSimpleTypeTimeOnly, type@ XSDSimpleTypeToken@required

Possible parents:XMLListening

TYPE: alias of XSDComplexTypeOtherListening

XSD_TREE = XSDTree(tag=element, name=other-listening type=other-listening)

class musicxml.xmlelement.xmlelement.XMLOtherNotation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-notation type is used to define any notations not yet in the MusicXML format. It handles notations where more specific extension elements such as other-dynamics and other-technical are not appropriate. The smufl attribute can be used to specify a particular notation, allowing application interoperability without requiring every SMuFL glyph to have a MusicXML element equivalent. Using the other-notation type without the smufl attribute allows for extended representation, though without application interoperability.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName, type@ XSDSimpleTypeStartStopSingle@required

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeOtherNotation

XSD_TREE = XSDTree(tag=element, name=other-notation type=other-notation)

class musicxml.xmlelement.xmlelement.XMLOtherOrnament(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The other-ornament element is used to define any ornaments not yet in the MusicXML format. The smufl attribute can be used to specify a particular ornament, allowing application interoperability without requiring every SMuFL ornament to have a MusicXML element equivalent. Using the other-ornament element without the smufl attribute allows for extended representation, though without application interoperability.

complexType: The other-placement-text type represents a text element with print-style, placement, and smufl attribute groups. This type is used by MusicXML notation extension elements to allow specification of specific SMuFL glyphs without needed to add every glyph as a MusicXML element.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeOtherPlacementText

XSD_TREE = XSDTree(tag=element, name=other-ornament type=other-placement-text)

class musicxml.xmlelement.xmlelement.XMLOtherPercussion(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The other-percussion element represents percussion pictograms not defined elsewhere.

complexType: The other-text type represents a text element with a smufl attribute group. This type is used by MusicXML direction extension elements to allow specification of specific SMuFL glyphs without needed to add every glyph as a MusicXML element.

Possible attributes: smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeOtherText

XSD_TREE = XSDTree(tag=element, name=other-percussion type=other-text)

class musicxml.xmlelement.xmlelement.XMLOtherPlay(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The other-play element represents other types of playback. The required type attribute indicates the type of playback to which the element content applies.

Possible attributes: type@ XSDSimpleTypeToken@required

Possible parents:XMLPlay

TYPE: alias of XSDComplexTypeOtherPlay

XSD_TREE = XSDTree(tag=element, name=other-play type=other-play)

class musicxml.xmlelement.xmlelement.XMLOtherTechnical(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The other-technical element is used to define any technical indications not yet in the MusicXML format. The smufl attribute can be used to specify a particular glyph, allowing application interoperability without requiring every SMuFL technical indication to have a MusicXML element equivalent. Using the other-technical element without the smufl attribute allows for extended representation, though without application interoperability.

complexType: The other-placement-text type represents a text element with print-style, placement, and smufl attribute groups. This type is used by MusicXML notation extension elements to allow specification of specific SMuFL glyphs without needed to add every glyph as a MusicXML element.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeOtherPlacementText

XSD_TREE = XSDTree(tag=element, name=other-technical type=other-placement-text)

class musicxml.xmlelement.xmlelement.XMLP(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=p type=empty)

class musicxml.xmlelement.xmlelement.XMLPageHeight(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLPageLayout

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=page-height type=tenths)

class musicxml.xmlelement.xmlelement.XMLPageLayout(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Page layout can be defined both in score-wide defaults and in the print element. Page margins are specified either for both even and odd pages, or via separate odd and even page number values. The type is not needed when used as part of a print element. If omitted when used in the defaults element, “both” is the default.

If no page-layout element is present in the defaults element, default page layout values are chosen by the application.

When used in the print element, the page-layout element affects the appearance of the current page only. All other pages use the default values as determined by the defaults element. If any child elements are missing from the page-layout element in a print element, the values determined by the defaults element are used there as well.

Possible children: XMLPageHeight, XMLPageMargins, XMLPageWidth

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=0@maxOccurs=1
        Element@name=page-height@minOccurs=1@maxOccurs=1
        Element@name=page-width@minOccurs=1@maxOccurs=1
    Element@name=page-margins@minOccurs=0@maxOccurs=2

Possible parents:XMLDefaults, XMLPrint

TYPE: alias of XSDComplexTypePageLayout

XSD_TREE = XSDTree(tag=element, name=page-layout type=page-layout minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPageMargins(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Page margins are specified either for both even and odd pages, or via separate odd and even page number values. The type attribute is not needed when used as part of a print element. If omitted when the page-margins type is used in the defaults element, “both” is the default value.

Possible attributes: type@ XSDSimpleTypeMarginType

Possible children: XMLBottomMargin, XMLLeftMargin, XMLRightMargin, XMLTopMargin

XSD structure:
Group@name=all-margins@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Group@name=left-right-margins@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=left-margin@minOccurs=1@maxOccurs=1
                Element@name=right-margin@minOccurs=1@maxOccurs=1
        Element@name=top-margin@minOccurs=1@maxOccurs=1
        Element@name=bottom-margin@minOccurs=1@maxOccurs=1

Possible parents:XMLPageLayout

TYPE: alias of XSDComplexTypePageMargins

XSD_TREE = XSDTree(tag=element, name=page-margins type=page-margins minOccurs=0 maxOccurs=2)

class musicxml.xmlelement.xmlelement.XMLPageWidth(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLPageLayout

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=page-width type=tenths)

class musicxml.xmlelement.xmlelement.XMLPan(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The pan and elevation elements allow placing of sound in a 3-D space relative to the listener. Both are expressed in degrees ranging from -180 to 180. For pan, 0 is straight ahead, -90 is hard left, 90 is hard right, and -180 and 180 are directly behind the listener.

simpleType: The rotation-degrees type specifies rotation, pan, and elevation values in degrees. Values range from -180 to 180.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypeRotationDegrees

XSD_TREE = XSDTree(tag=element, name=pan type=rotation-degrees minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPart(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible attributes: id@ XSDSimpleTypeIDREF@required

Possible children: XMLMeasure

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=measure@minOccurs=1@maxOccurs=unbounded

Possible parents:XMLScorePartwise

TYPE: alias of XSDComplexTypePart

XSD_TREE = XSDTree(tag=element, name=part maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLPartAbbreviation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The part-name type describes the name or abbreviation of a score-part element. Formatting attributes for the part-name element are deprecated in Version 2.0 in favor of the new part-name-display and part-abbreviation-display elements.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, justify@ XSDSimpleTypeLeftCenterRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLScorePart

TYPE: alias of XSDComplexTypePartName

XSD_TREE = XSDTree(tag=element, name=part-abbreviation type=part-name minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPartAbbreviationDisplay(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The name-display type is used for exact formatting of multi-font text in part and group names to the left of the system. The print-object attribute can be used to determine what, if anything, is printed at the start of each system. Enclosure for the display-text element is none by default. Language for the display-text element is Italian (“it”) by default.

Possible attributes: print_object@ XSDSimpleTypeYesNo

Possible children: XMLAccidentalText, XMLDisplayText

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Element@name=display-text@minOccurs=1@maxOccurs=1
        Element@name=accidental-text@minOccurs=1@maxOccurs=1

Possible parents:XMLPrint, XMLScorePart

TYPE: alias of XSDComplexTypeNameDisplay

XSD_TREE = XSDTree(tag=element, name=part-abbreviation-display type=name-display minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPartClef(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The part-clef element is used for transpositions that also include a change of clef, as for instruments such as bass clarinet.

complexType: The child elements of the part-clef type have the same meaning as for the clef type. However that meaning applies to a transposed part created from the existing score file.

Possible children: XMLClefOctaveChange, XMLLine, XMLSign

XSD structure:
Group@name=clef@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=sign@minOccurs=1@maxOccurs=1
        Element@name=line@minOccurs=0@maxOccurs=1
        Element@name=clef-octave-change@minOccurs=0@maxOccurs=1

Possible parents:XMLForPart

TYPE: alias of XSDComplexTypePartClef

XSD_TREE = XSDTree(tag=element, name=part-clef type=part-clef minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPartGroup(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The part-group element indicates groupings of parts in the score, usually indicated by braces and brackets. Braces that are used for multi-staff parts should be defined in the attributes element for that part. The part-group start element appears before the first score-part in the group. The part-group stop element appears after the last score-part in the group.

The number attribute is used to distinguish overlapping and nested part-groups, not the sequence of groups. As with parts, groups can have a name and abbreviation. Values for the child elements are ignored at the stop of a group.

A part-group element is not needed for a single multi-staff part. By default, multi-staff parts include a brace symbol and (if appropriate given the bar-style) common barlines. The symbol formatting for a multi-staff part can be more fully specified using the part-symbol element.

Possible attributes: number@ XSDSimpleTypeToken, type@ XSDSimpleTypeStartStop@required

Possible children: XMLFootnote, XMLGroupAbbreviationDisplay, XMLGroupAbbreviation, XMLGroupBarline, XMLGroupNameDisplay, XMLGroupName, XMLGroupSymbol, XMLGroupTime, XMLLevel

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=group-name@minOccurs=0@maxOccurs=1
    Element@name=group-name-display@minOccurs=0@maxOccurs=1
    Element@name=group-abbreviation@minOccurs=0@maxOccurs=1
    Element@name=group-abbreviation-display@minOccurs=0@maxOccurs=1
    Element@name=group-symbol@minOccurs=0@maxOccurs=1
    Element@name=group-barline@minOccurs=0@maxOccurs=1
    Element@name=group-time@minOccurs=0@maxOccurs=1
    Group@name=editorial@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Group@name=footnote@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=footnote@minOccurs=1@maxOccurs=1
            Group@name=level@minOccurs=0@maxOccurs=1
                Sequence@minOccurs=1@maxOccurs=1
                    Element@name=level@minOccurs=1@maxOccurs=1

Possible parents:XMLPartList

TYPE: alias of XSDComplexTypePartGroup

XSD_TREE = XSDTree(tag=element, name=part-group type=part-group)

class musicxml.xmlelement.xmlelement.XMLPartLink(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The part-link type allows MusicXML data for both score and parts to be contained within a single compressed MusicXML file. It links a score-part from a score document to MusicXML documents that contain parts data. In the case of a single compressed MusicXML file, the link href values are paths that are relative to the root folder of the zip file.

Possible children: XMLGroupLink, XMLInstrumentLink

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=instrument-link@minOccurs=0@maxOccurs=unbounded
    Element@name=group-link@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLScorePart

TYPE: alias of XSDComplexTypePartLink

XSD_TREE = XSDTree(tag=element, name=part-link type=part-link minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLPartList(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The part-list identifies the different musical parts in this document. Each part has an ID that is used later within the musical data. Since parts may be encoded separately and combined later, identification elements are present at both the score and score-part levels. There must be at least one score-part, combined as desired with part-group elements that indicate braces and brackets. Parts are ordered from top to bottom in a score based on the order in which they appear in the part-list.

Possible children: XMLPartGroup, XMLScorePart

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Group@name=part-group@minOccurs=0@maxOccurs=unbounded
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=part-group@minOccurs=1@maxOccurs=1
    Group@name=score-part@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=score-part@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Group@name=part-group@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=part-group@minOccurs=1@maxOccurs=1
        Group@name=score-part@minOccurs=1@maxOccurs=1
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=score-part@minOccurs=1@maxOccurs=1

Possible parents:XMLScorePartwise

TYPE: alias of XSDComplexTypePartList

XSD_TREE = XSDTree(tag=element, name=part-list type=part-list)

class musicxml.xmlelement.xmlelement.XMLPartName(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The part-name type describes the name or abbreviation of a score-part element. Formatting attributes for the part-name element are deprecated in Version 2.0 in favor of the new part-name-display and part-abbreviation-display elements.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, justify@ XSDSimpleTypeLeftCenterRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLScorePart

TYPE: alias of XSDComplexTypePartName

XSD_TREE = XSDTree(tag=element, name=part-name type=part-name)

class musicxml.xmlelement.xmlelement.XMLPartNameDisplay(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The name-display type is used for exact formatting of multi-font text in part and group names to the left of the system. The print-object attribute can be used to determine what, if anything, is printed at the start of each system. Enclosure for the display-text element is none by default. Language for the display-text element is Italian (“it”) by default.

Possible attributes: print_object@ XSDSimpleTypeYesNo

Possible children: XMLAccidentalText, XMLDisplayText

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Element@name=display-text@minOccurs=1@maxOccurs=1
        Element@name=accidental-text@minOccurs=1@maxOccurs=1

Possible parents:XMLPrint, XMLScorePart

TYPE: alias of XSDComplexTypeNameDisplay

XSD_TREE = XSDTree(tag=element, name=part-name-display type=name-display minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPartSymbol(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The part-symbol element indicates how a symbol for a multi-staff part is indicated in the score.

complexType: The part-symbol type indicates how a symbol for a multi-staff part is indicated in the score; brace is the default value. The top-staff and bottom-staff attributes are used when the brace does not extend across the entire part. For example, in a 3-staff organ part, the top-staff will typically be 1 for the right hand, while the bottom-staff will typically be 2 for the left hand. Staff 3 for the pedals is usually outside the brace. By default, the presence of a part-symbol element that does not extend across the entire part also indicates a corresponding change in the common barlines within a part.

simpleContent: The group-symbol-value type indicates how the symbol for a group or multi-staff part is indicated in the score.

Permitted Values: 'none', 'brace', 'line', 'bracket', 'square'

Possible attributes: bottom_staff@ XSDSimpleTypeStaffNumber, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, top_staff@ XSDSimpleTypeStaffNumber

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypePartSymbol

XSD_TREE = XSDTree(tag=element, name=part-symbol type=part-symbol minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPartTranspose(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The chromatic element in a part-transpose element will usually have a non-zero value, since octave transpositions can be represented in concert scores using the transpose element.

complexType: The child elements of the part-transpose type have the same meaning as for the transpose type. However that meaning applies to a transposed part created from the existing score file.

Possible children: XMLChromatic, XMLDiatonic, XMLDouble, XMLOctaveChange

XSD structure:
Group@name=transpose@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=diatonic@minOccurs=0@maxOccurs=1
        Element@name=chromatic@minOccurs=1@maxOccurs=1
        Element@name=octave-change@minOccurs=0@maxOccurs=1
        Element@name=double@minOccurs=0@maxOccurs=1

Possible parents:XMLForPart

TYPE: alias of XSDComplexTypePartTranspose

XSD_TREE = XSDTree(tag=element, name=part-transpose type=part-transpose)

class musicxml.xmlelement.xmlelement.XMLPedal(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The pedal type represents piano pedal marks, including damper and sostenuto pedal marks. The line attribute is yes if pedal lines are used. The sign attribute is yes if Ped, Sost, and * signs are used. For compatibility with older versions, the sign attribute is yes by default if the line attribute is no, and is no by default if the line attribute is yes. If the sign attribute is set to yes and the type is start or sostenuto, the abbreviated attribute is yes if the short P and S signs are used, and no if the full Ped and Sost signs are used. It is no by default. Otherwise the abbreviated attribute is ignored. The alignment attributes are ignored if the sign attribute is no.

Possible attributes: abbreviated@ XSDSimpleTypeYesNo, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, line@ XSDSimpleTypeYesNo, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, sign@ XSDSimpleTypeYesNo, type@ XSDSimpleTypePedalType@required, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypePedal

XSD_TREE = XSDTree(tag=element, name=pedal type=pedal)

class musicxml.xmlelement.xmlelement.XMLPedalAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The pedal-alter element defines the chromatic alteration for a single harp pedal.

simpleType: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible parents:XMLPedalTuning

TYPE: alias of XSDSimpleTypeSemitones

XSD_TREE = XSDTree(tag=element, name=pedal-alter type=semitones)

class musicxml.xmlelement.xmlelement.XMLPedalStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The pedal-step element defines the pitch step for a single harp pedal.

simpleType: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible parents:XMLPedalTuning

TYPE: alias of XSDSimpleTypeStep

XSD_TREE = XSDTree(tag=element, name=pedal-step type=step)

class musicxml.xmlelement.xmlelement.XMLPedalTuning(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The pedal-tuning type specifies the tuning of a single harp pedal.

Possible children: XMLPedalAlter, XMLPedalStep

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=pedal-step@minOccurs=1@maxOccurs=1
    Element@name=pedal-alter@minOccurs=1@maxOccurs=1

Possible parents:XMLHarpPedals

TYPE: alias of XSDComplexTypePedalTuning

XSD_TREE = XSDTree(tag=element, name=pedal-tuning type=pedal-tuning maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLPerMinute(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The per-minute type can be a number, or a text description including numbers. If a font is specified, it overrides the font specified for the overall metronome element. This allows separate specification of a music font for the beat-unit and a text font for the numeric value, in cases where a single metronome font is not used.

Possible attributes: font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLMetronome

TYPE: alias of XSDComplexTypePerMinute

XSD_TREE = XSDTree(tag=element, name=per-minute type=per-minute)

class musicxml.xmlelement.xmlelement.XMLPercussion(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The percussion element is used to define percussion pictogram symbols. Definitions for these symbols can be found in Kurt Stone’s “Music Notation in the Twentieth Century” on pages 206-212 and 223. Some values are added to these based on how usage has evolved in the 30 years since Stone’s book was published.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, enclosure@ XSDSimpleTypeEnclosureShape, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible children: XMLBeater, XMLEffect, XMLGlass, XMLMembrane, XMLMetal, XMLOtherPercussion, XMLPitched, XMLStickLocation, XMLStick, XMLTimpani, XMLWood

XSD structure:
Choice@minOccurs=1@maxOccurs=1
    Element@name=glass@minOccurs=1@maxOccurs=1
    Element@name=metal@minOccurs=1@maxOccurs=1
    Element@name=wood@minOccurs=1@maxOccurs=1
    Element@name=pitched@minOccurs=1@maxOccurs=1
    Element@name=membrane@minOccurs=1@maxOccurs=1
    Element@name=effect@minOccurs=1@maxOccurs=1
    Element@name=timpani@minOccurs=1@maxOccurs=1
    Element@name=beater@minOccurs=1@maxOccurs=1
    Element@name=stick@minOccurs=1@maxOccurs=1
    Element@name=stick-location@minOccurs=1@maxOccurs=1
    Element@name=other-percussion@minOccurs=1@maxOccurs=1

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypePercussion

XSD_TREE = XSDTree(tag=element, name=percussion type=percussion maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLPf(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=pf type=empty)

class musicxml.xmlelement.xmlelement.XMLPitch(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Pitch is represented as a combination of the step of the diatonic scale, the chromatic alteration, and the octave.

Possible children: XMLAlter, XMLOctave, XMLStep

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=step@minOccurs=1@maxOccurs=1
    Element@name=alter@minOccurs=0@maxOccurs=1
    Element@name=octave@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypePitch

XSD_TREE = XSDTree(tag=element, name=pitch type=pitch)

class musicxml.xmlelement.xmlelement.XMLPitched(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The pitched-value type represents pictograms for pitched percussion instruments. The smufl attribute is used to distinguish different SMuFL glyphs for a particular pictogram within the Tuned mallet percussion pictograms range.

simpleContent: The pitched-value type represents pictograms for pitched percussion instruments. The chimes and tubular chimes values distinguish the single-line and double-line versions of the pictogram.

Permitted Values: 'celesta', 'chimes', 'glockenspiel', 'lithophone', 'mallet', 'marimba', 'steel drums', 'tubaphone', 'tubular chimes', 'vibraphone', 'xylophone'

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypePitched

XSD_TREE = XSDTree(tag=element, name=pitched type=pitched)

class musicxml.xmlelement.xmlelement.XMLPlay(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The play type specifies playback techniques to be used in conjunction with the instrument-sound element. When used as part of a sound element, it applies to all notes going forward in score order. In multi-instrument parts, the affected instrument should be specified using the id attribute. When used as part of a note element, it applies to the current note only.

Possible attributes: id@ XSDSimpleTypeIDREF

Possible children: XMLIpa, XMLMute, XMLOtherPlay, XMLSemiPitched

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=0@maxOccurs=unbounded
        Element@name=ipa@minOccurs=1@maxOccurs=1
        Element@name=mute@minOccurs=1@maxOccurs=1
        Element@name=semi-pitched@minOccurs=1@maxOccurs=1
        Element@name=other-play@minOccurs=1@maxOccurs=1

Possible parents:XMLNote, XMLSound

TYPE: alias of XSDComplexTypePlay

XSD_TREE = XSDTree(tag=element, name=play type=play minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPlayer(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The player type allows for multiple players per score-part for use in listening applications. One player may play multiple instruments, while a single instrument may include multiple players in divisi sections.

Possible attributes: id@ XSDSimpleTypeID@required

Possible children: XMLPlayerName

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=player-name@minOccurs=1@maxOccurs=1

Possible parents:XMLScorePart

TYPE: alias of XSDComplexTypePlayer

XSD_TREE = XSDTree(tag=element, name=player type=player minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLPlayerName(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The player-name element is typically used within a software application, rather than appearing on the printed page of a score.

Possible parents:XMLPlayer

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=player-name type=xs:string)

class musicxml.xmlelement.xmlelement.XMLPlop(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The plop element is an indeterminate slide attached to a single note. The plop appears before the main note and comes from above the main pitch.

complexType: The empty-line type represents an empty element with line-shape, line-type, line-length, dashed-formatting, print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, line_length@ XSDSimpleTypeLineLength, line_shape@ XSDSimpleTypeLineShape, line_type@ XSDSimpleTypeLineType, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyLine

XSD_TREE = XSDTree(tag=element, name=plop type=empty-line)

class musicxml.xmlelement.xmlelement.XMLPluck(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The pluck element is used to specify the plucking fingering on a fretted instrument, where the fingering element refers to the fretting fingering. Typical values are p, i, m, a for pulgar/thumb, indicio/index, medio/middle, and anular/ring fingers.

complexType: The placement-text type represents a text element with print-style and placement attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypePlacementText

XSD_TREE = XSDTree(tag=element, name=pluck type=placement-text)

class musicxml.xmlelement.xmlelement.XMLPp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=pp type=empty)

class musicxml.xmlelement.xmlelement.XMLPpp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=ppp type=empty)

class musicxml.xmlelement.xmlelement.XMLPppp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=pppp type=empty)

class musicxml.xmlelement.xmlelement.XMLPpppp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=ppppp type=empty)

class musicxml.xmlelement.xmlelement.XMLPppppp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=pppppp type=empty)

class musicxml.xmlelement.xmlelement.XMLPreBend(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The pre-bend element indicates that a bend is a pre-bend rather than a normal bend or a release.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLBend

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=pre-bend type=empty)

class musicxml.xmlelement.xmlelement.XMLPrefix(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Values for the prefix element include plus and the accidental values sharp, flat, natural, double-sharp, flat-flat, and sharp-sharp. The prefix element may contain additional values for symbols specific to particular figured bass styles.

complexType: The style-text type represents a text element with a print-style attribute group.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLFigure

TYPE: alias of XSDComplexTypeStyleText

XSD_TREE = XSDTree(tag=element, name=prefix type=style-text minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLPrincipalVoice(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The principal-voice type represents principal and secondary voices in a score, either for analysis or for square bracket symbols that appear in a score. The element content is used for analysis and may be any text value. The symbol attribute indicates the type of symbol used. When used for analysis separate from any printed score markings, it should be set to none. Otherwise if the type is stop it should be set to plain.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, symbol@ XSDSimpleTypePrincipalVoiceSymbol@required, type@ XSDSimpleTypeStartStop@required, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypePrincipalVoice

XSD_TREE = XSDTree(tag=element, name=principal-voice type=principal-voice)

class musicxml.xmlelement.xmlelement.XMLPrint(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The print type contains general printing parameters, including layout elements. The part-name-display and part-abbreviation-display elements may also be used here to change how a part name or abbreviation is displayed over the course of a piece. They take effect when the current measure or a succeeding measure starts a new system.

Layout group elements in a print element only apply to the current page, system, or staff. Music that follows continues to take the default values from the layout determined by the defaults element.

Possible attributes: blank_page@ XSDSimpleTypePositiveInteger, id@ XSDSimpleTypeID, new_page@ XSDSimpleTypeYesNo, new_system@ XSDSimpleTypeYesNo, page_number@ XSDSimpleTypeToken, staff_spacing@ XSDSimpleTypeTenths

Possible children: XMLMeasureLayout, XMLMeasureNumbering, XMLPageLayout, XMLPartAbbreviationDisplay, XMLPartNameDisplay, XMLStaffLayout, XMLSystemLayout

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Group@name=layout@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=page-layout@minOccurs=0@maxOccurs=1
            Element@name=system-layout@minOccurs=0@maxOccurs=1
            Element@name=staff-layout@minOccurs=0@maxOccurs=unbounded
    Element@name=measure-layout@minOccurs=0@maxOccurs=1
    Element@name=measure-numbering@minOccurs=0@maxOccurs=1
    Element@name=part-name-display@minOccurs=0@maxOccurs=1
    Element@name=part-abbreviation-display@minOccurs=0@maxOccurs=1

Possible parents:XMLMeasure

TYPE: alias of XSDComplexTypePrint

XSD_TREE = XSDTree(tag=element, name=print type=print)

class musicxml.xmlelement.xmlelement.XMLPullOff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The hammer-on and pull-off elements are used in guitar and fretted instrument notation. Since a single slur can be marked over many notes, the hammer-on and pull-off elements are separate so the individual pair of notes can be specified. The element content can be used to specify how the hammer-on or pull-off should be notated. An empty element leaves this choice up to the application.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHammerOnPullOff

XSD_TREE = XSDTree(tag=element, name=pull-off type=hammer-on-pull-off)

class musicxml.xmlelement.xmlelement.XMLRehearsal(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The rehearsal element specifies letters, numbers, and section names that are notated in the score for reference during rehearsal. The enclosure is square if not specified. The language is Italian (“it”) if not specified. Left justification is used if not specified.

complexType: The formatted-text-id type represents a text element with text-formatting and id attributes.

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeFormattedTextId

XSD_TREE = XSDTree(tag=element, name=rehearsal type=formatted-text-id maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLRelation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

A related resource for the music that is encoded. This is similar to the Dublin Core relation element. Standard type values are music, words, and arrangement, but other types may be used.

complexType: The typed-text type represents a text element with a type attribute.

Possible attributes: type@ XSDSimpleTypeToken

Possible parents:XMLIdentification

TYPE: alias of XSDComplexTypeTypedText

XSD_TREE = XSDTree(tag=element, name=relation type=typed-text minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLRelease(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The release type indicates that a bend is a release rather than a normal bend or pre-bend. The offset attribute specifies where the release starts in terms of divisions relative to the current note. The first-beat and last-beat attributes of the parent bend element are relative to the original note position, not this offset value.

Possible attributes: offset@ XSDSimpleTypeDivisions

Possible parents:XMLBend

TYPE: alias of XSDComplexTypeRelease

XSD_TREE = XSDTree(tag=element, name=release type=release)

class musicxml.xmlelement.xmlelement.XMLRepeat(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The repeat type represents repeat marks. The start of the repeat has a forward direction while the end of the repeat has a backward direction. The times and after-jump attributes are only used with backward repeats that are not part of an ending. The times attribute indicates the number of times the repeated section is played. The after-jump attribute indicates if the repeats are played after a jump due to a da capo or dal segno.

Possible attributes: after_jump@ XSDSimpleTypeYesNo, direction@ XSDSimpleTypeBackwardForward@required, times@ XSDSimpleTypeNonNegativeInteger, winged@ XSDSimpleTypeWinged

Possible parents:XMLBarline

TYPE: alias of XSDComplexTypeRepeat

XSD_TREE = XSDTree(tag=element, name=repeat type=repeat minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLRest(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The rest element indicates notated rests or silences. Rest elements are usually empty, but placement on the staff can be specified using display-step and display-octave elements. If the measure attribute is set to yes, this indicates this is a complete measure rest.

Possible attributes: measure@ XSDSimpleTypeYesNo

Possible children: XMLDisplayOctave, XMLDisplayStep

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Group@name=display-step-octave@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=display-step@minOccurs=1@maxOccurs=1
            Element@name=display-octave@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeRest

XSD_TREE = XSDTree(tag=element, name=rest type=rest)

class musicxml.xmlelement.xmlelement.XMLRf(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=rf type=empty)

class musicxml.xmlelement.xmlelement.XMLRfz(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=rfz type=empty)

class musicxml.xmlelement.xmlelement.XMLRightDivider(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty-print-style-align-object type represents an empty element with print-object and print-style-align attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, valign@ XSDSimpleTypeValign

Possible parents:XMLSystemDividers

TYPE: alias of XSDComplexTypeEmptyPrintObjectStyleAlign

XSD_TREE = XSDTree(tag=element, name=right-divider type=empty-print-object-style-align)

class musicxml.xmlelement.xmlelement.XMLRightMargin(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLPageMargins, XMLSystemMargins

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=right-margin type=tenths)

class musicxml.xmlelement.xmlelement.XMLRights(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The rights element is borrowed from Dublin Core. It contains copyright and other intellectual property notices. Words, music, and derivatives can have different types, so multiple rights elements with different type attributes are supported. Standard type values are music, words, and arrangement, but other types may be used. The type attribute is only needed when there are multiple rights elements.

complexType: The typed-text type represents a text element with a type attribute.

Possible attributes: type@ XSDSimpleTypeToken

Possible parents:XMLIdentification

TYPE: alias of XSDComplexTypeTypedText

XSD_TREE = XSDTree(tag=element, name=rights type=typed-text minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLRoot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The root type indicates a pitch like C, D, E vs. a scale degree like 1, 2, 3. It is used with chord symbols in popular music. The root element has a root-step and optional root-alter element similar to the step and alter elements, but renamed to distinguish the different musical meanings.

Possible children: XMLRootAlter, XMLRootStep

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=root-step@minOccurs=1@maxOccurs=1
    Element@name=root-alter@minOccurs=0@maxOccurs=1

Possible parents:XMLHarmony

TYPE: alias of XSDComplexTypeRoot

XSD_TREE = XSDTree(tag=element, name=root type=root)

class musicxml.xmlelement.xmlelement.XMLRootAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The root-alter element represents the chromatic alteration of the root of the current chord within the harmony element. In some chord styles, the text for the root-step element may include root-alter information. In that case, the print-object attribute of the root-alter element can be set to no. The location attribute indicates whether the alteration should appear to the left or the right of the root-step; it is right by default.

complexType: The harmony-alter type represents the chromatic alteration of the root, numeral, or bass of the current harmony-chord group within the harmony element. In some chord styles, the text of the preceding element may include alteration information. In that case, the print-object attribute of this type can be set to no. The location attribute indicates whether the alteration should appear to the left or the right of the preceding element. Its default value varies by element.

simpleContent: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, location@ XSDSimpleTypeLeftRight, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLRoot

TYPE: alias of XSDComplexTypeHarmonyAlter

XSD_TREE = XSDTree(tag=element, name=root-alter type=harmony-alter minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLRootStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The root-step type represents the pitch step of the root of the current chord within the harmony element. The text attribute indicates how the root should appear in a score if not using the element contents.

simpleContent: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, text@ XSDSimpleTypeToken

Possible parents:XMLRoot

TYPE: alias of XSDComplexTypeRootStep

XSD_TREE = XSDTree(tag=element, name=root-step type=root-step)

class musicxml.xmlelement.xmlelement.XMLScaling(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Margins, page sizes, and distances are all measured in tenths to keep MusicXML data in a consistent coordinate system as much as possible. The translation to absolute units is done with the scaling type, which specifies how many millimeters are equal to how many tenths. For a staff height of 7 mm, millimeters would be set to 7 while tenths is set to 40. The ability to set a formula rather than a single scaling factor helps avoid roundoff errors.

Possible children: XMLMillimeters, XMLTenths

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=millimeters@minOccurs=1@maxOccurs=1
    Element@name=tenths@minOccurs=1@maxOccurs=1

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeScaling

XSD_TREE = XSDTree(tag=element, name=scaling type=scaling minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSchleifer(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The name for this ornament is based on the German, to avoid confusion with the more common slide element defined earlier.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=schleifer type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLScoop(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The scoop element is an indeterminate slide attached to a single note. The scoop appears before the main note and comes from below the main pitch.

complexType: The empty-line type represents an empty element with line-shape, line-type, line-length, dashed-formatting, print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, line_length@ XSDSimpleTypeLineLength, line_shape@ XSDSimpleTypeLineShape, line_type@ XSDSimpleTypeLineType, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyLine

XSD_TREE = XSDTree(tag=element, name=scoop type=empty-line)

class musicxml.xmlelement.xmlelement.XMLScordatura(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Scordatura string tunings are represented by a series of accord elements, similar to the staff-tuning elements. Strings are numbered from high to low.

Possible attributes: id@ XSDSimpleTypeID

Possible children: XMLAccord

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=accord@minOccurs=1@maxOccurs=unbounded

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeScordatura

XSD_TREE = XSDTree(tag=element, name=scordatura type=scordatura)

class musicxml.xmlelement.xmlelement.XMLScoreInstrument(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The score-instrument type represents a single instrument within a score-part. As with the score-part type, each score-instrument has a required ID attribute, a name, and an optional abbreviation.

A score-instrument type is also required if the score specifies MIDI 1.0 channels, banks, or programs. An initial midi-instrument assignment can also be made here. MusicXML software should be able to automatically assign reasonable channels and instruments without these elements in simple cases, such as where part names match General MIDI instrument names.

The score-instrument element can also distinguish multiple instruments of the same type that are on the same part, such as Clarinet 1 and Clarinet 2 instruments within a Clarinets 1 and 2 part.

Possible attributes: id@ XSDSimpleTypeID@required

Possible children: XMLEnsemble, XMLInstrumentAbbreviation, XMLInstrumentName, XMLInstrumentSound, XMLSolo, XMLVirtualInstrument

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=instrument-name@minOccurs=1@maxOccurs=1
    Element@name=instrument-abbreviation@minOccurs=0@maxOccurs=1
    Group@name=virtual-instrument-data@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=instrument-sound@minOccurs=0@maxOccurs=1
            Choice@minOccurs=0@maxOccurs=1
                Element@name=solo@minOccurs=1@maxOccurs=1
                Element@name=ensemble@minOccurs=1@maxOccurs=1
            Element@name=virtual-instrument@minOccurs=0@maxOccurs=1

Possible parents:XMLScorePart

TYPE: alias of XSDComplexTypeScoreInstrument

XSD_TREE = XSDTree(tag=element, name=score-instrument type=score-instrument minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLScorePart(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Each MusicXML part corresponds to a track in a Standard MIDI Format 1 file. The score-instrument elements are used when there are multiple instruments per track. The midi-device element is used to make a MIDI device or port assignment for the given track. Initial midi-instrument assignments may be made here as well.

complexType: The score-part type collects part-wide information for each part in a score. Often, each MusicXML part corresponds to a track in a Standard MIDI Format 1 file. In this case, the midi-device element is used to make a MIDI device or port assignment for the given track or specific MIDI instruments. Initial midi-instrument assignments may be made here as well. The score-instrument elements are used when there are multiple instruments per track.

Possible attributes: id@ XSDSimpleTypeID@required

Possible children: XMLGroup, XMLIdentification, XMLMidiDevice, XMLMidiInstrument, XMLPartAbbreviationDisplay, XMLPartAbbreviation, XMLPartLink, XMLPartNameDisplay, XMLPartName, XMLPlayer, XMLScoreInstrument

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=identification@minOccurs=0@maxOccurs=1
    Element@name=part-link@minOccurs=0@maxOccurs=unbounded
    Element@name=part-name@minOccurs=1@maxOccurs=1
    Element@name=part-name-display@minOccurs=0@maxOccurs=1
    Element@name=part-abbreviation@minOccurs=0@maxOccurs=1
    Element@name=part-abbreviation-display@minOccurs=0@maxOccurs=1
    Element@name=group@minOccurs=0@maxOccurs=unbounded
    Element@name=score-instrument@minOccurs=0@maxOccurs=unbounded
    Element@name=player@minOccurs=0@maxOccurs=unbounded
    Sequence@minOccurs=0@maxOccurs=unbounded
        Element@name=midi-device@minOccurs=0@maxOccurs=1
        Element@name=midi-instrument@minOccurs=0@maxOccurs=1

Possible parents:XMLPartList

TYPE: alias of XSDComplexTypeScorePart

XSD_TREE = XSDTree(tag=element, name=score-part type=score-part)

class musicxml.xmlelement.xmlelement.XMLScorePartwise(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The score-partwise element is the root element for a partwise MusicXML score. It includes a score-header group followed by a series of parts with measures inside. The document-attributes attribute group includes the version attribute.

Possible attributes: version@ XSDSimpleTypeToken

Possible children: XMLCredit, XMLDefaults, XMLIdentification, XMLMovementNumber, XMLMovementTitle, XMLPartList, XMLPart, XMLWork

XSD structure:

Sequence@minOccurs=1@maxOccurs=1
    Group@name=score-header@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=work@minOccurs=0@maxOccurs=1
            Element@name=movement-number@minOccurs=0@maxOccurs=1
            Element@name=movement-title@minOccurs=0@maxOccurs=1
            Element@name=identification@minOccurs=0@maxOccurs=1
            Element@name=defaults@minOccurs=0@maxOccurs=1
            Element@name=credit@minOccurs=0@maxOccurs=unbounded
            Element@name=part-list@minOccurs=1@maxOccurs=1
    Element@name=part@minOccurs=1@maxOccurs=unbounded

TYPE: alias of XSDComplexTypeScorePartwise

write(path: pathlib.Path, intelligent_choice: bool = False) → None[source]

Parameters:

path – Output xml file path, required.
intelligent_choice – Set to True if you wish to use intelligent choice in final checks to be able to change the attachment order of XMLElement children in self.child_container_tree if an Exception was thrown and other choices can still be checked. (No GUARANTEE!)

Returns:

None

XSD_TREE = XSDTree(tag=element, name=score-partwise block=extension substitution final=#all)

class musicxml.xmlelement.xmlelement.XMLSecond(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLSwing

TYPE: alias of XSDSimpleTypePositiveInteger

XSD_TREE = XSDTree(tag=element, name=second type=xs:positiveInteger)

class musicxml.xmlelement.xmlelement.XMLSegno(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The segno type is the visual indicator of a segno sign. The exact glyph can be specified with the smufl attribute. A sound element is also needed to guide playback applications reliably.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflSegnoGlyphName, valign@ XSDSimpleTypeValign

Possible parents:XMLBarline, XMLDirectionType

TYPE: alias of XSDComplexTypeSegno

XSD_TREE = XSDTree(tag=element, name=segno type=segno maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLSemiPitched(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The semi-pitched type represents categories of indefinite pitch for percussion instruments.

Permitted Values: 'high', 'medium-high', 'medium', 'medium-low', 'low', 'very-low'

Possible parents:XMLPlay

TYPE: alias of XSDSimpleTypeSemiPitched

XSD_TREE = XSDTree(tag=element, name=semi-pitched type=semi-pitched)

class musicxml.xmlelement.xmlelement.XMLSenzaMisura(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

A senza-misura element explicitly indicates that no time signature is present. The optional element content indicates the symbol to be used, if any, such as an X. The time element’s symbol attribute is not used when a senza-misura element is present.

Possible parents:XMLTime

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=senza-misura type=xs:string)

class musicxml.xmlelement.xmlelement.XMLSf(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sf type=empty)

class musicxml.xmlelement.xmlelement.XMLSffz(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sffz type=empty)

class musicxml.xmlelement.xmlelement.XMLSfp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sfp type=empty)

class musicxml.xmlelement.xmlelement.XMLSfpp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sfpp type=empty)

class musicxml.xmlelement.xmlelement.XMLSfz(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sfz type=empty)

class musicxml.xmlelement.xmlelement.XMLSfzp(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLDynamics

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sfzp type=empty)

class musicxml.xmlelement.xmlelement.XMLShake(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The shake element has a similar appearance to an inverted-mordent element.

complexType: The empty-trill-sound type represents an empty element with print-style, placement, and trill-sound attributes.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeEmptyTrillSound

XSD_TREE = XSDTree(tag=element, name=shake type=empty-trill-sound)

class musicxml.xmlelement.xmlelement.XMLSign(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The sign element represents the clef symbol.

simpleType: The clef-sign type represents the different clef symbols. The jianpu sign indicates that the music that follows should be in jianpu numbered notation, just as the TAB sign indicates that the music that follows should be in tablature notation. Unlike TAB, a jianpu sign does not correspond to a visual clef notation.

The none sign is deprecated as of MusicXML 4.0. Use the clef element’s print-object attribute instead. When the none sign is used, notes should be displayed as if in treble clef.

Permitted Values: 'G', 'F', 'C', 'percussion', 'TAB', 'jianpu', 'none'

Possible parents:XMLClef, XMLPartClef

TYPE: alias of XSDSimpleTypeClefSign

XSD_TREE = XSDTree(tag=element, name=sign type=clef-sign)

class musicxml.xmlelement.xmlelement.XMLSlash(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The slash type is used to indicate that slash notation is to be used. If the slash is on every beat, use-stems is no (the default). To indicate rhythms but not pitches, use-stems is set to yes. The type attribute indicates whether this is the start or stop of a slash notation style. The use-dots attribute works as for the beat-repeat element, and only has effect if use-stems is no.

Possible attributes: type@ XSDSimpleTypeStartStop@required, use_dots@ XSDSimpleTypeYesNo, use_stems@ XSDSimpleTypeYesNo

Possible children: XMLExceptVoice, XMLSlashDot, XMLSlashType

XSD structure:
Group@name=slash@minOccurs=0@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=0@maxOccurs=1
            Element@name=slash-type@minOccurs=1@maxOccurs=1
            Element@name=slash-dot@minOccurs=0@maxOccurs=unbounded
        Element@name=except-voice@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLMeasureStyle

TYPE: alias of XSDComplexTypeSlash

XSD_TREE = XSDTree(tag=element, name=slash type=slash)

class musicxml.xmlelement.xmlelement.XMLSlashDot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The slash-dot element is used to specify any augmentation dots in the note type used to display repetition marks.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLBeatRepeat, XMLSlash

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=slash-dot type=empty minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLSlashType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The slash-type element indicates the graphical note type to use for the display of repetition marks.

simpleType: The note-type-value type is used for the MusicXML type element and represents the graphic note type, from 1024th (shortest) to maxima (longest).

Permitted Values: '1024th', '512th', '256th', '128th', '64th', '32nd', '16th', 'eighth', 'quarter', 'half', 'whole', 'breve', 'long', 'maxima'

Possible parents:XMLBeatRepeat, XMLSlash

TYPE: alias of XSDSimpleTypeNoteTypeValue

XSD_TREE = XSDTree(tag=element, name=slash-type type=note-type-value)

class musicxml.xmlelement.xmlelement.XMLSlide(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Glissando and slide types both indicate rapidly moving from one pitch to the other so that individual notes are not discerned. A slide is continuous between the two pitches and defaults to a solid line. The optional text for a is printed alongside the line.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, first_beat@ XSDSimpleTypePercent, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, id@ XSDSimpleTypeID, last_beat@ XSDSimpleTypePercent, line_type@ XSDSimpleTypeLineType, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeSlide

XSD_TREE = XSDTree(tag=element, name=slide type=slide)

class musicxml.xmlelement.xmlelement.XMLSlur(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Slur types are empty. Most slurs are represented with two elements: one with a start type, and one with a stop type. Slurs can add more elements using a continue type. This is typically used to specify the formatting of cross-system slurs, or to specify the shape of very complex slurs.

Possible attributes: bezier_offset2@ XSDSimpleTypeDivisions, bezier_offset@ XSDSimpleTypeDivisions, bezier_x2@ XSDSimpleTypeTenths, bezier_x@ XSDSimpleTypeTenths, bezier_y2@ XSDSimpleTypeTenths, bezier_y@ XSDSimpleTypeTenths, color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, line_type@ XSDSimpleTypeLineType, number@ XSDSimpleTypeNumberLevel, orientation@ XSDSimpleTypeOverUnder, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStartStopContinue@required

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeSlur

XSD_TREE = XSDTree(tag=element, name=slur type=slur)

class musicxml.xmlelement.xmlelement.XMLSmear(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The smear element represents the tilde-shaped smear symbol used in brass notation.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=smear type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLSnapPizzicato(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The snap-pizzicato element represents the snap pizzicato symbol. This is a circle with a line, where the line comes inside the circle. It is distinct from the thumb-position symbol, where the line does not come inside the circle.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=snap-pizzicato type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLSoftAccent(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The soft-accent element indicates a soft accent that is not as heavy as a normal accent. It is often notated as <>. It can be combined with other articulations to implement the first eight symbols in the SMuFL Articulation supplement range.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=soft-accent type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLSoftware(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLEncoding

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=software type=xs:string)

class musicxml.xmlelement.xmlelement.XMLSolo(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The solo element is present if performance is intended by a solo instrument.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLInstrumentChange, XMLScoreInstrument

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=solo type=empty)

class musicxml.xmlelement.xmlelement.XMLSound(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The sound element contains general playback parameters. They can stand alone within a part/measure, or be a component element within a direction.

Tempo is expressed in quarter notes per minute. If 0, the sound-generating program should prompt the user at the time of compiling a sound (MIDI) file.

Dynamics (or MIDI velocity) are expressed as a percentage of the default forte value (90 for MIDI 1.0).

Dacapo indicates to go back to the beginning of the movement. When used it always has the value “yes”.

Segno and dalsegno are used for backwards jumps to a segno sign; coda and tocoda are used for forward jumps to a coda sign. If there are multiple jumps, the value of these parameters can be used to name and distinguish them. If segno or coda is used, the divisions attribute can also be used to indicate the number of divisions per quarter note. Otherwise sound and MIDI generating programs may have to recompute this.

By default, a dalsegno or dacapo attribute indicates that the jump should occur the first time through, while a tocoda attribute indicates the jump should occur the second time through. The time that jumps occur can be changed by using the time-only attribute.

The forward-repeat attribute indicates that a forward repeat sign is implied but not displayed. It is used for example in two-part forms with repeats, such as a minuet and trio where no repeat is displayed at the start of the trio. This usually occurs after a barline. When used it always has the value of “yes”.

The fine attribute follows the final note or rest in a movement with a da capo or dal segno direction. If numeric, the value represents the actual duration of the final note or rest, which can be ambiguous in written notation and different among parts and voices. The value may also be “yes” to indicate no change to the final duration.

If the sound element applies only particular times through a repeat, the time-only attribute indicates which times to apply the sound element.

Pizzicato in a sound element effects all following notes. Yes indicates pizzicato, no indicates arco.

The pan and elevation attributes are deprecated in Version 2.0. The pan and elevation elements in the midi-instrument element should be used instead. The meaning of the pan and elevation attributes is the same as for the pan and elevation elements. If both are present, the mid-instrument elements take priority.

The damper-pedal, soft-pedal, and sostenuto-pedal attributes effect playback of the three common piano pedals and their MIDI controller equivalents. The yes value indicates the pedal is depressed; no indicates the pedal is released. A numeric value from 0 to 100 may also be used for half pedaling. This value is the percentage that the pedal is depressed. A value of 0 is equivalent to no, and a value of 100 is equivalent to yes.

Instrument changes, MIDI devices, MIDI instruments, and playback techniques are changed using the instrument-change, midi-device, midi-instrument, and play elements. When there are multiple instances of these elements, they should be grouped together by instrument using the id attribute values.

The offset element is used to indicate that the sound takes place offset from the current score position. If the sound element is a child of a direction element, the sound offset element overrides the direction offset element if both elements are present. Note that the offset reflects the intended musical position for the change in sound. It should not be used to compensate for latency issues in particular hardware configurations.

Possible attributes: coda@ XSDSimpleTypeToken, dacapo@ XSDSimpleTypeYesNo, dalsegno@ XSDSimpleTypeToken, damper_pedal@ XSDSimpleTypeYesNoNumber, divisions@ XSDSimpleTypeDivisions, dynamics@ XSDSimpleTypeNonNegativeDecimal, elevation@ XSDSimpleTypeRotationDegrees, fine@ XSDSimpleTypeToken, forward_repeat@ XSDSimpleTypeYesNo, id@ XSDSimpleTypeID, pan@ XSDSimpleTypeRotationDegrees, pizzicato@ XSDSimpleTypeYesNo, segno@ XSDSimpleTypeToken, soft_pedal@ XSDSimpleTypeYesNoNumber, sostenuto_pedal@ XSDSimpleTypeYesNoNumber, tempo@ XSDSimpleTypeNonNegativeDecimal, time_only@ XSDSimpleTypeTimeOnly, tocoda@ XSDSimpleTypeToken

Possible children: XMLInstrumentChange, XMLMidiDevice, XMLMidiInstrument, XMLOffset, XMLPlay, XMLSwing

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=0@maxOccurs=unbounded
        Element@name=instrument-change@minOccurs=0@maxOccurs=1
        Element@name=midi-device@minOccurs=0@maxOccurs=1
        Element@name=midi-instrument@minOccurs=0@maxOccurs=1
        Element@name=play@minOccurs=0@maxOccurs=1
    Element@name=swing@minOccurs=0@maxOccurs=1
    Element@name=offset@minOccurs=0@maxOccurs=1

Possible parents:XMLDirection, XMLMeasure

TYPE: alias of XSDComplexTypeSound

XSD_TREE = XSDTree(tag=element, name=sound type=sound)

class musicxml.xmlelement.xmlelement.XMLSoundingPitch(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The sounding-pitch is the pitch which is heard when playing the harmonic.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLHarmonic

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=sounding-pitch type=empty)

class musicxml.xmlelement.xmlelement.XMLSource(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The source for the music that is encoded. This is similar to the Dublin Core source element.

Possible parents:XMLIdentification

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=source type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSpiccato(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The spiccato element is used for a stroke articulation, as opposed to a dot or a wedge.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=spiccato type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLStaccatissimo(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The staccatissimo element is used for a wedge articulation, as opposed to a dot or a stroke.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=staccatissimo type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLStaccato(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The staccato element is used for a dot articulation, as opposed to a stroke or a wedge.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=staccato type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLStaff(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Staff assignment is only needed for music notated on multiple staves. Used by both notes and directions. Staff values are numbers, with 1 referring to the top-most staff in a part.

Possible parents:XMLDirection, XMLForward, XMLHarmony, XMLNote

TYPE: alias of XSDSimpleTypePositiveInteger

XSD_TREE = XSDTree(tag=element, name=staff type=xs:positiveInteger)

class musicxml.xmlelement.xmlelement.XMLStaffDetails(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The staff-details element is used to indicate different types of staves.

complexType: The staff-details element is used to indicate different types of staves. The optional number attribute specifies the staff number from top to bottom on the system, as with clef. The print-object attribute is used to indicate when a staff is not printed in a part, usually in large scores where empty parts are omitted. It is yes by default. If print-spacing is yes while print-object is no, the score is printed in cutaway format where vertical space is left for the empty part.

Possible attributes: number@ XSDSimpleTypeStaffNumber, print_object@ XSDSimpleTypeYesNo, print_spacing@ XSDSimpleTypeYesNo, show_frets@ XSDSimpleTypeShowFrets

Possible children: XMLCapo, XMLLineDetail, XMLStaffLines, XMLStaffSize, XMLStaffTuning, XMLStaffType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=staff-type@minOccurs=0@maxOccurs=1
    Sequence@minOccurs=0@maxOccurs=1
        Element@name=staff-lines@minOccurs=1@maxOccurs=1
        Element@name=line-detail@minOccurs=0@maxOccurs=unbounded
    Element@name=staff-tuning@minOccurs=0@maxOccurs=unbounded
    Element@name=capo@minOccurs=0@maxOccurs=1
    Element@name=staff-size@minOccurs=0@maxOccurs=1

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeStaffDetails

XSD_TREE = XSDTree(tag=element, name=staff-details type=staff-details minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLStaffDistance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLStaffLayout

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=staff-distance type=tenths minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLStaffDivide(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The staff-divide element represents the staff division arrow symbols found at SMuFL code points U+E00B, U+E00C, and U+E00D.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeStaffDivideSymbol@required, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeStaffDivide

XSD_TREE = XSDTree(tag=element, name=staff-divide type=staff-divide)

class musicxml.xmlelement.xmlelement.XMLStaffLayout(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Staff layout includes the vertical distance from the bottom line of the previous staff in this system to the top line of the staff specified by the number attribute. The optional number attribute refers to staff numbers within the part, from top to bottom on the system. A value of 1 is used if not present.

When used in the defaults element, the values apply to all systems in all parts. When used in the print element, the values apply to the current system only. This value is ignored for the first staff in a system.

Possible attributes: number@ XSDSimpleTypeStaffNumber

Possible children: XMLStaffDistance

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=staff-distance@minOccurs=0@maxOccurs=1

Possible parents:XMLDefaults, XMLPrint

TYPE: alias of XSDComplexTypeStaffLayout

XSD_TREE = XSDTree(tag=element, name=staff-layout type=staff-layout minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLStaffLines(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The staff-lines element specifies the number of lines and is usually used for a non 5-line staff. If the staff-lines element is present, the appearance of each line may be individually specified with a line-detail element.

Possible parents:XMLStaffDetails

TYPE: alias of XSDSimpleTypeNonNegativeInteger

XSD_TREE = XSDTree(tag=element, name=staff-lines type=xs:nonNegativeInteger)

class musicxml.xmlelement.xmlelement.XMLStaffSize(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The staff-size element indicates how large a staff space is on this staff, expressed as a percentage of the work’s default scaling. Values less than 100 make the staff space smaller while values over 100 make the staff space larger. A staff-type of cue, ossia, or editorial implies a staff-size of less than 100, but the exact value is implementation-dependent unless specified here. Staff size affects staff height only, not the relationship of the staff to the left and right margins.

In some cases, a staff-size different than 100 also scales the notation on the staff, such as with a cue staff. In other cases, such as percussion staves, the lines may be more widely spaced without scaling the notation on the staff. The scaling attribute allows these two cases to be distinguished. It specifies the percentage scaling that applies to the notation. Values less that 100 make the notation smaller while values over 100 make the notation larger. The staff-size content and scaling attribute are both non-negative decimal values.

simpleContent: The non-negative-decimal type specifies a non-negative decimal value.

Possible attributes: scaling@ XSDSimpleTypeNonNegativeDecimal

Possible parents:XMLStaffDetails

TYPE: alias of XSDComplexTypeStaffSize

XSD_TREE = XSDTree(tag=element, name=staff-size type=staff-size minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLStaffTuning(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The staff-tuning type specifies the open, non-capo tuning of the lines on a tablature staff.

Possible attributes: line@ XSDSimpleTypeStaffLine@required

Possible children: XMLTuningAlter, XMLTuningOctave, XMLTuningStep

XSD structure:
Group@name=tuning@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=tuning-step@minOccurs=1@maxOccurs=1
        Element@name=tuning-alter@minOccurs=0@maxOccurs=1
        Element@name=tuning-octave@minOccurs=1@maxOccurs=1

Possible parents:XMLStaffDetails

TYPE: alias of XSDComplexTypeStaffTuning

XSD_TREE = XSDTree(tag=element, name=staff-tuning type=staff-tuning minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLStaffType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The staff-type value can be ossia, editorial, cue, alternate, or regular. An ossia staff represents music that can be played instead of what appears on the regular staff. An editorial staff also represents musical alternatives, but is created by an editor rather than the composer. It can be used for suggested interpretations or alternatives from other sources. A cue staff represents music from another part. An alternate staff shares the same music as the prior staff, but displayed differently (e.g., treble and bass clef, standard notation and tablature). It is not included in playback. An alternate staff provides more information to an application reading a file than encoding the same music in separate parts, so its use is preferred in this situation if feasible. A regular staff is the standard default staff-type.

Permitted Values: 'ossia', 'editorial', 'cue', 'alternate', 'regular'

Possible parents:XMLStaffDetails

TYPE: alias of XSDSimpleTypeStaffType

XSD_TREE = XSDTree(tag=element, name=staff-type type=staff-type minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLStaves(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The staves element is used if there is more than one staff represented in the given part (e.g., 2 staves for typical piano parts). If absent, a value of 1 is assumed. Staves are ordered from top to bottom in a part in numerical order, with staff 1 above staff 2.

Possible parents:XMLAttributes

TYPE: alias of XSDSimpleTypeNonNegativeInteger

XSD_TREE = XSDTree(tag=element, name=staves type=xs:nonNegativeInteger minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLStem(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Stems can be down, up, none, or double. For down and up stems, the position attributes can be used to specify stem length. The relative values specify the end of the stem relative to the program default. Default values specify an absolute end stem position. Negative values of relative-y that would flip a stem instead of shortening it are ignored. A stem element associated with a rest refers to a stemlet.

simpleContent: The stem-value type represents the notated stem direction.

Permitted Values: 'down', 'up', 'double', 'none'

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeStem

XSD_TREE = XSDTree(tag=element, name=stem type=stem minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible parents:XMLPitch

TYPE: alias of XSDSimpleTypeStep

XSD_TREE = XSDTree(tag=element, name=step type=step)

class musicxml.xmlelement.xmlelement.XMLStick(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The stick type represents pictograms where the material of the stick, mallet, or beater is included.The parentheses and dashed-circle attributes indicate the presence of these marks around the round beater part of a pictogram. Values for these attributes are “no” if not present.

Possible attributes: dashed_circle@ XSDSimpleTypeYesNo, parentheses@ XSDSimpleTypeYesNo, tip@ XSDSimpleTypeTipDirection

Possible children: XMLStickMaterial, XMLStickType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=stick-type@minOccurs=1@maxOccurs=1
    Element@name=stick-material@minOccurs=1@maxOccurs=1

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeStick

XSD_TREE = XSDTree(tag=element, name=stick type=stick)

class musicxml.xmlelement.xmlelement.XMLStickLocation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The stick-location type represents pictograms for the location of sticks, beaters, or mallets on cymbals, gongs, drums, and other instruments.

Permitted Values: 'center', 'rim', 'cymbal bell', 'cymbal edge'

Possible parents:XMLPercussion

TYPE: alias of XSDSimpleTypeStickLocation

XSD_TREE = XSDTree(tag=element, name=stick-location type=stick-location)

class musicxml.xmlelement.xmlelement.XMLStickMaterial(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The stick-material type represents the material being displayed in a stick pictogram.

Permitted Values: 'soft', 'medium', 'hard', 'shaded', 'x'

Possible parents:XMLStick

TYPE: alias of XSDSimpleTypeStickMaterial

XSD_TREE = XSDTree(tag=element, name=stick-material type=stick-material)

class musicxml.xmlelement.xmlelement.XMLStickType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The stick-type type represents the shape of pictograms where the material in the stick, mallet, or beater is represented in the pictogram.

Permitted Values: 'bass drum', 'double bass drum', 'glockenspiel', 'gum', 'hammer', 'superball', 'timpani', 'wound', 'xylophone', 'yarn'

Possible parents:XMLStick

TYPE: alias of XSDSimpleTypeStickType

XSD_TREE = XSDTree(tag=element, name=stick-type type=stick-type)

class musicxml.xmlelement.xmlelement.XMLStopped(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The stopped element represents the stopped symbol, which looks like a plus sign. The smufl attribute distinguishes different SMuFL glyphs that have a similar appearance such as handbellsMalletBellSuspended and guitarClosePedal. If not present, the default glyph is brassMuteClosed.

complexType: The empty-placement-smufl type represents an empty element with print-style, placement, and smufl attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacementSmufl

XSD_TREE = XSDTree(tag=element, name=stopped type=empty-placement-smufl)

class musicxml.xmlelement.xmlelement.XMLStraight(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLSwing

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=straight type=empty)

class musicxml.xmlelement.xmlelement.XMLStress(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The stress element indicates a stressed note.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=stress type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLString(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The string type is used with tablature notation, regular notation (where it is often circled), and chord diagrams. String numbers start with 1 for the highest pitched full-length string.

simpleContent: The string-number type indicates a string number. Strings are numbered from high to low, with 1 being the highest pitched full-length string.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLFrameNote, XMLTechnical

TYPE: alias of XSDComplexTypeString

XSD_TREE = XSDTree(tag=element, name=string type=string)

class musicxml.xmlelement.xmlelement.XMLStringMute(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The string-mute type represents string mute on and mute off symbols.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeOnOff@required, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeStringMute

XSD_TREE = XSDTree(tag=element, name=string-mute type=string-mute)

class musicxml.xmlelement.xmlelement.XMLStrongAccent(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The strong-accent element indicates a vertical accent mark.

complexType: The strong-accent type indicates a vertical accent mark. The type attribute indicates if the point of the accent is down or up.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, type@ XSDSimpleTypeUpDown

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeStrongAccent

XSD_TREE = XSDTree(tag=element, name=strong-accent type=strong-accent)

class musicxml.xmlelement.xmlelement.XMLSuffix(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Values for the suffix element include plus and the accidental values sharp, flat, natural, double-sharp, flat-flat, and sharp-sharp. Suffixes include both symbols that come after the figure number and those that overstrike the figure number. The suffix values slash, back-slash, and vertical are used for slashed numbers indicating chromatic alteration. The orientation and display of the slash usually depends on the figure number. The suffix element may contain additional values for symbols specific to particular figured bass styles.

complexType: The style-text type represents a text element with a print-style attribute group.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLFigure

TYPE: alias of XSDComplexTypeStyleText

XSD_TREE = XSDTree(tag=element, name=suffix type=style-text minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSupports(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The supports type indicates if a MusicXML encoding supports a particular MusicXML element. This is recommended for elements like beam, stem, and accidental, where the absence of an element is ambiguous if you do not know if the encoding supports that element. For Version 2.0, the supports element is expanded to allow programs to indicate support for particular attributes or particular values. This lets applications communicate, for example, that all system and/or page breaks are contained in the MusicXML file.

Possible attributes: attribute@ XSDSimpleTypeNMTOKEN, element@ XSDSimpleTypeNMTOKEN@required, type@ XSDSimpleTypeYesNo@required, value@ XSDSimpleTypeToken

Possible parents:XMLEncoding

TYPE: alias of XSDComplexTypeSupports

XSD_TREE = XSDTree(tag=element, name=supports type=supports)

class musicxml.xmlelement.xmlelement.XMLSwing(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The swing element specifies whether or not to use swing playback, where consecutive on-beat / off-beat eighth or 16th notes are played with unequal nominal durations.

The straight element specifies that no swing is present, so consecutive notes have equal durations.

The first and second elements are positive integers that specify the ratio between durations of consecutive notes. For example, a first element with a value of 2 and a second element with a value of 1 applied to eighth notes specifies a quarter note / eighth note tuplet playback, where the first note is twice as long as the second note. Ratios should be specified with the smallest integers possible. For example, a ratio of 6 to 4 should be specified as 3 to 2 instead.

The optional swing-type element specifies the note type, either eighth or 16th, to which the ratio is applied. The value is eighth if this element is not present.

The optional swing-style element is a string describing the style of swing used.

The swing element has no effect for playback of grace notes, notes where a type element is not present, and notes where the specified duration is different than the nominal value associated with the specified type. If a swung note has attack and release attributes, those values modify the swung playback.

Possible children: XMLFirst, XMLSecond, XMLStraight, XMLSwingStyle, XMLSwingType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Choice@minOccurs=1@maxOccurs=1
        Element@name=straight@minOccurs=1@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=first@minOccurs=1@maxOccurs=1
            Element@name=second@minOccurs=1@maxOccurs=1
            Element@name=swing-type@minOccurs=0@maxOccurs=1
    Element@name=swing-style@minOccurs=0@maxOccurs=1

Possible parents:XMLSound

TYPE: alias of XSDComplexTypeSwing

XSD_TREE = XSDTree(tag=element, name=swing type=swing minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSwingStyle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLSwing

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=swing-style type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSwingType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The swing-type-value type specifies the note type, either eighth or 16th, to which the ratio defined in the swing element is applied.

Permitted Values: '16th', 'eighth'

Possible parents:XMLSwing

TYPE: alias of XSDSimpleTypeSwingTypeValue

XSD_TREE = XSDTree(tag=element, name=swing-type type=swing-type-value minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSyllabic(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: Lyric hyphenation is indicated by the syllabic type. The single, begin, end, and middle values represent single-syllable words, word-beginning syllables, word-ending syllables, and mid-word syllables, respectively.

Permitted Values: 'single', 'begin', 'end', 'middle'

Possible parents:XMLLyric

TYPE: alias of XSDSimpleTypeSyllabic

XSD_TREE = XSDTree(tag=element, name=syllabic type=syllabic minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSymbol(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The symbol element specifies a musical symbol using a canonical SMuFL glyph name. It is used when an occasional musical symbol is interspersed into text. It should not be used in place of semantic markup, such as metronome marks that mix text and symbols. Left justification is used if not specified. Enclosure is none if not specified.

complexType: The formatted-symbol-id type represents a SMuFL musical symbol element with formatting and id attributes.

simpleContent: The smufl-glyph-name type is used for attributes that reference a specific Standard Music Font Layout (SMuFL) character. The value is a SMuFL canonical glyph name, not a code point. For instance, the value for a standard piano pedal mark would be keyboardPedalPed, not U+E650.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, dir@ XSDSimpleTypeTextDirection, enclosure@ XSDSimpleTypeEnclosureShape, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, justify@ XSDSimpleTypeLeftCenterRight, letter_spacing@ XSDSimpleTypeNumberOrNormal, line_height@ XSDSimpleTypeNumberOrNormal, line_through@ XSDSimpleTypeNumberOfLines, overline@ XSDSimpleTypeNumberOfLines, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, rotation@ XSDSimpleTypeRotationDegrees, underline@ XSDSimpleTypeNumberOfLines, valign@ XSDSimpleTypeValign

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeFormattedSymbolId

XSD_TREE = XSDTree(tag=element, name=symbol type=formatted-symbol-id)

class musicxml.xmlelement.xmlelement.XMLSync(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The sync type specifies the style that a score following application should use the synchronize an accompaniment with a performer. If this type is not included in a score, default synchronization depends on the application.

The optional latency attribute specifies a time in milliseconds that the listening application should expect from the performer. The optional player and time-only attributes restrict the element to apply to a single player or set of times through a repeated section, respectively.

Possible attributes: latency@ XSDSimpleTypeMilliseconds, player@ XSDSimpleTypeIDREF, time_only@ XSDSimpleTypeTimeOnly, type@ XSDSimpleTypeSyncType@required

Possible parents:XMLListening

TYPE: alias of XSDComplexTypeSync

XSD_TREE = XSDTree(tag=element, name=sync type=sync)

class musicxml.xmlelement.xmlelement.XMLSystemDistance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLSystemLayout

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=system-distance type=tenths minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSystemDividers(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The system-dividers element indicates the presence or absence of system dividers (also known as system separation marks) between systems displayed on the same page. Dividers on the left and right side of the page are controlled by the left-divider and right-divider elements respectively. The default vertical position is half the system-distance value from the top of the system that is below the divider. The default horizontal position is the left and right system margin, respectively.

When used in the print element, the system-dividers element affects the dividers that would appear between the current system and the previous system.

Possible children: XMLLeftDivider, XMLRightDivider

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=left-divider@minOccurs=1@maxOccurs=1
    Element@name=right-divider@minOccurs=1@maxOccurs=1

Possible parents:XMLSystemLayout

TYPE: alias of XSDComplexTypeSystemDividers

XSD_TREE = XSDTree(tag=element, name=system-dividers type=system-dividers minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSystemLayout(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: A system is a group of staves that are read and played simultaneously. System layout includes left and right margins and the vertical distance from the previous system. The system distance is measured from the bottom line of the previous system to the top line of the current system. It is ignored for the first system on a page. The top system distance is measured from the page’s top margin to the top line of the first system. It is ignored for all but the first system on a page.

Sometimes the sum of measure widths in a system may not equal the system width specified by the layout elements due to roundoff or other errors. The behavior when reading MusicXML files in these cases is application-dependent. For instance, applications may find that the system layout data is more reliable than the sum of the measure widths, and adjust the measure widths accordingly.

When used in the defaults element, the system-layout element defines a default appearance for all systems in the score. If no system-layout element is present in the defaults element, default system layout values are chosen by the application.

When used in the print element, the system-layout element affects the appearance of the current system only. All other systems use the default values as determined by the defaults element. If any child elements are missing from the system-layout element in a print element, the values determined by the defaults element are used there as well. This type of system-layout element need only be read from or written to the first visible part in the score.

Possible children: XMLSystemDistance, XMLSystemDividers, XMLSystemMargins, XMLTopSystemDistance

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=system-margins@minOccurs=0@maxOccurs=1
    Element@name=system-distance@minOccurs=0@maxOccurs=1
    Element@name=top-system-distance@minOccurs=0@maxOccurs=1
    Element@name=system-dividers@minOccurs=0@maxOccurs=1

Possible parents:XMLDefaults, XMLPrint

TYPE: alias of XSDComplexTypeSystemLayout

XSD_TREE = XSDTree(tag=element, name=system-layout type=system-layout minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLSystemMargins(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: System margins are relative to the page margins. Positive values indent and negative values reduce the margin size.

Possible children: XMLLeftMargin, XMLRightMargin

XSD structure:
Group@name=left-right-margins@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=left-margin@minOccurs=1@maxOccurs=1
        Element@name=right-margin@minOccurs=1@maxOccurs=1

Possible parents:XMLSystemLayout

TYPE: alias of XSDComplexTypeSystemMargins

XSD_TREE = XSDTree(tag=element, name=system-margins type=system-margins minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTap(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tap type indicates a tap on the fretboard. The text content allows specification of the notation; + and T are common choices. If the element is empty, the hand attribute is used to specify the symbol to use. The hand attribute is ignored if the tap glyph is already specified by the text content. If neither text content nor the hand attribute are present, the display is application-specific.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, hand@ XSDSimpleTypeTapHand, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeTap

XSD_TREE = XSDTree(tag=element, name=tap type=tap)

class musicxml.xmlelement.xmlelement.XMLTechnical(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Technical indications give performance information for individual instruments.

Possible attributes: id@ XSDSimpleTypeID

Possible children: XMLArrow, XMLBend, XMLBrassBend, XMLDoubleTongue, XMLDownBow, XMLFingering, XMLFingernails, XMLFlip, XMLFret, XMLGolpe, XMLHalfMuted, XMLHammerOn, XMLHandbell, XMLHarmonMute, XMLHarmonic, XMLHeel, XMLHole, XMLOpenString, XMLOpen, XMLOtherTechnical, XMLPluck, XMLPullOff, XMLSmear, XMLSnapPizzicato, XMLStopped, XMLString, XMLTap, XMLThumbPosition, XMLToe, XMLTripleTongue, XMLUpBow

XSD structure:

Choice@minOccurs=0@maxOccurs=unbounded
    Element@name=up-bow@minOccurs=1@maxOccurs=1
    Element@name=down-bow@minOccurs=1@maxOccurs=1
    Element@name=harmonic@minOccurs=1@maxOccurs=1
    Element@name=open-string@minOccurs=1@maxOccurs=1
    Element@name=thumb-position@minOccurs=1@maxOccurs=1
    Element@name=fingering@minOccurs=1@maxOccurs=1
    Element@name=pluck@minOccurs=1@maxOccurs=1
    Element@name=double-tongue@minOccurs=1@maxOccurs=1
    Element@name=triple-tongue@minOccurs=1@maxOccurs=1
    Element@name=stopped@minOccurs=1@maxOccurs=1
    Element@name=snap-pizzicato@minOccurs=1@maxOccurs=1
    Element@name=fret@minOccurs=1@maxOccurs=1
    Element@name=string@minOccurs=1@maxOccurs=1
    Element@name=hammer-on@minOccurs=1@maxOccurs=1
    Element@name=pull-off@minOccurs=1@maxOccurs=1
    Element@name=bend@minOccurs=1@maxOccurs=1
    Element@name=tap@minOccurs=1@maxOccurs=1
    Element@name=heel@minOccurs=1@maxOccurs=1
    Element@name=toe@minOccurs=1@maxOccurs=1
    Element@name=fingernails@minOccurs=1@maxOccurs=1
    Element@name=hole@minOccurs=1@maxOccurs=1
    Element@name=arrow@minOccurs=1@maxOccurs=1
    Element@name=handbell@minOccurs=1@maxOccurs=1
    Element@name=brass-bend@minOccurs=1@maxOccurs=1
    Element@name=flip@minOccurs=1@maxOccurs=1
    Element@name=smear@minOccurs=1@maxOccurs=1
    Element@name=open@minOccurs=1@maxOccurs=1
    Element@name=half-muted@minOccurs=1@maxOccurs=1
    Element@name=harmon-mute@minOccurs=1@maxOccurs=1
    Element@name=golpe@minOccurs=1@maxOccurs=1
    Element@name=other-technical@minOccurs=1@maxOccurs=1

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeTechnical

XSD_TREE = XSDTree(tag=element, name=technical type=technical)

class musicxml.xmlelement.xmlelement.XMLTenths(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLScaling

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=tenths type=tenths)

class musicxml.xmlelement.xmlelement.XMLTenuto(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The tenuto element indicates a tenuto line symbol.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=tenuto type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLText(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The text-element-data type represents a syllable or portion of a syllable for lyric text underlay. A hyphen in the string content should only be used for an actual hyphenated word. Language names for text elements come from ISO 639, with optional country subcodes from ISO 3166.

Possible attributes: color@ XSDSimpleTypeColor, dir@ XSDSimpleTypeTextDirection, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, lang@ XSDSimpleTypeLanguage, letter_spacing@ XSDSimpleTypeNumberOrNormal, line_through@ XSDSimpleTypeNumberOfLines, overline@ XSDSimpleTypeNumberOfLines, rotation@ XSDSimpleTypeRotationDegrees, underline@ XSDSimpleTypeNumberOfLines

Possible parents:XMLLyric

TYPE: alias of XSDComplexTypeTextElementData

XSD_TREE = XSDTree(tag=element, name=text type=text-element-data)

class musicxml.xmlelement.xmlelement.XMLThumbPosition(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The thumb-position element represents the thumb position symbol. This is a circle with a line, where the line does not come within the circle. It is distinct from the snap pizzicato symbol, where the line comes inside the circle.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=thumb-position type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLTie(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tie element indicates that a tie begins or ends with this note. If the tie element applies only particular times through a repeat, the time-only attribute indicates which times to apply it. The tie element indicates sound; the tied element indicates notation.

Possible attributes: time_only@ XSDSimpleTypeTimeOnly, type@ XSDSimpleTypeStartStop@required

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeTie

XSD_TREE = XSDTree(tag=element, name=tie type=tie minOccurs=0 maxOccurs=2)

class musicxml.xmlelement.xmlelement.XMLTied(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tied element represents the notated tie. The tie element represents the tie sound.

The number attribute is rarely needed to disambiguate ties, since note pitches will usually suffice. The attribute is implied rather than defaulting to 1 as with most elements. It is available for use in more complex tied notation situations.

Ties that join two notes of the same pitch together should be represented with a tied element on the first note with type=”start” and a tied element on the second note with type=”stop”. This can also be done if the two notes being tied are enharmonically equivalent, but have different step values. It is not recommended to use tied elements to join two notes with enharmonically inequivalent pitches.

Ties that indicate that an instrument should be undamped are specified with a single tied element with type=”let-ring”.

Ties that are visually attached to only one note, other than undamped ties, should be specified with two tied elements on the same note, first type=”start” then type=”stop”. This can be used to represent ties into or out of repeated sections or codas.

Possible attributes: bezier_offset2@ XSDSimpleTypeDivisions, bezier_offset@ XSDSimpleTypeDivisions, bezier_x2@ XSDSimpleTypeTenths, bezier_x@ XSDSimpleTypeTenths, bezier_y2@ XSDSimpleTypeTenths, bezier_y@ XSDSimpleTypeTenths, color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, line_type@ XSDSimpleTypeLineType, number@ XSDSimpleTypeNumberLevel, orientation@ XSDSimpleTypeOverUnder, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, type@ XSDSimpleTypeTiedType@required

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeTied

XSD_TREE = XSDTree(tag=element, name=tied type=tied)

class musicxml.xmlelement.xmlelement.XMLTime(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Time signatures are represented by the beats element for the numerator and the beat-type element for the denominator.

complexType: Time signatures are represented by the beats element for the numerator and the beat-type element for the denominator. The symbol attribute is used to indicate common and cut time symbols as well as a single number display. Multiple pairs of beat and beat-type elements are used for composite time signatures with multiple denominators, such as 2/4 + 3/8. A composite such as 3+2/8 requires only one beat/beat-type pair.

The print-object attribute allows a time signature to be specified but not printed, as is the case for excerpts from the middle of a score. The value is “yes” if not present. The optional number attribute refers to staff numbers within the part. If absent, the time signature applies to all staves in the part.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, halign@ XSDSimpleTypeLeftCenterRight, id@ XSDSimpleTypeID, number@ XSDSimpleTypeStaffNumber, print_object@ XSDSimpleTypeYesNo, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, separator@ XSDSimpleTypeTimeSeparator, symbol@ XSDSimpleTypeTimeSymbol, valign@ XSDSimpleTypeValign

Possible children: XMLBeatType, XMLBeats, XMLInterchangeable, XMLSenzaMisura

XSD structure:
Choice@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Group@name=time-signature@minOccurs=1@maxOccurs=unbounded
            Sequence@minOccurs=1@maxOccurs=1
                Element@name=beats@minOccurs=1@maxOccurs=1
                Element@name=beat-type@minOccurs=1@maxOccurs=1
        Element@name=interchangeable@minOccurs=0@maxOccurs=1
    Element@name=senza-misura@minOccurs=1@maxOccurs=1

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeTime

XSD_TREE = XSDTree(tag=element, name=time type=time minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLTimeModification(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Time modification indicates tuplets, double-note tremolos, and other durational changes. A time-modification element shows how the cumulative, sounding effect of tuplets and double-note tremolos compare to the written note type represented by the type and dot elements. Nested tuplets and other notations that use more detailed information need both the time-modification and tuplet elements to be represented accurately.

Possible children: XMLActualNotes, XMLNormalDot, XMLNormalNotes, XMLNormalType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=actual-notes@minOccurs=1@maxOccurs=1
    Element@name=normal-notes@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=0@maxOccurs=1
        Element@name=normal-type@minOccurs=1@maxOccurs=1
        Element@name=normal-dot@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeTimeModification

XSD_TREE = XSDTree(tag=element, name=time-modification type=time-modification minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTimeRelation(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The time-relation type indicates the symbol used to represent the interchangeable aspect of dual time signatures.

Permitted Values: 'parentheses', 'bracket', 'equals', 'slash', 'space', 'hyphen'

Possible parents:XMLInterchangeable

TYPE: alias of XSDSimpleTypeTimeRelation

XSD_TREE = XSDTree(tag=element, name=time-relation type=time-relation minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTimpani(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The timpani type represents the timpani pictogram. The smufl attribute is used to distinguish different SMuFL stylistic alternates.

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeTimpani

XSD_TREE = XSDTree(tag=element, name=timpani type=timpani)

class musicxml.xmlelement.xmlelement.XMLToe(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The heel and toe elements are used with organ pedals. The substitution value is “no” if the attribute is not present.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, substitution@ XSDSimpleTypeYesNo

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeHeelToe

XSD_TREE = XSDTree(tag=element, name=toe type=heel-toe)

class musicxml.xmlelement.xmlelement.XMLTopMargin(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLPageMargins

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=top-margin type=tenths)

class musicxml.xmlelement.xmlelement.XMLTopSystemDistance(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

simpleType: The tenths type is a number representing tenths of interline staff space (positive or negative). Both integer and decimal values are allowed, such as 5 for a half space and 2.5 for a quarter space. Interline space is measured from the middle of a staff line.

Distances in a MusicXML file are measured in tenths of staff space. Tenths are then scaled to millimeters within the scaling element, used in the defaults element at the start of a score. Individual staves can apply a scaling factor to adjust staff size. When a MusicXML element or attribute refers to tenths, it means the global tenths defined by the scaling element, not the local tenths as adjusted by the staff-size element.

Possible parents:XMLSystemLayout

TYPE: alias of XSDSimpleTypeTenths

XSD_TREE = XSDTree(tag=element, name=top-system-distance type=tenths minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTouchingPitch(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The touching-pitch is the pitch at which the string is touched lightly to produce the harmonic.

complexType: The empty type represents an empty element with no attributes.

Possible parents:XMLHarmonic

TYPE: alias of XSDComplexTypeEmpty

XSD_TREE = XSDTree(tag=element, name=touching-pitch type=empty)

class musicxml.xmlelement.xmlelement.XMLTranspose(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

If the part is being encoded for a transposing instrument in written vs. concert pitch, the transposition must be encoded in the transpose element using the transpose type.

complexType: The transpose type represents what must be added to a written pitch to get a correct sounding pitch. The optional number attribute refers to staff numbers, from top to bottom on the system. If absent, the transposition applies to all staves in the part. Per-staff transposition is most often used in parts that represent multiple instruments.

Possible attributes: id@ XSDSimpleTypeID, number@ XSDSimpleTypeStaffNumber

Possible children: XMLChromatic, XMLDiatonic, XMLDouble, XMLOctaveChange

XSD structure:
Group@name=transpose@minOccurs=1@maxOccurs=1
    Sequence@minOccurs=1@maxOccurs=1
        Element@name=diatonic@minOccurs=0@maxOccurs=1
        Element@name=chromatic@minOccurs=1@maxOccurs=1
        Element@name=octave-change@minOccurs=0@maxOccurs=1
        Element@name=double@minOccurs=0@maxOccurs=1

Possible parents:XMLAttributes

TYPE: alias of XSDComplexTypeTranspose

XSD_TREE = XSDTree(tag=element, name=transpose type=transpose minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLTremolo(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tremolo ornament can be used to indicate single-note, double-note, or unmeasured tremolos. Single-note tremolos use the single type, double-note tremolos use the start and stop types, and unmeasured tremolos use the unmeasured type. The default is “single” for compatibility with Version 1.1. The text of the element indicates the number of tremolo marks and is an integer from 0 to 8. Note that the number of attached beams is not included in this value, but is represented separately using the beam element. The value should be 0 for unmeasured tremolos.

When using double-note tremolos, the duration of each note in the tremolo should correspond to half of the notated type value. A time-modification element should also be added with an actual-notes value of 2 and a normal-notes value of 1. If used within a tuplet, this 2/1 ratio should be multiplied by the existing tuplet ratio.

The smufl attribute specifies the glyph to use from the SMuFL Tremolos range for an unmeasured tremolo. It is ignored for other tremolo types. The SMuFL buzzRoll glyph is used by default if the attribute is missing.

Using repeater beams for indicating tremolos is deprecated as of MusicXML 3.0.

simpleContent: The number of tremolo marks is represented by a number from 0 to 8: the same as beam-level with 0 added.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, smufl@ XSDSimpleTypeSmuflGlyphName, type@ XSDSimpleTypeTremoloType

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeTremolo

XSD_TREE = XSDTree(tag=element, name=tremolo type=tremolo)

class musicxml.xmlelement.xmlelement.XMLTrillMark(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The trill-mark element represents the trill-mark symbol.

complexType: The empty-trill-sound type represents an empty element with print-style, placement, and trill-sound attributes.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeEmptyTrillSound

XSD_TREE = XSDTree(tag=element, name=trill-mark type=empty-trill-sound)

class musicxml.xmlelement.xmlelement.XMLTripleTongue(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The triple-tongue element represents the triple tongue symbol (three dots arranged horizontally).

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=triple-tongue type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLTuningAlter(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The tuning-alter element is represented like the alter element, with a different name to reflect its different function in string tuning.

simpleType: The semitones type is a number representing semitones, used for chromatic alteration. A value of -1 corresponds to a flat and a value of 1 to a sharp. Decimal values like 0.5 (quarter tone sharp) are used for microtones.

Possible parents:XMLAccord, XMLStaffTuning

TYPE: alias of XSDSimpleTypeSemitones

XSD_TREE = XSDTree(tag=element, name=tuning-alter type=semitones minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTuningOctave(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The tuning-octave element is represented like the octave element, with a different name to reflect its different function in string tuning.

simpleType: Octaves are represented by the numbers 0 to 9, where 4 indicates the octave started by middle C.

Possible parents:XMLAccord, XMLStaffTuning

TYPE: alias of XSDSimpleTypeOctave

XSD_TREE = XSDTree(tag=element, name=tuning-octave type=octave)

class musicxml.xmlelement.xmlelement.XMLTuningStep(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The tuning-step element is represented like the step element, with a different name to reflect its different function in string tuning.

simpleType: The step type represents a step of the diatonic scale, represented using the English letters A through G.

Permitted Values: 'A', 'B', 'C', 'D', 'E', 'F', 'G'

Possible parents:XMLAccord, XMLStaffTuning

TYPE: alias of XSDSimpleTypeStep

XSD_TREE = XSDTree(tag=element, name=tuning-step type=step)

class musicxml.xmlelement.xmlelement.XMLTuplet(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: A tuplet element is present when a tuplet is to be displayed graphically, in addition to the sound data provided by the time-modification elements. The number attribute is used to distinguish nested tuplets. The bracket attribute is used to indicate the presence of a bracket. If unspecified, the results are implementation-dependent. The line-shape attribute is used to specify whether the bracket is straight or in the older curved or slurred style. It is straight by default.

Whereas a time-modification element shows how the cumulative, sounding effect of tuplets and double-note tremolos compare to the written note type, the tuplet element describes how this is displayed. The tuplet element also provides more detailed representation information than the time-modification element, and is needed to represent nested tuplets and other complex tuplets accurately.

The show-number attribute is used to display either the number of actual notes, the number of both actual and normal notes, or neither. It is actual by default. The show-type attribute is used to display either the actual type, both the actual and normal types, or neither. It is none by default.

Possible attributes: bracket@ XSDSimpleTypeYesNo, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, line_shape@ XSDSimpleTypeLineShape, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, show_number@ XSDSimpleTypeShowTuplet, show_type@ XSDSimpleTypeShowTuplet, type@ XSDSimpleTypeStartStop@required

Possible children: XMLTupletActual, XMLTupletNormal

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=tuplet-actual@minOccurs=0@maxOccurs=1
    Element@name=tuplet-normal@minOccurs=0@maxOccurs=1

Possible parents:XMLNotations

TYPE: alias of XSDComplexTypeTuplet

XSD_TREE = XSDTree(tag=element, name=tuplet type=tuplet)

class musicxml.xmlelement.xmlelement.XMLTupletActual(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The tuplet-actual element provide optional full control over how the actual part of the tuplet is displayed, including number and note type (with dots). If any of these elements are absent, their values are based on the time-modification element.

complexType: The tuplet-portion type provides optional full control over tuplet specifications. It allows the number and note type (including dots) to be set for the actual and normal portions of a single tuplet. If any of these elements are absent, their values are based on the time-modification element.

Possible children: XMLTupletDot, XMLTupletNumber, XMLTupletType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=tuplet-number@minOccurs=0@maxOccurs=1
    Element@name=tuplet-type@minOccurs=0@maxOccurs=1
    Element@name=tuplet-dot@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLTuplet

TYPE: alias of XSDComplexTypeTupletPortion

XSD_TREE = XSDTree(tag=element, name=tuplet-actual type=tuplet-portion minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTupletDot(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tuplet-dot type is used to specify dotted tuplet types.

Possible attributes: color@ XSDSimpleTypeColor, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLTupletActual, XMLTupletNormal

TYPE: alias of XSDComplexTypeTupletDot

XSD_TREE = XSDTree(tag=element, name=tuplet-dot type=tuplet-dot minOccurs=0 maxOccurs=unbounded)

class musicxml.xmlelement.xmlelement.XMLTupletNormal(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The tuplet-normal element provide optional full control over how the normal part of the tuplet is displayed, including number and note type (with dots). If any of these elements are absent, their values are based on the time-modification element.

complexType: The tuplet-portion type provides optional full control over tuplet specifications. It allows the number and note type (including dots) to be set for the actual and normal portions of a single tuplet. If any of these elements are absent, their values are based on the time-modification element.

Possible children: XMLTupletDot, XMLTupletNumber, XMLTupletType

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=tuplet-number@minOccurs=0@maxOccurs=1
    Element@name=tuplet-type@minOccurs=0@maxOccurs=1
    Element@name=tuplet-dot@minOccurs=0@maxOccurs=unbounded

Possible parents:XMLTuplet

TYPE: alias of XSDComplexTypeTupletPortion

XSD_TREE = XSDTree(tag=element, name=tuplet-normal type=tuplet-portion minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTupletNumber(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tuplet-number type indicates the number of notes for this portion of the tuplet.

Possible attributes: color@ XSDSimpleTypeColor, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLTupletActual, XMLTupletNormal

TYPE: alias of XSDComplexTypeTupletNumber

XSD_TREE = XSDTree(tag=element, name=tuplet-number type=tuplet-number minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTupletType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The tuplet-type type indicates the graphical note type of the notes for this portion of the tuplet.

simpleContent: The note-type-value type is used for the MusicXML type element and represents the graphic note type, from 1024th (shortest) to maxima (longest).

Permitted Values: '1024th', '512th', '256th', '128th', '64th', '32nd', '16th', 'eighth', 'quarter', 'half', 'whole', 'breve', 'long', 'maxima'

Possible attributes: color@ XSDSimpleTypeColor, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLTupletActual, XMLTupletNormal

TYPE: alias of XSDComplexTypeTupletType

XSD_TREE = XSDTree(tag=element, name=tuplet-type type=tuplet-type minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLTurn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The turn element is the normal turn shape which goes up then down.

complexType: The horizontal-turn type represents turn elements that are horizontal rather than vertical. These are empty elements with print-style, placement, trill-sound, and slash attributes. If the slash attribute is yes, then a vertical line is used to slash the turn. It is no if not specified.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, slash@ XSDSimpleTypeYesNo, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeHorizontalTurn

XSD_TREE = XSDTree(tag=element, name=turn type=horizontal-turn)

class musicxml.xmlelement.xmlelement.XMLType(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The note-type type indicates the graphic note type. Values range from 1024th to maxima. The size attribute indicates full, cue, grace-cue, or large size. The default is full for regular notes, grace-cue for notes that contain both grace and cue elements, and cue for notes that contain either a cue or a grace element, but not both.

simpleContent: The note-type-value type is used for the MusicXML type element and represents the graphic note type, from 1024th (shortest) to maxima (longest).

Permitted Values: '1024th', '512th', '256th', '128th', '64th', '32nd', '16th', 'eighth', 'quarter', 'half', 'whole', 'breve', 'long', 'maxima'

Possible attributes: size@ XSDSimpleTypeSymbolSize

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeNoteType

XSD_TREE = XSDTree(tag=element, name=type type=note-type minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLUnpitched(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The unpitched type represents musical elements that are notated on the staff but lack definite pitch, such as unpitched percussion and speaking voice. If the child elements are not present, the note is placed on the middle line of the staff. This is generally used with a one-line staff. Notes in percussion clef should always use an unpitched element rather than a pitch element.

Possible children: XMLDisplayOctave, XMLDisplayStep

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Group@name=display-step-octave@minOccurs=0@maxOccurs=1
        Sequence@minOccurs=1@maxOccurs=1
            Element@name=display-step@minOccurs=1@maxOccurs=1
            Element@name=display-octave@minOccurs=1@maxOccurs=1

Possible parents:XMLNote

TYPE: alias of XSDComplexTypeUnpitched

XSD_TREE = XSDTree(tag=element, name=unpitched type=unpitched)

class musicxml.xmlelement.xmlelement.XMLUnstress(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The unstress element indicates an unstressed note. It is often notated using a u-shaped symbol.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLArticulations

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=unstress type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLUpBow(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The up-bow element represents the symbol that is used both for up-bowing on bowed instruments, and up-stroke on plucked instruments.

complexType: The empty-placement type represents an empty element with print-style and placement attributes.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLTechnical

TYPE: alias of XSDComplexTypeEmptyPlacement

XSD_TREE = XSDTree(tag=element, name=up-bow type=empty-placement)

class musicxml.xmlelement.xmlelement.XMLVerticalTurn(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The vertical-turn element has the turn symbol shape arranged vertically going from upper left to lower right.

complexType: The empty-trill-sound type represents an empty element with print-style, placement, and trill-sound attributes.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, last_beat@ XSDSimpleTypePercent, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn

Possible parents:XMLOrnaments

TYPE: alias of XSDComplexTypeEmptyTrillSound

XSD_TREE = XSDTree(tag=element, name=vertical-turn type=empty-trill-sound)

class musicxml.xmlelement.xmlelement.XMLVirtualInstrument(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The virtual-instrument element defines a specific virtual instrument used for an instrument sound.

Possible children: XMLVirtualLibrary, XMLVirtualName

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=virtual-library@minOccurs=0@maxOccurs=1
    Element@name=virtual-name@minOccurs=0@maxOccurs=1

Possible parents:XMLInstrumentChange, XMLScoreInstrument

TYPE: alias of XSDComplexTypeVirtualInstrument

XSD_TREE = XSDTree(tag=element, name=virtual-instrument type=virtual-instrument minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLVirtualLibrary(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The virtual-library element indicates the virtual instrument library name.

Possible parents:XMLVirtualInstrument

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=virtual-library type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLVirtualName(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The virtual-name element indicates the library-specific name for the virtual instrument.

Possible parents:XMLVirtualInstrument

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=virtual-name type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLVoice(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

Possible parents:XMLDirection, XMLForward, XMLNote

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=voice type=xs:string)

class musicxml.xmlelement.xmlelement.XMLVolume(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The volume element value is a percentage of the maximum ranging from 0 to 100, with decimal values allowed. This corresponds to a scaling value for the MIDI 1.0 channel volume controller.

simpleType: The percent type specifies a percentage from 0 to 100.

Possible parents:XMLMidiInstrument

TYPE: alias of XSDSimpleTypePercent

XSD_TREE = XSDTree(tag=element, name=volume type=percent minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLWait(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The wait type specifies a point where the accompaniment should wait for a performer event before continuing. This typically happens at the start of new sections or after a held note or indeterminate music. These waiting points cannot always be inferred reliably from the contents of the displayed score. The optional player and time-only attributes restrict the type to apply to a single player or set of times through a repeated section, respectively.

Possible attributes: player@ XSDSimpleTypeIDREF, time_only@ XSDSimpleTypeTimeOnly

Possible parents:XMLListen

TYPE: alias of XSDComplexTypeWait

XSD_TREE = XSDTree(tag=element, name=wait type=wait)

class musicxml.xmlelement.xmlelement.XMLWavyLine(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Wavy lines are one way to indicate trills and vibrato. When used with a barline element, they should always have type=”continue” set. The smufl attribute specifies a particular wavy line glyph from the SMuFL Multi-segment lines range.

Possible attributes: accelerate@ XSDSimpleTypeYesNo, beats@ XSDSimpleTypeTrillBeats, color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, last_beat@ XSDSimpleTypePercent, number@ XSDSimpleTypeNumberLevel, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, second_beat@ XSDSimpleTypePercent, smufl@ XSDSimpleTypeSmuflWavyLineGlyphName, start_note@ XSDSimpleTypeStartNote, trill_step@ XSDSimpleTypeTrillStep, two_note_turn@ XSDSimpleTypeTwoNoteTurn, type@ XSDSimpleTypeStartStopContinue@required

Possible parents:XMLBarline, XMLOrnaments

TYPE: alias of XSDComplexTypeWavyLine

XSD_TREE = XSDTree(tag=element, name=wavy-line type=wavy-line)

class musicxml.xmlelement.xmlelement.XMLWedge(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The wedge type represents crescendo and diminuendo wedge symbols. The type attribute is crescendo for the start of a wedge that is closed at the left side, and diminuendo for the start of a wedge that is closed on the right side. Spread values are measured in tenths; those at the start of a crescendo wedge or end of a diminuendo wedge are ignored. The niente attribute is yes if a circle appears at the point of the wedge, indicating a crescendo from nothing or diminuendo to nothing. It is no by default, and used only when the type is crescendo, or the type is stop for a wedge that began with a diminuendo type. The line-type is solid if not specified.

Possible attributes: color@ XSDSimpleTypeColor, dash_length@ XSDSimpleTypeTenths, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, id@ XSDSimpleTypeID, line_type@ XSDSimpleTypeLineType, niente@ XSDSimpleTypeYesNo, number@ XSDSimpleTypeNumberLevel, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths, space_length@ XSDSimpleTypeTenths, spread@ XSDSimpleTypeTenths, type@ XSDSimpleTypeWedgeType@required

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeWedge

XSD_TREE = XSDTree(tag=element, name=wedge type=wedge)

class musicxml.xmlelement.xmlelement.XMLWithBar(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The with-bar element indicates that the bend is to be done at the bridge with a whammy or vibrato bar. The content of the element indicates how this should be notated. Content values of “scoop” and “dip” refer to the SMuFL guitarVibratoBarScoop and guitarVibratoBarDip glyphs.

complexType: The placement-text type represents a text element with print-style and placement attribute groups.

Possible attributes: color@ XSDSimpleTypeColor, default_x@ XSDSimpleTypeTenths, default_y@ XSDSimpleTypeTenths, font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight, placement@ XSDSimpleTypeAboveBelow, relative_x@ XSDSimpleTypeTenths, relative_y@ XSDSimpleTypeTenths

Possible parents:XMLBend

TYPE: alias of XSDComplexTypePlacementText

XSD_TREE = XSDTree(tag=element, name=with-bar type=placement-text minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLWood(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The wood type represents pictograms for wood percussion instruments. The smufl attribute is used to distinguish different SMuFL stylistic alternates.

simpleContent: The wood-value type represents pictograms for wood percussion instruments. The maraca and maracas values distinguish the one- and two-maraca versions of the pictogram.

Permitted Values: 'bamboo scraper', 'board clapper', 'cabasa', 'castanets', 'castanets with handle', 'claves', 'football rattle', 'guiro', 'log drum', 'maraca', 'maracas', 'quijada', 'rainstick', 'ratchet', 'reco-reco', 'sandpaper blocks', 'slit drum', 'temple block', 'vibraslap', 'whip', 'wood block'

Possible attributes: smufl@ XSDSimpleTypeSmuflPictogramGlyphName

Possible parents:XMLPercussion

TYPE: alias of XSDComplexTypeWood

XSD_TREE = XSDTree(tag=element, name=wood type=wood)

class musicxml.xmlelement.xmlelement.XMLWordFont(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: The empty-font type represents an empty element with font attributes.

Possible attributes: font_family@ XSDSimpleTypeFontFamily, font_size@ XSDSimpleTypeFontSize, font_style@ XSDSimpleTypeFontStyle, font_weight@ XSDSimpleTypeFontWeight

Possible parents:XMLDefaults

TYPE: alias of XSDComplexTypeEmptyFont

XSD_TREE = XSDTree(tag=element, name=word-font type=empty-font minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLWords(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The words element specifies a standard text direction. The enclosure is none if not specified. The language is Italian (“it”) if not specified. Left justification is used if not specified.

complexType: The formatted-text-id type represents a text element with text-formatting and id attributes.

Possible parents:XMLDirectionType

TYPE: alias of XSDComplexTypeFormattedTextId

XSD_TREE = XSDTree(tag=element, name=words type=formatted-text-id)

class musicxml.xmlelement.xmlelement.XMLWork(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

complexType: Works are optionally identified by number and title. The work type also may indicate a link to the opus document that composes multiple scores into a collection.

Possible children: XMLOpus, XMLWorkNumber, XMLWorkTitle

XSD structure:
Sequence@minOccurs=1@maxOccurs=1
    Element@name=work-number@minOccurs=0@maxOccurs=1
    Element@name=work-title@minOccurs=0@maxOccurs=1
    Element@name=opus@minOccurs=0@maxOccurs=1

Possible parents:XMLScorePartwise

TYPE: alias of XSDComplexTypeWork

XSD_TREE = XSDTree(tag=element, name=work type=work minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLWorkNumber(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The work-number element specifies the number of a work, such as its opus number.

Possible parents:XMLWork

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=work-number type=xs:string minOccurs=0)

class musicxml.xmlelement.xmlelement.XMLWorkTitle(value_='', xsd_check=True, **kwargs)[source]

Bases: XMLElement

external documentation

The work-title element specifies the title of a work, not including its opus or other work number.

Possible parents:XMLWork

TYPE: alias of XSDSimpleTypeString

XSD_TREE = XSDTree(tag=element, name=work-title type=xs:string minOccurs=0)