# 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)