RepresentedVariable

Fully qualified class name: DDICDIModels::DDICDILibrary::Classes::Conceptual::RepresentedVariable

Definition

Conceptual variable with a substantive value domain specified.

Examples

The pair (Number of Employees, Integer), where “Number of Employees” is the characteristic of the population (variable) and “Integer” is how that measure will be represented (value domain).

Explanatory notes

Extends from conceptual variable and can contain all descriptive fields without creating a conceptual variable. By referencing a conceptual variable it can indicate a common relationship with represented variables expressing the same characteristic of a universe measured in another way, such as Age of Persons in hours rather than years. Represented variable constrains the coverage of the unit type to a specific universe. In the above case the universe with the measurement of Age in hours may be constrained to Persons under 5 days (120 hours old). Represented variable can define sentinel values for multiple storage systems which have the same conceptual domain but specialized value domains.

Diagram

Inheritance
Conceptual::Concept
  ᐊ── Conceptual::ConceptualVariable
    ᐊ── Conceptual::RepresentedVariable
      ᐊ── Long::DescriptorVariable
      ᐊ── Conceptual::InstanceVariable
      ᐊ── Long::ReferenceVariable
Attributes

Name

Inherited from

Description

Data Type

Multiplicity

Default value

describedUnitOfMeasure

- own class -

The unit in which the data values are measured (kg, pound, euro), expressed as a value from a controlled system of entries (i.e., QDT). Supports the provision of an identifier for the entry in the authoritative source (a URI, etc.), and the specific vocabulary.

ControlledVocabularyEntry

0..1

hasIntendedDataType

- own class -

The data type intended to be used by this variable. Supports the optional use of an external controlled vocabulary.

ControlledVocabularyEntry

0..1

simpleUnitOfMeasure

- own class -

The unit in which the data values are measured (kg, pound, euro), expressed as a simple string, in cases where no additional information is available (in the legacy system) or needed (as in the case of broad agreement within the community of use [i.e., ISO country codes, currencies, etc. in SDMX])

String

0..1

descriptiveText

Conceptual::ConceptualVariable

A short natural language account of the characteristics of the object.

InternationalString

0..1

unitOfMeasureKind

Conceptual::ConceptualVariable

Kind of unit of measure, so that it may be prone to translation to equivalent UOMs. Example values include “acceleration,” “temperature,” “salinity”, etc. This description exists at the conceptual level, indicating a limitation on the type of representations which may be used for the variable as it is made more concrete.

ControlledVocabularyEntry

0..1

catalogDetails

Conceptual::Concept

Bundles the information useful for a data catalog entry. Examples would be creator, contributor, title, copyright, embargo, and license information. A set of information useful for attribution, data discovery, and access. This is information that is tied to the identity of the object. If this information changes the version of the associated object changes.

CatalogDetails

0..1

definition

Conceptual::Concept

Natural language statement conveying the meaning of a concept, differentiating it from other concepts. Supports the use of multiple languages and structured text. ‘externalDefinition’ can’t be used if ‘definition’ is used.

InternationalString

0..1

displayLabel

Conceptual::Concept

A human-readable display label for the object. Supports the use of multiple languages. Repeat for labels with different content, for example, labels with differing length limitations.

LabelForDisplay

0..*

externalDefinition

Conceptual::Concept

A reference to an external definition of a concept (that is, a concept which is described outside the content of the DDI-CDI metadata description). An example is a SKOS concept. The definition property is assumed to duplicate the external one referenced if externalDefinition is used. Other corresponding properties are assumed to be included unchanged if used.

Reference

0..1

identifier

Conceptual::Concept

Identifier for objects requiring short- or long-lasting referencing and management.

Identifier

0..1

name

Conceptual::Concept

Human understandable name (linguistic signifier, word, phrase, or mnemonic). May follow ISO/IEC 11179-5 naming principles, and have context provided to specify usage.

ObjectName

0..*
Associations

Direction

Association

Description

Multiplicity of RepresentedVariable

Package of Other Class

Other Class

Multiplicity of other class

Aggregation Kind

Inherited from

from

ConceptualVariable measures UnitType

The measures association is intended to describe specific relationships between the ConceptualVariable and UnitType classes, and similar relationships between their sub-classes. This is documented in section VII.D.5 of the “DDI-Cross Domain Integration: Detailed Model” document.

