Closed sebvi closed 1 year ago
https://github.com/wmo-im/CCT/wiki/Teleconference-4.10.2022 meeting notes:
Sebastien presented this proposal; when ready Sebastien can provide examples and a pre-release of ecCodes for validation. @SibylleK will review proposal
https://github.com/wmo-im/CCT/wiki/Teleconference-1-and-2.11.2022 notes:
https://github.com/wmo-im/CCT/wiki/Teleconference-1-and-2.11.2022 notes:
@amilan17 will work on
Dear @sebvi I downloaded the samples and source code from Eccodes. This works fine. As I am not an expert on waves, I asked a colleague, Rosio Maita, to take a look at the data, and another colleague, Fernando Ii, to help plotting with Metview. At the moment, we only draw a map with a string of '1'. We are trying to understand how to plot this data correctly, to verify the values.
Dear @sebvi I downloaded the samples and source code from Eccodes. This works fine. As I am not an expert on waves, I asked a colleague, Rosio Maita, to take a look at the data, and another colleague, Fernando Ii, to help plotting with Metview. At the moment, we only draw a map with a string of '1'. We are trying to understand how to plot this data correctly, to verify the values.
Dear @sergioh-pessoal The GRIB files do not have actual data ( in the Data Section ). They are "constant fields" (all field values set to 1) This was done to reduce their size.
Dear @shahramn So the decoding is correct. thanks for the clarification
We have receive several questions and comments from @SibylleK . We have worked on these and will provide a response as soon as possible (I need to reformat our answers/clarifications). It should be done this week.
https://github.com/wmo-im/CCT/wiki/Teleconference-21.11.2022 notes: @sebvi will update the issue with questions and responses received offline. Will probably not change the proposal, but it's still in progress. @SibylleK said it would be useful to compare to the GRIB1 data file.
Here are the questions received from @SibylleK and DWD.
These templates are intended to be used exclusively for encoding 2D wave spectra. We think it is not needed to add fixed surface-information to these templates so we agree that the title of the templates could contain water surface waves.
These templates are intended to encode parameters like the significant wave height which is related to the water surface. For this reason, the fixed surface-information was added.
-The (non-expert) users may not know if the wave frequency means “1/T” or “2p/T”, where “T” denotes the wave period. This should be clarified in a Note, but see also issue 6 below.
f=1/T is used and we are not aware that someone in the wave model community uses 2p/T. We will add a note.
-The (non-expert) users may not know on which wave dispersion relation the data are based, so they may be unable to assign a wavelength to the given wave frequencies (or wave periods). Maybe there should be at least an optional list of the wavelengths that correspond to the wave frequencies (or wave periods).
The dispersion relation is ω2 = g k tanh(k D). It includes the water depth which makes the relation frequency / wavelength, water depth dependent. If a user would need to determine the associated wave length, the model water depth is needed. An optional list of wavelength corresponding to the wave frequencies/periods would therefore not be valid over the entire model domain except the model would only consider deep water areas.
These templates are intended to encode 2D wave spectra. These spectra are based on discrete frequencies and directions. We are not aware of any wave model which uses intervals / bins of wave frequencies / directions to describe the wave spectrum. Do you have a specific use case in mind, which would make it necessary to encode intervals?
Maybe we should have split this proposal into two independent proposals because the first 4 templates are totally independent of the last 2 templates and serves completely different purpose, they should not be consider together.
The wave spectrum is well established and comes from the simple assumption that the wave fields (all waves together) can be represented as Fourier series, for which frequency is normally used.
We prefer to have separate templates for the 2D spectra (4.99-4.102) and for parameters which are derived(4.103/104) like the significant wave height (swh) to distinguish between spectrum and derived parameters.
Templates 4.103/104 are intended to be used for parameters like the “Significant wave height of all waves with periods within the inclusive range from 10 to 12 seconds“,`
The description of this parameter in our parameter database describes this parameter like this:
„This parameter is four times the square root of the integral over all directions of the two-dimensional wave spectrum and all frequencies between 1/12 and 1/10 hertz (i.e. periods between 10 and 12 seconds)“.
-There should be a Note on the unit of the wave direction.
We will add a note on the unit.
https://github.com/wmo-im/CCT/wiki/Teleconference-12-and-13.12.2022 notes:
double check after branch update
Reviewed consistency and only needed to make many words all lowercase.
Thanks @amilan17 I can have a look at this. I believe the note already exists and have an note_id, it is the generic note we have for these octets in all templates.
@sebvi is it note ID 33?
33 | Hours greater than 65534 will be coded as 65534. |
@sebvi In this https://github.com/wmo-im/GRIB2/issues/167#issuecomment-1332454032 you mentioned that you would add some notes. Is this done?
https://github.com/wmo-im/CCT/wiki/Teleconference-10.01.2023 notes:
@SibylleK - will verify notes
@amilan17 and @marijanacrepulja will review consistency
Notes have been verified.
Initial request
ECMWF is engaged in migrating its operations to GRIB2 with the aim to complete the work in the following years. To support this activity, we are requesting new section 4 templates in the context of wave modelling to encode some products, namely the full 2D wave spectra (wave direction and frequency) and products based on a subset of waves discriminated by wave periods and wave period ranges.
Although the parameters for wave spectra exists in Code Table 4.2, discipline 10 - oceanography, category 0 - waves, there are no templates in section 4 in which one can specify the partitioning of the spectra in terms of frequency and direction.
At ECMWF, the current partitioning of the spectra consists of 36 directions (every 10 degrees, 0 to 350) and 36 frequencies.
The proposed templates 4.99 and 4.100 enable the encoding of wave spectra for deterministic and ensemble forecasting respectively and allow to specify the full list of frequencies and directions of the partitioning (in a similar way the hybrid levels coefficients can be specified at the end of section 4). This is handy when frequencies and/or directions can not be derived from a mathematical formula.
The proposed templates 4.101 and 4.102 enable the encoding of wave spectra for deterministic and ensemble forecasting respectively and allow to specify the mathematical formulae needed to derive the frequencies and directions programatically. At ECMWF, the directions can be derived using an arithmetic formula while the frequencies can be derived using a geometric formula. The formula used can be specified in a new Code table 4.251 and the parameters of the formula can be specified subsequently. This mechanism is similar to the mechanism used to specify aerosol particle size distributions.
Finally, the proposed templates 4.101 and 4.1102 enable the encoding of parameters based on a subset of the wave periods. For instance, at ECMWF, we produce the products several "significant wave height" with period ranges: 10 to 12 seconds, 12 to 14 seconds, 14 to 17 seconds ,etc. We also produce "mean wave period" with various threshold, for instance "period of at least 10 seconds", of at least 12 seconds, etc. The proposed templates allow the encoding of these ranges and thresholds.
Amendment details
ADD the following templates entries in code table 4.0 and update range of unused entries:
ADD New Code Table 4.251 – Wave direction and frequency formulae
Note 1: Geometric sequence: x_n = x_0 * r^(n-1) with "x_0" first parameter and "r" second parameter Note 2: Arithmetic sequence: a_n = a_1 + (n-1) d with "a_1" first parameter and "d" second parameter
ADD Template 4.99 - Analysis or forecast at a horizontal level or in a horizontal layer at a point in time for wave 2D spectra with explicit list of frequencies and directions
ADD Template 4.100 Individual ensemble forecast, control and perturbed, at a horizontal level or in a horizontal layer at a point in time for wave 2D spectra with explicit list of frequencies and directions
ADD Template 4.101 Analysis or forecast at a horizontal level or in a horizontal layer at a point in time for wave 2D spectra with frequencies and directions defined by formulae
ADD Template 4.102 Individual ensemble forecast, control and perturbed, at a horizontal level or in a horizontal layer at a point in time for wave 2D spectra with frequencies and directions defined by formulae
ADD Template 4.103 Analysis or forecast at a horizontal level or in a horizontal layer at a point in time for waves selected by period range
ADD Template 4.104 Individual ensemble forecast, control and perturbed, at a horizontal level or in a horizontal layer at a point in time for waves selected by period range
Comments
No response
Requestor(s)
Jean Bidlot, Robert Osinski and Sebastien Villaume (all ECMWF)
Stakeholder(s)
Enter list of stakeholder(s).
Publication(s)
Manual on Codes (WMO-No. 306), Volume I.2, GRIB Code Table 4.0 (new entries) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Code Table 4.251 (new table) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Template 4.99 (new template) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Template 4.100 (new template) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Template 4.101 (new template) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Template 4.102 (new template) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Template 4.103 (new template) Manual on Codes (WMO-No. 306), Volume I.2, GRIB Template 4.104 (new template)
Expected impact of change
No response
Collaborators
The proposal was drafted together with the wave model Team at ECMWF and tested in ECMWF's GRIB decoder ecCodes
References
No response
Validation
No response