NAME

       Using - manual page for Using python version: 3.8.2 (default, Feb 25 2020, 13:04:52)

DESCRIPTION

       Using  python  version: 3.8.2 (default, Feb 25 2020, 13:04:52) [GCC 9.2.1 20200224] usage:
       yade-batch [options] [ TABLE [SIMULATION.py] | SIMULATION.py[/nCores] [...] ]

       yade-batch  runs  yade  simulation  multiple  times   with   different   parameters.   See
       https://yade-dem.org/sphinx/user.html#batch-queuing-and-execution-yade-batch  for details.
       Batch can be specified either with parameter table TABLE (must not end in .py),  which  is
       either followed by exactly one SIMULATION.py (must end in .py), or contains !SCRIPT column
       specifying the simulation to be run.  The second option is to  specify  multiple  scripts,
       which  can  optionally  have /nCores suffix to specify number of cores for that particular
       simulation (corresponds to !THREADS column in the parameter table), e.g. sim.py/3.

   optional arguments:
       -h, --help
              show this help message and exit

       -j NUM, --jobs NUM
              Maximum number of simultaneous threads to run (default: number  of  cores,  further
              limited by OMP_NUM_THREADS if set by the environment: 4)

       -v, --version
              Print version and exit.

       --job-threads NUM
              Default  number  of threads for one job; can be overridden by per-job with !THREADS
              (or !OMP_NUM_THREADS) column. Defaults to 1.

       --force-threads
              Force jobs to not use more cores than the  maximum  (see  \-j),  even  if  !THREADS
              colums specifies more.

       --log FORMAT
              Format of job log files: must contain a $, % or @, which will be replaced by script
              name, line number or by description column respectively (default: $.@.log)

       --global-log FILE
              Filename where to redirect output of yade-batch itself (as opposed to \-\-log);  if
              not specified (default), stdout/stderr are used

       -l LIST, --lines LIST
              Lines of TABLE to use, in the format 2,3-5,8,11-13 (default: all available lines in
              TABLE)

       --nice NICE
              Nice value of spawned jobs (default: 10)

       --cpu-affinity
              Bind each job to specific CPU cores; cores are assigned in  a  quasi-random  order,
              depending  on availability at the moment the jobs is started. Each job can override
              this setting by setting AFFINE column.

       --executable FILE
              Name        of         the         program         to         run         (default:
              /build/yadeZOjJOS/yade-2020.01a/debian/tmp/usr/bin/yade).  Jobs  can  override with
              !EXEC column.

       --gnuplot FILE
              Gnuplot file where gnuplot from all jobs should be put together

       --dry-run
              Do not actually run (useful for getting gnuplot only, for instance)

       --http-wait
              Do not quit if still serving overview over http repeatedly

       --plot-update TIME
              Interval (in seconds) at which job plots will be updated even if not requested  via
              HTTP.  Non-positive  values  will make the plots not being updated and saved unless
              requested via HTTP (see \-\-plot-timeout for controlling  maximum  age  of  those).
              Plots  are  saved  at  exit  under  the  same  name  as the log file, with the .log
              extension removed. (default: 120 seconds)

       --plot-timeout TIME
              Maximum age (in seconds) of plots served over HTTP; they will be  updated  if  they
              are older. (default: 30 seconds)

       --refresh TIME
              Refresh rate of automatically reloaded web pages (summary, logs, ...).

       --timing COUNT
              Repeat    each    job    COUNT    times,   and   output   a   simple   table   with
              average/variance/minimum/maximum job  duration;  used  for  measuring  how  various
              parameters  affect  execution  time.  Jobs  can  override the global value with the
              !COUNT column.

       --timing-output FILE
              With \-\-timing, save measured durations to FILE, instead of  writing  to  standard
              output.

       --randomize
              Randomize job order (within constraints given by assigned cores).

       --disable-pynotify
              Disable screen notifications

       -L IMPLIBRARIES, --libs IMPLIBRARIES
              import  libraries  at  startup  before  importing  yade  libs. May be used when the
              ordering of imports matter (see  e.g.  https://bugs.launchpad.net/yade/+bug/1183402
              /comments/3). The option can be used multiple times, as in "yade -Llib1 -Llib2"

       [GCC  9.2.1  20200224]  Yade  version: 2020.01a, features:  BoostLog Odeint VTK OpenMP GTS
       GUI-Qt5 CGAL PFVFLOW PFVFLOW LINSOLV MPI TWOPHASEFLOW SPH FEMLIKE  GL2PS  LBMFLOW  THERMAL
       PotentialParticles

SEE ALSO

       The full documentation for Using is maintained as a Texinfo manual.  If the info and Using
       programs are properly installed at your site, the command

              info Using

       should give you access to the complete manual.

Using python version: 3.8.2 (default, Feb 25March,202004:52)                             USING(1)