Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat(providers): cop_ewds as new provider #1331

Merged
merged 8 commits into from
Oct 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/getting_started_guide/providers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ Products from the following providers are made avaiable through ``eodag``:
* `cop_ads <https://ads.atmosphere.copernicus.eu>`_: Copernicus Atmosphere Data Store
* `cop_cds <https://cds.climate.copernicus.eu>`_: Copernicus Climate Data Store
* `cop_dataspace <https://dataspace.copernicus.eu/>`_: Copernicus Data Space
* `cop_ewds <https://ewds.climate.copernicus.eu>`_: CEMS Early Warning Data Store
* `cop_marine <https://marine.copernicus.eu>`_: Copernicus Marine Service
* `creodias <https://creodias.eu/>`_: CloudFerro DIAS
* `creodias_s3 <https://creodias.eu/>`_: CloudFerro DIAS data through S3 protocol
Expand Down
22 changes: 20 additions & 2 deletions docs/getting_started_guide/register.rst
Original file line number Diff line number Diff line change
Expand Up @@ -64,8 +64,8 @@ Then log in and go to your user profile on `Climate Data Store <https://cds-beta

To download data, you also have to accept certain terms depending on the dataset. Some datasets have a specific licence
whereas other licences are valid for a group of datasets.
For example after accepting the `Licence to use Copernicus Products` you can use all `ERA5` datasets and the
`CEMS-FLOODS datasets licence` is valid for all `GLOFAS` and `EFAS` datasets.
For example after accepting the `Licence to use Copernicus Products` you can use all `ERA5` datasets, to use the seasonal data from C3S you
also have to accept the `Additional licence to use non European contributions`.

To accept a licence:

Expand All @@ -80,6 +80,24 @@ To accept a licence:
Create an account `here
<https://identity.dataspace.copernicus.eu/auth/realms/CDSE/protocol/openid-connect/auth?client_id=cdse-public&redirect_uri=https%3A%2F%2Fdataspace.copernicus.eu%2Fbrowser%2F&response_type=code&scope=openid>`__

``cop_ewds``
^^^^^^^^^^^^
Go to the `ECMWF homepage <https://www.ecmwf.int/>`__ and create an account by clicking on *Log in* and then *Register*.
Then log in and go to your user profile on `CEMS Early Warning Data Store <https://ewds.climate.copernicus.eu>`__ and use your
*Personal Access Token* as *apikey* in eodag credentials.

To download data, you also have to accept certain terms depending on the dataset. There are two different licences that have to be accepted
to use the CEMS EWDS datasets. Accepting the `CEMS-FLOODS datasets licence` is necessary to use the `GLOFAS` and `EFAS` datasets,
the `Licence to use Copernicus Products` is valid for the Fire danger datasets.

To accept a licence:

* Search for the dataset you want to download `here <https://ewds.climate.copernicus.eu/datasets>`__ while being
logged in.
* Open the dataset details and go to the download tab.
* Scroll down and accept the licence in the section `Terms of use`.
* You can check which licences you have accepted in your user profile.

