pymusicxml.music_xml_objects.Rest¶
-
class
pymusicxml.music_xml_objects.
Rest
(duration: Union[pymusicxml.music_xml_objects.Duration, str, float], notations: Sequence[Union[Notation, str, xml.etree.ElementTree.Element]] = (), directions: Sequence[Direction] = ())[source]¶ Bases:
pymusicxml.music_xml_objects._XMLNote
Class representing a notated rest.
- Parameters
duration – either a
Duration
object, a string to parse as a duration (seeDuration.from_string()
), or a number of quarter notes.notations – see
Note
directions – see
Note
Inherited Methods
export_to_file
(file_path[, pretty_print])Exports this musical object (wrapped as a score) to the given file path.
Minimum divisor of a quarter note that would be needed to represent the duration of this note accurately.
Returns the number of beams needed to represent this note’s duration.
render
()Renders this component to a tuple of ElementTree.Element.
to_xml
([pretty_print])Renders this component to MusicXML, adding a version tag, but not wrapping it up as a full score.
view_in_software
(command)Uses the given terminal command to create a score out of this musical object, and open it in music notation software.
Wraps this component in a
Score
so that it can be exported and viewedAttributes
Subdivision used when representing this duration.
Length in terms of subdivisions.
True length in terms of the number of quarter notes, taking into tuplet time modification.
Written length in terms of the number of quarter notes.
-
property
divisions
¶ Subdivision used when representing this duration.
-
export_to_file
(file_path: str, pretty_print: bool = True) → None¶ Exports this musical object (wrapped as a score) to the given file path.
- Parameters
file_path – The path of the file we want to write to.
pretty_print – If True, breaks the MusicXML onto multiple lines, with indentation
-
property
length_in_divisions
¶ Length in terms of subdivisions. (See description of “divisions” attribute in
Duration
)
-
min_denominator
() → int¶ Minimum divisor of a quarter note that would be needed to represent the duration of this note accurately. For instance, a triplet quarter note would have min_denominator 3, since it is 2/3 of a quarter.
-
num_beams
() → int¶ Returns the number of beams needed to represent this note’s duration.
-
render
() → Sequence[xml.etree.ElementTree.Element]¶ Renders this component to a tuple of ElementTree.Element. (The reason for making it a tuple is that musical objects like chords are represented by several notes side by side, with all but the first containing a </chord> tag.)
-
to_xml
(pretty_print: bool = False) → str¶ Renders this component to MusicXML, adding a version tag, but not wrapping it up as a full score.
- Parameters
pretty_print – If True, breaks the MusicXML onto multiple lines, with indentation
-
property
true_length
¶ True length in terms of the number of quarter notes, taking into tuplet time modification. Returns 0 in the case of grace notes.
-
view_in_software
(command: str) → None¶ Uses the given terminal command to create a score out of this musical object, and open it in music notation software.
- Parameters
command – The terminal command corresponding to the software with which we want to open the score.
-
wrap_as_score
() → pymusicxml.music_xml_objects.Score¶ Wraps this component in a
Score
so that it can be exported and viewed
-
property
written_length
¶ Written length in terms of the number of quarter notes.