0..*

- own package -

UnitType

0..1

none

Conceptual::ConceptualVariable

from

ConceptualVariable takesSentinelConceptsFrom SentinelConceptualDomain

Identifies the conceptual domain containing the set of sentinel concepts used to describe the conceptual variable.

0..*

- own package -

SentinelConceptualDomain

0..1

none

Conceptual::ConceptualVariable

from

ConceptualVariable takesSubstantiveConceptsFrom SubstantiveConceptualDomain

Identifies the substantive conceptual domain containing the set of substantive concepts used to describe the conceptual variable.

0..*

- own package -

SubstantiveConceptualDomain

0..1

none

Conceptual::ConceptualVariable

to

VariableCollection has ConceptualVariable

Variable collection has zero to many conceptual variables.

0..*

- own package -

VariableCollection

0..*

none

Conceptual::ConceptualVariable

to

VariablePosition indexes ConceptualVariable

Variable position indexes a conceptual variable.

1..1

- own package -

VariablePosition

0..*

none

Conceptual::ConceptualVariable

to

VariableRelationship hasSource ConceptualVariable

0..*

- own package -

VariableRelationship

0..*

none

Conceptual::ConceptualVariable

to

VariableRelationship hasTarget ConceptualVariable

Note that this can be realized as a collection to support tuples.

0..*

- own package -

VariableRelationship

0..*

none

Conceptual::ConceptualVariable

to

AgentListing isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

Agents

AgentListing

0..*

none

Conceptual::Concept

to

ClassificationFamily isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

Representations

ClassificationFamily

0..*

none

Conceptual::Concept

to

ClassificationIndex isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

Representations

ClassificationIndex

0..*

none

Conceptual::Concept

to

ClassificationSeries isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

Representations

ClassificationSeries

0..*

none

Conceptual::Concept

to

Concept uses Concept

The uses association is intended to describe specific relationships between Concepts and several of its sub-classes. This is documented in section VII.D.5 of the “DDI-Cross Domain Integration: Detailed Model” document.

0..*

- own package -

Concept

0..*

none

Conceptual::Concept

to

ConceptMap hasSource Concept

Concept map has one to many source concepts.

1..*

- own package -

ConceptMap

0..*

none

Conceptual::Concept

to

ConceptMap hasTarget Concept

Concept map has one to many target concepts.

1..*

- own package -

ConceptMap

0..*

none

Conceptual::Concept

to

ConceptRelationship hasSource Concept

Restricts source object to concept for the relationship.

1..1

- own package -

ConceptRelationship

0..*

none

Conceptual::Concept

to

ConceptRelationship hasTarget Concept

Restricts target object to concept for the relationship.

1..1

- own package -

ConceptRelationship

0..*

none

Conceptual::Concept

to

ConceptSystem has Concept

Concept system has zero to many concepts.

0..*

- own package -

ConceptSystem

0..*

none

Conceptual::Concept

to

ConceptSystem isDefinedBy Concept

Concept system is defined by zero to many concepts. The conceptual basis for the collection of members.

0..*

- own package -

ConceptSystem

0..*

none

Conceptual::Concept

to

DataStore isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

FormatDescription

DataStore

0..*

none

Conceptual::Concept

to

EnumerationDomain isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

Representations

EnumerationDomain

0..*

none

Conceptual::Concept

to

Level isDefinedBy Concept

A concept or concept sub-type which describes the level.

0..1

Representations

Level

0..*

none

Conceptual::Concept

to

LogicalRecord isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

FormatDescription

LogicalRecord

0..*

none

Conceptual::Concept

to

PhysicalDataSet isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

FormatDescription

PhysicalDataSet

0..*

none

Conceptual::Concept

to

PhysicalRecordSegment isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

FormatDescription

PhysicalRecordSegment

0..*

none

Conceptual::Concept

to

PhysicalSegmentLayout isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

FormatDescription

PhysicalSegmentLayout

0..*

none

Conceptual::Concept

to

VariableCollection isDefinedBy Concept

The conceptual basis for the collection of members.

0..*

- own package -

VariableCollection

0..*

none

Conceptual::Concept

to

DataStructureComponent isDefinedBy RepresentedVariable

