Changes between Version 4 and Version 5 of Tags/196/ExternalisationParameters

Timestamp:

2011-03-18T14:25:59+01:00 (13 years ago)

Author:

dsolyga

Comment:

--

Tags/196/ExternalisationParameters

@@ -27 +27 @@
 With this version, the user has the possibility to choose a number of PFTs between 2 and X (X is any number, but
 a max value could be 94, corresponding to the Olson classification) and to change the values of less or more 300
-new parameters (plus the already externalized ones in the AR5).[[BR]]
+new parameters in the run.def file (plus the already externalized ones in the AR5).[[BR]]
 
 
@@ -34 +34 @@
 How did we solve the problems outlined in the section "What a new version of ORCHIDEE?" ? [[BR]]
 We use an formal concept called Metaclass(MTC in the following) based on an idea of N.Viovy.[[BR]]
+Before to detail the concept, let's take a problem we can solve with the MTCs .
+
+=== A small problem === 
+Let's suppose you want to represent two types of tree. These trees are the same PFT (PFT 6 for example).[[BR]]
+
+These two species differ from the parameter VCMAX_OPT (15 and 25 for example). We will that this kind of problem
+can be easily solved by the MTCs.
 
 === What is a Metaclass? ===
 
-It consists of an overlayer of the current PFTs. Here is the list of the MTCs implemented in the ORCHIDEE "externalizes" version : 
+It consists of an overlayer of the current PFTs. Here is the list of the MTCs implemented in the ORCHIDEE "externalized" version : 
+
+1. bare ground 
+
+2. tropical  broad-leaved evergreen 
+ 
+3. tropical  broad-leaved raingreen
+
+4. temperate needleleaf   evergreen 
+
+5. temperate broad-leaved evergreen 
+
+6. temperate broad-leaved summergreen
+
+7. boreal  needleleaf evergreen 
+
+8. boreal broad-leaved summergreen
+
+9. boreal needleleaf summergreen
+
+10. C3   grass
+
+11. C4   grass  
+
+12. C3   agriculture
+
+13. C4   agriculture
+
+Actually, the MTCs match exactly to the usual PFTs. We only decided to put a new name for them.[[BR]]
+We want to distinguish the floating number of PFTs from the fixed PFTs alias the MTCs. 
+
+=== How does it work? ===
+Basically, it will initialize all the pft-parameters by default values by linking a PFT to a MTC. [[BR]]
+When you associate a PFT to a MTC, the parameters from this PFT will be initialized automatically by pre-defined
+values. After that, you can impose any value you want for the parameters.[[BR]]
+
+=== Why using the MTC? ===
+We tried to make ORCHIDEE more user-friendly with this version. In the current version of the externalized version, there is
+approximatively 86 pfts-parameters of size 'nvm'. If the MTC didn't exist, the user has to fill the run.def file with 86*nvm
+values!
+
+=== Going back to our small problem ===
+
+Now, we can solve our problem with the externalized version. The first step is to declare nvm, the number of PFTs you will 
+consider for your job.[[BR]]
+
+{{{
+NVM = 14
+}}}
+
+Here we consider 14 PFTs for solving our problem.[[BR]]
+The second step is to fill an array called PFT_TO_MTC. PFT_TO_MTC is the correspondance table between PFT and MTC.
+{{{
+PFT_TO_MTC__01 = 1
+PFT_TO_MTC__02 = 2
+PFT_TO_MTC__03 = 3
+PFT_TO_MTC__04 = 4
+PFT_TO_MTC__05 = 5
+PFT_TO_MTC__06 = 6
+PFT_TO_MTC__07 = 7
+PFT_TO_MTC__08 = 8
+PFT_TO_MTC__09 = 9
+PFT_TO_MTC__10 = 10
+PFT_TO_MTC__11 = 11
+PFT_TO_MTC__12 = 12
+PFT_TO_MTC__13 = 13
+PFT_TO_MTC__14 = 6
+}}}
+
+
+Our first specie of tree is the PFT 6 and the second one, the PFT 14.[[BR]]
+
+They both belong to the MTC 6. The standard value for VCMAX for the MTC 6 is 15. [[BR]]
+
+Concerning the values of VCMAX_OPT for the PFTs 6 and 14, we simply have : [[BR]]
+
+{{{
+VCMAX_OPT__06 = 15
+VCMAX_OPT__14 = 15
+}}}
+
+But you would like to set 25 for the 14th PFT. For that, write in run.def :
+
+{{{
+VCMAX_OPT__14 = 25
+}}}
+
+To finish, launch your job. It's done. [[BR]]
+This example is only an overview of the possibilities of this version. You will
+find a user's guide here :
+
+UsersGuide
+
+
+
+== How to download it? ==
+
+To be continued. For the moment please have a look at the presentation of 31012011.
 
 
 
 
-=== How does it work? ===
-Basically, it will initialize all the pft-parameters by default values by linking a PFT to a MTC. 
 
-
+