SubstantiveConceptualDomain

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

Definition

Conceptual domain of substantive concepts.

Examples

An enumeration of concepts for a categorical variable like “male” and “female” for gender, or “ozone” and “particulate matter less than 2.5 microns in diameter” for pollutant in an air quality measure.

Explanatory notes

A conceptual variable links a unit type to a substantive conceptual domain. The latter can be an enumeration or description of the values that the variable may take on. In the enumerated case these are the categories in a category set that can be values, not the codes that represent the values. An example might be the conceptual domain for a variable representing self-identified gender. An enumeration might include the concept of “male” and the concept of “female”. These, in turn, would be represented in a substantive value domain by codes in a code list like “m” and “f”, or “0” and “1”. A conceptual domain might be described through a value and concept description’s description property of “a real number greater than 0” or through a more formal logical expression of “all reals x such that x > 0”. Even in the described case, what is being described are conceptual, not the symbols used to represent the values. This may be a subtle distinction, but allows specifying that the same numeric value might be represented by 32 bits or by 64 bits or by an Arabic numeral or a Roman numeral.

Diagram

Inheritance
Conceptual::ConceptualDomain
  ᐊ── Conceptual::SubstantiveConceptualDomain
Attributes

Name

Inherited from

Description

Data Type

Multiplicity

Default value

catalogDetails

Conceptual::ConceptualDomain

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

displayLabel

Conceptual::ConceptualDomain

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..*

identifier

Conceptual::ConceptualDomain

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

Identifier

0..1
Associations

Direction

Association

Description

Multiplicity of SubstantiveConceptualDomain

Package of Other Class

Other Class

Multiplicity of other class

Aggregation Kind

Inherited from

from

ConceptualDomain isDescribedBy ValueAndConceptDescription

A description of the concepts in the domain. A numeric domain might use a logical expression to be machine actionable; a text domain might use a regular expression to describe strings that describe the concepts.

0..*

Representations

ValueAndConceptDescription

0..1

none

Conceptual::ConceptualDomain

from

ConceptualDomain takesConceptsFrom ConceptSystem

Conceptual domain takes concept from zero to one concept system.

0..*

- own package -

ConceptSystem

0..1

none

Conceptual::ConceptualDomain

to

ConceptualValue hasConceptFrom ConceptualDomain

Conceptual value has concept from one conceptual domain.

1..1

DataDescription

ConceptualValue

0..*

none

Conceptual::ConceptualDomain

to

ConceptualVariable takesSubstantiveConceptsFrom SubstantiveConceptualDomain

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

0..1

- own package -

ConceptualVariable

0..*

none

- own class -

to

SubstantiveValueDomain takesConceptsFrom SubstantiveConceptualDomain

Corresponding conceptual definition given by an substantive conceptual domain.

0..1

Representations

SubstantiveValueDomain

