change repo structure #1

README.md

@@ -1,2 +1,62 @@
 # ogs-data-exploration
-This repository contains all data exploration notebooks for OpenGeoScales project
+This repository is dedicated to the cartography and exploration of greenhouse gas (GHG) emissions data at various geographical scales.
+
+## Documentation
+
+### Goal
+The goal of documentation tasks consists of identifying relevant GHG data and documenting associated knowledge and concepts for understanding its content.
+
+### Outputs
+
+- List of data sources with respective links in wiki data-source page
+- Feeding wiki with references,  knowledge and concepts related to GHG emissions data
+
+## Exploration
+### Goal
+The goal of data exploration tasks consists of exploring and analyzing the different data sources identified in the documentation tasks.
+
+### Process
+
+Each member will be responsible for the analysis of x data sources.
+We create a branch by data source in the github repo.
+We create a folder by data source.
+For each data source, a readme file is needed to describe the content.
+Each data source explorer maintains his/her branch by documenting the data source, providing analysis notebooks and generating a json file describing datasource metadata.
+You are asked to commit changes as frequent as possible by adding issue number in the commit message. 
+When you want to merge your changes in the main branch, make a pull request by identifying the reviewer and linking the pull request to the issue you are working on.
+You will receive a message of acceptance when your pull request is merged.
+
+
+### Outputs
+
+#### Notebooks
+Notebooks (Python or R) providing exploratory analysis of raw data
+
+#### Data Catalog
+
+- Feeding a Data Catalog with information about analyzed data
+```json
+{
+	"fields": [
+	{
+			"data_source": "Name of data source",
+			"data_provider": "Name of data provider",
+			"format": "data format (csv, json, xls)",
+			"temporal_resolution": ["year", "month", "day"],
+			"spatial_resolution": ["country", "city", "grid-xkm"],
+			"temporal_coverage": ["min-date", "max-date"],
+			"spatial_coverage": ["Europe", "France"],
+			"data_access": ["download", "api"],
+			"gases": ["CO2", "CH4"],
+			"scopes": ["Scope 1", "Scope 2", "NA"],
+			"sectors": ["All sectors", "Industrial", "Agriculture"],
+			"protocols": ["kyoto protocol"],
+			"estimation_methods": ["Top-Down", "Bottom-Up"]
+		}
+	]
+}
+```
+#### Selected datasets
+
+- Selection of datasets to integrate in OGS platform
+- Identification of potential transformation necessary for normalizing each data source

