annot

<annot>

(annotation) – Provides a short statement explaining the text or indicating the basis for an assertion.

Module MEI.shared

Attributes


@analog(optional)Contains a reference to a field or element in another descriptive encoding system to which this MEI element is comparable. Value of datatype string. att.bibl
@copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI. att.common.anl
@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. att.common.anl
@dots(optional)Records the number of augmentation dots required by a dotted duration. Value conforms to data.AUGMENTDOT. att.augmentdots
@dur(optional)Records duration using optionally dotted, relative durational values provided by the data.DURATION datatype. When the duration is "irrational", as is sometimes the case with tuplets, multiple space-separated values that add up to the total duration may be used. When dotted values are present, the dots attribute must be ignored. One or more values from data.DURATION.additive, separated by spaces. att.duration.additive
@dur.ges(optional)Records performed duration information that differs from the written duration. Its value may be expressed in several forms; that is, ppq (MIDI clicks and MusicXML 'divisions'), Humdrum **recip values, beats, seconds, or mensural duration values. Value conforms to data.DURATION.gestural. att.duration.performed
@endid(optional)Indicates the final element in a sequence of events to which the feature applies. Value conforms to data.URI. att.startendid
@evaluate(optional)Specifies the intended meaning when a participant in a relationship is itself a pointer. Allowed values are: "all" (If an element pointed to is itself a pointer, then the target of that pointer will be taken, and so on, until an element is found which is not a pointer.), "one" (If an element pointed to is itself a pointer, then its target (whether a pointer or not) is taken as the target of this pointer.), "none" (No further evaluation of targets is carried out beyond that needed to find the element(s) specified in plist or target attribute.)att.targeteval
@facs(optional)Permits the current element to reference a facsimile surface or image zone which corresponds to it. One or more values from data.URI, separated by spaces. att.facsimile
@label(optional)Provides a name or label for an element. The value may be any string. Value of datatype string. att.commonPart
@layer(optional)Identifies the layer to which a feature applies. One or more values of datatype positiveInteger, separated by spaces. att.layerident
@n(optional)Provides a number-like designation for an element. Value conforms to token. att.common
@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. att.common.anl
@plist(optional)Contains a space separated list of references that identify active participants in a collection/relationship, such as notes under a phrase mark; that is, the entities pointed "from". One or more values from data.URI, separated by spaces. att.plist
@prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces. att.common.anl
@resp(optional)Captures information regarding responsibility for some aspect of the text's creation, 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. att.responsibility
@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. att.common.anl
@source(optional)Contains a list of one or more pointers indicating the sources which attest to a given reading. Each value should correspond to the ID of a <source> element located in the document header. One or more values from data.URI, separated by spaces. att.source
@staff(optional)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. att.staffident
@startid(optional)Holds a reference to the first element in a sequence of events to which the feature applies. Value conforms to data.URI. att.startid
@subtype(optional)Provide any sub-classification for the element, additional to that given by its type attribute. Value of datatype NMTOKEN. att.typed
@synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces. att.common.anl
@translit(optional)Specifies the transliteration technique used. Value of datatype NMTOKEN. att.lang
@tstamp(optional)Encodes the onset time in terms of musical time, i.e., beats[.fractional_beat_part]. Value conforms to data.BEAT. att.timestamp.musical
@tstamp.ges(optional)Captures performed onset time in several forms; that is, ppq (MIDI clicks and MusicXML 'divisions'), Humdrum **recip values, beats, seconds, or mensural duration values. Value conforms to data.DURATION.gestural. att.timestamp.performed
@tstamp.real(optional)Used to record the onset time in terms of ISO time. Value conforms to data.ISOTIME. att.timestamp.performed
@tstamp2(optional)Encodes the ending point of an event in terms of musical time, i.e., a count of measures plus a beat location. Value conforms to data.MEASUREBEAT. att.timestamp2.musical
@type(optional)Characterizes the element in some sense, using any convenient classification scheme or typology. Value of datatype NMTOKEN. att.typed
@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. att.alignment
@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. att.commonPart
@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 of datatype ID. att.id
@xml:lang(optional)Identifies the language of the element's content. The values for this attribute are language 'tags' as defined in BCP 47. All language tags that make use of private use sub-tags must be documented in a corresponding language element in the MEI header whose id attribute is the same as the language tag's value. Value of datatype language. att.lang