0..*

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 SubstantiveConceptualDomain (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-SubstantiveConceptualDomain"
 5                 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#SubstantiveConceptualDomain"
 6                 xmi:type="uml:Class">
 7   <ownedComment xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-SubstantiveConceptualDomain-ownedComment"
 8                 xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#SubstantiveConceptualDomain-ownedComment"
 9                 xmi:type="uml:Comment">
10      <annotatedElement xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-SubstantiveConceptualDomain"/>
11      <body>Definition 
12==========
13Conceptual domain of substantive concepts.  
14
15Examples 
16======== 
17An enumeration of concepts for a categorical variable like "male" and "female" for gender, or "ozone" and "particulate matter less than 2.5 microns in diameter" for pollutant in an air quality measure.  
18
19Explanatory notes 
20=================
21A conceptual variable links a unit type to a substantive conceptual domain. The latter can be an enumeration or description of the values that the variable may take on. In the enumerated case these are the categories in a category set that can be values, not the codes that represent the values. An example might be the conceptual domain for a variable representing self-identified gender. An enumeration might include the concept of "male" and the concept of "female". These, in turn, would be represented in a substantive value domain by codes in a code list like "m" and "f", or "0" and "1". A conceptual domain might be described through a value and concept description's description property of "a real number greater than 0" or through a more formal logical expression of "all reals x such that x &gt; 0". Even in the described case, what is being described are conceptual, not the symbols used to represent the values. This may be a subtle distinction, but allows specifying that the same numeric value might be represented by 32 bits or by 64 bits or by an Arabic numeral or a Roman numeral.</body>
22   </ownedComment>
23   <name>SubstantiveConceptualDomain</name>
24   <generalization xmi:id="DDICDIModels-DDICDILibrary-Classes-Conceptual-SubstantiveConceptualDomain-generalization"
25                   xmi:uuid="http://ddialliance.org/Specification/DDI-CDI/1.0/XMI/#SubstantiveConceptualDomain-generalization"
26                   xmi:type="uml:Generalization">
27      <general xmi:idref="DDICDIModels-DDICDILibrary-Classes-Conceptual-ConceptualDomain"/>
28   </generalization>
29</packagedElement>

Fragment for the class SubstantiveConceptualDomain (entire XML Schema)

 1<xs:element name="SubstantiveConceptualDomain"
 2            type="SubstantiveConceptualDomainXsdType"
 3            xml:id="SubstantiveConceptualDomain">
 4  <!-- based on the UML class DDICDIModels::DDICDILibrary::Classes::Conceptual::SubstantiveConceptualDomain -->
 5  <xs:annotation>
 6    <xs:documentation>Definition 
 7          ==========
 8          Conceptual domain of substantive concepts.  
 9          
10          Examples 
11          ======== 
12          An enumeration of concepts for a categorical variable like "male" and "female" for gender, or "ozone" and "particulate matter less than 2.5 microns in diameter" for pollutant in an air quality measure.  
13          
14          Explanatory notes 
15          =================
16          A conceptual variable links a unit type to a substantive conceptual domain. The latter can be an enumeration or description of the values that the variable may take on. In the enumerated case these are the categories in a category set that can be values, not the codes that represent the values. An example might be the conceptual domain for a variable representing self-identified gender. An enumeration might include the concept of "male" and the concept of "female". These, in turn, would be represented in a substantive value domain by codes in a code list like "m" and "f", or "0" and "1". A conceptual domain might be described through a value and concept description's description property of "a real number greater than 0" or through a more formal logical expression of "all reals x such that x &gt; 0". Even in the described case, what is being described are conceptual, not the symbols used to represent the values. This may be a subtle distinction, but allows specifying that the same numeric value might be represented by 32 bits or by 64 bits or by an Arabic numeral or a Roman numeral.</xs:documentation>
17  </xs:annotation>
18</xs:element>
19<xs:complexType name="SubstantiveConceptualDomainXsdType"
20                xml:id="SubstantiveConceptualDomainXsdType">
21  <xs:annotation>
22    <xs:documentation>Definition 
23          ==========
24          Conceptual domain of substantive concepts.  
25          
26          Examples 
27          ======== 
28          An enumeration of concepts for a categorical variable like "male" and "female" for gender, or "ozone" and "particulate matter less than 2.5 microns in diameter" for pollutant in an air quality measure.  
29          
30          Explanatory notes 
31          =================
32          A conceptual variable links a unit type to a substantive conceptual domain. The latter can be an enumeration or description of the values that the variable may take on. In the enumerated case these are the categories in a category set that can be values, not the codes that represent the values. An example might be the conceptual domain for a variable representing self-identified gender. An enumeration might include the concept of "male" and the concept of "female". These, in turn, would be represented in a substantive value domain by codes in a code list like "m" and "f", or "0" and "1". A conceptual domain might be described through a value and concept description's description property of "a real number greater than 0" or through a more formal logical expression of "all reals x such that x &gt; 0". Even in the described case, what is being described are conceptual, not the symbols used to represent the values. This may be a subtle distinction, but allows specifying that the same numeric value might be represented by 32 bits or by 64 bits or by an Arabic numeral or a Roman numeral.</xs:documentation>
33  </xs:annotation>
34  <xs:complexContent>
35    <xs:extension base="ConceptualDomainXsdType">
36      
37    </xs:extension>
38  </xs:complexContent>
39</xs:complexType>

Fragment for the class SubstantiveConceptualDomain (main ontology)

1# class SubstantiveConceptualDomain
2# based on the UML class DDICDIModels::DDICDILibrary::Classes::Conceptual::SubstantiveConceptualDomain
3cdi:SubstantiveConceptualDomain
4  a rdfs:Class, owl:Class, ucmis:Class;
5  rdfs:label "SubstantiveConceptualDomain";
6  rdfs:comment "Definition \n==========\nConceptual domain of substantive concepts.  \n\nExamples \n======== \nAn enumeration of concepts for a categorical variable like \"male\" and \"female\" for gender, or \"ozone\" and \"particulate matter less than 2.5 microns in diameter\" for pollutant in an air quality measure.  \n\nExplanatory notes \n=================\nA conceptual variable links a unit type to a substantive conceptual domain. The latter can be an enumeration or description of the values that the variable may take on. In the enumerated case these are the categories in a category set that can be values, not the codes that represent the values. An example might be the conceptual domain for a variable representing self-identified gender. An enumeration might include the concept of \"male\" and the concept of \"female\". These, in turn, would be represented in a substantive value domain by codes in a code list like \"m\" and \"f\", or \"0\" and \"1\". A conceptual domain might be described through a value and concept description's description property of \"a real number greater than 0\" or through a more formal logical expression of \"all reals x such that x > 0\". Even in the described case, what is being described are conceptual, not the symbols used to represent the values. This may be a subtle distinction, but allows specifying that the same numeric value might be represented by 32 bits or by 64 bits or by an Arabic numeral or a Roman numeral."@en;
7  rdfs:subClassOf cdi:ConceptualDomain;
8.

Fragment for the class SubstantiveConceptualDomain (main JSON-LD)

 1{
 2  "@context": [
 3    "ConceptualDomain.jsonld",
 4    {
 5      "cdi": "http://ddialliance.org/Specification/DDI-CDI/1.0/RDF/",
 6      "xsd": "http://www.w3.org/2001/XMLSchema#",
 7      "SubstantiveConceptualDomain": "cdi:SubstantiveConceptualDomain",
 8      
 9      "takesSubstantiveConceptsFrom_OF_ConceptualVariable": {
10        "@reverse": "cdi:ConceptualVariable_takesSubstantiveConceptsFrom_SubstantiveConceptualDomain",
11        "@type": "@id"
12      },
13      "takesConceptsFrom_OF_SubstantiveValueDomain": {
14        "@reverse": "cdi:SubstantiveValueDomain_takesConceptsFrom_SubstantiveConceptualDomain",
15        "@type": "@id"
16      },
17      " comment ": "tag:json-should-support-trailing-commas" 
18    }
19  ],
20  "generatedBy": "This code was generated by the Eclipse Acceleo project UCMIS M2T on 2024-09-23 21:52:55.",
21  "basedOn": "based on the UML data type DDICDIModels::DDICDILibrary::Classes::Conceptual::SubstantiveConceptualDomain"
22}