data-catalog/ghg-emissions/ademe/ademe-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+Agence De l'Environnement Et de la Maitrise de l'Energie (ADEME) | In France, ADEME provides GHG accounting framework, called Bilan Carbone, for collecting and compiling emissions inventories from organizations and territories. | `City scale`| `ADEME` | [Get data](https://www.data.gouv.fr/fr/datasets/bilans-demissions-de-ges-publies-sur-le-site-de-lademe-1/)|

data-catalog/ghg-emissions/cdiac/cdiac-data-desc.md

@@ -0,0 +1,2 @@
+
+- [link for CDIAC datasets](https://cdiac.ess-dive.lbl.gov/trends/emis/meth_reg.html)

data-catalog/ghg-emissions/cdp/cdp-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+Carbon Disclosure Project (CDP) | The CDP is an international non-profit organisation that helps companies and cities disclose their environmental impact and GHG emissions. CDP provides [an open data protal](https://data.cdp.net/) for exploring companies and city-wide collected data. | `City scale`| `CDP` | [Get data](https://data.cdp.net/browse?category=Emissions)|

data-catalog/ghg-emissions/citepa/citepa-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+Technical Reference for Air Pollution and Climate Change (CITEPA) | Citepa officially estimates greenhouse gas and air polluant emissions each year on behalf of the French Ministry of the Environment. | `Country scale`<br /> `City scale`| `Citepa` | [Get data](https://www.citepa.org/fr/telechargements/) |

data-catalog/ghg-emissions/edgar/edgar-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---|
+The Joint Research Center of Euorpean Commission | The Joint Research center produces the Emission **Database for Global Atmospheric Research (EDGAR)**. EDGAR provides independent estimates of the global anthropogenic emissions and emission trends, based on publicly available statistics, for the atmospheric modeling community as well as for policy makers. This scientific independent emission inventory is characterized by a coherent world historical trend from 1970 to year x-3, including emissions of all greenhouse gases, air pollutants and aerosols. Data are presented for all countries, with emissions provided per main source category, and spatially allocated on a 0.1x0.1 grid over the globe  | `World scale`  <br />  `Country scale`  <br />  `Grid scale`| `EDGAR` | [Get data](https://data.jrc.ec.europa.eu/collection/edgar) |

data-catalog/ghg-emissions/eea/eea-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+European Environmental Agency (EEA) | The EEA compiles and provides data on greenhouse gas emissions and removals, sent by countries to UNFCCC and the EU Greenhouse Gas Monitoring Mechanism (EU Member States).| `Europe scale` <br /> `Country scale`| `UNFCCC`| [Get data](https://www.eea.europa.eu/data-and-maps/data/national-emissions-reported-to-the-unfccc-and-to-the-eu-greenhouse-gas-monitoring-mechanism-16) |

data-catalog/ghg-emissions/eurostat/eurostat-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+Eurostat | Eurostat (European Statistical Office) is a Directorate-General of the European Commission. It provides statistical information to the institutions of the European Union (EU) such as a comprehensive set of climate change-related data including GHG emissions statistics. Eurostat maintains a [data portal](https://ec.europa.eu/eurostat/databrowser/view/sdg_13_10/default/table?lang=en) for exploring emissions data. | `Europe scale` <br /> `Country scale`| `EEA` `UNFCCC`| [Get data](https://ec.europa.eu/eurostat/web/climate-change/data/database) |

data-catalog/ghg-emissions/gcp/gcp-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+Global Carbon Project (GCP) | GCP is a global research project that seeks to quantify global greenhouse gas emissions and their causes. It provides data on carbon fluxes resulting from human activities and natural processes and a platform to explore and visualize the most up-to-date data ([Gloabl carbon Atlas](http://www.globalcarbonatlas.org/en/content/welcome-carbon-atlas)) | `World scale`<br />`Country scale`<br /> `City scale`| `GCP` |[Get data](https://www.globalcarbonproject.org/carbonbudget/20/data.htm) |

data-catalog/ghg-emissions/owid/owid-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+Our World In Data | Our WOrld In Data compile, maintain and shares CO2 and GHG emissions data. It is updated regularly and includes data on CO2 emissions (annual, per capita, cumulative and consumption-based), other greenhouse gases, energy mix, and other relevant metrics. | `World scale` <br /> `Country scale`| `GCP` <br /> `CAIT` |[Get data](https://github.com/owid/co2-data) |

data-catalog/ghg-emissions/wri/wri-data-desc.md

@@ -0,0 +1,4 @@
+
+Data provider | Description | Geoscale | Data sources | Access |
+---|---------|---|---| ---| 
+The World Resources Institute (WRI) | The World Resources Institute compiles various sources of GHG emissions and provide access to this data through a specific tool: [CLIMAT WATCH](https://www.climatewatchdata.org/data-explorer/historical-emissions?historical-emissions-data-sources=cait&historical-emissions-gases=&historical-emissions-regions=&historical-emissions-sectors=&page=1). Provided [GHG emissions data](https://www.climatewatchdata.org/data-explorer/historical-emissions?historical-emissions-data-sources=cait&historical-emissions-gases=&historical-emissions-regions=&historical-emissions-sectors=&page=1) is based on various data sources: CAIT database, UNFCCC, PIK.  | `World scale` <br /> `Country scale`|  `CAIT` `UNFCCC` `PIK`  | [Get data](https://www.climatewatchdata.org/data-explorer/historical-emissions?historical-emissions-data-sources=cait&historical-emissions-gases=&historical-emissions-regions=&historical-emissions-sectors=&page=1) |