lpjml.conf(5)

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