<graceGrp>

(grace group) – A container for a sequence of grace notes.
4.2.5.1.2 Grace Notes
Module
MEI.cmn
Attributes
attach, class, color, copyof, corresp, facs, follows, grace, grace.time, label, layer, n, next, precedes, prev, resp, sameas, staff, synch, tstamp, tstamp.ges, tstamp.real, type, when, xml:base, xml:id
attach(optional)Records whether the grace note group is attached to the following event or to the preceding one. The usual name for the latter is "Nachschlag". Allowed values are: "pre" (Attached to the preceding event.), "post" (Attached to the following event.), "unknown" (Attachment is ambiguous.)
<graceGrp>att.graceGrp.log@attach
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.typedatt.classed@class
color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
<graceGrp>att.graceGrp.visatt.color@color
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
<graceGrp>att.commonatt.linking@copyof
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@corresp
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
<graceGrp>att.facsimile@facs
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@follows
grace(optional)Marks a note or chord as a "grace" (without a definite performed duration) and records from which other note/chord it should "steal" time. Value conforms to data.GRACE.
<graceGrp>att.graceGrp.logatt.graced@grace
grace.time(optional)Records the amount of time to be "stolen" from a non-grace note/chord. Value conforms to data.PERCENT.
<graceGrp>att.graceGrp.logatt.graced@grace.time
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
<graceGrp>att.commonatt.labelled@label
layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
<graceGrp>att.graceGrp.logatt.eventatt.layerIdent@layer
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
<graceGrp>att.commonatt.nNumberLike@n
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@next
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@precedes
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@prev
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.responsibility@resp
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@sameas
staff(recommended)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
<graceGrp>att.graceGrp.logatt.eventatt.staffIdent@staff
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
<graceGrp>att.commonatt.linking@synch
tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
<graceGrp>att.graceGrp.logatt.eventatt.timestamp.log@tstamp
tstamp.ges(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
<graceGrp>att.graceGrp.logatt.eventatt.timestamp.ges@tstamp.ges
tstamp.real(optional)Records the onset time in terms of ISO time. Value conforms to data.ISOTIME.
<graceGrp>att.graceGrp.logatt.eventatt.timestamp.ges@tstamp.real
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
<graceGrp>att.commonatt.typed@type
when(optional)Indicates the point of occurrence of this feature along a time line. Its value must be the ID of a when element elsewhere in the document. Value conforms to data.URI.
<graceGrp>att.graceGrp.logatt.eventatt.alignment@when
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
<graceGrp>att.commonatt.basic@xml:base
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
<graceGrp>att.commonatt.basicatt.id@xml:id
(MEI.shared) Attributes common to many elements.
(MEI.shared) Attributes that form the basis of the att.common class.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
(MEI.shared) Attributes that uniquely identify an element.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
(MEI.shared)
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
(MEI.shared) Attributes that specify element-to-element relationships.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes used to supply a number-like designation for an element.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
(MEI.shared) Attributes capturing information regarding responsibility for some aspect of the text's creation, transcription, editing, or encoding.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
(MEI.facsimile) Attributes that associate a feature corresponding with all or part of an image.
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
(MEI.cmn) Logical domain attributes.
attach(optional)Records whether the grace note group is attached to the following event or to the preceding one. The usual name for the latter is "Nachschlag". Allowed values are: "pre" (Attached to the preceding event.), "post" (Attached to the following event.), "unknown" (Attachment is ambiguous.)
(MEI.shared) Attributes that apply to all written events, , note, chord, rest, etc.
(MEI.performance) Temporal alignment attributes.
when(optional)Indicates the point of occurrence of this feature along a time line. Its value must be the ID of a when element elsewhere in the document. Value conforms to data.URI.
(MEI.shared) Attributes that identify the layer to which a feature applies.
layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
(MEI.shared) Attributes for identifying the staff associated with the current feature.
staff(recommended)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
(MEI.gestural) Attributes that record a performed (as opposed to notated) time stamp.
tstamp.ges(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
tstamp.real(optional)Records the onset time in terms of ISO time. Value conforms to data.ISOTIME.
(MEI.shared) Attributes that record a time stamp in terms of musical time, , beats[.fractional beat part].
tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
(MEI.cmn) Attributes that mark a note or chord as a "grace", how it should "steal" time, and how much time should be allotted to the grace note/chord.
grace(optional)Marks a note or chord as a "grace" (without a definite performed duration) and records from which other note/chord it should "steal" time. Value conforms to data.GRACE.
grace.time(optional)Records the amount of time to be "stolen" from a non-grace note/chord. Value conforms to data.PERCENT.
(MEI.visual) Visual domain attributes.
(MEI.shared) Visual color attributes.
color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
(MEI.gestural) Gestural domain attributes.
(MEI.analytical) Analytical domain attributes.
Common Music Notation (CMN) repertoire component declarations.
attach(optional)Records whether the grace note group is attached to the following event or to the preceding one. The usual name for the latter is "Nachschlag". Allowed values are: "pre" (Attached to the preceding event.), "post" (Attached to the following event.), "unknown" (Attachment is ambiguous.)
grace(optional)Marks a note or chord as a "grace" (without a definite performed duration) and records from which other note/chord it should "steal" time. Value conforms to data.GRACE.
grace.time(optional)Records the amount of time to be "stolen" from a non-grace note/chord. Value conforms to data.PERCENT.
Facsimile component declarations.
facs(optional)Points to one or more images, portions of an image, or surfaces which correspond to the current element. One or more values from data.URI, separated by spaces.
Gestural component declarations.
tstamp.ges(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
tstamp.real(optional)Records the onset time in terms of ISO time. Value conforms to data.ISOTIME.
Performance component declarations.
when(optional)Indicates the point of occurrence of this feature along a time line. Its value must be the ID of a when element elsewhere in the document. Value conforms to data.URI.
Component declarations that are shared between two or more modules.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
color(optional)Used to indicate visual appearance. Do not confuse this with the musical term 'color' as used in pre-CMN notation. Value conforms to data.COLOR.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces.
n(optional)Provides a number-like designation that indicates an element’s position in a sequence of similar elements. May not contain space characters. Value conforms to data.WORD.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
staff(recommended)Signifies the staff on which a notated event occurs or to which a control event applies. Mandatory when applicable. One or more values of datatype positiveInteger, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional beat part], as expressed in the written time signature. Value conforms to data.BEAT.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
Member of
model.eventLike.cmnGroups events that appear in CMN.
Contained By
(MEI.cmn) Groups events that appear in CMN.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
graceGrpA container for a sequence of grace notes.
tupletA group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.
(MEI.cmn) Groups notated events that may appear at the layer level in CMN.
(MEI.shared) Groups notated events that may appear at the layer level in all repertoires.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
layerAn independent stream of events on a staff.
lemContains the lemma, or base text, of a textual variation.
oLayerA layer that contains an alternative to material in another layer.
origContains material which is marked as following the original, rather than being normalized or corrected.
rdgContains a single reading within a textual variation.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Common Music Notation (CMN) repertoire component declarations.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
graceGrpA container for a sequence of grace notes.
oLayerA layer that contains an alternative to material in another layer.
tupletA group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.
Critical apparatus component declarations.
lemContains the lemma, or base text, of a textual variation.
rdgContains a single reading within a textual variation.
Editorial and transcriptional component declarations.
abbrA generic element for 1) a shortened form of a word, including an acronym or 2) a shorthand notation.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
expanContains the expansion of an abbreviation.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Component declarations that are shared between two or more modules.
layerAn independent stream of events on a staff.
May Contain
(MEI.cmn) Groups events that appear in CMN.
bTremA rapid alternation on a single pitch or chord.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
beatRptAn indication that material on a preceding beat should be repeated.
fTremA rapid alternation between a pair of notes (or chords or perhaps between a note and a chord) that are (usually) farther apart than a major second.
graceGrpA container for a sequence of grace notes.
halfmRptA half-measure repeat in any meter.
tupletA group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.
(MEI.critapp) Groups elements that contain a critical apparatus entry.
appContains one or more alternative encodings.
(MEI.edittrans) Groups elements for editorial interventions that may be useful both in transcribing and in authoring processes.
choiceGroups a number of alternative encodings for the same point in a text.
substGroups transcriptional elements when the combination is to be regarded as a single intervention in the text.
(MEI.edittrans) Groups elements used for editorial transcription of pre-existing source materials.
addMarks an addition to the text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
gapIndicates a point where material has been omitted in a transcription, whether as part of sampling practice or for editorial reasons described in the MEI header.
handShiftMarks the beginning of a passage written in a new hand, or of a change in the scribe, writing style, ink or character of the document hand.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
(MEI.shared) Groups event elements that occur in all notational repertoires.
barLineVertical line drawn through one or more staves that divides musical notation into metrical units.
chordA simultaneous sounding of two or more notes in the same layer *with the same duration*.
clefIndication of the exact location of a particular note on the staff and, therefore, the other notes as well.
clefGrpA set of simultaneously-occurring clefs.
custosSymbol placed at the end of a line of music to indicate the first note of the next line. Sometimes called a "direct".
noteA single pitched event.
padAn indication of extra visual space between notational elements.
restA non-sounding event found in the source being transcribed.
spaceA placeholder used to fill an incomplete measure, layer, etc. most often so that the combined duration of the events equals the number of beats in the measure.
(MEI.shared) Groups elements that have the same function as a key signature.
keySigWritten key signature.
(MEI.shared) Groups elements that represent a meter signature.
meterSigWritten meter signature.
meterSigGrpUsed to capture alternating, interchanging, mixed or other non-standard meter signatures.
Common Music Notation (CMN) repertoire component declarations.
bTremA rapid alternation on a single pitch or chord.
beamA container for a series of explicitly beamed events that begins and ends entirely within a measure.
beatRptAn indication that material on a preceding beat should be repeated.
fTremA rapid alternation between a pair of notes (or chords or perhaps between a note and a chord) that are (usually) farther apart than a major second.
graceGrpA container for a sequence of grace notes.
halfmRptA half-measure repeat in any meter.
meterSigWritten meter signature.
meterSigGrpUsed to capture alternating, interchanging, mixed or other non-standard meter signatures.
tupletA group of notes with "irregular" (sometimes called "irrational") rhythmic values, for example, three notes in the time normally occupied by two or nine in the time of five.
Critical apparatus component declarations.
appContains one or more alternative encodings.
Editorial and transcriptional component declarations.
addMarks an addition to the text.
choiceGroups a number of alternative encodings for the same point in a text.
corrContains the correct form of an apparent erroneous passage.
damageContains an area of damage to the physical medium.
delContains information deleted, marked as deleted, or otherwise indicated as superfluous or spurious in the copy text by an author, scribe, annotator, or corrector.
gapIndicates a point where material has been omitted in a transcription, whether as part of sampling practice or for editorial reasons described in the MEI header.
handShiftMarks the beginning of a passage written in a new hand, or of a change in the scribe, writing style, ink or character of the document hand.
origContains material which is marked as following the original, rather than being normalized or corrected.
regContains material which has been regularized or normalized in some sense.
restoreIndicates restoration of material to an earlier state by cancellation of an editorial or authorial marking or instruction.
sicContains apparently incorrect or inaccurate material.
substGroups transcriptional elements when the combination is to be regarded as a single intervention in the text.
suppliedContains material supplied by the transcriber or editor for any reason.
unclearContains material that cannot be transcribed with certainty because it is illegible or inaudible in the source.
Component declarations that are shared between two or more modules.
barLineVertical line drawn through one or more staves that divides musical notation into metrical units.
chordA simultaneous sounding of two or more notes in the same layer *with the same duration*.
clefIndication of the exact location of a particular note on the staff and, therefore, the other notes as well.
clefGrpA set of simultaneously-occurring clefs.
custosSymbol placed at the end of a line of music to indicate the first note of the next line. Sometimes called a "direct".
keySigWritten key signature.
noteA single pitched event.
padAn indication of extra visual space between notational elements.
restA non-sounding event found in the source being transcribed.
spaceA placeholder used to fill an incomplete measure, layer, etc. most often so that the combined duration of the events equals the number of beats in the measure.
Constraints

