Difference between revisions of "Series Key"

From FMR Knowledge Base
Jump to navigation Jump to search
(Overview)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Cross product of values of Dimensions uniquely identifying a series within a dataset.  
+
[[Category:Concepts_Reference_V10]]
 +
[[Category:Concepts_Reference_V11]]
 +
A Series Key is the cross product of values of Dimensions uniquely identifying a series within a dataset.  
  
A Series Key that also includes a time value uniquely identifies an observation.
+
=Overview=
 
+
Consider the following Data Structure Definition:
'''Example'''<br>
 
Consider a [[Data Structure Definition]]:
 
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 23: Line 23:
 
| n/a || Primary Measure || Observation Value || The observation value
 
| n/a || Primary Measure || Observation Value || The observation value
 
|}
 
|}
The Series Key is the dot (.) concatenation of the Dimensions in the order specified in the DSD.  
+
In SDMX, Series Keys are generally written by concatenating the Dimension values with dots (.) in the order specified in the DSD.  
  
 
For the DSD above, the Series Key is constructed as follows:
 
For the DSD above, the Series Key is constructed as follows:
Line 30: Line 30:
  
 
Examples
 
Examples
  EN_ATM_CO2E_GF_KT.GRC.A
+
  ATMCO2.GRC.A
  EN_ATM_CO2E_GF_KT.GRC.M
+
  ATMCO2.GRC.M
  SH_TBS_INCD.MDG.A
+
  TBSINDC.MDG.A
  DT_INR_PRVT.GBR.M
+
  TBSINDC.GBR.M
  
 +
Attributes do not form part of the Series Key because they have no role in uniquely identifying series or observations.
 +
 +
In some implementations, Series Keys use a colon (:) separator:
 +
Q:S:L:A:TO1:A:5J:A:5A:U:5R:N
 +
Q:S:L:A:TO1:A:5J:A:5A:U:5C:N
 +
Q:S:L:A:TO1:A:5J:A:5A:U:1N:N
 +
Q:S:L:A:TO1:A:5J:A:5A:U:3C:N
 +
Q:S:L:A:TO1:A:5J:A:5A:U:1C:N
 +
 +
=Series Keys with time value=
 +
A Series Key that also includes a time value uniquely identifies an observation.
 +
                    2015    2016    2017    2018    2019    2020
 +
ATMCO2.GRC.A        278    290    298    304    312    209       
 +
TBSINDC.MDG.A        631    678    645    655    662    669
  
Attributes do not form part of the Series Key so have no explicit or implied ordering.
+
In the above example ATMCO2.GRC.A.2015 identifies the 2015 time period with observation value 278.

Latest revision as of 06:38, 25 August 2022

A Series Key is the cross product of values of Dimensions uniquely identifying a series within a dataset.

Overview

Consider the following Data Structure Definition:

Position Component Type Component ID Description
1 Dimension INDICATOR Indicator
2 Dimension REF_AREA Reference Area
3 Dimension FREQUENCY Data Frequency
n/a Time Dimension TIME_PERIOD Observation Time
n/a Attribute UNIT_MULT Unit Multiplier e.g. tens, thousands, millions
n/a Attribute Observation Status Observation Status e.g. Estimated, Final
n/a Primary Measure Observation Value The observation value

In SDMX, Series Keys are generally written by concatenating the Dimension values with dots (.) in the order specified in the DSD.

For the DSD above, the Series Key is constructed as follows:

<INDICATOR>.<REF_AREA>.<FREQUENCY>

Examples

ATMCO2.GRC.A
ATMCO2.GRC.M
TBSINDC.MDG.A
TBSINDC.GBR.M

Attributes do not form part of the Series Key because they have no role in uniquely identifying series or observations.

In some implementations, Series Keys use a colon (:) separator:

Q:S:L:A:TO1:A:5J:A:5A:U:5R:N
Q:S:L:A:TO1:A:5J:A:5A:U:5C:N
Q:S:L:A:TO1:A:5J:A:5A:U:1N:N
Q:S:L:A:TO1:A:5J:A:5A:U:3C:N
Q:S:L:A:TO1:A:5J:A:5A:U:1C:N

Series Keys with time value

A Series Key that also includes a time value uniquely identifies an observation.

                    2015    2016    2017    2018    2019    2020
ATMCO2.GRC.A         278     290     298     304     312     209         
TBSINDC.MDG.A        631     678     645     655     662     669

In the above example ATMCO2.GRC.A.2015 identifies the 2015 time period with observation value 278.