CMETEO

Introduction

Cmeteo stands for CORINE-meteo. Cmeteo can be seen an application suite to process meteo data as found in e.g. the CGMS.grid_weather dataset. It aggregates and translates meteo indicators according to some spatial and thematic specs. Think of meteo indicators on temperature (maximum, minimum, mean or daily), windspeed, precipitation, radiation. Also indicators as potential transpiration, evaporation may be included. In the context of MARS, the weather indicators are given per grid. These indicators will be aggregated to spatial themas like NUTS or agri environmental regions, or translated/adjusted for landcovers of interest like crops, etc. Translation will be accompanied by aggregation. See ..(somewhere else in this wiki).. for more detailed description of cmeteo.

The cmeteo package is designed to operate in several environments which may differ in both input as output datasets. All these environments need to have the basic data (both input and output) available for the CMeteo process.

Software tools needed by cmeteo

Cmeteo uses functionality which is implemented in several other software tools. The major ones are listed in the following table.

tool	remarks
REGLISTS	supplies specific lists of regions directed by input parameters.
MRS_PROCESS	contains common used functionality for processing more complex programs like cmeteo.
ADD_PROCESS_LOG	procedure to send some info to a logtable.
ADD_PROCESS_METRICS	procedure to send some data, retrieved during processing, to a logtable.
MRS_STATS	generic tool to collect some metrics during processing.
MRS_HTTP	generic tool to handle some messages.
DATE_GENERATOR	generic tool to generate specific lists of dates according to the input paramaters.

Interface

Datasets used by cmeteo

dataset containing	example in CGMS_EUR_08	name in cmeteo	remarks
weather indicators per grid	GRID_WEATHER	CMETEO_GRID_WEATHER	input for cmeteo, renaming columns to a standardized naming
weather indicators per NUTS-region	NUTS_WEATHER	cmeteo_region_weather	input for cmeteo, renaming columns to a standardized naming
weather indicators per agri-environmental region (stratum, zone)	ZONAL_WEATHER	cmeteo_zonal_weather	input for cmeteo, renaming columns to a standardized naming
landcovers or crops to be evaluated	crop_landcover	cmeteo_landcovers	input for cmeteo, renaming some columns to a standardized naming
areas/surfaces for landcovers per grid and per NUTS region	grid_plus_nuts_landcover	cmeteo_grid_landcover_areas	input for cmeteo, renaming the dataset and some columns in a standardized way
areas/surfaces for landcovers per grid and per agri-env. region	grid_plus_ens_landcover
areas/surfaces for crops per NUTS region	aggregation_areas	cmeteo_aggregation_areas	input for cmeteo, renaming some columns to a standardized naming
weather indicators per region which are rejected		cmeteo_rejected_weather	output for cmeteo, containing weather indicators per region that could not be stored in regular output via cmeteo_region_weather
regions and their mappings		cmeteo_region_mappings	input for cmeteo

Specifications of cmeteo_grid_weather

Cmeteo_region_weather is a replacement for a variety of datasets to which cmeteo need to fill up with output. The results of cmeteo must be placed into datasets with an appropriate spacial resolution like NUTS regions or agri-environmental zones. In general, datasets for NUTS-regions are pre- or postfixed with 'nuts'; datasets for agri_environmental zones are pre- or postfixed with 'zonal'. Per thema, the structure of datasets for both resolutions are very similar. In various schemas, datasets containing weather indicators do vary both in name of the set and in names of the attributes. Also the collection of the attributes may vary. However, all the sets contain the indicators that are essential to process cmeteo. As cmeteo only can use one structure for grid weather, some logic must be applied to transform the various sets into unified representations. This transformation is implemented as a view (standard selection) on each of the original datasets while renaming the attributes and eventually suppliyng neutral or valuable data for missing attributes. The dataset cmeteo_grid_weather is composed of the most wide combination of attributes of the various underlying datasets. Below a summary of some sets in various schemas and the definition of cmeteo_grid_weather domain schema: CGMS_EUR_08 CGFS_EUR_09 CGFS_EUR_09 CGMS_ASIA_08 dataset: grid_weather ecmwf_his_downscaled_data ecmwf_eps_downscaled_data ecmwf_downscaled_data cmeteo_grid_weather attributes: grid_no grid_no grid_no ecmwf_grid_no grid_no NN number(10) day mdate mdate mdate day NN date - 1) - 1) date_offset - 1) day_offset NN number(10) - 2) - 2) member_no - 2) member_no NN number(10) maximum_temperature temperature_max temperature_max temperature_max max_temperature NN number(3,1) minimum_temperature temperature_min temperature_min temperature_min min_temperature NN number(3,1) - 3) temperature_mean temperature_mean temperature_mean mean_temperature NN number(3,1) - 4) temperature_dew temperature_dew temperature_dew dew_temperature NN number(3,1) vapour_pressure vapour_pressure vapour_pressure vapour_pressure vapour_pressure NN number(4,2) windspeed wind_speed wind_speed wind_speed wind_speed NN number(5,1) rainfall precipitation precipitation precipitation precipitation NN number(4,1) e0 e0 e0 e0 e0 NN number(4,2) es0 es0 es0 es0 es0 NN number(4,2) et0 et0 et0 et0 et0 NN number(4,2) calculated_radiation radiation_global radiation_global radiation_global global_radiation NN number(6) snow_depth snow_depth snow_depth snow_depth snow_depth number(6,2) 1) If an attribute for the offset of the day isn't available, the day-offset in cmeteo grid weather will be filled with a neutral value (0). This value doesn't influence the processing. 2) For sets that doesn't contain an attribute for members, a member_no: 1 will be supplied in cmeteo grid weather. 3) If an attribute for the mean or daily temperature doesn't exist, this value will be estimated as the mean value of minimum and maximum temperature of the day. Cmeteo will process this value and produces a result for it. 4) A dummy value (0) for the dew temperature wil be supplied to cmeteo grid weather for sets lacking such an attribute. Cmeteo will process this value and produces a result for it, so precautions must be taken to supply these results to the output table.