Data structure component is defined by zero to one represented variable.

0..1

Components

DataStructureComponent

0..*

none

- own class -

from

RepresentedVariable takesSentinelValuesFrom SentinelValueDomain

A represented variable may have more than one sets of sentinel value domains, one for each type of software platform on which related instance variables might be instantiated. All of the sentinel value domains must have sentinel conceptual domains that correspond exactly. This allows codes for missing values to be explicitly matched across platforms.

0..*

Representations

SentinelValueDomain

0..*

none

- own class -

from

RepresentedVariable takesSubstantiveValuesFrom SubstantiveValueDomain

The substantive representation (substantive value domain) of the variable. This is equivalent to the relationship “Measures” in the Generic Statistical Information Model (GSIM) although GSIM makes no distinction between substantive and sentinel values.

0..*

Representations

SubstantiveValueDomain

0..1

none

- own class -
Syntax representations / encodings

All syntax representations except the Canonical XMI are provided as reference points for specific implementations, or for use as defaults if sufficient in the form presented.

Fragment for the class RepresentedVariable (entire model as XMI)

  1<packagedElement xmlns:StandardProfile="http://www.eclipse.org/uml2/5.0.0/UML/Profile/Standard"
  2                 xmlns:uml="http://www.eclipse.org/uml2/5.0.0/UML"
  3                 xmlns:xmi="http://www.omg.org/spec/XMI/20131001"
  4                 xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable"
  5                 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable"
  6                 xmi:type="uml:Class">
  7   <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedComment"
  8                 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedComment"
  9                 xmi:type="uml:Comment">
 10      <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable"/>
 11      <body>Definition 
 12========== 
 13Conceptual variable with a substantive value domain specified.   
 14
 15Examples 
 16========== 
 17The pair (Number of Employees, Integer), where "Number of Employees" is the characteristic of the population (variable) and "Integer" is how that measure will be represented (value domain).  
 18
 19Explanatory notes 
 20=================== 
 21Extends from conceptual variable and can contain all descriptive fields without creating a conceptual variable. By referencing a conceptual variable it can indicate a common relationship with represented variables expressing the same characteristic of a universe measured in another way, such as Age of Persons in hours rather than years. Represented variable constrains the coverage of the unit type to a specific universe. In the above case the universe with the measurement of Age in hours may be constrained to Persons under 5 days (120 hours old). Represented variable can define sentinel values for multiple storage systems which have the same conceptual domain but specialized value domains.</body>
 22   </ownedComment>
 23   <name>RepresentedVariable</name>
 24   <generalization xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-generalization"
 25                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-generalization"
 26                   xmi:type="uml:Generalization">
 27      <general xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-ConceptualVariable"/>
 28   </generalization>
 29   <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-describedUnitOfMeasure"
 30                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-describedUnitOfMeasure"
 31                   xmi:type="uml:Property">
 32      <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-describedUnitOfMeasure-ownedComment"
 33                    xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-describedUnitOfMeasure-ownedComment"
 34                    xmi:type="uml:Comment">
 35         <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-describedUnitOfMeasure"/>
 36         <body>The unit in which the data values are measured (kg, pound, euro), expressed as a value from a controlled system of entries (i.e., QDT). Supports the provision of an identifier for the entry in the authoritative source (a URI, etc.), and the specific vocabulary.</body>
 37      </ownedComment>
 38      <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-describedUnitOfMeasure-lowerValue"
 39                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-describedUnitOfMeasure-lowerValue"
 40                  xmi:type="uml:LiteralInteger"/>
 41      <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-describedUnitOfMeasure-upperValue"
 42                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-describedUnitOfMeasure-upperValue"
 43                  xmi:type="uml:LiteralUnlimitedNatural">
 44         <value>1</value>
 45      </upperValue>
 46      <name>describedUnitOfMeasure</name>
 47      <type xmi:idref="DDICDIModels-DDICDILibrary-DataTypes-StructuredDataTypes-ControlledVocabularyEntry"/>
 48   </ownedAttribute>
 49   <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-hasIntendedDataType"
 50                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-hasIntendedDataType"
 51                   xmi:type="uml:Property">
 52      <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-hasIntendedDataType-ownedComment"
 53                    xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-hasIntendedDataType-ownedComment"
 54                    xmi:type="uml:Comment">
 55         <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-hasIntendedDataType"/>
 56         <body>The data type intended to be used by this variable. Supports the optional use of an external controlled vocabulary.</body>
 57      </ownedComment>
 58      <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-hasIntendedDataType-lowerValue"
 59                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-hasIntendedDataType-lowerValue"
 60                  xmi:type="uml:LiteralInteger"/>
 61      <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-hasIntendedDataType-upperValue"
 62                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-hasIntendedDataType-upperValue"
 63                  xmi:type="uml:LiteralUnlimitedNatural">
 64         <value>1</value>
 65      </upperValue>
 66      <name>hasIntendedDataType</name>
 67      <type xmi:idref="DDICDIModels-DDICDILibrary-DataTypes-StructuredDataTypes-ControlledVocabularyEntry"/>
 68   </ownedAttribute>
 69   <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedAttribute_1"
 70                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedAttribute_1"
 71                   xmi:type="uml:Property">
 72      <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedAttribute_1-lowerValue"
 73                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedAttribute_1-lowerValue"
 74                  xmi:type="uml:LiteralInteger"/>
 75      <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedAttribute_1-upperValue"
 76                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedAttribute_1-upperValue"
 77                  xmi:type="uml:LiteralUnlimitedNatural">
 78         <value>*</value>
 79      </upperValue>
 80      <association xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain"/>
 81      <type xmi:idref="DDICDIModels-DDICDILibrary-Classes-Representations-SentinelValueDomain"/>
 82   </ownedAttribute>
 83   <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedAttribute_2"
 84                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedAttribute_2"
 85                   xmi:type="uml:Property">
 86      <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedAttribute_2-lowerValue"
 87                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedAttribute_2-lowerValue"
 88                  xmi:type="uml:LiteralInteger"/>
 89      <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-ownedAttribute_2-upperValue"
 90                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-ownedAttribute_2-upperValue"
 91                  xmi:type="uml:LiteralUnlimitedNatural">
 92         <value>1</value>
 93      </upperValue>
 94      <association xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain"/>
 95      <type xmi:idref="DDICDIModels-DDICDILibrary-Classes-Representations-SubstantiveValueDomain"/>
 96   </ownedAttribute>
 97   <ownedAttribute xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-simpleUnitOfMeasure"
 98                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-simpleUnitOfMeasure"
 99                   xmi:type="uml:Property">
