Code Table 4.2: parameters related to energy/water budgets

[sebvi]

Proposer

ECMWF : Richard Mladek, Sebastien Villaume

Summary and purpose

This document proposes new GRIB2 Code Table 4.2 for parameters related to energy/water budgets.

Action proposed

The team is requested to approve the content of this proposal for inclusion with the next update of the WMO Manual on Codes.

Discussions

The tables in this proposal contain parameters (for ozone, energy, mass and water budget) that will be of crucial importance for the next phase of ECMWF Reanalysis project (ERA6) which will start its production in 2023.

Detailed proposal

add in Code Table 4.2 the following parameters:

in discipline 0 - meteorology, category 1 - moisture

Parameter	Product Discipline	Parameter Category	proposed Parameter number	Units
Column integrated eastward water vapour mass flux	0	1	150	kg m-1 s-1
Column integrated northward water vapour mass flux	0	1	151	kg m-1 s-1
Column integrated eastward cloud liquid water mass flux	0	1	152	kg m-1 s-1
Column integrated northward cloud liquid water mass flux	0	1	153	kg m-1 s-1
Column integrated eastward cloud ice mass flux	0	1	154	kg m-1 s-1
Column integrated northward cloud ice mass flux	0	1	155	kg m-1 s-1
Column integrated eastward rain mass flux	0	1	156	kg m-1 s-1
Column integrated northward rain mass flux	0	1	157	kg m-1 s-1
Column integrated eastward snow mass flux	0	1	158	kg m-1 s-1
Column integrated northward snow mass flux	0	1	159	kg m-1 s-1
Column integrated divergence of water vapour mass flux	0	1	160	kg m-2 s-1
Column integrated divergence of cloud liquid water mass flux	0	1	161	kg m-2 s-1
Column integrated divergence of cloud ice mass flux	0	1	162	kg m-2 s-1
Column integrated divergence of rain mass flux	0	1	163	kg m-2 s-1
Column integrated divergence of snow mass flux	0	1	164	kg m-2 s-1

in discipline 0 - meteorology, category 3 - mass

Parameter	Product Discipline	Parameter Category	proposed Parameter number	Units
Column integrated divergence of total mass flux	0	3	35	kg m-2 s-1
Column integrated eastward total mass flux	0	3	36	kg m-1 s-1
Column integrated northward total mass flux	0	3	37	kg m-1 s-1

in discipline 0 - meteorology, category 14 - Trace gases category 20 - Atmospheric Chemical Constituents

Parameter	Product Discipline	Parameter Category	proposed Parameter number	Units
Column integrated eastward ozone mass flux	0	14 20	3 78	kg m-1 s-1
Column integrated northward ozone mass flux	0	14 20	4 79	kg m-1 s-1
Column integrated divergence of ozone mass flux	0	14 20	5 80	kg m-2 s-1
Column integrated net source of ozone (see Note )	0	14 20	6 81	kg m-2 s-1

add Note: The net source of ozone is the sum of all the atmospheric (chemical) processes creating and destroying constituent/aerosol of ozone in the column.

in discipline 0 - meteorology, could be Category 1 - Temperature OR Category 7 - thermodynamic stability indices (renamed "thermodynamic stability indices and properties") OR Category 19 - physical atmospheric properties OR new category XXX - thermodynamic properties Category 21 - Thermodynamic properties

Parameter	Product Discipline	Parameter Category	proposed Parameter number	Units
Column integrated potential + internal energy	0	XX 21	XX 0	J m-2
Column integrated kinetic energy	0	XX 21	XX 1	J m-2
Column integrated total energy (see Note 1)	0	XX 21	XX 2	J m-2
Column integrated enthalpy	0	XX 21	XX 3	J m-2
Column integrated water enthalpy (see Note 2)	0	XX 21	XX 4	J m-2
Column integrated eastward enthalpy flux	0	XX 21	XX 5	W m-1
Column integrated northward enthalpy flux	0	XX 21	XX 6	W m-1
Column integrated eastward potential energy flux	0	XX 21	XX 7	W m-1
Column integrated northward potential energy flux	0	XX 21	XX 8	W m-1
Column integrated eastward kinetic energy flux	0	XX 21	XX 9	W m-1
Column integrated northward kinetic energy flux	0	XX 21	XX 10	W m-1
Column integrated eastward total energy flux (see Note 1)	0	XX 21	XX 11	W m-1
Column integrated northward total energy flux (see Note 1)	0	XX 21	XX 12	W m-1
Divergence of column integrated enthalpy flux	0	XX 21	XX 13	W m-2
Divergence of column integrated potential energy flux	0	XX 21	XX 14	W m-2
Divergence of column integrated water potential energy flux (see Note 3)	0	XX 21	XX 15	W m-2
Divergence of column integrated kinetic energy flux	0	XX 21	XX 16	W m-2
Divergence of column integrated total energy flux (see Note 1)	0	XX 21	XX 17	W m-2
Divergence of column integrated water enthalpy flux (see Note 2)	0	XX 21	XX 18	W m-2

add Notes
1: Total (atmospheric) energy is the sum of internal energy, potential energy, kinetic energy and latent heat. Same applies to energy fluxes
2: The water enthalpy (flux) is the enthalpy (flux) associated with the temperature of the water mass.
3: The water potential energy flux is the flux of potential energy associated with the water mass.

