CAMS global forecast test data is available from 1 September 2022 onwards from the MARS archive. A daily updated test dataset is also available for the most recent 3 days on the FTP server.

MARS

If you have access to ECMWF systems you can retrieve CAMS global forecast test data from MARS archive using keywords:

class=mc
expver=0078

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

Atmosphere Data Store (ADS)

If you don't have access to ECMWF computers but would still like to access a large subset of test data, you can retrieve fields from the cams-global-atmospheric-composition-forecasts-test dataset using the Copernicus Atmosphere Data Store API.

Read documentation of the Copernicus Atmosphere Data Store API.

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

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".

Example

Get new variables available from IFS Cycle 48r1:

  • Anthropogenic secondary organic aerosol mass mixing ratio (pressure or model level)

  • Biogenic secondary organic aerosol mass mixing ratio (pressure or model level)

  • Glyoxal (pressure or model level)

  • Secondary organic aerosol optical depth 550nm (surface)

  • Total column glyoxal (surface)

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

NetCDF
import cdsapi

c = cdsapi.Client()

c.retrieve(
    'cams-global-atmospheric-composition-forecasts-test',
    {
        'date':          '2023-04-01/2023-04-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/cdsapp#!/dataset/cams-global-atmospheric-composition-forecasts?tab=form
        'leadtime_hour': [h for h in range(0,25,3)],
        'area':          [70, -35, 35, 60]         # [N,W,S,E] Europe area boundaries
    },
    '/tmp/cams_test_20230401_10.nc.zip')

FTP dissemination

The test dataset is available through ECPDS FTP dissemination systems in these directories:

/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