Merge pull request #3 from SantanderMetGroup/devel

Devel

README.md

@@ -17,6 +17,6 @@ The IPCC reference regions have been used as the basis to generate popular spati
 Besides the analysis of time-slices (e.g. near-, mid- and long-term, 2021-2040, 2041-2060, 2081-2100, respectively), we also provide information to work with [Global Warming Levels (+1.5º, +2º, +3º, +4º)](https://github.com/SantanderMetGroup/ATLAS/tree/master/GWL). 
 
 ### Virtual Workspace: The Atlas Hub
-The Atlas Hub is a cloud facility providing virtual workspace for the Climate Change Atlas code and data (with preinstalled software and accesible data). The Atlas Hub is based on **Jupyter** to create and run notebooks on a remote machine where all the software is pre-installed (instructions available in the *IPCC-Atlas_hub_instructions.pdf* document). The Atlas Hub builds on the R **climate4R** package, allowing for transparent climate data access, collocation, post-processing (including bias correction) and visualization. Instructions to start working with the Hub are available at the document [IPCC-Atlas_hub_instructions.pdf](https://github.com/SantanderMetGroup/IPCC-Atlas/IPCC-Atlas_hub_instructions.pdf) on this repository.
+The Atlas Hub is a cloud facility providing virtual workspace for the Climate Change Atlas code and data (with preinstalled software and accesible data). The Atlas Hub is based on **Jupyter** to create and run notebooks on a remote machine where all the software is pre-installed (instructions available in the *Atlas_hub_instructions.pdf* document). The Atlas Hub builds on the R **climate4R** package, allowing for transparent climate data access, collocation, post-processing (including bias correction) and visualization. Instructions to start working with the Hub are available at the document [Atlas_hub_instructions.pdf](https://github.com/SantanderMetGroup/ATLAS/blob/master/man/Atlas_Hub_instructions.pdf) in the *man* folder on this repository.
 
 ### **Important**: This initiative contributes to the development of the IPCC AR6 Atlas, but this is not an official IPCC site. This repository is fully managed by the [Santander Met Group](https://github.com/SantanderMetGroup) and it is only intended to keep track of internal research activities.

reference_regions/CMIP6_referenceRegions_coordinates.csv

@@ -0,0 +1,58 @@
+POLAR,Greenland/Iceland,GIC,-10.0|58.0,-50.0|58.0,-82.0|85.0,-10.0|85.0,,,,,,,,,,
+NORTH-AMERICA,N.E.Canada,NEC,-55.0|50.0,-50.0|58.0,-82.0|85.0,-105.0|85.0,-105.0|50.0,,,,,,,,,
+NORTH-AMERICA,C.North-America,CNA,-90.0|50.0,-90.0|25.0,-105.0|33.8,-105.0|50.0,,,,,,,,,,
+NORTH-AMERICA,E.North-America,ENA,-70.0|25.0,-90.0|25.0,-90.0|50.0,-55.0|50.0,-77.0|31.0,,,,,,,,,
+NORTH-AMERICA,N.W.North-America,NWN,-105.0|50.0,-130.0|50.0,-143.0|60.0,-168.0|60.0,-168.0|72.6,-105.0|72.6,-105.0|60.0,,,,,,,
+NORTH-AMERICA,W.North-America,WNA,-130.0|50.0,-122.5|33.8,-105.0|33.8,-105.0|50.0,,,,,,,,,,
+CENTRAL-AMERICA,N.Central-America,NCA,-90.0|25.0,-104.5|16.0,-122.5|33.8,-105.0|33.8,,,,,,,,,,
+CENTRAL-AMERICA,S.Central-America,SCA,-75.0|12.0,-83.4|2.2,-104.5|16.0,-90.0|25.0,,,,,,,,,,
+CENTRAL-AMERICA,Caribbean,CAR,-75.0|12.0,-90.0|25.0,-70.0|25.0,-55.0|12.0,,,,,,,,,,
+SOUTH-AMERICA,N.W.South-America,NWS,-75.0|12.0,-83.4|2.2,-83.4|-10.0,-79.0|-15.0,-72.0|-15.0,-72.0|12.0,,,,,,,,
+SOUTH-AMERICA,South-American-Monsoon,SAM,-66.4|-20.0,-72.0|-15.0,-72.0|-8.0,-50.0|-8.0,-50.0|-20.0,,,,,,,,,
+SOUTH-AMERICA,S.South-America,SSA,-79.0|-56.0,-79.0|-47.0,-56.0|-47.0,-56.0|-56.0,,,,,,,,,,
+SOUTH-AMERICA,S.W.South-America,SWS,-72.0|-15.0,-66.4|-20.0,-71.5|-47.0,-79.0|-47.0,-74.6|-20.0,-79.0|-15.0,,,,,,,,
+SOUTH-AMERICA,S.E.South-America,SES,-34.0|-20.0,-56.0|-47.0,-71.5|-47.0,-66.4|-20.0,,,,,,,,,,
+SOUTH-AMERICA,N.South-America,NSA,-72.0|12.0,-72.0|-8.0,-50.0|-8.0,-50|7.6,-55.0|12.0,,,,,,,,,
+SOUTH-AMERICA,N.E.South-America,NES,-34.0|-20.0,-50.0|-20.0,-50.0|0.0,-34.0|0.0,,,,,,,,,,
+EUROPE,N.Europe,NEU,-10.0|48.0,-10.0|72.6,40.0|72.6,40.0|61.3,,,,,,,,,,
+EUROPE,C.Europe,CEU,-10.0|45.0,-10.0|48.0,40.0|61.3,40.0|45.0,,,,,,,,,,
+EUROPE,E.Europe,EEU,40.0|45.0,40.0|65.0,60.0|65.0,60.0|45.0,,,,,,,,,,
+EUROPE-AFRICA,Mediterranean,MED,-10.0|30.0,-10.0|45.0,40.0|45.0,40.0|30.0,,,,,,,,,,
+AFRICA,West-Africa,WAF,-20.0|7.6,-20.0|14.7,15.0|14.7,8.0|0.0,,,,,,,,,,
+AFRICA,Sahara,SAH,-20.0|14.7,-20.0|30.0,33.0|30.0,42.1|14.7,,,,,,,,,,
+AFRICA,North-East-Africa,NEAF,27.0|2.3,27.0|14.7,42.1|14.7,43.7|12.0,53.0|15.0,53.0|2.3,,,,,,,,
+AFRICA,Central-East-Africa,CEAF,27.0|-10,27.0|2.3,53.0|2.3,53.0|-10,,,,,,,,,,
+AFRICA,South-West-Africa,SWAF,8|-36.0,8.0|-10,25.0|-10,25.0|-36.0,,,,,,,,,,
+AFRICA,South-Eeast-Africa,SEAF,25|-10.0,25.0|-36,53.0|-36,53.0|-10.0,,,,,,,,,,
+AFRICA,Central-Africa,CAF,8|-10.0,8|0,15.0|14.7,27.0|14.7,27.0|-10.0,,,,,,,,,
+ASIA,Russian-Arctic,RAR,40.0|65.0,40.0|72.6,94.0|82.0,180.0|72.6,180.0|65.0,,,,,,,,,
+ASIA,Russian-Far-East,RFE,130.0|45.0,130.0|65.0,180.0|65.0,180.0|60.0,157.0|50.0,152.0|45.0,,,,,,,,
+ASIA,E.Siberia,ESB,90.0|45.0,90.0|65.0,130.0|65.0,130.0|45.0,,,,,,,,,,
+ASIA,W.Siberia,WSB,60.0|45.0,60.0|65.0,90.0|65.0,90.0|45.0,,,,,,,,,,
+ASIA,W.C.Asia,WCA,40.0|30.0,40.0|45.0,75.0|45.0,75.0|30.0,,,,,,,,,,
+ASIA,Tibetan-Plateau,TIB,75.0|30.0,75.0|45.0,100.0|45.0,100.0|30.0,,,,,,,,,,
+ASIA,E.Asia,EAS,100.0|19.5,100.0|45.0,152.0|45.0,132.0|25.0,132.0|19.5,,,,,,,,,
+ASIA,Arabian-Peninsula,ARP,33.0|30.0,60.0|30.0,60.0|19.5,53.0|15.0,43.7|12.0,,,,,,,,,
+ASIA,S.Asia,SAS,60.0|23.5,60.0|30.0,100.0|30.0,100.0|19.5,95.0|19.5,87.0|19.5,79.0|7.0,76.0|7.0,70.0|19.5,66.5|23.5,,,,
+ASIA,S.E.Asia,SEA,93.0|-10.0,93.0|19.5,132.0|19.5,132.0|5.0,155.0|-10.0,,,,,,,,,
+OCEANIA,N.Australia,NAU,110.0|-20.0,110.0|-10.0,155.0|-10.0,155.0|-20.0,,,,,,,,,,
+OCEANIA,C.Australia,CAU,110.0|-30.0,110.0|-20.0,155.0|-20.0,155.0|-38.0,140.0|-30.0,,,,,,,,,
+OCEANIA,S.Australia,SAU,110.0|-36.0,110.0|-30.0,140.0|-30.0,155.0|-38.0,155.0|-50.0,,,,,,,,,
+OCEANIA,New-Zealand,NZ,155.0|-50.0,155.0|-30.0,180.0|-30.0,180.0|-50.0,,,,,,,,,,
+POLAR,E.Antarctica,EAN,-180.0|-90.0,-180.0|-83.0,-56.0|-83.0,-56.0|-75.0,-25.0|-75.0,5.0|-64.0,180.0|-64.0,180.0|-90.0,,,,,,
+POLAR,W.Antarctica,WAN,-180.0|-83.0,-180.0|-70.0,-80.0|-70.0,-65.0|-62.0,-56.0|-62.0,-56.0|-83.0,,,,,,,,
+ARCTIC,Arctic-Ocean,ARO,-180.0|90.0,-180.0|67.5,-168.0|67.5,-168.0|72.6,-105.0|72.6,-105.0|85.0,-10.0|85.0,-10.0|72.6,40.0|72.6,94.0|82.0,180.0|72.6,180.0|90.0,,
+PACIFIC,N.Pacific-Ocean1,NPO,132.0|7.6,132.0|25.0,157.0|50.0,180.0|60.0,180.0|7.6,,,,,,,,,
+PACIFIC,N.Pacific-Ocean2,NPO*,-180.0|7.6,-180.0|67.5,-168.0|67.5,-168.0|60.0,-143.0|60.0,-130.0|50.0,-122.5|33.8,-104.5|16.0,-91.7|7.6,,,,,
+PACIFIC,Equatorial.Pacific-Ocean1,EPO,155.0|-10.0,132.0|5.0,132.0|7.6,180.0|7.6,180.0|-10.0,,,,,,,,,
+PACIFIC,Equatorial.Pacific-Ocean2,EPO*,-180|-10.0,-180|7.6,-91.7|7.6,-83.4|2.2,-83.4|-10.0,,,,,,,,,
+PACIFIC,S.Pacific-Ocean1,SPO,180.0|-10.0,180.0|-30.0,155.0|-30.0,155.0|-10.0,,,,,,,,,,
+PACIFIC,S.Pacific-Ocean2,SPO*,-180.0|-56.0,-180.0|-10.0,-83.4|-10.0,-74.6|-20.0,-79.0|-47.0,-79.0|-56.0,,,,,,,,
+ATLANTIC,N.Atlantic-Ocean,NAO,-50.0|7.6,-77.0|31.0,-55.0|50.0,-50.0|58.0,-10.0|58.0,-10.0|30.0,-20.0|30.0,-20.0|7.6,,,,,,
+ATLANTIC,Equatorial.Atlantic-Ocean,EAO,-34.0|-10.0,-34.0|0.0,-50.0|0.0,-50|7.6,-20.0|7.6,8.0|0.0,8|-10.0,,,,,,,
+ATLANTIC,S.Atlantic-Ocean,SAO,-56.0|-56.0,-56.0|-47.0,-34.0|-20.0,-34.0|-10.0,8.0|-10,8|-36.0,,,,,,,,
+INDIAN,Arabian-Sea,ARS,53.0|7.0,53.0|15.0,60.0|19.5,60|23.5,66.5|23.5,70.0|19.5,76.0|7.0,,,,,,,
+INDIAN,Bengal-Gulf,BOB,79.0|7.0,87.0|19.5,93.0|19.5,93.0|7.0,,,,,,,,,,
+INDIAN,Equatorial.Indic-Ocean,EIO,53.0|-10,53.0|7.0,93.0|7.0,93.0|-10.0,,,,,,,,,,
+INDIAN,S.Indic-Ocean,SIO,53.0|-36,53.0|-10,110.0|-10.0,110.0|-36.0,,,,,,,,,,
+SOUTHERN,Southern-Ocean,SOO,-180.0|-56.0,-180.0|-70.0,-80.0|-70.0,-65.0|-62.0,-56.0|-62.0,-56.0|-75.0,-25.0|-75.0,5.0|-64.0,180.0|-64.0,180.0|-50.0,155.0|-50,110.0|-36.0,8|-36.0,-56.0|-56.0        

reference_regions/README.md

@@ -1,5 +1,5 @@
-# AR6-WGI Reference regions and CMIP6 averaged results
+## Updated AR5 Reference Regions and CMIP6 averaged results
 
-The new references resgions are provided as polygons (csv and shapefile, *AR6-WGI_refereceRegions.zip*). Moreover, the R and Python notebooks illustrating the use of these regions with worked out examples are also provided.
+The new references regions are provided as polygons in different formats (csv with coordinates, R data, and shapefile, *CMIP6_refereceRegions*) together with R and Python notebooks illustrating the use of these regions with worked out examples.
 
-Spatially averaged results of CMIP6 models have been computed for the different reference regions and are available at the *regional_means* folder (see [IPCC-Altas Hub inventory](https://github.com/SantanderMetGroup/IPCC-Atlas/tree/devel/AtlasHub-inventory), version 20191211). 
+Spatially averaged results of CMIP6 models have been computed for the different reference regions and are available at the *regional_means* folder (see [Altas Hub inventory](https://github.com/SantanderMetGroup/IPCC-Atlas/tree/devel/AtlasHub-inventory), version 20191211). 

reference_regions/regional_means/README.md

@@ -1,6 +1,6 @@
-# Spatial averages of CMIP6 projections over the AR6-WGI reference regions
+## Spatial averages of CMIP6 projections over the AR6-WGI reference regions
 
-Spatially aggregated monthly results over the different AR6 reference regions have been calculated for all CMIP6 models and runs available in the IPCC-Altas Hub (see the [inventory](https://github.com/SantanderMetGroup/IPCC-Atlas/tree/devel/AtlasHub-inventory), CMIP6Amon_Hub version 20191211) for land, sea, and land-sea gridboxes. These results are provided in the following links:
+Spatially aggregated monthly results over the different reference regions have been calculated for all CMIP6 models and runs available in the Altas Hub (see the [inventory](https://github.com/SantanderMetGroup/IPCC-Atlas/tree/devel/AtlasHub-inventory), CMIP6Amon_Hub version 20191211) separately for land, sea, and land-sea gridboxes. These results are provided in the following links:
 
 [CMIP6Amon_pr_land.zip](http://meteo.unican.es/work/IPCC_Atlas/regional_means/CMIP6Amon_pr_land.zip)\
 [CMIP6Amon_pr_landsea.zip](http://meteo.unican.es/work/IPCC_Atlas/regional_means/CMIP6Amon_pr_landsea.zip)\
@@ -9,4 +9,4 @@ Spatially aggregated monthly results over the different AR6 reference regions ha
 [CMIP6Amon_tas_landsea.zip](http://meteo.unican.es/work/IPCC_Atlas/regional_means/CMIP6Amon_tas_landsea.zip)\
 [CMIP6Amon_tas_sea.zip](http://meteo.unican.es/work/IPCC_Atlas/regional_means/CMIP6Amon_tas_sea.zip)
 
-The landsea results for the subset of CMIP6 models (runs) used in the Interactive Atlas (CMIP6Amon_Atlas version 20191211 in the [inventory](https://github.com/SantanderMetGroup/IPCC-Atlas/tree/devel/AtlasHub-inventory)), are also available in the data folder.
+The landsea results for a subset of CMIP6 model runs (a single run per model) used in the Atlas (CMIP6Amon_Atlas version 20191211 in the [inventory](https://github.com/SantanderMetGroup/IPCC-Atlas/tree/devel/AtlasHub-inventory)), are also available in the data folder.