#!/usr/bin/env python
# coding: utf-8

# # Table of contents
# 1. [About Open Power System Data](#opsd)
# 2. [About Jupyter Notebooks and GitHub](#jupyter)
# 3. [About this datapackage](#datapackage)
# 4. [Data sources](#sources)
# 5. [Naming conventions](#naming)
# 6. [License](#license)

# <div style="width:100%; background-color: #D9EDF7; border: 1px solid #CFCFCF; text-align: left; padding: 10px;">
#       <b>Time series: Processing Notebook</b>
#       <ul>
#         <li>Main Notebook</li>
#         <li><a href="processing.ipynb">Processing Notebook</a></li>
#       </ul>
#       <br>This Notebook is part of the <a href="http://data.open-power-system-data.org/heating_profiles">heating profiles data package</a> contributed to the <a href="http://open-power-system-data.org">Open Power System Data</a> platform.
# </div>

# <a id='opsd'></a>
# # 1. About Open Power System Data

# This notebook is a contribution to the project [Open Power System Data](http://open-power-system-data.org). Open Power System Data develops a platform for free and open data for electricity system modeling. We collect, check, process, document, and provide data that are publicly available but currently inconvenient to use. 
# More info on Open Power System Data:
# - [Information on the project on our website](http://open-power-system-data.org)
# - [Data and metadata on our data platform](http://data.open-power-system-data.org)
# - [Data processing scripts on our GitHub page](https://github.com/Open-Power-System-Data)

# <a id='jupyter'></a>
# # 2. About Jupyter Notebooks and GitHub

# This file is a [Jupyter Notebook](http://jupyter.org/). A Jupyter Notebook is a file that combines executable programming code with visualizations and comments in markdown format, allowing for an intuitive documentation of the code. We use Jupyter Notebooks for combined coding and documentation. We use Python 3 as programming language. All Notebooks are stored on [GitHub](https://github.com/), a platform for software development, and are publicly available. More information on our IT-concept can be found [here](http://open-power-system-data.org/it). See also our [step-by-step manual](http://open-power-system-data.org/step-by-step) how to use the dataplatform.

# <a id='datapackage'></a>
# # 3. About this datapackage

# This dataset comprises national time series for representing building heat pumps in power system models. The heat demand of buildings and the coefficient of performance (COP) of heat pumps is calculated for several European countries and years in an hourly resolution.  
#     
# Heat demand time series for space and water heating are computed by combining gas standard load profiles with spatial temperature and wind speed reanalysis data as well as population geodata. The profiles are year-wise scaled to 1 TWh each. For the years 2008 to 2015, the data is additionally scaled with annual statistics on the final energy consumption for heating.
#     
# COP time series for different heat sources – air, ground, and groundwater – and different heat sinks – floor heating, radiators, and water heating – are calculated based on COP and heating curves using reanalysis temperature data, spatially aggregated with respect to the heat demand, and corrected based on field measurements.
#     
# All data processing as well as the download of relevant input data is conducted in python and pandas and has been documented in the processing notebooks linked below. Please also consider and cite our <a href="https://doi.org/10.1038/s41597-019-0199-y">Data Descriptor</a>.

# <a id='sources'></a>
# # 4. Data sources

# A complete list of data sources is provided on the [datapackage information website](http://data.open-power-system-data.org/when2heat/latest). They are also contained in the JSON file that contains all metadata.

# <a id='naming'></a>
# # 5. Naming conventions

# In[1]:


import pandas as pd; pd.read_csv('input/notation.csv', index_col=list(range(4)))


# <a id='license'></a>
# # 6. License

# This notebook as well as all other documents in this repository is published under the [MIT License](LICENSE.md).