https://wiki.openmod-initiative.org/api.php?action=feedcontributions&user=Wolf-Dieter+Bunke&feedformat=atom
wiki.openmod-initiative.org - User contributions [en]
2024-03-29T01:29:34Z
User contributions
MediaWiki 1.19.7
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-10-25T08:47:43Z
<p>Wolf-Dieter Bunke: /* Open Data */</p>
<hr />
<div><br />
{{GlossaryTermTemp<br />
|SubtermOf=Database<br />
}} The following database rules explain the basic principles of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br />
<br />
<br/><br />
<br />
<br />
= Open Data<br/> =<br />
<br />
*Only use data with suitable licences<br/><br />
*<span lang="EN-US">Do not upload restricted data into the database</span><br/><br />
<br />
More Information can be found on [[Choosing a license|Open Licenses.]] Additional, the Project Open Power System Data is dealing this topic on [http://open-power-system-data.org/legal OPSD - Legal].<br />
<br />
<br/><br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn how to do so<br/><br />
*All abreviations have to be documentated in the of the openmod wiki<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
*The nomenclature should follow a logical structure<br/><br />
*There are different levels of naming<br/><br />
<br />
== Database Name<br/> ==<br />
<br />
*The name of the database is<br/><br />
<br />
<br/><br />
<br />
== Database Schema<br/> ==<br />
<br />
*There are schemas to structure tables<br />
*The following schemas are already in existence:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**openstreetmap<br />
**political_boundary<br />
**scenario<br/><br />
**social<br />
**supply<br />
**weather<br/><br />
<br />
<br/><br />
<br />
*Special schemas:<br/><br />
**model_draft<br/><br />
***model data<br/><br />
***has no version control<br />
<br />
*<br />
*reference<br/><br />
***sources<br/><br />
***literature<br/><br />
<br />
Further schema categories or changes can be [https://github.com/openego/oeplatform/issues discussed on GitHub]. There is a whitelist.<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source, project or model name (e.g. zensus, eGo)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
Remember to put your abbreviations in the<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST''' has to be set<br />
<br />
<br/><br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begin with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br/><br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal"></span></u>''<u>'''Example:'''</u><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields: <br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the table to be referenced</font></font></div><br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | Origin<br/><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | Link or textual description of the data set this row origins from<br/><br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | Assumption<br/><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows<br/><br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | begin<br/><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | First column affected by the assumption<br/><br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | end<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | Last column affected by the assumption<br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | type<br/><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br/><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are: gap, multiplicity<br/><br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | solution<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | Method that was used to generate date to fix this problem (e.g. linear interpolation)<br />
|-<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | values<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | [Only if type is multiplicity] Possible Values that could have been used<br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Discription</font></font><br/></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">column</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">name</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-10-24T14:47:06Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div>{{GlossaryTermTemp<br />
|SubtermOf=Database<br />
}}<br />
The following database rules explain the basic principles of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br />
<br />
<br />
= Open Data<br/> =<br />
<br />
*Only use data with suitable licences<br/><br />
*<span lang="EN-US">Do not upload restricted data into the database</span><br/><br />
<br />
More Information can be found on [[Choosing a license|Open Licenses.]] Additional to the the Project Open Power System Data is covering this topic on [http://open-power-system-data.org/legal OPSD - Legal].<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn how to do so<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]] of the openmod wiki<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
*The nomenclature should follow a logical structure<br/><br />
*There are different levels of naming<br/><br />
<br />
== Database Name<br/> ==<br />
<br />
*The name of the database is <br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
*There are schemas to structure tables<br />
*The following schemas are already in existence:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**openstreetmap<br />
**political_boundary<br />
**scenario<br/><br />
**social<br />
**supply<br />
**weather<br/><br />
<br />
<br/><br />
<br />
*<u></u>Special schemas:<br/><br />
**model_draft<br/><br />
***model data<br/><br />
***has no version control<br />
<br />
**reference<br/><br />
***sources<br/><br />
***literature<br/><br />
<br />
Further schema categories or changes can be [https://github.com/openego/oeplatform/issues discussed on GitHub]. There is a whitelist.<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source, project or model name (e.g. zensus, eGo)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
Remember to put your abbreviations in the [[Category:Glossary|Glossary.]]<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST''' has to be set<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begin with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">column</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">name</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal"></span></u>''<u>'''Example:'''</u><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-10-24T14:46:03Z
<p>Wolf-Dieter Bunke: /* Comments on Schema */</p>
<hr />
<div>{{GlossaryTermTemp<br />
|SubtermOf=Database<br />
}}<br />
The following database rules explain the basic principles of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br />
<br />
<br />
= Open Data<br/> =<br />
<br />
*Only use data with suitable licences<br/><br />
*<span lang="EN-US">Do not upload restricted data into the database</span><br/><br />
<br />
More Information can be found on [[Choosing a license|Open Licenses.]] Additional to the the Project Open Power System Data is covering this topic on [http://open-power-system-data.org/legal OPSD - Legal].<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn how to do so<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]] of the openmod wiki<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
*The nomenclature should follow a logical structure<br/><br />
*There are different levels of naming<br/><br />
<br />
== Database Name<br/> ==<br />
<br />
*The name of the database is <br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
*There are schemas to structure tables<br />
*The following schemas are already in existence:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**openstreetmap<br />
**political_boundary<br />
**scenario<br/><br />
**social<br />
**supply<br />
**weather<br/><br />
<br />
<br/><br />
<br />
*<u></u>Special schemas:<br/><br />
**model_draft<br/><br />
***model data<br/><br />
***has no version control<br />
<br />
**reference<br/><br />
***sources<br/><br />
***literature<br/><br />
<br />
Further schema categories or changes can be [https://github.com/openego/oeplatform/issues discussed on GitHub]. There is a whitelist.<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source, project or model name (e.g. zensus, eGo)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
Remember to put your abbreviations in the [[Category:Glossary|Glossary.]]<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST''' has to be set<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begin with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">column</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">name</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal"></span></u>''<u>'''Example:'''</u><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-10-24T14:43:13Z
<p>Wolf-Dieter Bunke: /* Geografic Data */</p>
<hr />
<div>{{GlossaryTermTemp<br />
|SubtermOf=Database<br />
}}<br />
The following database rules explain the basic principles of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br />
<br />
<br />
= Open Data<br/> =<br />
<br />
*Only use data with suitable licences<br/><br />
*<span lang="EN-US">Do not upload restricted data into the database</span><br/><br />
<br />
More Information can be found on [[Choosing a license|Open Licenses.]] Additional to the the Project Open Power System Data is covering this topic on [http://open-power-system-data.org/legal OPSD - Legal].<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn how to do so<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]] of the openmod wiki<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
*The nomenclature should follow a logical structure<br/><br />
*There are different levels of naming<br/><br />
<br />
== Database Name<br/> ==<br />
<br />
*The name of the database is <br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
*There are schemas to structure tables<br />
*The following schemas are already in existence:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**openstreetmap<br />
**political_boundary<br />
**scenario<br/><br />
**social<br />
**supply<br />
**weather<br/><br />
<br />
<br/><br />
<br />
*<u></u>Special schemas:<br/><br />
**model_draft<br/><br />
***model data<br/><br />
***has no version control<br />
<br />
**reference<br/><br />
***sources<br/><br />
***literature<br/><br />
<br />
Further schema categories or changes can be [https://github.com/openego/oeplatform/issues discussed on GitHub]. There is a whitelist.<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source, project or model name (e.g. zensus, eGo)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
Remember to put your abbreviations in the [[Category:Glossary|Glossary.]]<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST''' has to be set<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
=== <s>Comments on Schema</s><br/> ===<br />
<br />
<s>Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">.</span></s><br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ <s>Metadata Documentation of schemata</s><br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div><s>Attribute (level 1)</s><br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Attribute (level 2)</s><br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div><s>Description</s><br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Name</s><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div><s>Original name of the data set</s></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Description</s></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Short description of the data set.</s></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Changes</s></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Information of changes and user</s></div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Name</s></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Name of Person created or changed dataset</s></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Mail</s></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>E-mail Address</s></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Date</s><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Date of changes</s></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Comment</s><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Comment of changes</s></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Note</s><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Field for notes or ToDo which are not done yet</s><br/></div><br />
|}<br />
<br />
<br/><s>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]</s><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begin with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">column</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">name</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal"></span></u>''<u>'''Example:'''</u><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-10-24T14:41:30Z
<p>Wolf-Dieter Bunke: /* Open Data */</p>
<hr />
<div>{{GlossaryTermTemp<br />
|SubtermOf=Database<br />
}}<br />
The following database rules explain the basic principles of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br />
<br />
<br />
= Open Data<br/> =<br />
<br />
*Only use data with suitable licences<br/><br />
*<span lang="EN-US">Do not upload restricted data into the database</span><br/><br />
<br />
More Information can be found on [[Choosing a license|Open Licenses.]] Additional to the the Project Open Power System Data is covering this topic on [http://open-power-system-data.org/legal OPSD - Legal].<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn how to do so<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]] of the openmod wiki<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
*The nomenclature should follow a logical structure<br/><br />
*There are different levels of naming<br/><br />
<br />
== Database Name<br/> ==<br />
<br />
*The name of the database is <br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
*There are schemas to structure tables<br />
*The following schemas are already in existence:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**openstreetmap<br />
**political_boundary<br />
**scenario<br/><br />
**social<br />
**supply<br />
**weather<br/><br />
<br />
<br/><br />
<br />
*<u></u>Special schemas:<br/><br />
**model_draft<br/><br />
***model data<br/><br />
***has no version control<br />
<br />
**reference<br/><br />
***sources<br/><br />
***literature<br/><br />
<br />
Further schema categories or changes can be [https://github.com/openego/oeplatform/issues discussed on GitHub]. There is a whitelist.<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source, project or model name (e.g. zensus, eGo)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
Remember to put your abbreviations in the [[Category:Glossary|Glossary.]]<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST''' has to be set<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
=== <s>Comments on Schema</s><br/> ===<br />
<br />
<s>Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">.</span></s><br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ <s>Metadata Documentation of schemata</s><br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div><s>Attribute (level 1)</s><br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Attribute (level 2)</s><br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div><s>Description</s><br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Name</s><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div><s>Original name of the data set</s></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Description</s></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Short description of the data set.</s></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Changes</s></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Information of changes and user</s></div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Name</s></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Name of Person created or changed dataset</s></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Mail</s></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>E-mail Address</s></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Date</s><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Date of changes</s></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><s>Comment</s><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Comment of changes</s></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><s>Note</s><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><s>Field for notes or ToDo which are not done yet</s><br/></div><br />
|}<br />
<br />
<br/><s>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]</s><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begin with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| style="width: 643px" cellspacing="1" cellpadding="1"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2"><</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">column</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">name</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2</font></font><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="4"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font style="font-size: 8pt" size="1">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font style="font-size: 10pt" size="2">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal"></span></u>''<u>'''Example:'''</u><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
'''This section is still work in progress! Please contribute to the discussion to improve the implementation.'''<br />
<br />
<br/><br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| style="width: 100%" cellspacing="0" cellpadding="0" border="0"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T20:18:58Z
<p>Wolf-Dieter Bunke: /* Meta Documentation of data collections from several sources: */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T20:18:08Z
<p>Wolf-Dieter Bunke: /* Database Name */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T20:17:47Z
<p>Wolf-Dieter Bunke: /* Comments on Tables */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T18:30:25Z
<p>Wolf-Dieter Bunke: /* Processed and Result Data (calc/res) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T18:29:49Z
<p>Wolf-Dieter Bunke: /* Meta Documentation of original data collections from several sources: */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T18:28:14Z
<p>Wolf-Dieter Bunke: /* &nbsp;Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
==== &nbsp;Meta Documentation of Tables<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T18:23:31Z
<p>Wolf-Dieter Bunke: /* &nbsp;Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Note<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T17:28:01Z
<p>Wolf-Dieter Bunke: /* Database Table */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source or model name (e.g. zensus, ego)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T16:59:14Z
<p>Wolf-Dieter Bunke: /* Database Schema */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic<br />
**emission<br />
**environmental<br />
**grid<br />
**political_boundary<br />
**social<br />
**supply<br />
**scenario<br />
**weather<br />
**model_draft<br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T16:56:58Z
<p>Wolf-Dieter Bunke: /* Database Schema */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
<br />
== Database Schema<br/> ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The schema is&nbsp;categorized into the the type of the schema:<br/><br />
**demand<br/><br />
**economic <br />
**emission <br />
**environmental <br />
**grid <br />
**political_boundary <br />
**social <br />
**supply <br />
**scenario <br />
**weather <br />
**model_draft <br />
**reference<br/><br />
<br />
<br/><br />
<br />
Further schema categories or change can be discussed under Discussion.<br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T16:33:03Z
<p>Wolf-Dieter Bunke: /* Data Integrity */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T15:37:35Z
<p>Wolf-Dieter Bunke: /* Processed and Result Data (calc/res) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0)",<br />
"URL":"http://www.govdata.de/dl-de/by-2-0"}],<br />
"Instructions for proper use": ["Always state licence"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T15:33:54Z
<p>Wolf-Dieter Bunke: /* &nbsp;Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"Note": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T15:32:58Z
<p>Wolf-Dieter Bunke: /* Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
==== &nbsp;Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T15:31:24Z
<p>Wolf-Dieter Bunke: /* Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"],<br />
"Label": ["Germany", "Example Data"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-09-12T15:30:48Z
<p>Wolf-Dieter Bunke: /* Comments on Schema */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Note<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Field for notes or ToDo which are not done yet<br/></div><br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"],<br />
"Label": ["Germany", "Example Data"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-08-31T12:23:34Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Schema<br/> ===<br />
<br />
Schemata are used in the database in order to structure tables, functions, assign assignment of permissions and much more. For the documentation purpose a string in json format is set as comment on schema. The attribute names begins with an <u>upper case</u> and are given by the following definition for schemata<span style="font-weight: normal">. </span><br/><br />
<br />
<br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of schemata<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/>[https://github.com/openego/data_processing/blob/master/data_documentation/documentaion_on_schema_example.sql SQL Json Example]<br />
<br />
<br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database table.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"],<br />
"Label": ["Germany", "Example Data"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-08-31T12:01:16Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on schema: Contains metadata that define several aspects for the database schema<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"],<br />
"Label": ["Germany", "Example Data"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-08-31T10:13:43Z
<p>Wolf-Dieter Bunke: /* Processed and Result Data (calc/res) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"],<br />
"Label": ["Germany", "Example Data"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]<br />
"Label": ["Study", "Example Data"]<br />
}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-08-31T10:12:05Z
<p>Wolf-Dieter Bunke: </p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]<br />
<br />
<br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"],<br />
"Label": ["Germany", "Example Data"]<br />
}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-08-31T10:08:14Z
<p>Wolf-Dieter Bunke: /* Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [http://wiki.openmod-initiative.org/wiki/Category:Glossary Glossary]<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
<br />
<br />
= Data Integrity<br/> =<br />
<br />
"Data integrity refers to maintaining and assuring the accuracy and consistency of data over its entire life-cycle." ([https://en.wikipedia.org/wiki/Data_integrity Wikipedia]) These two aspects belong to the [[Data_quality|data quality]] criteria, the data in the oedb should meet.<br />
<br />
<s>Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.</s><br />
<br />
<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser (automatically done by the system)<br/><br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. Therefore, ensuring the quality of these meta data is as important as ensuring the quality of the data itself (see also [[Data_quality|here]]).<br />
<br />
For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | Label<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Associated key words of data table<br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*multiplicity: A field could be filled by several values<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:36:48Z
<p>Wolf-Dieter Bunke: /* Processed and Result Data (calc/res) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [http://wiki.openmod-initiative.org/wiki/Category:Glossary Glossary]<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
The documentation rules for processed / calculated and results tables are equal the the original data.<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are commited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:34:15Z
<p>Wolf-Dieter Bunke: /* Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [http://wiki.openmod-initiative.org/wiki/Category:Glossary Glossary]<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" | <div>Attribute (level 1)<br/></div><br />
! scope="col" style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Attribute (level 2)<br/></div><br />
! scope="col" style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| rowspan="3" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| rowspan="4" style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''[https://github.com/openego/data_processing/tree/master/data_documentation Json Example:]'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:30:49Z
<p>Wolf-Dieter Bunke: /* Meta Documentation of original data collections from several sources: */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [http://wiki.openmod-initiative.org/wiki/Category:Glossary Glossary]<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:26:18Z
<p>Wolf-Dieter Bunke: /* Data Documentation */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [http://wiki.openmod-initiative.org/wiki/Category:Glossary Glossary]<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:25:24Z
<p>Wolf-Dieter Bunke: /* Data Documentation */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]!<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:23:06Z
<p>Wolf-Dieter Bunke: /* Data Documentation */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]] !<br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-13T13:20:02Z
<p>Wolf-Dieter Bunke: /* Data Documentation */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the&nbsp;[[Category:Glossary|Glossary]]!<br/><br/><br />
<br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-07T09:52:39Z
<p>Wolf-Dieter Bunke: /* Meta Documentation of original data collections from several sources: */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| rowspan="6" style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| rowspan="2" style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: center"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western" style="text-align: left"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-07T09:51:02Z
<p>Wolf-Dieter Bunke: /* Comments on Tables */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper case</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T14:16:55Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper chase</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Address</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|100px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table: '''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
The metadata [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing in the table public.entries.<br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T14:10:12Z
<p>Wolf-Dieter Bunke: /* Meta Documentation of original data collections from several sources: */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper chase</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Adress</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|140px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font> default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table:'''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
<br/><br />
<br />
The [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier,<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description":"Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "Name":"Autor1",<br />
"Mail":"Autor1@e-mail.com",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{ "Name":"Autor2",<br />
"Mail":"Autor2@e-mail.com",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T14:05:49Z
<p>Wolf-Dieter Bunke: /* Processed and Result Data (calc/res) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper chase</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Adress</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|140px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font>default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table:'''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
<br/><br />
<br />
The [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description":"Unique identifier,<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description":"Reference Year",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description":"Some important value",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "name":"Autor1",<br />
"mail":"Autor1@e-mail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Autor2",<br />
"mail":"Autor2@e-mail.com",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0;<br />
[http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T14:04:47Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper chase</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Adress</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br />
|}<br />
<br />
<br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|140px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font>default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table:'''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
<br/><br />
<br />
The [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description":"Unique identifier,<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description":"Reference Year",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description":"Some important value",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "name":"Autor1",<br />
"mail":"Autor1@e-mail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Autor2",<br />
"mail":"Autor2@e-mail.com",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><br />
<br />
{| cellspacing="0" cellpadding="0" border="0" style="width: 100%"<br />
|-<br />
| <pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
|}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T13:59:04Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper chase</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Adress</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
<pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM oedb references example.png|frame|center|180px|ERM references example|alt=ERM references example]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font>default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table:'''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
<br/><br />
<br />
The [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description":"Unique identifier,<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description":"Reference Year",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description":"Some important value",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "name":"Autor1",<br />
"mail":"Autor1@e-mail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Autor2",<br />
"mail":"Autor2@e-mail.com",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
<ul style="margin-left: 40px;"><br />
<li><br/></li><br />
</ul></div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T13:56:20Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
<br />
= Data Referencing<br/> =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an <u>upper chase</u> and are given by the following definition of <span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables. The Json meta documentation string is stored as table comment&nbsp; on the database.</span><br />
<br />
<br/><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
Original Data (orig) are defined as data from one source which are not further processed (see: '''Database Schema'''). The metadata Documentation for those data sets are set as a comment on the table. Following meta data are proposed:<br/><br />
<br />
<br/><br />
<br />
{| cellspacing="1" cellpadding="1" style="width: 643px"<br />
|+ Metadata Documentation of original data on table<br/><br />
|- valign="top"<br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 198px; height: 15px" scope="col" | <div>Attribute (level 1)<br/></div><br />
! style="border-width: 1px medium 1px 1px; border-style: solid none solid solid; border-color: rgb(0, 0, 0) -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0.1cm 0cm 0.1cm 0.1cm; width: 131px" scope="col" | <div>Attribute (level 2)<br/></div><br />
! style="width: 291px; border: 1px solid rgb(0, 0, 0); padding: 0.1cm" scope="col" | <div>Description<br/></div><br />
|- valign="top"<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Name<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px; height: 15px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm; height: 15px" | <div>Original name of the data set</div><br />
|-<br />
| style="height: 15px; width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Source</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div><br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="2" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name&nbsp;<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Source Name<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>URL<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>URL string</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Reference date</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Reference date of the data set.<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Date of collection</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of data collection into the database.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Original file</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of the original data file with file extension (e.g. .xls,.shp, .pdf, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Spatial resolution</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Spatial resolution of the data set</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Description</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Short description of the data set.</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Column</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Metadata of all table fields / columns<br/></div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column 1<br/></div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column 1</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>…</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>...</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="3" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Description</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>English description of Column N</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Unit</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Unit if exist e.g. (€, MWh, etc.)</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Changes</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Information of changes and user</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" rowspan="4" | <div><br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Name</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Name of Person created or changed dataset</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Mail</div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>E-mail Adress</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Date<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Date of changes</div><br />
|- valign="top"<br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div>Comment<br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of changes</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>ToDo</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Comment of ToDo which are not done yet</div><br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Licence</div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Licence of the data set</div><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br/><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | Name<br/><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | Name of Licence<br/><br />
|-<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | URL<br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | URL of Licence<br />
|- valign="top"<br />
| style="width: 168px; border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 198px" | <div>Instructions for proper use<br/></div><br />
| style="border-width: medium medium 1px 1px; border-style: none none solid solid; border-color: -moz-use-text-color -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0cm 0.1cm 0.1cm; width: 131px" | <div><br/></div><br />
| style="width: 291px; border-width: medium 1px 1px; border-style: none solid solid; border-color: -moz-use-text-color rgb(0, 0, 0) rgb(0, 0, 0); padding: 0cm 0.1cm 0.1cm" | <div>Instructions for proper use of Licences.</div><br />
|}<br />
<br />
<br/><br />
<br />
<u>'''Json Example:'''</u><br/><br />
<br />
<pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br/><br />
<br />
=== Meta Documentation of original data collections from several sources: ===<br />
<br />
In addition to the meta documentation described above, data tables (blue table in figure) which include data from several sources get a ref_id column. The ref_id links each row with a json documentation string (ref_data_json) in the database table public.reference_to_entries (green table in figure).This table also includes the ref_data_json column which links to all sources of the row to be referenced (blue). The ref_data_json string includes one jabref_entries_id for each source used. The jabref_entries_id is matched by one entries_id belonging to a source stored in the public.entries table (orange table).<br />
<br />
<br/><br />
<br />
'''''<u>Example: ER-Model</u>'''''<br/><br />
<br />
[[File:ERM references example|frame|center|180px|ERM references example|alt=ERM references example|link=http://wiki.openmod-initiative.org/images/f/fc/ERM_oedb_references_example.png]]<br/><br />
<br />
''<u>reference_to_entries table structure:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font><br/></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Reference ID</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Json Documentation string</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the schema which includes the table “tbl_name”</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of table with the data to be referenced</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of user changing or creating this reference entry. (Automatic</font></font>default setting)<br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Date of entry modification.&nbsp;(Automatic</font></font>default setting)<br/></div><br />
&nbsp;<br/><br />
<br />
|}<br />
<br />
<br/><br />
<br />
Each row in the reference_to_entries table (green) contains a ref_data_json documentation string which links to the meta data in the Jabref table public.entries (orange).<br/><br />
<br />
<br/><br />
<br />
''<u>Json documentation string structure on row:</u>''<br/><br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|+ Metadata Documentation of original data on rows<br />
|- valign="top"<br />
| style="width: 22%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 1)'''</font></font><br/></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 2)'''</font></font><br/></div><br />
| style="width: 19%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Attribute (level 3)'''</font></font></div><br />
| style="width: 39%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''Description'''</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Name of the table to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Discription</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description of the table</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><span style="background: transparent">Column</span></font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Columns which need to be referenced</font></font></div><br />
|- valign="top"<br />
| style="height: 15px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="6" | <div style="text-align: center" class="western"></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">&lt;column name 1&gt;</font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 1, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt"><</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">column</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">name</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2</font></font><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">></font></font></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Column name 2, (original column name and spelling)</font></font></div><br />
|- valign="top"<br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" rowspan="2" | <div style="text-align: center" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">jabref_entries_id</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Jabref entries id of Literature entry</font></font></div><br />
|- valign="top"<br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Description</font></font></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Short description</font></font></div><br />
|- valign="top"<br />
| style="height: 14px; width: 22%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: left" class="western"></div><br />
| style="width: 19%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 39%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">Note or comment to this entry</font></font></div><br />
|}<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<u>'''Example:'''</u><br />
<br />
'''Database table:'''ref_test.parameter_electrical_power_plant<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 8%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">fuel</font></font></div><br />
| style="width: 25%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">type_of_generation</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">effnetto_el</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">opex_var</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div style="text-align: justify"><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_id</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">coal</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">st</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''0.35'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''2'''</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
|- valign="top"<br />
| style="width: 8%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">...</font></font></div><br />
| style="width: 25%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><br/></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><br/></div><br />
|}<br />
<br />
<br/><br />
<br />
'''''Database table: '''<u>reference_to_entries table structure:</u>''<br />
<br />
{| cellspacing="0" cellpadding="4" style="width: 100%"<br />
|- valign="top"<br />
| style="width: 14%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_id'''</font></font></div><br />
| style="width: 18%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''ref_data_json'''</font></font></div><br />
| style="width: 20%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''schema_name'''</font></font></div><br />
| style="width: 15%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''tbl_name'''</font></font></div><br />
| style="width: 17%; border-top: 1px solid #000000; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0.1cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''changed_by'''</font></font></div><br />
| style="width: 17%; border: 1px solid #000000; padding: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">'''lastmodified'''</font></font></div><br />
|- valign="top"<br />
| style="width: 14%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">1</font></font></div><br />
| style="width: 18%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">{</font></font></div><div style="margin-bottom: 0cm"><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Name": "Collection of electrical power plant parameter",</font></font></div><div><font face="Arial, sans-serif"><font size="1" style="font-size: 8pt">"Discription": "Technical parameter of confentional electrical power plants '''…'''</font></font></div><br />
| style="width: 20%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">ref_test</font></font></div><br />
| style="width: 15%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">parameter_electrical_power_plant</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: none; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">user_1</font></font></div><br />
| style="width: 17%; border-top: none; border-bottom: 1px solid #000000; border-left: 1px solid #000000; border-right: 1px solid #000000; padding-top: 0cm; padding-bottom: 0.1cm; padding-left: 0.1cm; padding-right: 0.1cm" | <div><font face="Arial, sans-serif"><font size="2" style="font-size: 10pt">2016-03-17 15:37:24.538213</font></font></div><br />
|}<br />
<br />
&lt;u</u&gt;<br />
<br />
<u>'''Json'''</u>''<u><span style="font-weight: normal">ref_data_json</span></u>''<u>'''Example:'''</u><br />
<br />
<pre><br />
{<br />
"Name": ["Collection of electrical power plant parameter"],<br />
"Description":["Technical parameter of conventional electrical power plants "],<br />
"Column": [{<br />
"effnetto_el":{"jabref_entries_id": 1,<br />
"Description":"Electrical net efficiency},<br />
<br />
"opex_var": {"jabref_entries_id": 2,<br />
"Description":"Variable operational expenditure"} }],<br />
<br />
"Note":["Short note or comment to this entry"]<br />
}</pre><br />
<br />
<br/><br />
<br />
'''Note:''' The general meta information like units are given meta documentation of the table.<br />
<br />
<br/><br />
<br />
The [https://en.wikipedia.org/wiki/BibTeX BibTeX standard] from [http://www.jabref.org JabRef] is used for the Data Referencing<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description":"Unique identifier,<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description":"Reference Year",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description":"Some important value",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "name":"Autor1",<br />
"mail":"Autor1@e-mail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Autor2",<br />
"mail":"Autor2@e-mail.com",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
<ul style="margin-left: 40px;"><br />
<li><br/></li><br />
</ul></div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/File:ERM_oedb_references_example.png
File:ERM oedb references example.png
2016-07-04T13:19:16Z
<p>Wolf-Dieter Bunke: User created page with UploadWizard</p>
<hr />
<div>=={{int:filedesc}}==<br />
{{Information<br />
|description={{en|1=ERM oedb references example}}<br />
|date=2016-07-04<br />
|source={{own}}<br />
|author=[[User:Wolf-Dieter Bunke|Wolf-Dieter Bunke]]<br />
|permission=<br />
|other_versions=<br />
|other_fields=<br />
}}<br />
<br />
=={{int:license-header}}==<br />
{{self|cc-by-sa-3.0}}</div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T12:04:08Z
<p>Wolf-Dieter Bunke: /* Original Data (orig) */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an upper chase and are given by the following definition of<span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables.</span><br />
<br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
<pre><br />
{<br />
"Name": "Original name of the data set",<br />
"Source":[{<br />
"Name": "Website of data",<br />
"URL": "www.website.com" }],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Column": [<br />
{"Name":"id",<br />
"Description":"Unique identifier",<br />
"Unit":"" },<br />
<br />
{"Name":"year",<br />
"Description":"Reference Year",<br />
"Unit":"" },<br />
<br />
{"Name":"example_value",<br />
"Description": "Some important value",<br />
"Unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"Name":"Joe Nobody",<br />
"Mail":"joe.nobody@gmail.com (fake)",<br />
"Date":"16.06.2014",<br />
"Comment":"Created table" },<br />
<br />
{"Name":"Joana Anybody",<br />
"Mail":"joana.anybody@gmail.com (fake)",<br />
"Date":"17.07.2014",<br />
"Comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": [{"Name":"Licence – Version 2.0 (dl-de/by-2-0",<br />
"URL": "http://www.govdata.de/dl-de/by-2-0]"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description":"Unique identifier,<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description":"Reference Year",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description":"Some important value",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "name":"Autor1",<br />
"mail":"Autor1@e-mail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Autor2",<br />
"mail":"Autor2@e-mail.com",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
<ul style="margin-left: 40px;"><br />
<li><br/></li><br />
</ul></div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-07-04T11:55:44Z
<p>Wolf-Dieter Bunke: /* Data Referencing */</p>
<hr />
<div><br />
The following database rules explain the usage of the database called oedb, which will become a part of the openmod internet presence. For further details see also [[Database|here]].<br/><br/><br/><br />
<br />
= Data Documentation<br/> =<br />
<br />
*All data included in the databases has be documented! On this wiki page you learn, how to do so.<br/><br />
*All abreviations have to be documentated in the [[Category:Glossary|Glossary]]&nbsp;!<br/><br/><br />
<br />
= Naming of Data<br/> =<br />
<br />
The data in the database is organised in schemata and tables, which names are important to find around.<br/><br/><br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb.'''<br/><br />
<br />
<br/><br/><br />
<br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schemata, which follows the following rules:<br/><br />
<br />
*always lower case<br/><br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*The name starts with the type of the schema:<br />
*#'''orig''' for original data: Data that is directly available in other sources and underwent no editing other than transfering it to a data base friendly format<br />
*#'''calc''' for processed data: Data that origin from original data or processed data via some script or other modifications. The specific data and methods used for this computations must be mentioned.<br/><br />
*#'''res''' for result data: Data that is the result of an energy model<br />
<br />
<br/><br />
<br />
*The name includes the distinct subject area or source.<br/><br />
<br />
<br/><br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
<br />
== Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
The table name consists of<br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
Data Integrity is one aspect of ensuring [[Data quality|data quality]] the in the oedb.<br/><br />
<br />
== General ==<br />
<br />
*Each table should have a single auto-incremented integer column as Primary Key with the corresponding table constraint.<br/><br />
*Grant all privilegs to oeuser<br/><br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom.'''<br />
*Data type is '''geometry''' (or raster).<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
<br />
<br />
= Data Referencing =<br />
<br />
There are several useful attributes on a table users have to know in order to work with the contained data efficiently. For these meta data the documentation open-standard Json is used ([https://en.wikipedia.org/wiki/JSON Wiki] and [http://www.json.org/ Json.org]). The documentation is separated in two major categories:<br />
<br />
#Comments on tables: Contains metadata that define several aspects for the whole table<br />
#Comments on rows: Store important informations on a specific row and the stored data<br />
<br />
<br/><br/><br />
<br />
=== Comments on Tables<br/> ===<br />
<br />
Comments on a table are json-dictionary as strings that describe the overall structure of the corresponding table. For every field the corresponding unit (in case of numerical values) and a description that specifies the contained data should be attached. The attribute names begins with an upper chase and are given by the following definition of<span style="font-weight: normal"></span><span style="font-weight: normal">Database Tables.</span><br />
<br />
==== Original Data (orig)<br/> ====<br />
<br />
<pre>{"Name": "The Full Name",<br />
"Source": ["Name", "www.website.com / registation required"],<br />
"Reference date": ["2013"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Example Data (annual totals)", "Regional level: national"],<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description"Unique identifier"",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description"Reference Year"",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description"Some important value"",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
{"name":"Joe Nobody",<br />
"mail":"joe.nobody@gmail.com (fake)",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{"name":"Joana Anybody",<br />
"mail":"joana.anybody@gmail.com (fake)",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Licence – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
==== Processed and Result Data (calc/res)<br/> ====<br />
<br />
As processed data does not necessarily have a simple source the fields "Source", "Original File", "Reference date" are ommited. These information should be mentioned row-wise as explained in the next paragraph.<br />
<br />
<pre><br />
{"Name": "Results",<br />
"Date of collection": ["01.08.2013"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", <br />
"Regional level: municipalities, association of municipalities"],<br />
<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description":"Unique identifier,<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description":"Reference Year",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description":"Some important value",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
<br />
{ "name":"Autor1",<br />
"mail":"Autor1@e-mail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Autor2",<br />
"mail":"Autor2@e-mail.com",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}<br />
<br />
</pre><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
=== Comments on Rows<br/> ===<br />
<br />
The comments on a row aim to enhance the reproducabilty of data that is present in the database by stating the underlying data that was used to compute this&nbsp; row as well as the applied computational methods.<br/><br />
<br />
During these processes some kinds of uncertainities might occur as well as the decissions (assumtions) that were made to deal with them. Examplatory, some values might be missing amid this row and a linear development during this period was assumed to fix this gap. Each row has to be annotated by a json dictionary that must contain the following fields:<br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
**<br />
<br />
*<br />
*solution: Method that was used to select one value (e.g. Minimum)<br />
**<br />
<br />
*<br />
*values: Possible Values that could have been used<br />
<br />
&nbsp;<br />
<br />
<br/><br/>An examplatory dictionary:<br/><pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre><br />
<ul style="margin-left: 40px;"><br />
<li><br/></li><br />
</ul></div>
Wolf-Dieter Bunke
https://wiki.openmod-initiative.org/wiki/DatabaseRules
DatabaseRules
2016-05-27T09:26:23Z
<p>Wolf-Dieter Bunke: </p>
<hr />
<div><br />
= Data Documentation<br/> =<br />
<br />
All data included in the databases has be documented!<br />
<br />
All abreviations have to be documentated in the Glossary!<br />
<br />
= Naming of Data =<br />
<br />
== Database Name<br/> ==<br />
<br />
The name of the database is '''oedb'''<br />
<br />
<br/><br />
<br />
== Database Schema ==<br />
<br />
The structure of the database is realised via the naming of the schema!<br />
<br />
*always lower case<br />
*no points, no commas<br />
*no spaces<br />
*no dates<br />
*use underscores<br />
<br />
<br/><br />
<br />
*name starts with type of schema<br />
*#'''orig''' for original data<br />
*#'''calc''' for processed data<br />
<br />
*name includes distinct subject area or source<br />
<br />
Example: ''orig_vg250''<br />
<br />
<br/><br />
<br />
== <br/>Database Table ==<br />
<br />
*always lower case<br/><br />
*no points, no commas<br/><br />
*no spaces<br/><br />
*no dates<br/><br />
*use underscores<br />
<br />
<br/><br />
<br />
#name starts with the source (e.g. zensus)<br />
#main value (e.g. population)<br />
#if separated by [attribute] (e.g. by_gender)<br />
#with resolution [tupel] (e.g. per_mun)<br />
<br />
Example: ''zensus_population_by_gender_per_mun''<br/><br />
<br />
= Data Integrity<br/> =<br />
<br />
== General ==<br />
<br />
*Primary Key [PK]<br/><br />
*Grants to oeuser<br />
<br />
<br/><br />
<br />
<br/><br />
<br />
<br/><br />
<br />
== Geografic Data<br/> ==<br />
<br />
*Attribut name is '''geom'''<br />
*Data type is '''geometry''' (or raster)<br />
*One of the '''Geometric Types''' is defined ([https://www.postgresql.org/docs/current/static/datatype-geometric.html https://www.postgresql.org/docs/current/static/datatype-geometric.html])<br />
*The '''CRS''' is defined as EPSG ([http://spatialreference.org/ref/epsg/ http://spatialreference.org/ref/epsg/])<br />
**Original data stays with the original CRS!<br />
**Prefered CRS of the oedb are:<br/><br />
<br />
#WGS84 - EPSG: 4326 ([http://spatialreference.org/ref/epsg/4326/ http://spatialreference.org/ref/epsg/4326/])<br />
#ETRS89 / ETRS-LAEA - EPSG: 3035 ([http://spatialreference.org/ref/epsg/3035/ http://spatialreference.org/ref/epsg/3035/])<br />
<br />
*Spacial index '''GIST'''<br />
<br />
<br/><br />
<br />
= Data Referencing =<br />
<br />
=== Original Data (orig)<br/> ===<br />
<br />
Tables are annotated by a comment in form of a json string:<br/><br />
<br />
<pre>{"Name": "Wirtschaftsdaten pro Region",<br />
"Source": ["Regionaldatenbank Deutschland", "www.regionalstatistik.de / registation required"],<br />
"Reference date": ["2013"],<br />
"Retrieved": ["04.06.2014"],<br />
"Date of collection": ["01.08.2013"],<br />
"Original file": ["346-22-5.xls"],<br />
"Spatial resolution": ["Germany"],<br />
"Description": ["Financial key figures of German municipalities (annual totals)", "Regional level: municipalities, association of municipalities"],<br />
<br />
"Table fields": [<br />
{"name":"id",<br />
"description"Unique identifier"",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"year",<br />
"description"Reference Year"",<br />
"description_german":"",<br />
"unit":"" },<br />
<br />
{"name":"example_value",<br />
"description"Some important value"",<br />
"description_german":"",<br />
"unit":"EUR" }],<br />
<br />
"Changes":[<br />
{ "name":"Wolf-Dieter Bunke",<br />
"mail":"wd.bunke@gmail.com",<br />
"date":"16.06.2014",<br />
"comment":"Created table" },<br />
<br />
{ "name":"Cord Kaldemeyer",<br />
"mail":"cord.kaldemeyer@fh-flensburg.de",<br />
"date":"17.07.2014",<br />
"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br />
"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br />
"Instructions for proper use": ["Always state licence"]}</pre><br/><br />
<br />
<br/><br />
<br />
=== Processed Data (calc)<br/> ===<br />
<br />
{"Name": "Results",<br/>"Date of collection": ["01.08.2013"],<br/>"Spatial resolution": ["Germany"],<br/>"Description": ["Financial key figures of German municipalities (annual totals)", "Regional level: municipalities, association of municipalities"],<br/><br />
<br />
"Table fields": [<br/>{"name":"id",<br/>"description"Unique identifier"",<br/>"description_german":"",<br/>"unit":"" },<br />
<br />
{"name":"year",<br/>"description"Reference Year"",<br/>"description_german":"",<br/>"unit":"" },<br />
<br />
{"name":"example_value",<br/>"description"Some important value"",<br/>"description_german":"",<br/>"unit":"EUR" }],<br />
<br />
"Changes":[<br/>&nbsp;{ "name":"Autor1",<br/>&nbsp;"mail":"Autor1@e-mail.com",<br/>&nbsp;"date":"16.06.2014",<br/>&nbsp;"comment":"Created table" },<br />
<br />
&nbsp;{ "name":"Autor2",<br/>&nbsp;"mail":"Autor2@e-mail.com",<br/>&nbsp;"date":"17.07.2014",<br/>&nbsp;"comment":"Translated field names"}],<br />
<br />
"ToDo": ["Some datasets are odd -> Check numbers against another data"],<br/>"Licence": ["Datenlizenz Deutschland – Namensnennung – Version 2.0 (dl-de/by-2-0; [http://www.govdata.de/dl-de/by-2-0 http://www.govdata.de/dl-de/by-2-0])"],<br/>"Instructions for proper use": ["Always state licence"]}<br/><br />
<br />
<br/><br />
<br />
==== Processed Data (calc) - Row Annotation ====<br />
<br />
Each row has to be annotated by a json dictionary that must contain the following fields:<br/><br />
<br />
*origin: Link or textual description of the data set this row origins from.<br/><br />
*method: Method used to calculate this row from above origin (e.g. Link to a python script)<br/><br />
*assumption: A list of dictionaries. Each dictionary describes an assumption and annotates the affected rows.<br/><br />
**begin: First column affected by the assumption<br/><br />
**end: Last column affected by the assumption<br/><br />
**type: Type of the problem that had to be solved. Each type requires one or more additional keys in this dictionary. Possible types and their required additional keys are:<br/><br />
***gap: A not all fields could be calculated and/or filled,<br />
****solution: Method that was used to generate date to fill this gap (e.g. linear interpolation)<br />
<br />
*<br />
*<br />
*multiplicity: A field could be filled by several values<br />
****values: Possible Values that could habe been used<br />
****solution: Method that was used to select one value (e.g. Minimum)<br />
<br />
<br/>An examplatory dictionary:<br/><pre><br />
{<br />
"origin":"https://data.openmod-initiative.org/data/oedb/orig_db/table<br />
"method":"https://github.com/openego/data_processing/blob/master/calc_ego_substation/Voronoi_ehv.sql"<br />
"assumptions":<br />
[<br />
{<br />
"type": "gap"<br />
"begin": "step_15"<br />
"end": "step_34"<br />
"solution": "linear_interpolation"<br />
} <br />
]<br />
}<br />
</pre></div>
Wolf-Dieter Bunke