Code Tables 4.1, 4.2 and 4.5: new entries for ERA6 and Destination Earth datasets

[sebvi]

Initial request

ECMWF is requesting new entries in Code Table 4.2 for our projects ERA6 and Destination Earth.

In this context, we are also requesting a new category "renewable energy sector" within discipline 20 "Health and socioeconomic impacts".

Amendment details

Add new Category in Code Table 4.1 discipline 20

Name	proposed category number
Renewable energy sector	3

ADD new entries in Code table 4.2 discipline 0 category 1

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Saturation specific humidity with respect to water	0	1	168	kg m-3
Total column integrated saturation specific humidity with respect to water	0	1	169	kg m-2

ADD new entries in Code Table 4.2 discipline 0 category 2

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Vertical divergence	0	2	59	s-1
Drag thermal coefficient	0	2	60	Numeric
Drag evaporation coefficient	0	2	61	Numeric
Eastward turbulent surface stress	0	2	62	N m-2
Northward turbulent surface stress	0	2	63	N m-2
Eastward turbulent surface stress due to orographic form drag	0	2	64	N m-2
Northward turbulent surface stress due to orographic form drag	0	2	65	N m-2
Eastward turbulent surface stress due to surface roughness	0	2	66	N m-2
Northward turbulent surface stress due to surface roughness	0	2	67	N m-2

DEPRECATE in Code Table 4.2 discipline 0 category 2

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Eastward turbulent surface stress	0	2	37	N m-2 s
Northward turbulent surface stress	0	2	38	N m-2 s

ADD new entry in CodeTable 4.2 discipline 0 category 3

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Pressure departure from hydrostatic state	0	3	46	Pa

ADD new entry in Code Table 4.2 discipline 0 category 19

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Net radiation flux	0	19	46	W m-2
Global irradiance on tilted surfaces	0	19	47	W m-2

ADD new entry in Code Table 4.2 discipline 0 category 21

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Eady growth rate	0	21	22	day-1

ADD new entry in Code Table 4.2 discipline 0 category 191

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Tropical cyclones track density	0	191	4	Numeric

ADD new entries in Code Table 4.2 discipline 2 category 0

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Emissivity	2	0	62	Proportion
Canopy air temperature	2	0	63	K

ADD new entry in Code Table 4.2 discipline 2 category 3

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Soil wetness index	2	3	30	Numeric

ADD new entries in Code Table 4.2 discipline 2 category 6

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Distance downward from roof surface	2	6	6	m
Distance inwards from outer wall surface	2	6	7	m
Distance downwards from road surface	2	6	8	m

ADD new entries in Code Table 4.2 discipline 3 category 1

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Cloudy reflectance	3	1	31	%
Clear reflectance	3	1	32	%

ADD new entries in Code Table 4.2 discipline 10 category 2

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
x-component of ice drift	10	2	24	m s-1
y-component of ice drift	10	2	25	m s-1

ADD new entry in Code Table 4.2 discipline 10 category 3

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
salinity	10	3	21	kg kg-1

ADD new entries in Code Table 4.2 discipline 10 category 4

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units
Sea water meridional volume transport	10	4	42	m3 m-2 s-1
Sea water zonal volume transport	10	4	43	m3 m-2 s-1
Sea water column integrated meridional volume transport	10	4	44	m3 m-1 s-1
Sea water column integrated zonal volume transport	10	4	45	m3 m-1 s-1
Sea water meridional mass transport	10	4	46	kg m-2 s-1
Sea water zonal mass transport	10	4	47	kg m-2 s-1
Sea water column integrated meridional mass transport	10	4	48	kg m-1 s-1
Sea water column integrated zonal mass transport	10	4	49	kg m-1 s-1
Sea water column integrated practical salinity	10	4	50	g kg-1 m
Sea water column integrated salinity	10	4	51	kg kg-1 m

ADD new entries in Code Table 4.2 discipline 20 category 3

