climetlab-wekeo-clms 0.1.1
A dataset plugin for climetlab for the dataset wekeo-clms
License: Apache License Version 2.0
Keywords: meteorology

## climetlab-wekeo_clms

A dataset plugin for climetlab for the CLMS datasets available on WEkEO.

For installation and usage instructions, please refer to [the documentation](https://climetlab-wekeo-clms.readthedocs.io/).

Features
--------

This plugin provides a simple access to CLMS datasets provided by WEkEO.

To narrow down the data to download, users can specify a start and an end date.

While it is not mandatory, the usage of Dask is recommended.

For usage examples, please refer to the [demo notebook](https://github.com/wekeo/climetlab-wekeo-clms/tree/main/notebooks/demo_main.ipynb)

## Datasets description

There are several datasets:

- cgls_continents_wb_v1_1km
- cgls_daily10_lst_dc_global_v1
- cgls_daily10_lst_dc_global_v2
- cgls_daily10_lst_tci_global_v1
- cgls_daily10_lst_tci_global_v2
- cgls_global_albh_v1_1km
- cgls_global_aldh_v1_1km
- cgls_global_ba300_v1_333m
- cgls_global_ba300_v3
- cgls_global_dmp_v2_1km
- cgls_global_dmp300_v1_333m
- cgls_global_fapar_v1_1km
- cgls_global_fapar_v2_1km
- cgls_global_fapar300_v1_333m
- cgls_global_fcover_v1_1km
- cgls_global_fcover_v2_1km
- cgls_global_fcover300_v1_333m
- cgls_global_gdmp_v2_1km
- cgls_global_gdmp300_v1_333m
- cgls_global_lai_v1_1km
- cgls_global_lai_v2_1km
- cgls_global_lai300_v1_333m
- cgls_global_ndvi_st
- cgls_global_ndvi_v2_1km_lts
- cgls_global_ndvi_v2_1km
- cgls_global_ndvi_v3_1km
- cgls_global_ndvi300_v1_333m
- cgls_global_ndvi300_v2_333m
- cgls_global_swi_static_v1_0_1degree
- cgls_global_swi10_v3_0_1degree
- cgls_global_wb300_v1_333m
- cgls_hourly_lst_global_v1
- cgls_hourly_lst_global_v2

The descriptions can be retrieved directly from [WEkEO](https://www.wekeo.eu/data)

## Using climetlab to access the data

See the [demo notebooks](https://github.com/wekeo/climetlab-wekeo-clms/tree/main/notebooks)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/wekeo/climetlab-wekeo-clms/main?urlpath=lab)


- [demo_main.ipynb](https://github.com/wekeo/climetlab-wekeo-clms/tree/main/notebooks/demo_main.ipynb)
[![nbviewer](https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg)](https://nbviewer.jupyter.org/github/wekeo/climetlab-wekeo-clms/blob/main/notebooks/demo_main.ipynb)
[![Open in colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/wekeo/climetlab-wekeo-clms/blob/main/notebooks/demo_main.ipynb)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/wekeo/climetlab-wekeo-clms/main?filepath=notebooks/demo_main.ipynb)
[<img src="https://deepnote.com/buttons/launch-in-deepnote-small.svg">](https://deepnote.com/launch?name=MyProject&url=https://github.com/wekeo/climetlab-wekeo-clms/tree/main/notebooks/demo_main.ipynb)


The climetlab python package allows easy access to the data with a few lines of code such as:
``` python

!pip install climetlab climetlab-wekeo-clms
import climetlab as cml
ds = cml.load_dataset(
    "wekeo-clms-cgls-hourly-lst-global-v2",
    start="2021-01-18",
    end="2021-01-19",
)
ds.to_xarray(xarray_open_mfdataset_kwargs={"chunks": "auto", "engine": "netcdf4"})


Support and contributing
------------------------

Please open a issue on github if this is a github repository.

LICENSE
-------

See the LICENSE file.
(C) Copyright 2023 European Centre for Medium-Range Weather Forecasts.
This software is licensed under the terms of the Apache Licence Version 2.0
which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
In applying this licence, ECMWF does not waive the privileges and immunities
granted to it by virtue of its status as an intergovernmental organisation
nor does it submit to any jurisdiction.

Authors
-------

Germano Guerrini and al.

See also the CONTRIBUTORS.md file.