Start downloading ECMWF data

1. Create an ECMWF Account

If you already have an ECMWF account, you can skip this subsection and go directly to Prepare the Configuration File.

Once this process is completed, you will be able to download both CAMS and ERA5 data.

Go to the ECMWF login page and click on Register new user to create an account.

Check your confirmation email, accept the Terms and Conditions, and fill in the required information to activate your account.

2. Accept Dataset Terms

Navigate to the download page of the dataset you want to download. For example this one.

You only need to do this once to any dataset, it will apply to all datasets.

Scroll down to Terms of Use and accept the CC-BY license.

3. Prepare the Configuration File

Before downloading, prepare your configuration file. It’s recommended to first read How to Enable Atmosphere Data Store Download.

or

You can use any of the preconfigured sections in configurations/cams_dl.conf. For example:

./bin/providentia --config=cams_dl.conf --section=cams_analysis_ensemble-regional --dl

4. API Configuration

If you had the ~/.cdsapirc already configured on your computer, you can skip this section.

Once you run the command, the following message will appear:

“’.cdsapirc’ file not found. Creating it at /home/example/.cdsapirc. Do you agree? ([y]/n)”

Answer y to the prompt.

Next, you will be asked for your personal access token:

“Enter your personal access token, which you can find at https://ads.atmosphere.copernicus.eu/profile after login:”

Go to the link specified in the prompt, scroll down to API Key, and copy it.

Paste your API key on the prompt. Providentia will automatically create the ~/.cdsapirc file.

If the API key is incorrect, Providentia will remove the file. You can then run Providentia again and enter the correct API key.

Congratulations! You are now ready to start downloading CAMS and ERA5 data from the Atmosphere Data Store using Providentia.