lpjliveview.1
NAME
lpjliveview - Graphical live view of a LPJmL simulation
SYNOPSIS
lpjliveview [-output socket=:port] [-outpath dir] [-inpath
dir] [[-Dmacro[=value]] [-Idir] ...] [filename [-display
disp] [-step n] [-scale min max] [variable]]
DESCRIPTION
Program display a global map for output variables of a LPJmL
simulation run on a X11 window. Data sent from lpjml is also
stored in files as specified in the LPJmL configuration
file. After the last simulation year has been shown all
years are displayed repeatedly until a key is pressed. lpjml
must be started with '-output socket=hostname' option to
enable a connection with lpjliveview running on host
hostname.
OPTIONS
-output socket=:port
set the port of the TCP/IP connection where the program
listens. Default value is 2222. Be sure to configure
the firewall appropriately.
-outpath dir
set the output directory path. The path is added to the
output filenames if they do not contain an absolute
path.
-inpath dir
set the input directory path. The path is added to the
input filenames if they do not contain an absolute
path.
-Dmacro[=value]
define macro for the preprocessor of the configuration
file
-Idir
define include directory for the preprocessor of the
configuration file
filename
name of configuration file, default is lpjml.conf.
-display disp
Set X11 display.
-step n
Set number of colors in output.
-scale min max
Set scaling of output data.
variable
Select output variable. Valid variables are firec,
firef, vegc, soilc, litc,mg_vegc, mg_soilc, mg_litc,
aprec, input_lake, adischarge, flux_estab, harvest,
prod_turnover, deforest_emis, mnpp, d_npp, mrh,
mtransp, mrunoff, mdischarge, mevap, minterc, mswc1,
mswc2, mirrig, mreturn_flow_b, mevap_lake, 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_lainppdeficit, 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_hiopt, d_himind, d_froot, d_temp,
d_sun, d_par, d_daylength, d_pet. Default is vegc.
EXAMPLES
results for vegetation carbon on host aix:
Start simulation on compute cluster with 128 tasks and view
lpjliveview -DFROM_RESTART &
lpjsubmit 128 -output socket=aix -DFROM_RESTART
ENVIRONMENT
LPJCONFIG
default LPJmL configuration filename
LPJPREP
defines preprocessor command for LPJmL configuration
file, default is cpp -P.
LPJROOT
defines the root directory for LPJmL. This directory is
added to the include directories of the preprocessor
LPJOUTPUT
set port of TCP/IP connection.
LPJINPATH
Path appended to the input filenames. Only done for
filenames without absolute path.
LPJOPTIONS
runtime options for the preprocessor of LPJmL
configuration files
LPJOUTPATH
Path appended to the output filenames. Only done for
filenames without absolute path.
EXIT STATUS
lpjliveview returns a zero exit status if the output has
been displayed and the output files have been created. Non
zero is returned in case of failure.
AUTHOR
Werner von Bloh (Werner.von.Bloh@pik-potsdam.de)
SEE ALSO
lpjml(1), lpj(1), lpjml.conf(5)
Man(1) output converted with
man2html