Changes between Version 71 and Version 72 of Documentation/Forcings


Ignore:
Timestamp:
2018-01-19T16:14:22+01:00 (7 years ago)
Author:
aducharne
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentation/Forcings

    v71 v72  
    4141 
    4242==  1. Weather Data == 
    43 * '''High frequency''' meteorological files have a forcing step lower than or equal to six hours. 
    44 This document [attachment:Description_Forcing_Files.pdf] provides detail of how forcing files need to be prepared. It addresses in particular the issues one may face when the fluxes are averaged and scalar variables instantaneous. The driver needs to take this into account else the diurnal cycle needs to be misplaced. Some data providers have different convention for representing averaged fluxes and this type of details matter.  
    45  
    46 * ORCHIDEE accepts '''daily''' files (ask for example ISI-MIP files). 
    47 * ORCHIDEE accepts '''monthly''' files (see WG files below). 
    48  
    49 These forcing files are stored in the shared accounts in IGCM/SRF/METEO directory. The shared accounts are found: 
     43 
     44=== 1.0 General information === 
     45 
     46(a) '''ORCHIDEE accepts meteorological forcing files at different frequencies''': 
     47* '''high frequency''' meteorological files have a forcing step lower than or equal to six hours (most of the datasets below are  3-hourly or 6-hourly); 
     48* '''daily''' files (for example ISI-MIP files); 
     49* '''monthly''' files (see WG files below). 
     50It is the role of the driver to inter/extrapolate timeseries of the forcing meteorological variables at the time step of ORCHIDEE (usually 30 min) based on the forcing dataset. 
     51 
     52(b) '''Two versions of the driver are available''' to do do both the reading and the inter/extrapolation of the forcing datasets. They differ in the way they interpret the time at which the diffrent variables are read in the forcing dataset (further called the timestamp, while the interval refers to the period between two succesive timestamps): 
     53* '''the old driver (src_driver/dim2driver)''', which assumes that scalar variables (Tair,Qair,Psurf) are instantaneous values at the timestamp, while flux variables (Rainf,Snowf, SWdown, LWdown) are mean values over the interval ending at the timestamp. The old driver also needs a forcing that has its first record at 0 UTC to work correctly. 
     54* '''the new driver (src_driver/orchideedriver.f90) is more flexible''' and can normally deal with any temporal structure of the forcing datasets, provided the required attributes are inserted in the forcing files. This document [attachment:Description_Forcing_Files.pdf] provides detail of how forcing files need to be prepared. It addresses in particular the issues one may face when the fluxes are averaged and scalar variables instantaneous. The driver needs to take this into account else the diurnal cycle needs to be misplaced. Some data providers have different convention for representing averaged fluxes and this type of details matter.  
     55 
     56A longer discussion on the differences between the two drivers (dated in 2016) can be found on https://forge.ipsl.jussieu.fr/orchidee/wiki/Branches/Driver_Improvements. 
     57 
     58(c) '''Usually, the forcing files are stored in the shared accounts''' in IGCM/SRF/METEO directory. The shared accounts are found: 
    5059 * At TGCC: /ccc/work/cont003/dsm/p86ipsl/IGCM  
    5160 * At IDRIS: 
    … …  
    6069Read more about the shared accounts and IGCM repository here [http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/DocBenvEcommonfiles] 
    6170 
    62 Tips when building meteorological forcing files: 
    63 * '''Land compressed files''': The '''missing_value''' attribute is mandatory in forcing files containing only land points, with a value outside of the valid range of the variables, for example missing_value=1.e+20. In flinget_mat, the default value is set to 0, if this value is kept, oceanic points will be filled with it and treated as land points because 0. is a valid value for some fields (Qair) but ORCHIDEE will crash because it's not valid for others (PSurf), causing the usual problems in qsatcalc. 
    64  
     71(d) '''Tips and script examples when building meteorological forcing files''': 
     72* '''Land compressed files''':  
     73   - The '''missing_value''' attribute is mandatory in forcing files containing only land points, with a value outside of the valid range of the variables, for example missing_value=1.e+20. In flinget_mat, the default value is set to 0, if this value is kept, oceanic points will be filled with it and treated as land points because 0. is a valid value for some fields (Qair) but ORCHIDEE will crash because it's not valid for others (PSurf), causing the usual problems in qsatcalc. 
     74   - FORTRAN 90 script to create a land points only forcing file (use of the compress attribute) [attachment:mk_grid.f90] 
    6575 
    6676=== 1.1 CRU-NCEP === 
    … …  
    7080[https://github.com/bnordgren/pylsce] 
    7181 
    72 There are several versions of CRU-NCEP.  
     82There are several versions of CRU-NCEP. All of them are compatible with the old driver. 
    7383 
    7484==== CRU-NCEP / v7.2 ==== 
    … …  
    182192The data have been prepared for all sites of the Free Access Fluxnet database (http://www.fluxdata.org/DataInfo) as available in August, 2012 (~150 sites). 
    183193 
    184 === 1.5 WFDEI_CRU === 
    185  
    186 This data corresponds to the one described in the publication Weedon et al. 2014 (http://onlinelibrary.wiley.com/doi/10.1002/2014WR015638/abstract) 
    187  
     194=== 1.5 WFD_CRU === 
     195 
     196This data corresponds to the one described in the publication Weedon et al. 2011 (http://journals.ametsoc.org/doi/abs/10.1175/2011JHM1369.1) 
     197 
     198|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     199|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     200|| WFD_CRU_yyyy.nc || WFD_CRU || -180:180; -90:90 || 720x360 || 1901 || 2001 || 1000 || 3H || || 14 Nov 2014|| || 592 GB || 
     201 
     202 
     203=== 1.6 WFDEI_CRU === 
     204  
     205This data corresponds to the one described in the publication Weedon et al. 2014 (http://onlinelibrary.wiley.com/doi/10.1002/2014WR015638/abstract). Compared to WFD, WFDEI offers values in the 21st century owing the ERA-Intermin reanalysis. 
    188206|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    189207|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    … …  
    192210As this data is based on the ERA-I re-analysis the fluxes are cumulated over the 3h period preceding the time-stamp. All other variables are instantaneous at the given date. This is now properly described by the cell_method data in the netCDF file.  
    193211 
    194 === 1.6 WFD_CRU === 
    195  
    196 This data corresponds to the one described in the publication Weedon et al. 2011 (http://journals.ametsoc.org/doi/abs/10.1175/2011JHM1369.1) 
    197  
    198 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    199 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    200 || WFD_CRU_yyyy.nc || WFD_CRU || -180:180; -90:90 || 720x360 || 1901 || 2001 || 1000 || 3H || || 14 Nov 2014|| || 592 GB || 
    201  
    202212=== 1.7 WFDEI_GPCC === 
    203213 
    204 This is the same atmospheric forcing as the one described above except that rainfall is now corrected with the GPCC data : http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_windowLabel=T12404818261141645314319&_urlType=action&switchLang=en&_pageLabel=_dwdwww_klima_umwelt_datenzentren_wzn 
     214There are several versions of WFDEI_GPCC. 
     215 
     216==== WFDEI_GPCC ==== 
     217 
     218This is the same atmospheric forcing as the one described above (1.6 WFDEI_CRU) except that rainfall is now corrected with the GPCC data : http://www.dwd.de/bvbw/appmanager/bvbw/dwdwwwDesktop?_nfpb=true&_windowLabel=T12404818261141645314319&_urlType=action&switchLang=en&_pageLabel=_dwdwww_klima_umwelt_datenzentren_wzn 
    205219As this rainfall series is shorter, WFDEI_GPCC has fewer years than WFDEI_CRU. 
    206220 
    … …  
    209223|| WFDEI_GPCC_yyyy.nc || WFDEI_GPCC || -180:180; -90:90 || 720x360 || 1979 || 2010 || 32 || 3H || || 8 April 2015|| || 265 GB || 
    210224 
    211 === 1.8 ERA_05 === 
    212  
    213 This meteorological data set has been prepared by ECMWF in the framework of the Earth2Observe project : http://www.earth2observe.eu/ 
    214  
    215 Using a simple bi-linear interpolation the data of the ERA-I re-analysis on the Gaussian grid (N128) output was projected to a regular lat/lon grid at 0.5deg resolution, without special consideration for the land/sea mask. It was thus considered, in consultation with Emanuel Dutra of ECMWF, that it was not unreasonable to use the same land/sea mask as WFDEI and hope that the atmospheric forcing on coastal points will not be too badly affected by the methodology. 
    216  
    217 The value of this forcing lies in its close relation to the ERA-I re-analysis and its extension to December 2014. 
    218  
    219 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    220 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    221 || ERAI_yyyy.nc || ERAI_05 || -180:180; -90:90 || 720x360 || 1979 || 2014 || 36 || 3H || || 20 June 2015|| || 293 GB || 
    222  
    223  
    224 === 1.9 ERA_05_GPCP 
    225  
    226 This is the same forcing as ERA_05 except for the rainfall and snow fall from the re-analysis which were corrected with the GPCP estimates (http://precip.gsfc.nasa.gov/). 
    227  
    228 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    229 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    230 || ERAI_GPCP_yyyy.nc || ERAI_05_GPCP || -180:180; -90:90 || 720x360 || 1979 || 2014 || 36 || 3H || || 20 June 2015|| || 298 GB || 
    231  
    232 ==  2. Older Weather Data == 
    233  
    234 These forcing data sets have been superseded by more recent re-analysis of meteorological observations and more complete meta-data have been included in the forcing file.  
    235  
    236 === 2.1 ISLSCP === 
    237 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    238 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    239 || islscp_for_1987.nc || ||  -180:180; -90:90 || 360x179 || 1987 || 1987 || 1 ||  6H || || 28 jun 2005 || || 1.1 GB || 
    240  
    241 === 2.2 ISLSCP2 === 
    242 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    243 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    244 || islscp_for_yyyy.nc || ||  -180:180; -90:90 || 360x179 || 1982 || 1995 || 14 ||  3H (6H for 1982)  || || 28 jun 2005 ||  ||19 GB || 
    245  
    246 === 2.3 NCC === 
    247 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    248 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    249 || ncc_for_yyyy.nc || || -180:180; -90:90 || 360x180 || 1948 || 2000 || 52 || 6H  || [http://thanh.ngoduc.free.fr/wiki/index.php/Main/NCCDataset info]|| sept  2005 ||[http://www.agu.org/pubs/crossref/2005/2004JD005434.shtml ref] || 37 GB || 
    250  
    251 === 2.4 NLDAS === 
    252 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    253 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    254 || orchidee_NLDAS_forcing_yyyymm.nc || || -67:-24; 25:52 || 464x224 || 199701 || 200212 || 6 ||  1H  || || mai 2008 |||| 197 GB || 
    255  
    256 === 2.5 WFD3/annual  === 
    257 || Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    258 || Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    259 || WFD_yyyy.nc || || -180:180; -90:90 || 720x360 || 1958 || 2001 || 44 || 3H  || || april  2010 || || 300 GB || 
    260  
    261 === 2.6 WFDEI (WFDEI_GPCC/v1/noleap)  === 
     225==== WFDEI_GPCC/v1/noleap ==== 
     226 
     227This dataset is available in the shared accounts (IGCM/SRF/METEO directory).  
    262228|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    263229|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    264230|| WFDEI_GPCC_yyyy.nc || || -180:180; -90:90 || 720x300 || 1979 || 2009 || 31 || 3H || || 3 juin 2013|| || 182 GB || 
    265231 
    266 === 2.7 WFDEI_GPCC/v2/leap  === 
     232The old driver (dim2driver) needs a forcing that has its first record at 0 UTC, in addition to instanteaneous "scalars" and fluxes as mean(end), to work correctly. The original WFDEI starts at 3UTC, and to make it compatible with with dim2driver, a lag of 3 hours has been introduced by Ben Poulter and Fabienne Maignan. 
     233 
     234==== WFDEI_GPCC/v2/leap  ==== 
     235 
     236This dataset is available in the shared accounts (IGCM/SRF/METEO directory).  
    267237|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    268238|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    … …  
    270240NB: Year 2011 is incomplete. 
    271241 
    272 === 2.8 WG === 
     242The above shift has not been done here, and this forcing should only be used with the new driver (orchideedriver.f90). 
     243 
     244=== 1.8 Princeton Global Forcing (PGF) === 
     245 
     246This dataset is available in the shared accounts (IGCM/SRF/METEO/Princeton_GPCC/v1/1deg_3h directory).  
     247|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     248|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     249|| PGF_GPCC_1deg_3h_yyyy.nc || || -180:180; -90:90 || 360x180 || 1948 || 2010 || 63 || 3H || || 26 avril 2014|| || 265 GB || 
     250 
     251 
     252 
     253=== 1.9 ERA_05 === 
     254 
     255This meteorological data set has been prepared by ECMWF in the framework of the Earth2Observe project : http://www.earth2observe.eu/ 
     256 
     257Using a simple bi-linear interpolation the data of the ERA-I re-analysis on the Gaussian grid (N128) output was projected to a regular lat/lon grid at 0.5deg resolution, without special consideration for the land/sea mask. It was thus considered, in consultation with Emanuel Dutra of ECMWF, that it was not unreasonable to use the same land/sea mask as WFDEI and hope that the atmospheric forcing on coastal points will not be too badly affected by the methodology. 
     258 
     259The value of this forcing lies in its close relation to the ERA-I re-analysis and its extension to December 2014. 
     260 
     261|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     262|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     263|| ERAI_yyyy.nc || ERAI_05 || -180:180; -90:90 || 720x360 || 1979 || 2014 || 36 || 3H || || 20 June 2015|| || 293 GB || 
     264 
     265 
     266=== 1.10 ERA_05_GPCP 
     267 
     268This is the same forcing as ERA_05 except for the rainfall and snow fall from the re-analysis which were corrected with the GPCP estimates (http://precip.gsfc.nasa.gov/). 
     269 
     270|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     271|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     272|| ERAI_GPCP_yyyy.nc || ERAI_05_GPCP || -180:180; -90:90 || 720x360 || 1979 || 2014 || 36 || 3H || || 20 June 2015|| || 298 GB || 
     273 
     274=== 1.11 GSWP3  
     275 
     276This forcing has been constructed for the GSWP3 experiment, cf. http://hydro.iis.u-tokyo.ac.jp/GSWP3/exp1.html#boundary-conditions. It is based on the 20th Century Reanalysis (20CR) [Compo et al., 2011 http://hydro.iis.u-tokyo.ac.jp/GSWP3/refs.html#compo2011] at the global 2° resolution, dynamically downscaled into T248 (~0.5°). Several versions are available.  
     277 
     278==== GSWP3v0 (ISIMIP2) ==== 
     279 
     280This dataset is available on ergon in /arch/home/rech/lmd/rlmd979/GSWP3_forcing/halfdeg_v1. It was prepared by Jinfeng Chang for the ISIMIP2 simulations, using the TRENDY land mask. 
     281It was also upscaled at the 1° resolution by Matthieu Guimberteau for the ORCHIDEE-MICT paper (https://www.geosci-model-dev.net/11/121/2018/) 
     282 
     283|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     284|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     285||GSWP3_halfdeg_3h _yyyy.nc || GSWP3 || -180:180; -90:90 || 720x360 || 1901 || 2007 || 107 || 3H || || 24 April 2016|| || 5.5 GB/yr || 
     286 
     287==== GSWP3v1 ==== 
     288 
     289This is the official v1 release of GSWP3. It covers 1901-2010 and is dated on 2017-06-01. The original files are 2D, and only the wind is not worldwide and can serve as a land mask). 
     290This dataset needs to be formatted for ORCHIDEE for : 
     291- the LS3MIP off-line simulation (landhist at the resolution of the IPSL-CM6 climate model 144x143) 
     292- the SP-MIP simulations at the 0.5° 
     293 
     294==  2. Older Weather Data == 
     295 
     296These forcing data sets have been superseded by more recent re-analysis of meteorological observations and more complete meta-data have been included in the forcing file.  
     297 
     298=== 2.1 ISLSCP === 
     299|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     300|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     301|| islscp_for_1987.nc || ||  -180:180; -90:90 || 360x179 || 1987 || 1987 || 1 ||  6H || || 28 jun 2005 || || 1.1 GB || 
     302 
     303=== 2.2 ISLSCP2 === 
     304|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     305|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     306|| islscp_for_yyyy.nc || ||  -180:180; -90:90 || 360x179 || 1982 || 1995 || 14 ||  3H (6H for 1982)  || || 28 jun 2005 ||  ||19 GB || 
     307 
     308=== 2.3 NCC === 
     309|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     310|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     311|| ncc_for_yyyy.nc || || -180:180; -90:90 || 360x180 || 1948 || 2000 || 52 || 6H  || [http://thanh.ngoduc.free.fr/wiki/index.php/Main/NCCDataset info]|| sept  2005 ||[http://www.agu.org/pubs/crossref/2005/2004JD005434.shtml ref] || 37 GB || 
     312 
     313=== 2.4 NLDAS === 
     314|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     315|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     316|| orchidee_NLDAS_forcing_yyyymm.nc || || -67:-24; 25:52 || 464x224 || 199701 || 200212 || 6 ||  1H  || || mai 2008 |||| 197 GB || 
     317 
     318=== 2.5 WFD3/annual  === 
     319|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
     320|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
     321|| WFD_yyyy.nc || || -180:180; -90:90 || 720x360 || 1958 || 2001 || 44 || 3H  || || april  2010 || || 300 GB || 
     322 
     323=== 2.6 WG === 
    273324|| Name || || Spatial information || ||Temporal information || || || || Web documentation || || || Size || 
    274325|| Abbreviation || Full name || Coverage || Resolution || First year || Last year || Number of years || Resolution || Informations || Data download || References || GB || 
    … …  
    277328 
    278329 
    279 === 2.9 Scripts examples === 
    280  - FORTRAN 90 script to create a land points only forcing file (use of the compress attribute) [attachment:mk_grid.f90] 
     330