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