Page History

• Regional subselection and horizontal

  Horizontal grid interpolation

Currently the interactive CDS forms don't allow users to perform a regional subselection or an interpolation of the selected data. However, both actions that action can be performed using the CDS API keywords area and keyword grid with the same syntax used by ECMWF MARS and Web API.

...

import cdsapi

c = cdsapi.Client()

c.retrieve(
    'seasonal-monthly-single-levels',
    {
        'format':'grib',
        'originating_centre':'cmcc',
        'system':'3',
        'variable':'2m_temperature',
        'product_type':'monthly_mean',
        'year':'2007',
        'month':'11',
        'leadtime_month':['1','2','3','4','5','6'],
		'area' : '75/-25/10/60', # 'North/West/South/East' (i.e. 'top-left corner lat/top-left corner lon/bottom-right corner lat/bottom-right corner lon'
		'grid' : '2.5/2.5' # Interpolate to a regular 2.5x2.5 degree horizontal grid
    },
    'download.grib')

Users must be aware of the following:

• • Use of area for regional subselection is safeUse of grid for horizontal interpolation is currently NOT recommended:
    • It can lead to errors when trying to download MetOffice seasonal forecast datadata produced before January 2018 (system=12). More information about what causes this error can be found in Known issue D2.
    • These errors It can lead to failing data retrievals if more than one model version (system) is requested. Note that if system is not explicitly specified it defaults to all available systems.
    • Hindcast data Access to C3S seasonal data was also available through ECMWF Web API until 5 March 2019. Data previously downloaded using that Web API , access may have used a different interpolation method. You ; you would need to assess whether there such differences are relevant differences from the same data retrieved using CDS API

• Conversion to NetCDF

Currently the interactive CDS forms don't allow users to select NetCDF as data format for their retrievals. However, the value of the format keyword in CDS API scripts can be set to "netcdf" to obtain a netCDF version of the archived GRIB data.

Users must be aware of the following:

• • • for your choice of data. This issue is relevant in the context of the required consistency between interpolation of real-time forecasts and the associated hindcasts.

• Conversion to NetCDF

Users must be aware that conversion

...

to NetCDF is considered experimental and it is not guaranteed to work in all situations.

In this context,

• • It is NOT recommended to download hindcast data in netCDF, if include in a single request more than one model version (system) is requested. Note that if system is not explicitly specified it defaults to all available systemsfor hindcasts, data from more than one system may exist in the archive.
  • It is NOT recommended to use when downloading include in a single request data related to more than one start time in a single request.

• Efficiency tips

The C3S seasonal forecast dataset is currently based on GRIB files archived at ECMWF's MARS archive. This implies, in some situations, accessing data not available online (on disk) but archived in the tape library.

...

• • Users are encouraged to explore the C3S catalogue using the former Web API catalogue tool here: https://apps.ecmwf.int/data-catalogues/c3s-seasonal/?class=c3
    The guidance given in section 2a here explains the mapping of syntax between that Web API catalogue and the CDS forms.
    All the data shown at the same time in a window like the picture below, constitutes a "leaf" in the MARS "tree". This is usually guaranteed to be in a single archived file, and hence in one single tape.
    Users are encouraged to

    • combine in one single request all the data they are interested in which is contained in the same MARS "leaf"

    • avoid combining data from two different "leaves".

      Expand
      title See here how a MARS leaf looks like in the ECMWF catalogue
      Image Modified

      
      

  • Users are encouraged to devise their requests as follows:
    • Do NOT ask for different start months in the same request when retrieving data from the "daily" datasets.
      It is much more efficient to request one single month (e.g. November) for all the hindcast years (1993 to 2016) than requesting all 12 months from a single year
    • Combine in one single request all variables of interest, all levels (for pressure level fields), all product types and all leadtimes (hours or months, depending on the CDS product)
      . However, note that there are some limitations in the size of a request. If you are using the CDS forms directly, you will be informed when you request is too big before submitting it. If you are using CDS API you can use the forms to discover whether the request you are trying to submit is affordable or not.

• Guidelines to decode monthly data

More information here.