lpjml_image.conf(5)

NAME
lpjml_image.conf - Configuration file for LPJmL runs with IMAGE coupling

DESCRIPTION
The LPJmL configuration 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.

-DRIVER_ROUTING
    Simulation is performed with river routing. Input file for drainage has 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_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_IMAGE  /* Simulation type */
    RANDOM_PREC random seed (int)
    CLOUDINESS
    NO_FIRE | FIRE | SPITFIRE
    NO_FIREWOOD | FIREWOOD
    NO_POPULATION | POPULATION
    NO_DRAINAGE | DRAINAGE
    PERM | NO_PERM
    LANDUSE | CONST_LANDUSE
    NO_FIXED_SDATE | FIXED_SDATE
    NO_IRRIGATION | LIM_IRRIGATION | POT_IRRIGATION | ALL_IRRIGATION
    CONST_LAI_MAX | LAIMAX_INTERPOLATE | LAIMAX_CFT
    NO_RESOURCE | RESOURCE
    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)
    RAW|CLM|CLM2|CDF land use data filename (string)
    #ifdef READ_SDATES
    RAW|CLM|CLM2|CDF  sowing dates 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)
    TXT CO2 data filename (string)
    #ifdef ISRANDOM
    RAW|CLM|CLM2|CDF number of wet days filename (string)
    RAW|CLM|CLM2|CDF temperature variation data filename (string)
    RAW|CLM|CLM2|CDF precipitation variation data 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
    If daily output is set a CFT index must be included after the end of the output variable section:
    #ifdef DAILY_OUTPUT
    CFT 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)
    start of image coupling (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)

MG_VEGC
    managed vegetation carbon (gC/m2)

MG_SOILC
    managed soil carbon (gC/m2)

MG_LITC
    managed litter carbon (gC/m2)

APREC
    annual precipitation

INPUT_LAKE
    Lake influx

ADISCHARGE
    annual discharge (dm3/yr)

FLUX_ESTAB
    establishment flux

HARVEST
    harvest flux

DEFOREST_EMIS
    carbon emissions from deforested wood burnt (gC/m2)

PROD_TURNOVER
    carbon emissions from product turnover (gC/m2) in IMAGE coupling

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

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

MIRRIG
    monthly irrigation

MRETURN_FLOW_B
    monthly blue water

MEVAP_LAKE
    Lake evaporation

MFIREC
    Monthly fire counts

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)