Member of

model.annotLike

Contained by

MEI.cmngliss measure octave

MEI.critapplem rdg

MEI.edittransabbr add corr cpMark damage del expan orig reg restore sic supplied unclear

MEI.figtablefigDesc td th

MEI.fingeringfing

MEI.harmonyf harm

MEI.namesdatesaddName bloc corpName country district famName foreName genName geogFeat geogName nameLink periodName persName region roleName settlement street styleName

MEI.neumessyllable

MEI.ptrrefref

MEI.textl li quote

MEI.usersymbolsanchoredText line symbolDef

May contain

Text

MEI.edittransabbr add choice corr damage del expan gap handShift orig reg restore sic subst supplied unclear

MEI.figtablefig table

MEI.namesdatesbloc corpName country district geogFeat geogName periodName persName postBox postCode region settlement street styleName

MEI.ptrrefptr ref

MEI.sharedaddress annot bibl biblList castList date eventList head identifier lb name num p pb rend repository stack title

MEI.textlg list quote

MEI.usersymbolssymbol

Declaration


                  <classes>
                     
                     <memberOf
                           key="att.bibl"/>
                     
                     <memberOf
                           key="att.common"/>
                     
                     <memberOf
                           key="att.facsimile"/>
                     
                     <memberOf
                           key="att.lang"/>
                     
                     <memberOf
                           key="att.source"/>
                     
                     <memberOf
                           key="att.annot.log"/>
                     
                     <memberOf
                           key="att.annot.vis"/>
                     
                     <memberOf
                           key="att.annot.ges"/>
                     
                     <memberOf
                           key="att.annot.anl"/>
                     
                     <memberOf
                           key="att.plist"/>
                     
                     <memberOf
                           key="att.responsibility"/>
                     
                     <memberOf
                           key="att.targeteval"/>
                     
                     <memberOf
                           key="att.typed"/>
                     
                     <memberOf
                           key="model.annotLike"/>
                     </classes>
                  <content>
                     
                     <rng:zeroOrMore>
                        
                        <rng:choice>
                           
                           <rng:text/>
                           
                           <rng:ref
                                 
                                 name="model.headLike"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.textcomponentLike"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.textphraseLike"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.editLike"
                                 />
                           
                           <rng:ref
                                 
                                 name="model.transcriptionLike"
                                 />
                           </rng:choice>
                        </rng:zeroOrMore>
                     </content>

Remarks

The annot element can be used for both general comments and for annotations of the musical text. It provides a way to group participating *events* and/or *control events*, for example, the notes that form a descending bass line, and provide a label for and comment regarding the group. Participating entities may be identified in the plist attribute. An editorial or analytical comment or observation may be included directly within the annot element. The starting point of the annotation may be indicated by either a tstamp, tstamp.ges, tstamp.real or startid attribute, while the ending point may be recorded by either a dur, dur.ges or endid attribute. The resp attribute records the editor(s) responsible for identifying or creating the annotation.

Constraint

Head elements can only occur at the start of annot.

Mixed content is not allowed when head, lg, p, quote, or table is used.

Unstructured text not allowed when head, lg, p, quote, or table elements are used.


                  <sch:rule context="mei:annot[mei:head or mei:lg or mei:p or mei:quote or mei:table]">
                     
                     <sch:assert test="not(mei:head[preceding-sibling::*[not(local-name()='head')]])">Head
                        elements can only occur at the start of annot.</sch:assert>
                     
                     <sch:assert test="not(*[../text()[normalize-space()]])">Mixed content is not allowed
                        when head, lg, p, quote, or table is used.</sch:assert>
                     
                     <sch:assert test="not(*[not(local-name() eq 'biblList' or local-name() eq 'castList' or local-name()
                              eq 'head' or                local-name() eq 'lg' or local-name() eq 'list' or local-name()
                              eq 'p' or local-name() eq 'quote' or                local-name() eq 'table')])">Unstructured text not allowed when head, lg, p, quote, or table elements are
                        used.</sch:assert>
                     </sch:rule>