A graceGrp without a copyof attribute must have at least 1 note, rest, chord, or space descendants.
The grace attribute is not allowed on descendants of a graceGrp with a grace attribute.

Declaration
<elementSpec ident="graceGrp" module="MEI.cmn">
<gloss versionDate="2023-06-16" xml:lang="en">grace group</gloss>
<desc xml:lang="en">A container for a sequence of grace notes.</desc>
<classes>
<memberOf key="att.common"/>
<memberOf key="att.facsimile"/>
<memberOf key="att.graceGrp.log"/>
<memberOf key="att.graceGrp.vis"/>
<memberOf key="att.graceGrp.ges"/>
<memberOf key="att.graceGrp.anl"/>
<memberOf key="model.eventLike.cmn"/>
</classes>
<content>
<rng:zeroOrMore>
<rng:choice>
<rng:ref name="model.eventLike"/>
<rng:ref name="model.eventLike.cmn"/>
<rng:ref name="model.appLike"/>
<rng:ref name="model.editLike"/>
<rng:ref name="model.transcriptionLike"/>
</rng:choice>
</rng:zeroOrMore>
</content>
<constraintSpec ident="When_not_copyof_graceGrp_content" scheme="schematron">
<constraint>
<sch:rule context="mei:graceGrp[not(@copyof)]">
<sch:assert test="count(descendant::*[local-name()='note' or local-name()='rest' or local-name()='chord' or local-name()='space']) > 0">A graceGrp without a copyof attribute must have at least 1 note, rest, chord, or space descendants.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
<constraintSpec ident="When_graced" scheme="schematron">
<constraint>
<sch:rule context="mei:graceGrp[@grace]">
<sch:assert test="not(descendant::mei:*[@grace])">The grace attribute is not allowed on descendants of a graceGrp with a grace attribute.</sch:assert>
</sch:rule>
</constraint>
</constraintSpec>
</elementSpec>
MEI Version: 5.0(#eb14650)