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
          For authors and contributors see AUTHORS file


     COPYRIGHT
          (C) Potsdam Institute for Climate Impact Research (PIK), see
          COPYRIGHT file


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