plucky (1) work_queue_graph_log.1.gz

NAME

       work_queue_graph_log - plots Work Queue statistics logs.

SYNOPSIS

       work_queue_graph_log [options] work-queue-log

DESCRIPTION

       work_queue_graph_log  is  a  script to plot some of the statistics from a Work Queue log, as generated by
       work_queue_specify_log from the C and Perl Work Queue APIs, or by  q.specify_log  from  the  Python  Work
       Queue API. It assumes the availability of gnuplot.

       work_queue_graph_log generates four plots, all with timestamp as the independent variable:

       time:
           timestamp,  total_send_time,  total_receive_time,  total_transfer_time,  and total_manager_time. (The
       last two generated by the script, not in the log.)

       time-log:
           log-scale version of times, plus total_execute_time.

       tasks:
           total_tasks_waiting,   total_tasks_running,    total_workers_connected,    total_workers_busy,    and
       total_cores

       tasks-log:
           log-scale version of tasks, plus total_complete_tasks.

OPTIONS

        -o <prefix-output>
              Generate  prefix-output.{time,time-log,tasks,tasks-log}.<output-format>.  Default  is <work-queue-
              log>.

        -o <prefix-output>
              Generate prefix-output.{time,time-log,tasks,tasks-log}.<output-format>.  Default  is  <work-queue-
              log>.

        -c <gnuplot-path>
              Specify the location of the gnuplot executable. Default is gnuplot.

        -r <range>
              Range  of  time to plot, in time units (see -u) from the start of execution. Of the form: min:max,
              min:, or :max.

        -T <output-format>
              Set output format. Default is png. If "text", then the gnuplot scripts are written instead of  the
              images.

        -u <time-unit>
              Time scale to output. One of s,m,h or d, for seconds, minutes (default), hours or days.

        -h    Show help text.

EXAMPLES

       General use:

               % work_queue_graph_log mylog
               % ls mylog*.png
               mylog.tasks.png mylog.tasks-log.png mylog.time.png mylog.time-log.png

       Plot up to the eleventh hour:

               % work_queue_graph_log -u h -r :11 mylog

       Generate script text:

               % work_queue_graph_log -Ttext mylog
               % ls mylog*.gnuplot
               mylog.tasks.png.gnuplot mylog.tasks-log.png.gnuplot mylog.time.png.gnuplot mylog.time-log.png.gnuplot

       Specify gnuplot path:

               % work_queue_graph_log -c/some/dir/bin/gnuplot mylog

BUGS

       •   Some  formats  need  a  special setup for their gnuplot output terminal. -T blindly passes the output
           format

COPYRIGHT

       The Cooperative Computing Tools are Copyright (C) 2022 The University of Notre Dame.   This  software  is
       distributed under the GNU General Public License.  See the file COPYING for details.