pbcoreInstantiation

pbcoreInstantiation contains subelements that describe a single instantiation of an asset. The definition is malleable, but it should be thought of as any discreet and tangible unit that typically (though not always) comprises a whole representation of the asset. For example, an original master videotape, a preservation master video file, and a low-bitrate access copy would all be considered Instantiations of a single video program. All of the sub-elements held by this element are used to describe the instantiation specifically, not necessarily the asset as a whole.

pbcoreInstantiation can be contained within the elements pbcoreDescriptionDocument or pbcorePart.

Usage: optional, repeatable

Attributes

  • startTime optional.  Attribute startTime combines with the endTime attribute to define a specific media segment within a broader timeline of an asset and/or instantiation.
  • endTime – optional.  Attribute endTime combines with a similar value in the startTime attribute to define a specific media segment within a broader timeline of an asset and/or instantiation.
  • timeAnnotationoptional.  Attribute timeAnnotation includes narrative information intended to clarify information about the value of the startTime and endTime attributes.

Subelements

pbcoreInstantiation contains the following subelements:

  • instantiationIdentifier – required. The instantiationIdentifier element contains an unambiguous reference or identifier for a particular instantiation of an asset.
  • instantiationDate – optional. A date associated with an instantiation.
  • instantiationPhysical – optional. Use the element instantiationPhysical to identify the format of a particular instantiation as it exists in a physical form that occupies physical space (e.g., a tape on a shelf). This includes physical digital media, such as a DV tape, audio CD or authored DVD, as well as analog media.
  • instantiationDigital – optional.  Use the element instantiationDigital to identify the format of a particular instantiation of an asset as it exists as a digital file on a server, hard drive, or other digital storage medium. Digital instantiations should be expressed as a formal Internet MIME types.
  • instantiationStandardoptional.  If the instantiation is a physical item, instantiationStandard can be used to refer to the broadcast standard of the video signal (e.g. NTSC, PAL), or the audio encoding (e.g. Dolby A, vertical cut). If the instantiation is a digital item, instantiationStandard should be used to express the container format of the digital file (e.g. MXF).
  • instantiationLocation required.  instantiationLocation may contain information about a specific location for an instantiation, such as an organization’s name, departmental name, shelf ID and contact information. The instantiationLocation for a digital file should include domain, path or URI to the file.
  • instantiationMediaType optional.  This element identifies the general, high level nature of the content of an instantiation. It uses categories that show how content is presented to an observer, e.g., as a sound, text or moving image.
  • instantiationGenerations optional.  The instantiationGeneration element identifies the use type and provenance of the instantiation. The generation of a video tape may be an “Original Master” or “Dub”, the generation of a film reel may be an “Original Negative” or “Composite Positive”, an audiotape may be a “Master” or “Mix Element”, an image may be a “Photograph” or a “Photocopy”.
  • instantiationFileSize – optional.  This element indicates the file size of a digital instantiation. It should contain only numerical values. As a standard, express the file size in bytes. Units of Measure should be declared in the unitsOfMeasure attribute.
  • instantiationTimeStart – optional.  This element describes the point at which playback begins for a time-based instantiation. It is likely that the content on a tape may begin an arbitrary amount of time after the beginning of the instantiation. Best practice is to use a timestamp format such as HH:MM:SS[:|;]FF or HH:MM:SS.mmm or S.mmm.
  • instantiationDuration optional.  The element instantiationDuration provides a timestamp for the overall length or duration of a time-based media item. It represents the playback time. Best practice is to use a timestamp format such as HH:MM:SS[:|;]FF or HH:MM:SS.mmm or S.mmm
  • instantiationDataRate optional.  The element instantiationDataRate expresses the amount of data in a digital media file that is encoded, delivered or distributed, for every second of time. This should be expressed as numerical data, with the units of measure declared in the unitsOfMeasure attribute. For example, if the audio file is 56 kilobits/second, then 56 should be the value of instantiationDataRate and the attribute unitsOfMeasure should be kilobits/second.
  • instantiationColors optional.  The element instantiationColors indicates the overall color, grayscale, or black and white nature of the presentation of an instantiation, as a single occurrence or combination of occurrences in or throughout the instantiation.
  • instantiationTracks optional.  The element instantiationTracks is simply intended to indicate the number and type of tracks that are found in a media item, whether it is analog or digital. (e.g. 1 video track, 2 audio tracks, 1 text track, 1 sprite track, etc.) Other configuration information specific to these identified tracks should be described using instantiationChannelConfiguration.
  • instantiationChannelConfiguration optional.  The element instantiationChannelConfiguration is designed to indicate, at a general narrative level, the arrangement or configuration of specific channels or layers of information within an instantiation’s tracks. Examples are 2-track mono, 8- track stereo, or video track with alpha channel.
  • instantiationLanguage optional.  The element language identifies the primary language of the instantiation’s audio or text. Alternative audio or text tracks and their associated languages should be identified using the element instantiationAlternativeModes.
  • instantiationAlternativeModes optional.  The element instantiationAlternativeModes is a catch-all metadata element that identifies equivalent alternatives to the primary visual, sound or textual information that exists in an instantiation. These are modes that offer alternative ways to see, hear, and read the content of an instantiation. Examples include DVI (Descriptive Video Information), SAP (Supplementary Audio Program), ClosedCaptions, OpenCaptions, Subtitles, Language Dubs, and Transcripts. For each instance of available alternativeModes, the mode and its associated language should be identified together, if applicable. Examples include ‘SAP in English,’ ‘SAP in Spanish,’ ‘Subtitle in French,’ ‘OpenCaption in Arabic.’
  • instantiationEssenceTrack optional.  The instantiationEssenceTrack element is an XML container element that allows for grouping of related essenceTrack elements and their repeated use. Use instantiationEssenceTrack element to describe the individual streams that comprise an instantiation, such as audio, video, timecode, etc.
  • instantiationRelation optional.  The instantiationRelation element is a container for sub-elements instantiationRelationType and instantiationRelationIdentifier to describe relationships to other instantiations.
  • instantiationRights optional.  The instantiationRights element is a container for sub-elements rightsSummary, rightsLink and rightsEmbedded to describe rights particular to this instantiation.
  • instantiationAnnotation – optional.  The instantiationAnnotation element is used to add any supplementary information about an instantiation of the instantiation or the metadata used to describe it. It clarifies element values, terms, descriptors, and vocabularies that may not be otherwise sufficiently understood.
  • instantiationPart – optional.  InstantiationPart is a container that allows the instantiation to be split into multiple parts, which can describe the parts of a multi-section instantiation, e.g., a multi-disk DVD or vitagraph record and 35mm reel that are intended for synchronous playback. It contains all of the elements that a pbcoreInstantiation element would typically contain.
  • instantiationExtension optional.  Extensions are either a wrapper containing a specific element from another standard OR embedded xml containing the extension.

Examples

Submit any issues or suggested changes for future schema iterations by creating a ticket in our Github repository.