Skip to Content

Changes for page 13 Structure Mapping

Last modified by Helena on 2025/09/10 11:19
From version 10.5
edited by Helena
on 2025/05/16 09:14
Change comment: There is no comment for this version
To version 7.1
edited by Helena
on 2025/05/15 15:48
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,6 +1,4 @@
1 -{{box title="**Contents**"}}
2 -{{toc/}}
3 -{{/box}}
1 += 13 Structure Mapping =
4 4  
5 5  == 13.1 Introduction ==
6 6  
... ... @@ -18,7 +18,7 @@
18 18  
19 19  * Transforming received data into a common internal structure;
20 20  * Transforming reported data into the data collector's preferred structure;
21 -* Transforming unidimensional datasets{{footnote}}Unidimensional datasets are those with a single 'indicator' or 'series code' dimension.{{/footnote}} to multi-dimensional; and
19 +* Transforming unidimensional datasets^^[[^^43^^>>path:#sdfootnote43sym||name="sdfootnote43anc"]]^^ to multi-dimensional; and
22 22  * Transforming internal datasets with a complex structure to a simpler structure with fewer dimensions suitable for dissemination.
23 23  
24 24  == 13.2 1-1 structure maps ==
... ... @@ -27,25 +27,25 @@
27 27  
28 28  In the example below, ISO 2-character country codes are mapped to their ISO 3character equivalent.
29 29  
30 -(% style="width:666.294px" %)
31 -|(% style="width:217px" %)**Country**|(% style="width:251px" %)**Alpha-2 code**|(% style="width:195px" %)**Alpha-3 code**
32 -|(% style="width:217px" %)Afghanistan|(% style="width:251px" %)AF|(% style="width:195px" %)AFG
33 -|(% style="width:217px" %)Albania|(% style="width:251px" %)AL|(% style="width:195px" %)ALB
34 -|(% style="width:217px" %)Algeria|(% style="width:251px" %)DZ|(% style="width:195px" %)DZA
35 -|(% style="width:217px" %)American Samoa|(% style="width:251px" %)AS|(% style="width:195px" %)ASM
36 -|(% style="width:217px" %)Andorra|(% style="width:251px" %)AD|(% style="width:195px" %)AND
37 -|(% style="width:217px" %)etc…|(% style="width:251px" %) |(% style="width:195px" %)
28 +|Country|Alpha-2 code|Alpha-3 code
29 +|Afghanistan|AF|AFG
30 +|Albania|AL|ALB
31 +|Algeria|DZ|DZA
32 +|American Samoa|AS|ASM
33 +|Andorra|AD|AND
34 +|etc…||
38 38  
39 39  Different source values can also map to the same target value, for example when deriving regions from country codes.
40 40  
41 -(% style="width:674.294px" %)
42 -|(% style="width:284px" %)**Source Component: REF_AREA**|(% style="width:387px" %)**Target Component: REGION**
43 -|(% style="width:284px" %)FR|(% style="width:387px" %)EUR
44 -|(% style="width:284px" %)DE|(% style="width:387px" %)EUR
45 -|(% style="width:284px" %)IT|(% style="width:387px" %)EUR
46 -|(% style="width:284px" %)ES|(% style="width:387px" %)EUR
47 -|(% style="width:284px" %)BE|(% style="width:387px" %)EUR
38 +[[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_59eee18f.gif||alt="Shape7" height="1" width="192"]]
48 48  
40 +|Source Component: REF_AREA|Target Component: REGION
41 +|FR|EUR
42 +|DE|EUR
43 +|IT|EUR
44 +|ES|EUR
45 +|BE|EUR
46 +
49 49  == 13.3 N-n structure maps ==
50 50  
51 51  N-n (pronounced 'N to N') mappings describe rules where a specified combination of values in multiple source Components map to specified values in one or more target Components. For example, when mapping a partial Series Key from a highly multidimensional cube (like Balance of Payments) to a single 'Indicator' Dimension in a target Data Structure.
... ... @@ -52,40 +52,52 @@
52 52  
53 53  Example:
54 54  
55 -(% style="width:760.294px" %)
56 -|(% style="width:58px" %)**Rule**|(% style="width:384px" %)**Source**|(% style="width:313px" %)**Target**
57 -|(% style="width:58px" %)1|(% style="width:384px" %)(((
53 +|Rule|Source|Target
54 +|1|(((
58 58  If
56 +
59 59  FREQUENCY=A; and ADJUSTMENT=N; and MATURITY=L.
60 -)))|(% style="width:313px" %)(((
58 +)))|(((
61 61  Set
60 +
62 62  INDICATOR=A_N_L
63 63  )))
64 -|(% style="width:58px" %)2|(% style="width:384px" %)(((
63 +|2|(((
65 65  If
65 +
66 66  FREQUENCY=M; and ADJUSTMENT=S_A1; and MATURITY=TY12.
67 -)))|(% style="width:313px" %)(((
67 +)))|(((
68 68  Set
69 +
69 69  INDICATOR=MON_SAX_12
70 70  )))
71 71  
72 72  N-n rules can also set values for multiple source Components.
73 73  
74 -(% style="width:757.294px" %)
75 -|(% style="width:62px" %)**Rule**|(% style="width:378px" %)**Source**|(% style="width:312px" %)**Target**
76 -|(% style="width:62px" %)1|(% style="width:378px" %)(((
75 +|Rule|Source|Target
76 +|1|(((
77 77  If
78 +
78 78  FREQUENCY=A; and ADJUSTMENT=N; and MATURITY=L.
79 -)))|(% style="width:312px" %)(((
80 +)))|(((
80 80  Set
81 -INDICATOR=A_N_L, STATUS=QXR15, NOTE="Unadjusted".
82 +
83 +INDICATOR=A_N_L, STATUS=QXR15,
84 +
85 +NOTE="Unadjusted".
82 82  )))
83 -|(% style="width:62px" %)2|(% style="width:378px" %)(((
87 +|2|(((
84 84  If
89 +
85 85  FREQUENCY=M; and ADJUSTMENT=S_A1; and MATURITY=TY12.
86 -)))|(% style="width:312px" %)(((
91 +)))|(((
87 87  Set
88 -INDICATOR=MON_SAX_12, STATUS=MPM12, NOTE="Seasonally Adjusted"
93 +
94 +INDICATOR=MON_SAX_12,
95 +
96 +STATUS=MPM12,
97 +
98 +NOTE="Seasonally Adjusted"
89 89  )))
90 90  
91 91  == 13.4 Ambiguous mapping rules ==
... ... @@ -146,7 +146,7 @@
146 146  |DZ|DZA
147 147  |AS|ASM
148 148  |AD|AND
149 -|etc…|
159 +|etc…|
150 150  
151 151  A Representation Map mapping free text country names to an ISO 2-character Codelist could be similarly described:
152 152  
... ... @@ -157,7 +157,7 @@
157 157  |"Great Britain"|GB
158 158  |"Ireland"|IE
159 159  |"Eire"|IE
160 -|etc…|
170 +|etc…|
161 161  
162 162  Valuelists, introduced in SDMX 3.0, are equivalent to Codelists but allow the maintenance of non-SDMX identifiers. Importantly, their IDs do not need to conform to IDType, but as a consequence are not Identifiable.
163 163  
... ... @@ -168,7 +168,7 @@
168 168  |Value|Locale|Name
169 169  |$|en|United States Dollar
170 170  |%|En|Percentage
171 -| |fr|Pourcentage
181 +||fr|Pourcentage
172 172  
173 173  Other characteristics of Representation Maps:
174 174  
... ... @@ -267,7 +267,7 @@
267 267  
268 268  Date and time formats are specified by date and time pattern strings based on Java's Simple Date Format. Within date and time pattern strings, unquoted letters from 'A' to 'Z' and from 'a' to 'z' are interpreted as pattern letters representing the components of a date or time string. Text can be quoted using single quotes (') to avoid interpretation. "''" represents a single quote. All other characters are not interpreted; they're simply copied into the output string during formatting or matched against the input string during parsing.
269 269  
270 -Due to the fact that dates may differ per locale, an optional property, defining the locale of the pattern, is provided. This would assist processing of source dates, according to the given locale^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^44^^>>path:#sdfootnote44sym||name="sdfootnote44anc"]](%%)^^. An indicative list of examples is presented in the following table:
280 +Due to the fact that dates may differ per locale, an optional property, defining the locale of the pattern, is provided. This would assist processing of source dates, according to the given locale^^[[^^44^^>>path:#sdfootnote44sym||name="sdfootnote44anc"]]^^. An indicative list of examples is presented in the following table:
271 271  
272 272  |English (en)|Australia (AU)|en-AU
273 273  |English (en)|Canada (CA)|en-CA
... ... @@ -313,7 +313,7 @@
313 313  
314 314  |Letter|Date or Time Component|Presentation|Examples
315 315  |G|Era designator|[[Text>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#text]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#text]]|AD
316 -|yy|Year short (upper case is Year of Week^^[[(% class="wikiinternallink wikiinternallink wikiinternallink" %)^^45^^>>path:#sdfootnote45sym||name="sdfootnote45anc"]](%%)^^)|[[Year>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#year]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#year]]|96
326 +|yy|Year short (upper case is Year of Week^^[[^^45^^>>path:#sdfootnote45sym||name="sdfootnote45anc"]]^^)|[[Year>>url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#year]][[url:https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html#year]]|96
317 317  |yyyy|Year Full (upper case is Year of Week)|Year|1996
318 318  |MM|Month number in year starting with 1|Month|07
319 319  |MMM|Month name short|Month|Jul
... ... @@ -518,7 +518,7 @@
518 518  
519 519  The following representation mapping can be used to explicitly map each age to an output code.
520 520  
521 -:
531 +:
522 522  
523 523  (((
524 524  |Source Input Free Text|Desired Output Code Id
... ... @@ -535,7 +535,7 @@
535 535  
536 536  __Regular Expression __Desired Output
537 537  
538 -:
548 +:
539 539  
540 540  (((
541 541  |[0-2]|A
... ... @@ -546,7 +546,7 @@
546 546  
547 547  This use case is where a specific observation for a specific time period has an attribute 3468 value.
548 548  
549 -:
559 +:
550 550  
551 551  (((
552 552  |Input INDICATOR|Input TIME_PERIOD|Output OBS_CONF
... ... @@ -567,7 +567,7 @@
567 567  
568 568  The Component Mapping from SYS_TIME to TIME_PERIOD specifies itself as a time mapping with the following details:
569 569  
570 -:
580 +:
571 571  
572 572  (((
573 573  |Source Value|Source Mapping|Target Frequency|Output
... ... @@ -578,18 +578,18 @@
578 578  
579 579  [[image:SDMX 3-0-0 SECTION 6 FINAL-1.0_en_dbe68698.gif||alt="Shape12" height="1" width="273"]]
580 580  
581 -:
582 -::
591 +:
592 +::
583 583  
584 584  (((
585 585  |Source Value|Source Mapping|Target Frequency Output Dimension
586 586  
587 -|18/07/1981 dd/MM/yyyy|FREQ| |1981-07-18 (when FREQ=D)
597 +|18/07/1981 dd/MM/yyyy|FREQ||1981-07-18 (when FREQ=D)
588 588  |(% rowspan="2" %)(((
589 589  __When the source is a numerical form__at
590 590  
591 591  Source Value Start Period Interv
592 -)))| | |
602 +)))|||
593 593  |al|(((
594 594  Target
595 595  
... ... @@ -613,5 +613,3 @@
613 613  Dimension
614 614  
615 615  1981 yyyy D – End of Period 1982-03-31
616 -
617 -{{putFootnotes/}}
SDMX 3-0-0 SECTION 6 FINAL-1.0_en_295af259.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -57.7 KB
Content
SDMX 3-0-0 SECTION 6 FINAL-1.0_en_a3215c79.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -30.6 KB
Content
SDMX 3-0-0 SECTION 6 FINAL-1.0_en_dbe68698.gif
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.helena
Size
... ... @@ -1,1 +1,0 @@
1 -863 bytes
Content