Class Name: Citation

Superclass - <SEDRIS Abstract Base>

Subclasses

Definition

An instance of this DRM class specifies the recommended bibliographic reference information to be used for the data set being described, such that the information is provided in an [ISO 19115] compatible form.

In the documentation for this class, the phrase "the data set" refers to "the data set being described by the given <Citation> instance". This, in turn, refers to the object tree rooted at the aggregate of the <Citation> instance.

If a <Citation> instance is shared by multiple aggregate objects, "the data set" refers to the collection of object trees rooted at its various aggregates.

Primary Page in DRM Diagram:

• 20

Secondary Pages in DRM Diagram:

• 1
• 2
• 6
• 10
• 14
• 19
• 22

Example

1. Consider a SEDRIS transmittal produced from Vector Product Format (VPF) source data, where the source data is not part of a series, and where this is its first edition as a SEDRIS transmittal. In this case, the transmittal was produced by Sterling Logicon, via their VPF-SEDRIS conversion software.

   The citation information for the transmittal's <Transmittal Root> is as follows.

   title	"dtopn/t007us01";
   edition	"1.0";
   series_name	"N/A";
   issue_identification	"N/A";
   other_citation_details	"Created using VPF-SEDRIS Converter";

   The <Absolute Time> instance's fields are set to the following.

   time_significance	SE_TIME_SIGNIF_PUBLICATION_DATE
   time_value. value.ymd_hms. year	2002
   time_value. value.ymd_hms. month	SE_MONTH_JUNE
   time_value. value.ymd_hms. day_of_month	22
   time_value. value.ymd_hms. hour	14
   time_value. value.ymd_hms. minutes	56
   time_value. value.ymd_hms. seconds	30.0

FAQs

What is the purpose of this class?

This class provides [ISO 19115] compliant metadata that allows a <Transmittal Root> or a high-level component of a <Transmittal Root> (e.g., a <Model>, <Image>, etc.) to be referenced in external documents. <Citation> identifies the object by name and edition/version, and specifies who created and/or released the object, and when it was created/released.

Constraints

• <<Publishable Object>>
• <<Mandatory Metadata>>

Composed of (two-way)

• one <Absolute Time> instance (notes)

Composed of (two-way metadata)

• one <Responsible Party> instance (notes)

Component of (two-way)

• zero or more <Colour Table> instances
• zero or more <Colour Table Group> instances
• zero or more <Cross Reference> instances
• zero or more <Data Table> instances
• zero or more <Environment Root> instances
• zero or more <Image> instances
• zero or more <Keywords> instances
• zero or more <Library> instances
• zero or more <Model> instances
• zero or more <Property Set> instances
• zero or more <Property Set Table> instances
• zero or more <Property Set Table Group> instances
• zero or more <Sound> instances
• zero or more <Source> instances
• zero or more <Symbol> instances
• zero or one <Transmittal Root> instance

Inherited Field Elements

Field Elements

Notes

Composed of Notes

Absolute_Time

 This specifies the date (mandatory) and time (optional) that the
 data set being described was released.

Responsible_Party

 This identifies the party responsible for the data set.

Fields Notes

title

 The title field specifies the name by which the data object is known.

edition

 If provided, the edition field specifies the version of the
 data object.

series_name

 The series_name field specifies the name of the series, or
 aggregate data set, of which the given data set is a part.

issue_identification

 The issue_identification field identifies the issue of the series.

other_citation_details

 The other_citation_details field supplies any other information
 required to complete the citation that is not recorded elsewhere.