         NAME
              lpjml.conf - Configuration file for LPJmL runs

         DESCRIPTION
              By default lpjml reads in the lpjml.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
              lpjml 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.

              -DWITH_LANDUSE[=mode]
                   Simulation is performed with managed land. Additional
                   parameter and input files have to be provided

              -DWITH_LAIMAX_CFT
                   Simulation with maximum LAI values for crops taken from
                   the management parameter file.

              -DWITH_SPITFIRE
                   Simulation with Spitfire fire model. Needs additional
                   input files.

              -DWITH_FIREWOOD
                   Simulation with wood fires. Needs population density
                   data file.

              -DWITH_RESERVOIRS
                   Simulation with dam reservoirs. Needs additional input
                   files for elevation and reservoirs.

              -DWITH_WATERUSE
                   Simulation is performed with water consumption for
                   industry, household and livestock.

              -DDAILY_OUTPUT
                   Daily output variables are written.

              -DWITH_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)
                   LPJML  /* Simulation type */
                   INTERPOLATE_PREC | RANDOM_PREC random seed (int)
                   CLOUDINESS | RADIATION | RADIATION_SWONLY | RADIATION_LWDOWN
                   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
                   NO_LANDUSE | LANDUSE | CONST_LANDUSE | ALL_CROPS
                                NO_FIXED_SDATE | FIXED_SDATE
                                NO_IRRIGATION | LIM_IRRIGATION | POT_IRRIGATION | ALL_IRRIGATION
                                CONST_LAI_MAX | LAIMAX_INTERPOLATE | LAIMAX_CFT
                                NO_RESERVOIR | RESERVOIR
                                NO_GRASS_FIXED_PFT | GRASS_FIXED_PFT
                   NO_WATERUSE | WATERUSE

              II. Input parameter section
                   LPJ, PFT and soil parameters are defined here. If land
                   use is enabled parameter file for management must be
                   also defined. 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), grid2clm (grid
                   coordinates) and cft2clm (land use data) command:

                   CDF variable (string) soilcode filename (string) | RAW|CLM|CLM2 soil filename (string)
                                                                      RAW|CLM|CLM2 coordinates filename (string)
                   #ifdef WITH_LANDUSE
                   RAW|CLM|CLM2 country and region code filename (string) | CDF variable (string) country code filename (string)
                                                                          | CDF variable (string) region code filename (string)
                   RAW|CLM|CLM2 land use data filename (string) | CDF variable (string) land use data filename (string)
                   #ifdef READ_SDATES
                   RAW|CLM|CLM2|CDF  sowing dates filename (string)
                   #endif
                   #ifdef WITH_FIXED_GRASS_PFT
                   RAW  grass fixed filename (string)
                   #endif
                   #ifdef WITH_GRASS_SCENARIOS
                   RAW|CLM|CLM2|CDF  grass harvest scenario filename (string)
                   #endif
                   #endif
                   #ifdef RIVER_ROUTING
                   RAW|CLM|CLM2|CDF lake fraction filename (string)
                   RAW|CLM river routing filename (string)
                   #ifdef WITH_LANDUSE
                   RAW|CLM|CLM2|CDF neighbor irrigation filename (string)
                   #ifdef WITH_RESERVOIRS
                   RAW|CLM|CLM2|CDF elevation filename (string)
                   RAW|CLM|CLM2 reservoir info filename (string)
                   #endif
                   #endif
                   #endif
                   RAW|CLM|CLM2|CDF temperature data filename (string)
                   RAW|CLM|CLM2|CDF precipitation data filename (string)
                   #ifdef USE_RADIATION
                   RAW|CLM|CLM2|CDF long wave net flux data filename (string)
                   RAW|CLM|CLM2|CDF short wave down flux data filename (string)
                   #else
                   RAW|CLM|CLM2|CDF cloudiness data filename (string)
                   #endif
                   #ifdef WITH_SPITFIRE
                   RAW|CLM|CLM2|CDF windspeed data filename (string)
                   RAW|CLM|CLM2|CDF temperature amplitude data filename (string) | CDF minimum temperature data filename  (string)
                                                                          CDF maximum temperature data filename (string)
                   RAW|CLM|CLM2|CDF lightning data filename (string)
                   RAW|CLM|CLM2|CDF human ignition data filename (string)
                   #endif
                   #if defined(WITH_SPITFIRE) || defined(WITH_FIREWOOD)
                   #endif
                   RAW|CLM|CLM2|CDF population density filename (string)
                   #ifdef USE_BURNTAREA
                   RAW|CLM|CLM2|CDF burnt area filename (string)
                   #endif
                   #ifdef USE_LANDCOVER
                   RAW|CLM|CLM2|CDF land cover filename (string)
                   #endif
                   TXT CO2 data filename (string)
                   #ifdef ISRANDOM
                   RAW|CLM|CLM2|CDF 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 RAW|TXT|CLM|CDF filename1 (string)
                   VARIABLE2 RAW|TXT|CLM|CDF filename2 (string)
                    ...
                   END

                   If daily output is set a PFT index must be included
                   after the end of the output variable section:

                   #ifdef DAILY_OUTPUT
                   PFT index (int)
                   DAILY_RAINFED|DAILY_IRRIG
                   #endif

              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 carbon emissions (gC/m2)

              FIREF
                fire frequency (1/yr)

              VEGC
                natural vegetation carbon (gC/m2)

              SOILC
                natural soil carbon (gC/m2)

              LITC
                natural litter carbon (gC/m2)

              MG_VEGC
                managed vegetation carbon (gC/m2)

              MG_SOILC
                managed soil carbon (gC/m2)

              MG_LITC
                managed litter carbon (gC/m2)

              APREC
                annual precipitation (mm)

              INPUT_LAKE
                Lake influx (hm3/yr)

              ADISCHARGE
                annual discharge (hm3/yr)

              FLUX_ESTAB
                establishment flux (gC/m2)

              HARVEST
                harvest flux (gC/m2)

              PFT_LITC
                PFT-specific litter carbon (gC/m2)

              MNPP
                monthly NPP (gC/m2}

              MGPP
                monthly GPP (gC/m2}

              D_NPP
                daily NPP (gC/m2}

              D_DAYLENGTH
                day length (h}

              MRH
                monthly respiration

              MTRANSP
                monthly transpiration (mm)

              MRUNOFF
                monthly runoff (mm)

              MDISCHARGE
                monthly discharge (hm3/d)

              MWATERAMOUNT
                mean monthly water amount (hm3)

              MEVAP
                monthly evaporation (mm)

              MINTERC
                monthly interception (mm)

              MSWC1
                monthly soil water layer 1

              MSWC2
                monthly soil water layer 2

              MIRRIG
                monthly irrigation (mm)

              MRETURN_FLOW_B
                monthly blue water (mm)

              MEVAP_LAKE
                Lake evaporation (mm)

              MFIREC
                Monthly fire carbon (gC/m2)

              MNFIRE

              Monthly fire

              MFIREDI
                Monthly fire danger index

              MFIREEMISSSION
                Monthly fire emissions

         D_GROWINGDAY, D_PVD, D_PHU, D_FPHU, D_LAIMAXAD, D_LAINPPDEF,
         D_HUSUM, D_VDSUM, D_WSCAL, D_NPP, D_GPP, D_RD, D_RROOT, D_RSO,
         D_RPOOL, D_GRESP, D_TRANS, D_EVAP, D_PREC, D_PERC, D_IRRIG, D_W0,
         D_W1, D_WEVAP, D_HI, D_FHIOPT, D_HIMIND, D_FROOT, D_TEMP, D_SUN,
         D_PAR, D_PET
              D_LAI, D_PHEN, D_CLEAF, D_CROOT, D_CSO, D_CPOOL, D_WDF,
                Daily output data.

         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) Jens Heinke
              (Jens.Heinke@pik-potsdam.de), Hester Biemans
              (Hester.Biemans@wur.nl), Kirsten Thonicke
              (Kirsten.Thonicke@pik-potsdam.de), Ursula Heyder
              (Ursula.Heyder@pik-potsdam.de),

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