100      <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-simpleUnitOfMeasure-ownedComment"
101                    xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-simpleUnitOfMeasure-ownedComment"
102                    xmi:type="uml:Comment">
103         <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-simpleUnitOfMeasure"/>
104         <body>The unit in which the data values are measured (kg, pound, euro), expressed as a simple string, in cases where no additional information is available (in the legacy system) or needed (as in the case of broad agreement within the community of use [i.e., ISO country codes, currencies, etc. in SDMX])</body>
105      </ownedComment>
106      <lowerValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-simpleUnitOfMeasure-lowerValue"
107                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-simpleUnitOfMeasure-lowerValue"
108                  xmi:type="uml:LiteralInteger"/>
109      <upperValue xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-RepresentedVariable-simpleUnitOfMeasure-upperValue"
110                  xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#RepresentedVariable-simpleUnitOfMeasure-upperValue"
111                  xmi:type="uml:LiteralUnlimitedNatural">
112         <value>1</value>
113      </upperValue>
114      <name>simpleUnitOfMeasure</name>
115      <type href="http://www.eclipse.org/uml2/5.0.0/UML/PrimitiveTypes.xmi#String"
116            xmi:type="uml:PrimitiveType"/>
117   </ownedAttribute>
118</packagedElement>

Fragment for the class RepresentedVariable (entire XML Schema)

  1<xs:element name="RepresentedVariable"
  2            type="RepresentedVariableXsdType"
  3            xml:id="RepresentedVariable">
  4  <!-- based on the UML class DDICDIModels::DDICDILibrary::Classes::Conceptual::RepresentedVariable -->
  5  <xs:annotation>
  6    <xs:documentation>Definition 
  7          ========== 
  8          Conceptual variable with a substantive value domain specified.   
  9          
 10          Examples 
 11          ========== 
 12          The pair (Number of Employees, Integer), where "Number of Employees" is the characteristic of the population (variable) and "Integer" is how that measure will be represented (value domain).  
 13          
 14          Explanatory notes 
 15          =================== 
 16          Extends from conceptual variable and can contain all descriptive fields without creating a conceptual variable. By referencing a conceptual variable it can indicate a common relationship with represented variables expressing the same characteristic of a universe measured in another way, such as Age of Persons in hours rather than years. Represented variable constrains the coverage of the unit type to a specific universe. In the above case the universe with the measurement of Age in hours may be constrained to Persons under 5 days (120 hours old). Represented variable can define sentinel values for multiple storage systems which have the same conceptual domain but specialized value domains.</xs:documentation>
 17  </xs:annotation>
 18</xs:element>
 19<xs:complexType name="RepresentedVariableXsdType"
 20                xml:id="RepresentedVariableXsdType">
 21  <xs:annotation>
 22    <xs:documentation>Definition 
 23          ========== 
 24          Conceptual variable with a substantive value domain specified.   
 25          
 26          Examples 
 27          ========== 
 28          The pair (Number of Employees, Integer), where "Number of Employees" is the characteristic of the population (variable) and "Integer" is how that measure will be represented (value domain).  
 29          
 30          Explanatory notes 
 31          =================== 
 32          Extends from conceptual variable and can contain all descriptive fields without creating a conceptual variable. By referencing a conceptual variable it can indicate a common relationship with represented variables expressing the same characteristic of a universe measured in another way, such as Age of Persons in hours rather than years. Represented variable constrains the coverage of the unit type to a specific universe. In the above case the universe with the measurement of Age in hours may be constrained to Persons under 5 days (120 hours old). Represented variable can define sentinel values for multiple storage systems which have the same conceptual domain but specialized value domains.</xs:documentation>
 33  </xs:annotation>
 34  <xs:complexContent>
 35    <xs:extension base="ConceptualVariableXsdType">
 36      <xs:sequence>
 37        <xs:element name="describedUnitOfMeasure"
 38                    type="ControlledVocabularyEntryXsdType"
 39                    minOccurs="0"
 40                    maxOccurs="1"
 41                    xml:id="RepresentedVariable-describedUnitOfMeasure">
 42          <xs:annotation>
 43            <xs:documentation>The unit in which the data values are measured (kg, pound, euro), expressed as a value from a controlled system of entries (i.e., QDT). Supports the provision of an identifier for the entry in the authoritative source (a URI, etc.), and the specific vocabulary.</xs:documentation>
 44          </xs:annotation>
 45        </xs:element>
 46        <xs:element name="hasIntendedDataType"
 47                    type="ControlledVocabularyEntryXsdType"
 48                    minOccurs="0"
 49                    maxOccurs="1"
 50                    xml:id="RepresentedVariable-hasIntendedDataType">
 51          <xs:annotation>
 52            <xs:documentation>The data type intended to be used by this variable. Supports the optional use of an external controlled vocabulary.</xs:documentation>
 53          </xs:annotation>
 54        </xs:element>
 55        <xs:element name="simpleUnitOfMeasure"
 56                    type="xs:string"
 57                    minOccurs="0"
 58                    maxOccurs="1"
 59                    xml:id="RepresentedVariable-simpleUnitOfMeasure">
 60          <xs:annotation>
 61            <xs:documentation>The unit in which the data values are measured (kg, pound, euro), expressed as a simple string, in cases where no additional information is available (in the legacy system) or needed (as in the case of broad agreement within the community of use [i.e., ISO country codes, currencies, etc. in SDMX])</xs:documentation>
 62          </xs:annotation>
 63        </xs:element>
 64        <xs:element name="RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain"
 65                    minOccurs="0"
 66                    maxOccurs="unbounded"
 67                    xml:id="RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain">
 68          <xs:annotation>
 69            <xs:documentation>A represented variable may have more than one sets of sentinel value domains, one for each type of software platform on which related instance variables might be instantiated. All of the sentinel value domains must have sentinel conceptual domains that correspond exactly. This allows codes for missing values to be explicitly matched across platforms.</xs:documentation>
 70          </xs:annotation>
 71          <xs:complexType>
 72            <xs:complexContent>
 73              <xs:restriction base="AssociationReferenceXsdType">
 74                <xs:sequence>
 75                  <xs:element name="ddiReference"
 76                              type="InternationalRegistrationDataIdentifierXsdType"
 77                              minOccurs="0"
 78                              maxOccurs="1"
 79                              xml:id="RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain-ddiReference"/>
 80                  <xs:element name="validType"
 81                              minOccurs="0"
 82                              maxOccurs="unbounded"
 83                              xml:id="RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain-validType">
 84                    <xs:simpleType>
 85                      <xs:restriction base="xs:NMTOKEN">
 86                        <xs:enumeration value="SentinelValueDomain"/>
 87                      </xs:restriction>
 88                    </xs:simpleType>
 89                  </xs:element>
 90                </xs:sequence>
 91              </xs:restriction>
 92            </xs:complexContent>
 93          </xs:complexType>
 94        </xs:element>
 95        <xs:element name="RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain"
 96                    minOccurs="0"
 97                    maxOccurs="1"
 98                    xml:id="RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain">
 99          <xs:annotation>
