Changes between Version 2 and Version 3 of Documentation/UserGuide/ReadingPFTmap


Ignore:
Timestamp:
2015-05-31T14:39:12+02:00 (9 years ago)
Author:
jgipsl
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentation/UserGuide/ReadingPFTmap

    v2 v3  
    22J. Ghattas 29mai 2015 
    33 
    4 == How it works in ORCHIDEE trunk since revision 27xx == 
     4== How it works in ORCHIDEE trunk since revision 2718 == 
    55Following parameters are related to the vegetation map and can be set in run.def: 
    66 
    7  * MAP_PFT_FORMAT = y/n  : ''Old name for MAP_PFT_FORMAT was LAND_USE.'' 
     7 * '''MAP_PFT_FORMAT''' = y/n  : ''Old name for MAP_PFT_FORMAT was LAND_USE.'' 
    88   * MAP_PFT_FORMAT = y(default) : The vegetation will be initialized reading a netcdf file on PFT format, PFTmap.nc. Same number of PFTs must be found in the file as used during run time. It is possible to use another file name using the parameter VEGETATION_FILE.  
    99   * MAP_PFT_FORMAT = n : The vegetation will be initialized by reading a OLSON type vegetation file. The default netcdf file is carteveg5km.nc. The file name can be changed using the parameter VEGETATION_FILE. No change in vegetation can be done using this file format. 
    1010 
    11  * VEGET_UPDATE = xY : update the vegetation every x years 
     11 * '''VEGET_UPDATE''' = xY : update the vegetation every x years 
    1212   * VEGET_UPDATE = 0Y(default) : no change in vegetation. PFTmap.nc is read only if starting without restart files. 
    1313   * VEGET_UPDATE = 1Y : update the vegetation in the beginning of each year. The netcdf file PFTmap.nc corresponding to the current year of simulation must be available.  
    1414   * VEGET_UPDATE > 1Y : update only at a certain frequency 
    1515 
    16  * VEGET_REINIT and VEGET_YEAR control parameters for the year to be read. These parameters are only neede for the special case if VEGET_UPDATE > 1Y. 
     16 * '''VEGET_REINIT''' and '''VEGET_YEAR''' are control parameters for the year to be read. These parameters are only needed for the special case if VEGET_UPDATE > 1Y. 
    1717   
    18 === How to set up a simulation === 
    19 * Case without land use change, VEGET_UPDATE=0Y, set in sechiba.card (offline simulation) or orchidee.card(coupled simulation) : 
     18'''How to set up a simulation'''[[BR]] 
     19 
     20Only the parameter VEGET_UPDATE needs to be set corresponding to the simulation. MAP_PFT_FORMAT keeps it's default value. 
     21 
     22* Case without land use change, set in sechiba.card (offline simulation) or orchidee.card(coupled simulation) : 
    2023    * VEGET_UPDATE=0Y in section [!UserChoices]    
    2124    * PFTmap.nc should be set only in List in section [!InitialStateFiles] 
    … …  
    2528}}} 
    2629 
    27 * Case with land use change, VEGET_UPDATE=1Y, set in sechiba.card (offline simulation) or orchidee.card(coupled simulation) : 
     30* Case with annual land use change, set in sechiba.card (offline simulation) or orchidee.card(coupled simulation) : 
    2831    * VEGET_UPDATE=1Y in section [!UserChoices]    
    2932    * PFTmap.nc should not be added in section [!InitialStateFiles] 
    30     * PFTmap.nc should be set in [!BoundaryFiles]/List using the variable $year. For simulations with !PeriodLenght=1M to optimize the copy of files, section !SmoothFiles can be used. But the syntax is more complex and it is not recommended.  
     33    * PFTmap.nc should only be set in [!BoundaryFiles]/List using the variable $year. For simulations with !PeriodLenght=1M to optimize the copy of files, section !SmoothFiles can be used. But the syntax is more complex and it is not recommended.  
    3134{{{ 
    3235[BoundaryFiles] 
    … …  
    3437}}}  
    3538     
    36 For both cases LAND_COVER_CHANGE can be removed for [!UserChoices] section. 
     39For both cases LAND_COVER_CHANGE can be removed for [!UserChoices] section. This parameter does not exist any more so it does not matter if it is kept or removed. 
    3740 
     41== How it works in ORCHIDEE trunk older revisions, branches and tags == 
     42 
     43Related parameters :  
     44* '''LAND_USE''' = y / n: old name for MAP_PFT_FORMAT 
     45  * LAND_USE = y(default) : read vegetation map on PFT format.  
     46  * LAND_USE = n read vegetation map on Olson format.  
     47* '''LAND_COVER_CHANGE''' = y / n : Activate stomate_lcchange calculations. Only possible if VEGET_UPDATE>0Y.  
     48* '''VEGET_UPDATE''', '''VEGET_REINIT''' and '''VEGET_YEAR''': same behaviour as in recent versions, see above 
     49  
     50 
     51 
     52'''How to set up a simulation '''[[BR]] 
     53 
     54* Case without land use change, set in sechiba.card (offline simulation) or orchidee.card(coupled simulation) : 
     55    * VEGET_UPDATE=0Y in section [!UserChoices]    
     56    * LAND_COVER_CHANGE=n in section [!UserChoices] 
     57    * PFTmap.nc should be set only in List in section [!InitialStateFiles] 
     58{{{ 
     59[InitialStateFiles] 
     60List=   (${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year}.nc, PFTmap.nc) 
     61}}} 
     62 
     63* Case with annual land use change, set in sechiba.card (offline simulation) or orchidee.card(coupled simulation) : 
     64 * Case 1) Simulations with !PeriodLength=1Y 
     65    * VEGET_UPDATE=1Y in section [!UserChoices]    
     66    * LAND_COVER_CHANGE=y in section [!UserChoices] 
     67    * PFTmap.nc should not be added in section [!InitialStateFiles] 
     68    * PFTmap.nc should only be set in [!BoundaryFiles]/List using the variable ${year_p1} for next coming year.   
     69{{{ 
     70[BoundaryFiles] 
     71List=(${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year_p1}.nc, PFTmap.nc) 
     72}}}  
     73 * Case 2) Simulations with !PeriodLength=1M 
     74    * VEGET_UPDATE=1Y in section [!UserChoices]    
     75    * LAND_COVER_CHANGE=y in section [!UserChoices] 
     76    * PFTmap.nc is kept in section [!InitialStateFiles] : this file is used for the first year if no restart files were used.  
     77    * PFTmap.nc is also added in section Smoothfiles using the variable ${year_p1} and the syntax 12:12:. This is done to copy the files in December each year : copy the file starting the 12'th period and updating it every 12 period. For this case it is important to always start the simulation in January. For other options, set up the as for 1Y. 
     78  {{{ 
     79[InitialStateFiles] 
     80List=   (${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year}.nc, PFTmap.nc) 
     81... 
     82[SmoothFiles] 
     83List=(${R_BC}/SRF/${config_UserChoices_TagName}/PFTmap_1850to2005_AR5_LUHa.rc2/PFTmap_IPCC_${year_p1}.nc, PFTmap.nc, 12:12:) 
     84}}} 
     85