Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
  • Page info
    infoTypeModified date
    prefixLast modified on
    typeFlat

    Info
    iconfalse
    titleTable of Contents
    Table of Contents
    maxLevel4

    CAMS global forecast test data is available from 05-2025 onwards from the MARS catalogue. A daily updated test dataset is also available for the most recent 3 days on the FTP server.

    MARS 

    If you have access and you can retrieve data from the MARS catalogue, please use the following keywords for the CAMS global forecast test data:

    Code Block
    class=mc
    expver=0080

    Here the link to directly access the data in the MARS catalogue (please remember that ecCodes version 2.44.0 or later is required to handle the full range of parameters of current CAMS data).

    Atmosphere Data Store (ADS)

    If you cannot retrieve data from the MARS catalogue, you can retrieve the data from the cams-global-atmospheric-composition-forecasts-test dataset using the API.

    Info

    Read documentation of the API.

    If you haven't done it yet, you will need to create an ECMWF account and accept the terms of use.

    The test data is only accessible through the ADS API service, and it is not possible to use the interactive web interface to download it.

    You can use existing requests for the CAMS global atmospheric composition dataset by replacing the dataset name with "cams-global-atmospheric-composition-forecasts-test".

    API Example

    Select only European domain, 10 dates and day 1 forecast (from hour 0 to 24):

    Code Block
    languagepy
    titleNetCDF
    import cdsapi
     
    c = cdsapi.Client()
     
    c.retrieve(
        'cams-global-atmospheric-composition-forecasts-test',
        {
            'date':          '2026-01-01/2026-01-10',
            'type':          'forecast',
            'format':        'netcdf_zip',
            'model_level':   '137',                    # Lowest model level only
            'variable':    [ 'biogenic_secondary_organic_aerosol_mass_mixing_ratio',
                             'anthropogenic_secondary_organic_aerosol_mass_mixing_ratio',
                             'glyoxal',
                             'secondary_organic_aerosol_optical_depth_550nm',
                             'total_column_glyoxal' ], # See other variables at:
            'time':          '00:00',                  # https://ads.atmosphere.copernicus.eu/datasets/cams-global-atmospheric-composition-forecasts?tab=download
            'leadtime_hour': [h for h in range(0,25,3)],
            'area':          [70, -35, 35, 60]         # [N,W,S,E] Europe area boundaries
        },
        'cams_test_20260101_10.nc.zip')

    ECMWF data portal (aux.ecmwf.int; SFTP/FTP/HTTPS data access)

    The test dataset is available through ECMWF data portal (aux.ecmwf.int; SFTP/FTP/HTTPS data access) in these directories:

    Code Block
    /DATA/CAMS_GLOBAL_TEST
    /DATA/CAMS_GLOBAL_ADDITIONAL_TEST
    /DATA/CAMS_EUROPE_BC_TEST

    You can use your normal FTP account to access the data. Details about filenames convention or list of available parameters can be found at CAMS Knowledge Base.

    If everything else fails ...

    ... you can always contact us on ECMWF Support Portal creating a ticket "Request for CAMS global test dataset" as a subject and specify:

    • which parameters and levels
    • which time period
    • forecast step / time frequency
    • which geographical area
    • which data format you require


    Info
    iconfalse

    This document has been produced in the context of theCopernicus Atmosphere Monitoring Service (CAMS).

    The activities leading to these results have been contracted by the European Centre for Medium-Range Weather Forecasts, operator of CAMS on behalf of the European Union (Delegation Agreement signed on 11/11/2014 and Contribution Agreement signed on 22/07/2021). All information in this document is provided "as is" and no guarantee or warranty is given that the information is fit for any particular purpose.

    The users thereof use the information at their sole risk and liability. For the avoidance of all doubt , the European Commission and the European Centre for Medium - Range Weather Forecasts have no liability in respect of this document, which is merely representing the author's view.

    Related articles

    Content by Label
    showLabelsfalse
    max5
    spacesCKB
    showSpacefalse
    sortmodified
    reversetrue
    typepage
    cqllabel = in ("cams","cams-global-atmospheric-composition-forecasts") and type = "page" and space = "CKB"
    labelsera5