100            <xs:documentation>The substantive representation (substantive value domain) of the variable. This is equivalent to the relationship "Measures" in the Generic Statistical Information Model (GSIM) although GSIM makes no distinction between substantive and sentinel values.</xs:documentation>
101          </xs:annotation>
102          <xs:complexType>
103            <xs:complexContent>
104              <xs:restriction base="AssociationReferenceXsdType">
105                <xs:sequence>
106                  <xs:element name="ddiReference"
107                              type="InternationalRegistrationDataIdentifierXsdType"
108                              minOccurs="0"
109                              maxOccurs="1"
110                              xml:id="RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain-ddiReference"/>
111                  <xs:element name="validType"
112                              minOccurs="0"
113                              maxOccurs="unbounded"
114                              xml:id="RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain-validType">
115                    <xs:simpleType>
116                      <xs:restriction base="xs:NMTOKEN">
117                        <xs:enumeration value="DescriptorValueDomain"/>
118                        <xs:enumeration value="SubstantiveValueDomain"/>
119                      </xs:restriction>
120                    </xs:simpleType>
121                  </xs:element>
122                </xs:sequence>
123              </xs:restriction>
124            </xs:complexContent>
125          </xs:complexType>
126        </xs:element>
127      </xs:sequence>
128    </xs:extension>
129  </xs:complexContent>
130</xs:complexType>

