*cd2es*
===================================

The *cd2es* tool can be used to convert climate data from the cordex initiative (https://cordex.org/) to energy system input data.
The tool can produce bias-adapted hourly time series for photovoltaics, concentrated solar power, on- and offshore wind and the efficiency of thermal power plants for the whole globe.
For Europe, there is also the possibility to produce hydro power and demand time series (as they are regression based, data research is necessary for other continents). 
If desired the results can be directly inserted in a backbone (https://doi.org/10.3390/en12173388) energy system model.
*cd2es* is aimed at energy system modelers who want to include climate data into their energy system models.

Check out the :doc:`usage` section for further information, including the :ref:`installation` of the project. 
The project is based on the workflow management tool snakemake. 
Snakemake uses rules with defined in- and output files to determine which rules have to be executed to produce the desired output files. 
An example of usage for the tool is given in :doc:`tutorial`.
The config file where all important settings can be made is explained more detailedly in :doc:`config`.
You find a description of all snakemake rules in the file :doc:`descriptionOfRules`, the python scripts are explained in greater detail in :doc:`pythonDoc`.
Common errors are depicted in :doc:`troubleshooting`, for more information on how to contribute or seek support, visit :doc:`community`.
In the chapter :doc:`methods` the methods used to convert the climate data are explained in greater detail.

If you use the software for your research, please cite the associated software paper in the Journal of Open Source Software: https://doi.org/10.21105/joss.07541.

Contents
--------

.. toctree::

   usage
   tutorial
   config
   descriptionOfRules
   pythonDoc
   troubleshooting
   community
   methods