| Table of Contents |
|---|
| Excerpt | ||
|---|---|---|
| ||
Import NWP forecasts (grb) from AROME model by Meteo-France |
Overview
The MeteoFranceArome importer facilitates access to forecast data generated by the Meteo-France, particularly from the AROME model. The data is retrieved via the Meteo-France API portal.
...
| Info | ||
|---|---|---|
| ||
Meteo-France API portal provides access to a number of models. A catalogue of models available and their descriptions can be found at METEO FRANCE – L’API AROME. To access different models, separate subscriptions is needed. BY default, a free subscription of 50 requests/minute is provided. |
AROME model
The AROME model provided by the API portal, is the French operational limited-area, fine-scale atmospheric forecasting model. It provides two types resolution and provides forecasts for various meteorological parameters at various levels. The forecasts have an hourly temporal resolution with a lead-time of 48 hours. The forecasts are tailored to specific regions covering the entire France and part of its neighboring countries. The download format includes GRIB V2, GEOTIFF or image PNG. This importer imports the GRIB V2 format.
...
The AROME model issues forecasts at a 3 hours interval (Timezone GMT). The forecasts availability can be found in the documentation here: 250_Meteo-France_2019_doc_arome_pour-portail-_250_2019-09-03.pdf
Authentication and APPLICATION_ID
The Meteo-France API portal allows access by a user name and password. The credentials are linked to an APPLICATION_ID, which is needed to generate access tokens by the importer.
...
curl -k -X POST https://portail-api.meteofrance.fr/token -d "grant_type=client_credentials" -H "Authorization: Basic APPLICATION_ID"Configuration (Example)
A complete import module configuration consists of an ID Mapping file and a Import Module Instance file. To convert the rainfall in a proper unit (from 1 kg_m2 per hour to mm/hr for example) it is also required to configure a Unit Conversion file.
ModuleConfigFiles
The following example of an Import Module Instance will import the AROME model with 0.1 resolution for France at hourly timestep over the complete forecast period from 0 to 24 hour leadtime.
...
| Info | ||
|---|---|---|
| ||
| The example above specified four properties: "tokenUrl", "applicationId","version" and "coverageIdSuffix". Among them, "coverageIdSuffix" is an operational property that will add a suffix to the coverage ID. In this case, a "coverageIdSuffix" with a value of "_PT1H" would request the complete forecast available since lead time of 1 hour for "TOTAL_PRECIPITATION__GROUND_OR_WATER_SURFACE". Besides, another optional property is "height" which will add to the subset query. For example, a "height" with a value of "2" would request the data at a level of 2 for "TEMPERATURE__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND". See example query: https://public-api.meteofrance.fr/public/arome/1.0/wcs/MF-NWP-HIGHRES-AROME-001-FRANCE-WCS/GetCoverage?SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&format=application/wmo-grib&coverageId=TEMPERATURE__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND___2024-05-24T00:00:00Z&subset=time(2024-05-24T01:00:00Z)&subset=lat(44.97702026367186,54.86471557617186)&subset=long(-5.980194091796874,9.884063720703125)&subset=height(2) |
IdMapFiles
Defines the ID mapping of the parameters.
| Code Block | ||
|---|---|---|
| ||
<idMap xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/idMap.xsd" version="1.1"> <parameter internal="P.nwp" external="TOTAL_PRECIPITATION__GROUND_OR_WATER_SURFACE"/> <!--<parameter internal="T.nwp" external="TEMPERATURE__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND"/>--> </idMap> |
UnitConversionFile
Defines the conversion of the units that should be applied.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<?xml version="1.0" encoding="UTF-8"?> <unitConversions ...................> <unitConversion> <inputUnitType>kg_m2</inputUnitType> <outputUnitType>mm</outputUnitType> <multiplier>1</multiplier> <incrementer>0</incrementer> </unitConversion> ........ ........ </unitConversions> |
Grid definition
Defines the definition of the AROME grid.
...