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. 

The data is provided under license: 

The import feature is available since May 2024, from Delft-FEWS version 2024.01 onwards.

About Meteo-France API portal

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. 

Documentation of the AROME model, including example query can be found (page in french): Données Publiques de Météo-France - Données de modèle AROME (meteofrance.fr)

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. 

After login Meteo-France API portal, click on the user account in connected mode (top right) > 'My API' > Choose an API > Click 'Generate Token'. The APPLICATION_ID can be found in the cURL command at the bottom of the page.

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.

Import_AROME.xml
<timeSeriesImportRun 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/timeSeriesImportRun.xsd">
	<import>
		<general>
			<importType>MeteoFranceArome</importType>
			<serverUrl>https://public-api.meteofrance.fr/public/arome/1.0/wcs/MF-NWP-HIGHRES-AROME-001-FRANCE-WCS</serverUrl>
			<relativeViewPeriod unit="hour" start="0" end="48"/>
			<idMapId>IdImportAROME</idMapId>
			<unitConversionsId>ImportUnitConversions</unitConversionsId>
		</general>
		<properties>
			<string key="tokenUrl" value="https://portail-api.meteofrance.fr/token"></string>
			<string key="applicationId" value=$APPLICATION_ID$></string>
			<string key="version" value="2.0.1"></string>
			<!--Below is needed only for some parameters, e.g. TOTAL_PRECIPITATION__GROUND_OR_WATER_SURFACE-->
			<string key="coverageIdSuffix" value="_PT1H"></string>
			<!--Below is needed only for some parameters, e.g. TEMPERATURE__SPECIFIC_HEIGHT_LEVEL_ABOVE_GROUND-->            
			<!--<string key="height" value="2"></string>-->
		</properties>
		<timeSeriesSet>
			<moduleInstanceId>Import_AROME</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>P.nwp</parameterId>
			<locationId>AROME</locationId>
			<timeSeriesType>external forecasting</timeSeriesType>
			<timeStep  unit="hour" multiplier="1"/>
			<readWriteMode>read complete forecast</readWriteMode>
			<expiryTime unit="day" multiplier="7"/>
		</timeSeriesSet>
		<externUnit parameterId="P.nwp" unit="kg_m2"/>
	</import>
</timeSeriesImportRun>


About server url

The serverUrl is used to select the product to import. The server url used in the example indicates the products is with 0.1 degree resolution covering the France region. It is also possible to different grids and resolution by using a different url. See the documentation for more information.


About optional properties

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.

sample of IdImportAROME.xml
<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.

sample of ImportKNMIUnits.xml
<?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. 

The below definition defines the entire model domain of AROME. 

Grids.xml
<grids 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/grids.xsd">
	<regular locationId="AROME">
        <rows>1791</rows>
        <columns>2801</columns>
        <geoDatum>WGS 1984</geoDatum>
        <firstCellCenter>
            <x>-12</x>
            <y>55.4</y>
            <z>0.0</z>
        </firstCellCenter>
        <xCellSize>0.01</xCellSize>
        <yCellSize>0.01</yCellSize>
    </regular>
</grids>


  • No labels