249 code table 14 43 and 46 adding new entries to better describe type of forecasting (#261)

amilan17 · sebvi · efucile · web-flow · commit 2ec32bf2f1ba · 2024-08-08T13:39:47.000+02:00
#249 * fix rebase conflict: 249 adding entries in code table 1.4, 4.3 and 4.6 with associated notes * fix rebase of xml,txt files * #249, add notes, change sample to example * xml,txt files * editorial, changed 23 to 22 in CF4.3 * xml,txt files * Update GRIB2_CodeFlag_4_6_CodeTable_en.csv Co-authored-by: Marijana Crepulja <62389855+marijanacrepulja@users.noreply.github.com> * xml,txt files --------- Co-authored-by: Sebastien Villaume <sebastien.villaume@ecmwf.int> Co-authored-by: Enrico Fucile <efucile@wmo.int> Co-authored-by: Marijana Crepulja <62389855+marijanacrepulja@users.noreply.github.com>
diff --git a/GRIB2_CodeFlag_1_4_CodeTable_en.csv b/GRIB2_CodeFlag_1_4_CodeTable_en.csv
@@ -8,6 +8,8 @@ Type of data,,5,,Control and perturbed forecast products,,,,Operational
 Type of data,,6,,Processed satellite observations,,,,Operational
 Type of data,,7,,Processed radar observations,,,,Operational
 Type of data,,8,,Event probability,,,,Operational
-Type of data,,9-191,,Reserved,,,,Operational
+Type of data,,9,,Example data,(see Note 2),249a,,Operational
+Type of data,,10,,ML based forecast,(see Note 3),249b,,Operational
+Type of data,,11-191,,Reserved,,,,Operational
 Type of data,,192-254,,Reserved for local use,,,,Operational
 Type of data,,255,,Missing,,,,Operational
diff --git a/GRIB2_CodeFlag_4_3_CodeTable_en.csv b/GRIB2_CodeFlag_4_3_CodeTable_en.csv
@@ -21,6 +21,7 @@ Type of generating process,,18,,Difference between two forecasts,,,,Operational
 Type of generating process,,19,,First guess,,,,Operational
 Type of generating process,,20,,Analysis increment,(see Note 2),29,,Operational
 Type of generating process,,21,,Initialization increment for analysis,(see Note 3),61,,Operational
-Type of generating process,,22-191,,Reserved,,,,Operational
+Type of generating process,,22,,Blended forecast,(See Note 4),249c,,Operational
+Type of generating process,,23-191,,Reserved,,,,Operational
 Type of generating process,,192-254,,Reserved for local use,,,,Operational
 Type of generating process,,255,,Missing,,,,Operational
diff --git a/GRIB2_CodeFlag_4_6_CodeTable_en.csv b/GRIB2_CodeFlag_4_6_CodeTable_en.csv
@@ -4,6 +4,11 @@ Type of ensemble forecast,,1,,Unperturbed low-resolution control forecast,,,,Ope
 Type of ensemble forecast,,2,,Negatively perturbed forecast,,,,Operational
 Type of ensemble forecast,,3,,Positively perturbed forecast,,,,Operational
 Type of ensemble forecast,,4,,Multi-model forecast,,,,Operational
-Type of ensemble forecast,,5-191,,Reserved,,,,Operational
+Type of ensemble forecast,,5,,Unpertubed forecast,,,,Operational
+Type of ensemble forecast,,6,,Perturbed forecast,,,,Operationaal
+Type of ensemble forecast,,7,,Initial conditions perturbations,(see Note 1),249d,,Operational
+Type of ensemble forecast,,8,,Model physics pertubations,(see Note 2),249e,,Operational
+Type of ensemble forecast,,9,,Initial conditions and model physics perturbations,(see Note 3),249f,,Operational
+Type of ensemble forecast,,10-191,,Reserved,,,,Operational
 Type of ensemble forecast,,192-254,,Reserved for local use,,,,Operational
 Type of ensemble forecast,,255,,Missing,,,,Operational
diff --git a/notes/CodeFlag_notes.csv b/notes/CodeFlag_notes.csv
@@ -150,6 +150,12 @@ noteID,note
 153,"The option quantile needs two additional arguments: 1) The total number of quantiles and 2) the quantile value."
 154,"These parameters are intended to be used with templates 4.121 and 4.122 in which the spatiotemporal criteria is encoded used to get a categorical yes/no per grid point of each ensemble member."
 155,"Scale Factor of Lower Limit, Scaled Value of Lower Limit, Scale Factor of Upper Limit and Scaled Value of Upper Limit must be set to missing. This entry is intended for, but not limited to, entries 5 to 7 in Code table 4.2 discipline 0 category 191."
+249a,Data for demonstrational purposes only.
+249b,Forecast from Machine Learning (ML) model.
+249c,"Combination of different forecast products to produce a smooth, continuous forecast by applying weights to each individual prediction system which depend on the lead time and forecast skill (for example, seamless prediction using nowcasting to short-range to medium-range)."
+249d,Ensemble members are initialised from different initial condition.
+249e,"Model physics are perturbed (for example, with methods like SPPT, SPP, SKEB, etc.)."
+249f,Combination of 7 and 8.
 248a,"Ben Bouallègue, Z. (2021). On the verification of the crossing-point forecast. Tellus A: Dynamic Meteorology and Oceanography, 73(1), 1–10. [https://doi.org/10.1080/16000870.2021.1913007]"
 253a,In relation to local coordinate axes at a (grid) cell edge.
 247a,"When using entry 10, the lower limit is used to encode the quantile q (must be an integer between 0 and Q) while the upper limit is used to encode the total number of quantiles Q. This defines the probability of the parameter falling within quantile q. For instance, to encode the probability of falling within the 10th percentile, then q=10 and Q=100; to encode the probability of falling within the 1st tercile, then q=1 and Q=3."
diff --git a/txt/CodeFlag.txt b/txt/CodeFlag.txt
@@ -75,7 +75,9 @@ Code table 1.4 - Type of data,,5,,Control and perturbed forecast products,,,,Ope
 Code table 1.4 - Type of data,,6,,Processed satellite observations,,,,Operational
 Code table 1.4 - Type of data,,7,,Processed radar observations,,,,Operational
 Code table 1.4 - Type of data,,8,,Event probability,,,,Operational
-Code table 1.4 - Type of data,,9-191,,Reserved,,,,Operational
+Code table 1.4 - Type of data,,9,,Example data,(see Note 2),249a,,Operational
+Code table 1.4 - Type of data,,10,,ML based forecast,(see Note 3),249b,,Operational
+Code table 1.4 - Type of data,,11-191,,Reserved,,,,Operational
 Code table 1.4 - Type of data,,192-254,,Reserved for local use,,,,Operational
 Code table 1.4 - Type of data,,255,,Missing,,,,Operational
 Code table 1.5 - Identification template number,,0,,Calendar definition,,,,Operational
@@ -1937,7 +1939,8 @@ Code table 4.3 - Type of generating process,,18,,Difference between two forecast
 Code table 4.3 - Type of generating process,,19,,First guess,,,,Operational
 Code table 4.3 - Type of generating process,,20,,Analysis increment,(see Note 2),29,,Operational
 Code table 4.3 - Type of generating process,,21,,Initialization increment for analysis,(see Note 3),61,,Operational
-Code table 4.3 - Type of generating process,,22-191,,Reserved,,,,Operational
+Code table 4.3 - Type of generating process,,22,,Blended forecast,(See Note 4),249c,,Operational
+Code table 4.3 - Type of generating process,,23-191,,Reserved,,,,Operational
 Code table 4.3 - Type of generating process,,192-254,,Reserved for local use,,,,Operational
 Code table 4.3 - Type of generating process,,255,,Missing,,,,Operational
 Code table 4.4 - Indicator of unit of time range,,0,,Minute,,,,Operational
@@ -2055,7 +2058,12 @@ Code table 4.6 - Type of ensemble forecast,,1,,Unperturbed low-resolution contro
 Code table 4.6 - Type of ensemble forecast,,2,,Negatively perturbed forecast,,,,Operational
 Code table 4.6 - Type of ensemble forecast,,3,,Positively perturbed forecast,,,,Operational
 Code table 4.6 - Type of ensemble forecast,,4,,Multi-model forecast,,,,Operational
-Code table 4.6 - Type of ensemble forecast,,5-191,,Reserved,,,,Operational
+Code table 4.6 - Type of ensemble forecast,,5,,Unpertubed forecast,,,,Operational
+Code table 4.6 - Type of ensemble forecast,,6,,Perturbed forecast,,,,Operationaal
+Code table 4.6 - Type of ensemble forecast,,7,,Initial conditions perturbations,(see Note 1),249d,,Operational
+Code table 4.6 - Type of ensemble forecast,,8,,Model physics pertubations,(see Note 2),249e,,Operational
+Code table 4.6 - Type of ensemble forecast,,9,,Initial conditions and model physics perturbations,(see Note 3),249f,,Operational
+Code table 4.6 - Type of ensemble forecast,,10-191,,Reserved,,,,Operational
 Code table 4.6 - Type of ensemble forecast,,192-254,,Reserved for local use,,,,Operational
 Code table 4.6 - Type of ensemble forecast,,255,,Missing,,,,Operational
 Code table 4.7 - Derived forecast,,0,,Unweighted mean of all members,,,,Operational
diff --git a/xml/CodeFlag.xml b/xml/CodeFlag.xml
@@ -458,7 +458,19 @@
 	</GRIB2_CodeFlag_en>
 	<GRIB2_CodeFlag_en>
 		<Title_en>Code table 1.4 - Type of data</Title_en>
-		<CodeFlag>9-191</CodeFlag>
+		<CodeFlag>9</CodeFlag>
+		<MeaningParameterDescription_en>Example data</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 1.4 - Type of data</Title_en>
+		<CodeFlag>10</CodeFlag>
+		<MeaningParameterDescription_en>ML based forecast</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 1.4 - Type of data</Title_en>
+		<CodeFlag>11-191</CodeFlag>
 		<MeaningParameterDescription_en>Reserved</MeaningParameterDescription_en>
 		<Status>Operational</Status>
 	</GRIB2_CodeFlag_en>
@@ -11630,7 +11642,13 @@
 	</GRIB2_CodeFlag_en>
 	<GRIB2_CodeFlag_en>
 		<Title_en>Code table 4.3 - Type of generating process</Title_en>
-		<CodeFlag>22-191</CodeFlag>
+		<CodeFlag>22</CodeFlag>
+		<MeaningParameterDescription_en>Blended forecast</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 4.3 - Type of generating process</Title_en>
+		<CodeFlag>23-191</CodeFlag>
 		<MeaningParameterDescription_en>Reserved</MeaningParameterDescription_en>
 		<Status>Operational</Status>
 	</GRIB2_CodeFlag_en>
@@ -12338,7 +12356,37 @@
 	</GRIB2_CodeFlag_en>
 	<GRIB2_CodeFlag_en>
 		<Title_en>Code table 4.6 - Type of ensemble forecast</Title_en>
-		<CodeFlag>5-191</CodeFlag>
+		<CodeFlag>5</CodeFlag>
+		<MeaningParameterDescription_en>Unpertubed forecast</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 4.6 - Type of ensemble forecast</Title_en>
+		<CodeFlag>6</CodeFlag>
+		<MeaningParameterDescription_en>Perturbed forecast</MeaningParameterDescription_en>
+		<Status>Operationaal</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 4.6 - Type of ensemble forecast</Title_en>
+		<CodeFlag>7</CodeFlag>
+		<MeaningParameterDescription_en>Initial conditions perturbations</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 4.6 - Type of ensemble forecast</Title_en>
+		<CodeFlag>8</CodeFlag>
+		<MeaningParameterDescription_en>Model physics pertubations</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 4.6 - Type of ensemble forecast</Title_en>
+		<CodeFlag>9</CodeFlag>
+		<MeaningParameterDescription_en>Initial conditions and model physics perturbations</MeaningParameterDescription_en>
+		<Status>Operational</Status>
+	</GRIB2_CodeFlag_en>
+	<GRIB2_CodeFlag_en>
+		<Title_en>Code table 4.6 - Type of ensemble forecast</Title_en>
+		<CodeFlag>10-191</CodeFlag>
 		<MeaningParameterDescription_en>Reserved</MeaningParameterDescription_en>
 		<Status>Operational</Status>
 	</GRIB2_CodeFlag_en>