Specifications of cmeteo_region_weather

Cmeteo_region_weather is a replacement for a variety of datasets, both for themes (e.g. cgfs-his, cgms) and for resolutions (e.g. NUTS regions, agri-environmental zones), to which cmeteo need to fill up with output. In general, datasets for NUTS-regions are pre- or postfixed with 'nuts'; datasets for agri_environmental zones are pre- or postfixed with 'zonal'. In various schemas, datasets containing weather indicators do vary both in name of the set and in names of the attributes. Also the collection of the attributes may vary. However, all the sets contain the essential indicators for which cmeteo delivers output. Per theme, the structure of datasets for both resolutions are very similar. As cmeteo only can use one structure for region weather, some logic must be applied to transform the various sets into unified representations. This transformation is implemented as a view (with the possibility to insert/update values) on each of the original datasets while renaming the attributes. As the dataset cmeteo_region_weather delivers the most wide combination of attributes of the various underlying datasets, some precautions must be taken to prevent some useless attributes being placed into the final dataset. Functionality for this is located in a technical construct (trigger) which is connected to the views. In a dynamical way cmeteo_region_weather will be linked to the proper dataset according to the theme and the appropriate spacial resolution to deliver the results of cmeteo. Below a summary of some sets in various schemas and the definition of cmeteo_region_weather domain schema: CGMS_EUR_08 CGFS_EUR_09 CGFS_EUR_09 CGMS_ASIA_08 datasets: nuts_weather ecmwf_his_downscaled_nuts ecmwf_eps_downscaled_nuts nuts_weather cmeteo_region_weather zonal_weather ecmwf_his_downscaled_zonal ecmwf_eps_downscaled_zonal attributes: reg_map_id reg_map_id reg_map_id reg_map_id reg_map_id NN number(10) landcover_id landcover_id landcover_id landcover_id landcover_id NN number(10) threshold threshold threshold threshold threshold NN number(3) day mdate mdate day day NN date - 1) - 1) date_offset - 1) day_offset NN number(10) - 2) - 2) member_no - 2) member_no NN number(10) maximum_temperature temperature_max temperature_max max_temperature max_temperature NN number(3,1) minimum_temperature temperature_min temperature_min min_temperature min_temperature NN number(3,1) daily_temperature temperature_mean temperature_mean daily_temperature mean_temperature NN number(3,1) - 3) temperature_dew temperature_dew dew_temperature dew_temperature NN number(3,1) vapour_pressure vapour_pressure vapour_pressure vapour_pressure vapour_pressure NN number(4,2) windspeed wind_speed wind_speed wind_speed wind_speed NN number(5,1) rainfall precipitation precipitation precipitation precipitation NN number(4,1) e0 e0 e0 e0 e0 NN number(4,2) es0 es0 es0 es0 es0 NN number(4,2) et0 et0 et0 et0 et0 NN number(4,2) calculated_radiation radiation_global radiation_global global_radiation global_radiation NN number(6) snow_depth snow_depth snow_depth snow_depth snow_depth number(6,2) 1) The value for the offset of the day as produced by cmeteo will not be inserted into indicated sets. 2) The value for the member as produced by cmeteo will not be inserted into indicated sets. 3) As input for this attribute was lacking cmeteo produced a dummy value (0). This value must be omitted.

Specifications of cmeteo_aggregation_areas

Cmeteo_aggregation_areas is a replacement for a some of datasets from which cmeteo need to gather input concerning sizes of surfaces. Below a summary of some sets in various schemas and the definition of cmeteo_aggregation_areas domain schema: CGMS_EUR_08 CGFS_EUR_09 CGMS_ASIA_08 dataset: aggregation_areas - 1) aggregation_areas cmeteo_aggregation_areas attributes: crop_no crop_no crop_no NN number(10) nuts_code nuts_code reg_code NN varchar2(10) year year year NN number(4) area_cultivated area_cultivated area_cultivated number source source source NN varchar2(40) day day percentage percentage 1) CGFS_EUR_09 uses the dataset of CGMS_EUR_08.

Specifications of cmeteo_grid_landcover_areas

Cmeteo_grid_landcover_areas is a replacement for a some of datasets from which cmeteo need to gather input concerning sizes of surfaces. Below a summary of some sets in various schemas and the definition of cmeteo_grid_landcover_areas domain schema: CGMS_EUR_08 CGFS_EUR_09 CGMS_ASIA_08 datasets: grid_plus_nuts_landcover - 1) grid_landcover_areas 2) cmeteo_grid_landcover_areas grid_plus_ens_landcover - 1) attributes: grid_no grid_no NN number(10) nuts_code/ens_code landcover_id landcover_id NN number(3) area area NN number(10) reg_code (only in gpel) reg_map_id reg_map_id NN number(10) 1) CGFS_EUR_09 uses the dataset of CGMS_EUR_08. 2) In CGMS_ASIA_08 a dataset has to be defined.

Examples