Fragment for the class RepresentedVariable (main ontology)

 1# class RepresentedVariable
 2# based on the UML class DDICDIModels::DDICDILibrary::Classes::Conceptual::RepresentedVariable
 3cdi:RepresentedVariable
 4  a rdfs:Class, owl:Class, ucmis:Class;
 5  rdfs:label "RepresentedVariable";
 6  rdfs:comment "Definition \n========== \nConceptual variable with a substantive value domain specified.   \n\nExamples \n========== \nThe pair (Number of Employees, Integer), where \"Number of Employees\" is the characteristic of the population (variable) and \"Integer\" is how that measure will be represented (value domain).  \n\nExplanatory notes \n=================== \nExtends from conceptual variable and can contain all descriptive fields without creating a conceptual variable. By referencing a conceptual variable it can indicate a common relationship with represented variables expressing the same characteristic of a universe measured in another way, such as Age of Persons in hours rather than years. Represented variable constrains the coverage of the unit type to a specific universe. In the above case the universe with the measurement of Age in hours may be constrained to Persons under 5 days (120 hours old). Represented variable can define sentinel values for multiple storage systems which have the same conceptual domain but specialized value domains."@en;
 7  rdfs:subClassOf cdi:ConceptualVariable;
 8.
 9
10cdi:RepresentedVariable-describedUnitOfMeasure
11  a rdf:Property, owl:ObjectProperty, ucmis:Attribute;
12  rdfs:label "describedUnitOfMeasure";
13  rdfs:comment "The unit in which the data values are measured (kg, pound, euro), expressed as a value from a controlled system of entries (i.e., QDT). Supports the provision of an identifier for the entry in the authoritative source (a URI, etc.), and the specific vocabulary."@en;
14  rdfs:domain cdi:RepresentedVariable;
15  rdfs:range cdi:ControlledVocabularyEntry;
16.
17
18cdi:RepresentedVariable-hasIntendedDataType
19  a rdf:Property, owl:ObjectProperty, ucmis:Attribute;
20  rdfs:label "hasIntendedDataType";
21  rdfs:comment "The data type intended to be used by this variable. Supports the optional use of an external controlled vocabulary."@en;
22  rdfs:domain cdi:RepresentedVariable;
23  rdfs:range cdi:ControlledVocabularyEntry;
24.
25
26cdi:RepresentedVariable-simpleUnitOfMeasure
27  a rdf:Property, owl:DatatypeProperty, ucmis:Attribute;
28  rdfs:label "simpleUnitOfMeasure";
29  rdfs:comment "The unit in which the data values are measured (kg, pound, euro), expressed as a simple string, in cases where no additional information is available (in the legacy system) or needed (as in the case of broad agreement within the community of use [i.e., ISO country codes, currencies, etc. in SDMX])"@en;
30  rdfs:domain cdi:RepresentedVariable;
31  rdfs:range xsd:string;
32.
33
34
35cdi:RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain
36  a rdf:Property, owl:ObjectProperty, ucmis:Association;
37  # ASSOCIATION
38  rdfs:label "takesSentinelValuesFrom";
39  skos:altLabel "RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain";
40  rdfs:comment "A represented variable may have more than one sets of sentinel value domains, one for each type of software platform on which related instance variables might be instantiated. All of the sentinel value domains must have sentinel conceptual domains that correspond exactly. This allows codes for missing values to be explicitly matched across platforms."@en;
41  rdfs:domain cdi:RepresentedVariable;
42  rdfs:range cdi:SentinelValueDomain;
43.
44
45cdi:RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain
46  a rdf:Property, owl:ObjectProperty, ucmis:Association;
47  # ASSOCIATION
48  rdfs:label "takesSubstantiveValuesFrom";
49  skos:altLabel "RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain";
50  rdfs:comment "The substantive representation (substantive value domain) of the variable. This is equivalent to the relationship \"Measures\" in the Generic Statistical Information Model (GSIM) although GSIM makes no distinction between substantive and sentinel values."@en;
51  rdfs:domain cdi:RepresentedVariable;
52  rdfs:range cdi:SubstantiveValueDomain;
53.