Name	Product Discipline	Parameter Category	proposed Parameter Number	Units	Comments
Renewable power capacity	20	3	0	W	Renewable power capacity is the possible instantaneous power production under optimal conditions from renewable sources.
Renewable power production rate	20	3	1	W
Wind power capacity	20	3	2	W	Power capacity is the possible instantaneous power production under optimal conditions using the specified source.
Wind power production rate	20	3	3	W
Solar photovoltaic (PV) power capacity	20	3	4	W	Power capacity is the possible instantaneous power production under optimal conditions using the specified source.
Solar photovoltaic (PV) power production rate	20	3	5	W
Solar non-photovoltaic (PV) power capacity	20	3	6	W	Power capacity is the possible instantaneous power production under optimal conditions using the specified source.
Solar non-photovoltaic (PV) power production rate	20	3	7	W
Concentrated solar power (CSP) power capacity	20	3	8	W	Power capacity is the possible instantaneous power production under optimal conditions using the specified source.
Concentrated solar power (CSP) power production rate	20	3	9	W

ADD new entries in Code Table 4.5

Code	Description	Units
173	Top of snow over sea ice on sea, lake or river	-
185	Roof level	-
186	Wall level	-
187	Road level	-
188	Melt pond top surface	-
189	Melt pond bottom surface	-

Comments

No response

Requestor(s)

Robert Osinski (ECMWF)
Matthew Griffith (ECMWF)
Sebastien Villaume (ECMWF)

Stakeholder(s)

ECMWF
Destination Earth partners

Publication(s)

Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.1, discipline 20
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 0, category 1
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 0, category 2
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 0, category 3
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 0, category 19
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 0, category 21
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 0, category 191
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 2, category 0
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 2, category 3
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 2, category 6
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 10, category 4
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.2, discipline 20, category 3
Manual on Codes (WMO-No. 306), Volume I.2, GRIB code table 4.5

Expected impact of change

None

Collaborators

No response

References

No response

Validation

No response

[amilan17]

https://github.com/wmo-im/CCT/wiki/Teleconference.25.26.April.2023 notes:

• Sebastien introduced the issue
• in 4.2.0.2 - proposing to deprecate two parameters, because they are in time seconds which is not correct, propose to replace the ones with wrong units with new codes with correct units. The current codes have a note stating that "accumulation does not change the units" (Marijana) can we change the units as an editorial change? (Sebastien) we usually don't do this (Jeff) It's probably safer to create new ones and add a note saying which ones to use instead (DECISION) add a note indicating which parameters to use instead. 
• (Jeff) 4.20.21 new code -- Is there a category 21? (Sebastien) I think it's new for Thermal dynamics ... and is still in the FT2023-1 branch. (Jeff) What is eady growth rate? (Sebastien) Eady is a person's name (DECISION) add a note/reference

[amilan17]

https://github.com/wmo-im/CCT/wiki/Teleconference.6.7.June.2023 notes:

They are starting to forecast the renewable energy production; It would be helpful if the units can be checked; @amilan17 see if you can find someone to review. units; 

@sebvi add notes for "deprecated" codes; update branch;

[sebvi]

branch updated, still need to add the notes for deprecated. Trying to see if I could reuse an existing as it is a typical case of parameter wrongly having units of an accumulation.

[amilan17]

see if you can find someone to review. units;

@sebvi All the units or just units for one of the tables? And what exactly needs to be checked?

[amilan17]

https://github.com/wmo-im/CCT/wiki/Teleconference.13.July.2023 notes:

sebastien is responding to Anna's review in PR

[sebvi]

see if you can find someone to review. units;

@sebvi All the units or just units for one of the tables? And what exactly needs to be checked?

for existing parameters that are deprecated due to their units, we have a typical type of comment : accumulation does not change the units, this parameter is deprecated, use a parameter with more suitable units). This is what I meant. So I will draft a note along these lines.

[amilan17]

I added a note "Parameters are deprecated. It is recommended to use 63 and 64 instead."