Skip to Content

Wiki source code of 9 Concept Roles

Version 6.4 by Helena on 2025/05/19 14:18
Show last authors
1 {{box title="**Contents**"}}
2 {{toc/}}
3 {{/box}}
4
5 == 9.1 Overview ==
6
7 The [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]] [[Components>>doc:xwiki:Glossary.Component.WebHome]] of [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] and [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]] can play a specific role in the [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]] and it is important to some applications that this role is specified. For instance, the following roles are some examples:
8
9 * **Frequency **– in a [[data set>>doc:xwiki:Glossary.Data set.WebHome]] the content of this [[Component>>doc:xwiki:Glossary.Component.WebHome]] contains information on the frequency of the observation values.
10 * **Geography** – in a [[data set>>doc:xwiki:Glossary.Data set.WebHome]] the content of this [[Component>>doc:xwiki:Glossary.Component.WebHome]] contains information on the geographic location of the observation values.
11
12 == 9.2 Information Model ==
13
14 The Information Model for this is shown below:
15
16 [[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_2a51ef88.jpg||height="296" width="557"]]
17
18 (% class="wikigeneratedid" id="HFigure19:InformationModelExtractforConceptRole" %)
19 **Figure 19: Information Model Extract for Concept Role**
20
21 It is possible to specify zero or more (% style="color:#2ecc71" %)concept(%%) roles for a [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] and Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]. The Time [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] has explicitly defined roles and cannot be further specified with additional (% style="color:#2ecc71" %)concept(%%) roles.
22
23 == 9.3 Technical Mechanism ==
24
25 The mechanism for maintain and using (% style="color:#2ecc71" %)concept(%%) roles is as follows:
26
27 1. A standard [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] maintained in the [[Global Registry>>doc:xwiki:Glossary.Global registry.WebHome]], with the following identification: [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]:CONCEPT_ROLES(1.0.0), shall include the default roles, specified by the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] SWG (as detailed in 9.5).
28 1. Any recognized Agency can have a [[concept scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] that contains (% style="color:#2ecc71" %)concepts(%%) that identify (% style="color:#2ecc71" %)concept(%%) roles. Indeed, from a technical perspective any agency can have more than one of these schemes, though this is not recommended.
29 1. The [[concept scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] that contains the "role" (% style="color:#2ecc71" %)concepts(%%) can contain (% style="color:#2ecc71" %)concepts(%%) that do not play a role.
30 1. There is no explicit indication on the (% style="color:#2ecc71" %)Concept(%%) whether it is a 'role' (% style="color:#2ecc71" %)concept(%%).
31 1. Therefore, any (% style="color:#2ecc71" %)concept(%%) in any [[concept scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] is capable of being a 'role' (% style="color:#2ecc71" %)concept(%%).
32 1. It is the responsibility of Agencies to ensure their community knows which (% style="color:#2ecc71" %)concepts(%%) in which [[concept schemes>>doc:xwiki:Glossary.Concept scheme.WebHome]] play a 'role' and the significance and interpretation of this role. In other words, such (% style="color:#2ecc71" %)concepts(%%) must be known by applications, there is no technical mechanism that can inform an application on how to process such a 'role'.
33 1. If the (% style="color:#2ecc71" %)concept(%%) referenced in the (% style="color:#2ecc71" %)Concept(%%) Identity in a [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]] ([[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]) is contained in the [[concept scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] containing (% style="color:#2ecc71" %)concept(%%) roles then the [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]] could play the role implied by the (% style="color:#2ecc71" %)concept(%%), if this is understood by the processing application.
34 1. If the (% style="color:#2ecc71" %)concept(%%) referenced in the (% style="color:#2ecc71" %)Concept(%%) Identity in a [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]] ([[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], [[Measure>>doc:xwiki:Glossary.Measure.WebHome]] [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]]) is not contained in the [[concept scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] containing (% style="color:#2ecc71" %)concept(%%) roles, and the [[DSD>>doc:xwiki:Glossary.Data structure definition.WebHome]] [[component>>doc:xwiki:Glossary.Component.WebHome]] is playing a role, then the (% style="color:#2ecc71" %)concept(%%) role is identified by the (% style="color:#2ecc71" %)Concept(%%) Role in the schema.
35
36 == 9.4 SDMX-ML Examples in a DSD ==
37
38 The standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]], is still a normal [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]], thus it may be used also for the (% style="color:#2ecc71" %)concept(%%) identity of a [[Component>>doc:xwiki:Glossary.Component.WebHome]], e.g., the 'FREQ':
39
40 [[image:1747386659499-933.png]]
41
42 Given this is the standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]], any application should interpret the above [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] to have the role of Frequency.
43
44 Using a [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] that is not the standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] where it is required to assign a role using the standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]]. Again, FREQ is chosen as the example.
45
46 [[image:1747386677366-237.png]]
47
48 This explicitly states that this [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]] is playing a role identified by the FREQ (% style="color:#2ecc71" %)concept(%%) in the standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]]. Again, the application must interpret this as a Frequency role.
49
50 In other cases where a role from a non-standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] is used, then the application has to know how to interpret the provided roles, e.g., like in the case below:
51
52 [[image:1747386694309-599.png]]
53
54 This is all that is required for interoperability within a community. Having a standard roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]], maintained by the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] SWG, allows the [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] community to have a common understanding of the roles, while also being able to extend the roles in bilateral (or multilateral) agreements, by maintaining their own roles [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]]. This will then ensure there is interoperability between systems that understand the use of these (% style="color:#2ecc71" %)concepts(%%).
55
56 Note that each of the [[Components>>doc:xwiki:Glossary.Component.WebHome]] (Data [[Attribute>>doc:xwiki:Glossary.Attribute.WebHome]], [[Measure>>doc:xwiki:Glossary.Measure.WebHome]], [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]], Time [[Dimension>>doc:xwiki:Glossary.Dimension.WebHome]]) has a mandatory identity association ((% style="color:#2ecc71" %)Concept(%%) Identity) and if this (% style="color:#2ecc71" %)Concept(%%) also identifies the role then it must be interpreted accordingly.
57
58 In order for these roles to be extensible and also to enable user communities to maintain community-specific roles, the roles are maintained in a controlled vocabulary which is implemented in [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] as (% style="color:#2ecc71" %)Concepts(%%) in a [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]]. The [[Component>>doc:xwiki:Glossary.Component.WebHome]] optionally references this (% style="color:#2ecc71" %)Concept(%%) if it is required to declare the role explicitly. Note that a [[Component>>doc:xwiki:Glossary.Component.WebHome]] can play more than one role and therefore multiple "role" (% style="color:#2ecc71" %)concepts(%%) can be referenced.
59
60 == 9.5 SDMX standard roles Concept Scheme ==
61
62 As of [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] 3.0, there is a predefined [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]], with a set of (% style="color:#2ecc71" %)Concepts(%%) that are considered the standard roles for [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]]. Beyond that, a user is free to add other roles, using custom [[Concept Schemes>>doc:xwiki:Glossary.Concept scheme.WebHome]]. This predefined [[Concept Scheme>>doc:xwiki:Glossary.Concept scheme.WebHome]] is the result of the SWG guidelines for (% style="color:#2ecc71" %)Concept(%%) Roles, plus that for [[Measure>>doc:xwiki:Glossary.Measure.WebHome]], and includes the following (% style="color:#2ecc71" %)Concepts(%%):
63
64 (% style="width:1183.29px" %)
65 |COMMENT|[[Comment>>doc:xwiki:Glossary.Comment.WebHome]]|(% style="width:723px" %)Descriptive text which can be attached to data or metadata.
66 |ENTITY|Entity|(% style="width:723px" %)Describes the subject of the [[data set>>doc:xwiki:Glossary.Data set.WebHome]] (e.g., a country).
67 |FLAG|Flag|(% style="width:723px" %)Coded [[attribute>>doc:xwiki:Glossary.Attribute.WebHome]] in a [[data set>>doc:xwiki:Glossary.Data set.WebHome]] that represents qualitative information for the cell or partial key (e.g. series) value.
68 |FREQ|Frequency|(% style="width:723px" %)Time interval at which the source data are collected.
69 |GEO|Geographical|(% style="width:723px" %)Geographic area to which the measured statistical phenomenon relates.
70 |OPERATION|Statistical operation|(% style="width:723px" %)Signifies statistical operations have been done on the observations.
71 |VARIABLE|Variable|(% style="width:723px" %)Characteristic of a unit being observed that may assume more than one of a set of values to which a numerical [[measure>>doc:xwiki:Glossary.Measure.WebHome]] or a [[category>>doc:xwiki:Glossary.Category.WebHome]] from a classification can be assigned.
72 |MEASURE|[[Measure>>doc:xwiki:Glossary.Measure.WebHome]]|(% style="width:723px" %)Used for emulating the functionality of the deprecated MeasureDimension.
73 |GEO_FEATU RE_SET|Geographical Feature Set|(% style="width:723px" %)Georeferencing information to describe the location or the shape of a [[statistical unit>>doc:xwiki:Glossary.Statistical unit.WebHome]], recognizable object or geographical area.
74 |PRIMARY|Primary [[Measure>>doc:xwiki:Glossary.Measure.WebHome]]|(% style="width:723px" %)Used for backwards compatibility with [[SDMX>>doc:xwiki:Glossary.Statistical data and metadata exchange.WebHome]] 2.1 and back, or when the “Primary [[Measure>>doc:xwiki:Glossary.Measure.WebHome]]” (% style="color:#2ecc71" %)concept(%%) is needed.