``cop_marine``
^^^^^^^^^^^^^^
No account is required
Expand Down
3 changes: 2 additions & 1 deletion docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,8 @@ types (Sentinel 1, Sentinel 2, Sentinel 3, Landsat, etc.) that can be searched a
`aws_eos <https://eos.com>`_,
`cop_ads <https://ads.atmosphere.copernicus.eu>`_,
`cop_cds <https://cds.climate.copernicus.eu>`_,
`cop_dataspace <https://dataspace.copernicus.eu>`_,
`cop_dataspace <https://dataspace.copernicus.eu/>`_,
`cop_ewds <https://ewds.climate.copernicus.eu>`_,
`cop_marine <https://marine.copernicus.eu>`_,
`creodias <https://creodias.eu>`_,
`creodias_s3 <https://creodias.eu>`_,
Expand Down
2 changes: 1 addition & 1 deletion docs/notebooks/tutos/tuto_cds.ipynb
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"source": [
"# Copernicus Atmosphere using BuildSearchResult plugin\n",
"\n",
"In this tutorial we will show you how to use eodag to download data from providers using [BuildSearchResult](https://eodag.readthedocs.io/en/latest/plugins_reference/generated/eodag.plugins.search.build_search_result.BuildSearchResult.html) `eodag` plugin. You can currently find two providers that uses it, `cop_ads` and `cop_cds`. For this tutorial we will use `cop_ads`, but `cop_cds` is used the same way."
"In this tutorial we will show you how to use eodag to download data from providers using [BuildSearchResult](https://eodag.readthedocs.io/en/latest/plugins_reference/generated/eodag.plugins.search.build_search_result.BuildSearchResult.html) `eodag` plugin. You can currently find three providers that uses it, `cop_ads`, `cop_cds` and `cop_ewds`. For this tutorial we will use `cop_ads`, but `cop_cds` and `cop_ewds` are used the same way."
]
},
{
Expand Down
33 changes: 33 additions & 0 deletions eodag/resources/product_types.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3689,6 +3689,39 @@ FIRE_HISTORICAL:
title: Fire danger indices historical data from the Copernicus Emergency Management Service
missionStartDate: "1940-01-03T00:00:00Z"

FIRE_SEASONAL:
abstract: |
This dataset offers modeled daily fire danger time series, driven by seasonal weather forecasts. It provides long-range
predictions of meteorological conditions conducive to the initiation, spread, and persistence of fires. The fire danger
metrics included in this dataset are part of an extensive dataset produced by the Copernicus Emergency Management Service (CEMS)
for the European Forest Fire Information System (EFFIS) and the Global Wildfire Information System (GWIS). EFFIS and GWIS
are used for monitoring and forecasting fire danger at both European and global scales. The dataset incorporates fire danger
indices from the U.S. Forest Service National Fire-Danger Rating System (NFDRS), the Canadian Forest Service Fire Weather Index Rating System (FWI),
and the Australian McArthur (Mark 5) rating systems.
This dataset was generated by driving the Global ECMWF Fire Forecast (GEFF) model with seasonal weather ensemble forecasts
from the European Centre for Medium-Range Weather Forecasts (ECMWF) System 5 (SEAS5) prediction system.These forecasts initially
consist of 25 ensemble members until December 2016, referred to as re-forecasts. After that period, they consist of seasonal
forecasts with 51 members. It is important to note that the re-forecast dataset was initialized using ERA-Interim analysis data,
while forecast simulations from 2016 onward are initialized using ECMWF operational analysis. Therefore, it is suggested that
the period 1981-2016 be used as a reference period, while the period 2017-to present as a real time forecast.
For both the re-forecast (1981-2016) and forecast periods (2017-present), the temporal resolution is daily forecasts at 12:00
local time, available once a month, with a prediction horizon of 216 days (equivalent to 7 months). The data records in this
dataset will be extended over time as seasonal forcing data becomes available. Once the SEAS5 operation ceases, the dataset
will be updated with the next ECMWF seasonal system (SEAS6). It is essential to note that this is not a real-time service,
as real-time forecasts are accessible through the EFFIS web services.
These seasonal forecasts can be used to assess the performance of the forecasting system or to develop tools for statistically
correcting forecast errors. ECMWF produces this dataset as the computational center for fire danger forecasting within the
Copernicus Emergency Management Service (CEMS) on behalf of the Joint Research Centre, which serves as the managing entity for this service.
instrument:
platform: CEMS
platformSerialIdentifier: CEMS
processingLevel:
keywords: ECMWF,CEMS,EFFIS,GWIS,fire,danger,seasonal,GEFF
sensorType:
license: proprietary
title: Seasonal forecast of fire danger indices from the Copernicus Emergency Management Service
missionStartDate: "1981-02-01T00:00:00Z"

GLOFAS_FORECAST:
abstract: |
This dataset contains global modelled daily data of river discharge forced with meteorological forecasts.
Expand Down
Loading