         NAME
              lpj.conf - Configuration file for LPJmL runs with natural
              vegetation

         DESCRIPTION
              By default lpj reads in the lpj.conf file. This file is
              preprocessed by the cpp processor. The type of simulation
              can be changed by defining macros as runtime options of the
              lpj command.

            Macro definitions
              -DFROM_RESTART
                   Simulation is started from a restart file.

              -DISRANDOM
                   A random precipitation generator is used. The number of
                   wet days in a month is used as an additional input
                   variable

              -DRIVER_ROUTING
                   Simulation is performed with river routing. Input file
                   for drainage has to be provided.

              -WITH_GRIDBASED
                   PFT-specific output is grid scaled.

            File structure
              The LPJmL configuration file contains integer, float, and
              string values. Strings containing white spaces must be
              delimited by '"'. The file include/conf.h has to be included
              for the definition of symbols.  The file is divided into
              five different sections:

              I. Simulation description and type section
                   The first two entries describe the simulation and its
                   type:

                   #include "include/conf.h"
                   Simulation description string (string)
                   LPJ  /* Simulation type with natural vegetation */
                   INTERPOLATE_PREC | RANDOM_PREC random seed (int)
                   CLOUDINESS | RADIATION | RADIATION_SWONLY | RADIATION_LWDOWN
                   NO_FIRE | FIRE
                   NO_FIRE | FIRE | SPITFIRE
                   NO_FIREWOOD | FIREWOOD
                   NO_POPULATION | POPULATION
                   NO_PRESCIBE_BURNTAREA | PRESCRIBE_BURNTAREA
                   NO_LANDCOVER | LANDCOVERFPC
                   OLD_PHENOLOGY | NEW_PHENOLOGY
                   NO_DRAINAGE | DRAINAGE
                   PERM | NO_PERM

              II. Input parameter section
                   PFT and soil parameters are defined here. They are
                   included from the $LPJROOT/par directory:
                   #include "param.conf"

              III. Input data section
                   This section contains filenames of the climate, land
                   use, and  river routing data. Data file have to be in
                   the clm data format and are created from binary files
                   by the cru2clm (climate data) and grid2clm (grid
                   coordinates) command:

                   grid coordinates filename (string)
                   soilcode filename (string)
                   #ifdef RIVER_ROUTING
                   lake fraction filename (string)
                   river routing filename (string)
                   #endif
                   temperature data filename (string)
                   precipitation data filename (string)
                   cloudiness data filename (string)
                   CO2 date filename (string)
                   #ifdef ISRANDOM
                   number of wet days filename (string)
                   #endif

              IV. Output data section
                   Output variables are defined in the output section of
                   then LPJmL configuration file. Definition has to be in
                   the format

                   GRIDBASED|PFTBASED
                   VARIABLE1 filename1 (string)
                   VARIABLE2 filename2 (string)
                    ...
                   END

              V. Run settings section
                   In the last section the first grid cell and the number
                   of grid cells have to be specified as well as the first
                   and last simulation year:

                   ALL | index of first cell (int) index of last years (int)
                   0 | Number of spinup years (int) cycle length during spinup (int)
                   first year of simulation (int)
                   last year of simulation (int)
                   NO_RESTART | RESTART restart filename  (string)
                   NO_RESTART | RESTART restart filename (string) year file is written (int)

            Output variables
              The following variables are defined:
              FIREC
                fire count

              FIREF
                fire fraction

              VEGC
                natural vegetation carbon (gC/m2)

              SOILC
                natural soil carbon (gC/m2)

              LITC
                natural litter carbon (gC/m2)

              APREC
                annual precipitation

              INPUT_LAKE
                Lake influx

              ADISCHARGE
                annual discharge (dm3/yr)

              MNPP
                monthly NPP (gC/m2}

              MGPP
                monthly GPP (gC/m2}

              MRH
                monthly respiration

              MTRANSP
                monthly transpiration

              MRUNOFF
                monthly runoff

              MDISCHARGE
                monthly discharge (hm3/d)

              MWATERAMOUNT
                mean monthly water amount (hm3)

              MEVAP
                monthly evaporation

              MINTERC
                monthly interception

              MSWC1
                monthly soil water layer 1

              MSWC2
                monthly soil water layer 2

              MEVAP_LAKE
                Lake evaporation

         AUTHORS
              Werner von Bloh (Werner.von.Bloh@pik-potsdam.de), Sibyll
              Schaphoff (Sibyll.Schaphoff@pik-potsdam.de), Stefanie Rost
              (Jachner) (Stefanie.Rost@pik-potsdam.de), Marlies
              Gumpenberger (Marlies.Gumpenberger@pik-potsdam.de), Tim
              Beringer (Erbrecht) (Tim.Beringer@pik-potsdam.de), Christoph
              Mueller (Christoph.Mueller@pik-potsdam.de)

         SEE ALSO
              lpj(1), lpjml(1), cru2clm(1), grid2clm(1), clm(5),
              lpjml.conf(5)