Fragment for the class RepresentedVariable (main JSON-LD)

 1{
 2  "@context": [
 3    "ConceptualVariable.jsonld",
 4    {
 5      "cdi": "http://ddialliance.org/Specification/DDI-CDI/1.0/RDF/",
 6      "xsd": "http://www.w3.org/2001/XMLSchema#",
 7      "RepresentedVariable": "cdi:RepresentedVariable",
 8      "describedUnitOfMeasure": {
 9        "@id": "cdi:RepresentedVariable-describedUnitOfMeasure",
10        "@type": "@id",
11        "@context": "ControlledVocabularyEntry.jsonld"
12      },
13      "hasIntendedDataType": {
14        "@id": "cdi:RepresentedVariable-hasIntendedDataType",
15        "@type": "@id",
16        "@context": "ControlledVocabularyEntry.jsonld"
17      },
18      "simpleUnitOfMeasure": {
19        "@id": "cdi:RepresentedVariable-simpleUnitOfMeasure",
20        "@type": "xsd:string"
21      },
22      
23      "takesSentinelValuesFrom": {
24        "@id": "cdi:RepresentedVariable_takesSentinelValuesFrom_SentinelValueDomain",
25        "@type": "@id"      },
26      "takesSubstantiveValuesFrom": {
27        "@id": "cdi:RepresentedVariable_takesSubstantiveValuesFrom_SubstantiveValueDomain",
28        "@type": "@id"      },
29      "isDefinedBy_OF_DataStructureComponent": {
30        "@reverse": "cdi:DataStructureComponent_isDefinedBy_RepresentedVariable",
31        "@type": "@id"
32      },
33      " comment ": "tag:json-should-support-trailing-commas" 
34    }
35  ],
36  "generatedBy": "This code was generated by the Eclipse Acceleo project UCMIS M2T on 2024-09-23 21:52:55.",
37  "basedOn": "based on the UML data type DDICDIModels::DDICDILibrary::Classes::Conceptual::RepresentedVariable"
38}