[amilan17]

re: https://github.com/wmo-im/CCT/wiki/Teleconference-26-and-28.4.2022

No objections but some uncertainty over which category some of the new parameters (those related to 'pure' energy as opposed to temperature etc) should go in, help requested. Sibylle to consult with experts in DWD.

[sebvi]

I really would like to reach a consensus as soon as possible to be able to proceed with the branch. Thank you

[amilan17]

https://github.com/wmo-im/CCT/wiki/Teleconference-18-and-19.5.2022 note:

last table will be a new sub-category and update the table with the list of categories

[sebvi]

During the meeting we favoured creating a new category for the energy variables. The ozone variables should be encoded using the mechanism of chemical constituents from Common Code Table 14 and a physical parameter from discipline 0 category 20.

@SibylleK : Are you happy if I call the new category for the thermodynamic parameters: "Thermodynamics properties" ?

[SibylleK]

I am happy with this proposal, but I got the comment of a colleague that maybe:

"Thermodynamics and energy forms properties"

could be another option worth considering, because kinetic and potential energies might not be associated directly with thermodynamics by everyone (but this is of course also a matter of taste).

[sebvi]

Thank you @SibylleK for the suggestion. Maybe we could use "Thermodynamic and Energies"

[sebvi]

I was planning to assign this new Thermodynamics category to 8 ... until I realized we somehow have an inconsistency: We don't have any entries in Code Table 4.2 for categories 8 to 12 (this is why I chose 8) but we actually have those number assigned in Code Table 4.1 (although entries 9-12 are marked as deprecated .... but not entry 8!!!):

Parameter category by product discipline,Product discipline 0 - Meteorological products,8,,Kinematic stability indices,,,,Operational
Parameter category by product discipline,Product discipline 0 - Meteorological products,9,,Temperature probabilities,,,,Deprecated
Parameter category by product discipline,Product discipline 0 - Meteorological products,10,,Moisture probabilities,,,,Deprecated
Parameter category by product discipline,Product discipline 0 - Meteorological products,11,,Momentum probabilities,,,,Deprecated
Parameter category by product discipline,Product discipline 0 - Meteorological products,12,,Mass probabilities,,,,Deprecated

I have checked in earlier version of the Code Tables (I checked version 5) and we don't seem to have ever populated this category 8.

I think this should be discussed at the meeting and possibly open a separated issue.

[amilan17]

https://github.com/wmo-im/CCT/wiki/Teleconference-8.6.2022 notes:

• @sebvi will use Category 21, not 8 in Code Table 4.1 and open a new issue to address category 8
• Change name to: Thermodynamic Properties

[amilan17]

@sebvi this branch has not been updated yet. will you be able to do it soon?

[sebvi]

oh! I have it ready locally but forgot to push it ! will do it this morning sorry @amilan17 !

[sebvi]

sorry for the delay, it is now updated

[marijanacrepulja]

@sebvi there are inconsistency for some of Code Table 4.2 entries branch vs proposal,

category 1 - moisture
in branch
154 Column integrated eastward cloud ice mass flux
in proposal
154 Column integrated eastward cloud ice water mass flux

in branch
155 Column integrated northward cloud ice mass flux
in proposal
155 Column integrated northward cloud ice water mass flux

in proposal
162 Column integrated divergence of cloud ice water mass flux
in banch
162 Column integrated divergence of cloud ice mass flux

category 20: atmospheric chemical
in proposal
80 Column integrated divergence mass flux
in branch
Column integrated divergence of mass flux

category 21
in proposal
10 Column integrated northward kinetic energy flux

in branch (it is typo kintic instead of kinetic)
10 Column integrated northward kintic energy flux

[sebvi]

Ok I will update the proposal to reflect the content of the branch. I removed "water" from "cloud ice water" to be more consistent with the other occurences of "cloud ice" in Code Table 4.2, the last 2 are typos, thank you for spotting.

[marijanacrepulja]

@sebvi the note under discipline 0 - meteorology, category 20 - Atmospheric Chemical Constituents is specific to ozone. Can you consult with relevant RD colleagues to reword the note and make it generic. Thanks

[sebvi]

Ah yes I removed the reference to ozone at the beginning of the note but not at the end. I have edited the proposal. That said, I don't think we added the note in the branch and I don't remember why. Let me know what you want me to do: leave it as is or add the note in the branch, Thanks

[marijanacrepulja]

Hi @amilan17,
@sebvi updated the text for the note under discipline 0 - meteorology, category 20 - Atmospheric Chemical Constituents
I believe we can update the note in FT2022-2 draft document.
Do we have the note in the branch, I can't see it.
Thanks

[amilan17]

I can update both branch and document. Is this the new note?
"The net source is the sum of all the atmospheric (chemical) processes creating and destroying constituent/aerosol of ozone in the column"

[sebvi]

@amilan17 nope, "of ozone" is striked through... maybe I remove all the striked through text if it is confusing. :)

[amilan17]

new note will be: "The net source is the sum of all the atmospheric (chemical) processes creating and destroying chemical constituents or aerosols in the column."