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


Ignore:
Timestamp:
2020-02-28T12:08:33+01:00 (4 years ago)
Author:
luyssaert
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/UserGuide/AddNewInputFiles

    v2 v3  
    11= How to tell libIGCM to copy a new input file for ORCHIDEE = 
    2 This page describes where you had to add the information so that libIGCM will copy a new input file of ORCHIDEE. 
     2 
     3Authors: D. Goll and J. Ghattas [[BR]]  
     4Last revision: 2020/02/28, S. Luyssaert [[BR]]  
     5 
     6== Objective == 
     7This help you to: (1) understand why libIGCM is used pass input files and ORCHIDEE and (2) how new input files can be passed to ORCHIDEE by making use of libIGCM. 
     8 
     9== Why using libIGCM for passing files == 
     10The ORCHIDEE code makes use of hard coded file names. Somewhere in the code, for example, there is the instruction to open the file PFTmap.nc which contains a description of the vegetation classified in PFTs for which the ORCHIDEE model was parameterized. When the experiment was configured to simulate land cover change, each year the model will have to read a different file despite it has to be called PFTmap.nc for the ORCHIDEE code to work. This is one of the tasks of libIGCM; if the model is in the year 1901, it will link the path of a PFT map for the year 1901 to the name PFTmap.nc. So, in the year 1901 ORCHIDEE will link the name PFTmap.nc to the PFT map for that year. Depending on the experiment one has in the mind, some input files only need to be read once at the start of the experiment, other need to be read every year, etc. As explained below, libIGCM can take care of this complexity.[[BR]]   
     11 
     12== Passing input files to ORCHIDEE ==  
     13=== Using libIGCM === 
     14 
    315Read more about setting up an experiment in [http://forge.ipsl.jussieu.fr/igcmg_doc/wiki/DocEsetupthe igmcg_doc chapter Setup].  
    416 
     
    3749 
    3850Modify sechiba.card and stomate.card as described above. 
     51 
     52=== Alternatives === 
     53In specific cases (i.e., hard core debugging) it could be useful to bypass libIGCM. For most input files this is possible because the file name can also be read from the run.def or orchidee.def files. This is, however, not recommended for any simulations passed the debug stage.