.TH "work_queue_graph_log" 1 "" "CCTools 7.1.2 FINAL" "Cooperative Computing Tools"

.SH NAME
.LP
\fBwork_queue_graph_log\fP - plots Work Queue statistics logs.

.SH SYNOPSIS
.LP
\FC\fBwork_queue_graph_log [options] work-queue-log\fP\FT

.SH DESCRIPTION
.LP

\fBwork_queue_graph_log\fP is a script to plot some of the statistics from a
Work Queue log, as generated by \FCwork_queue_specify_log\FT from the C and Perl Work Queue APIs, or by
\FCq.specify_log\FT from the Python Work Queue API. It assumes the availability of
\FCgnuplot\FT.

\fBwork_queue_graph_log\fP generates four plots, all with \FCtimestamp\FT as
the independent variable:

\FCtime\FT:
    timestamp, total_send_time, total_receive_time, total_transfer_time, and total_master_time. (The last two generated by the script, not in the log.)

\FCtime-log\FT:
    log-scale version of \FCtimes\FT, plus total_execute_time.

\FCtasks\FT:
    total_tasks_waiting, total_tasks_running, total_workers_connected, total_workers_busy, and total_cores

\FCtasks-log\FT:
    log-scale version of \FCtasks\FT, plus total_complete_tasks.

.SH OPTIONS
.LP
.LP
.TP
.BI \ -o \ <prefix-output>
.
Generate prefix-output.{time,time-log,tasks,tasks-log}.<output-format>. Default is <work-queue-log>.
.TP
.BI \ -c \ <gnuplot-path>
.
Specify the location of the gnuplot executable. Default is gnuplot.
.TP
.BI \ -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.
.TP
.BI \ -T \ <output-format>
.
Set output format. Default is png. If "text", then the gnuplot scripts are written instead of the images.
.TP
.BI \ -u \ <time-unit>
.
Time scale to output. One of s,m,h or d, for seconds, minutes (default), hours or days.
.TP
.B \ -h
.
Show help text.


.SH EXAMPLES
.LP

General use:

.fam C
.nf
.nh
.IP "" 8
% work_queue_graph_log mylog
% ls mylog*.png
mylog.tasks.png mylog.tasks-log.png mylog.time.png mylog.time-log.png
.fi
.hy
.fam
.P

Plot up to the eleventh hour:

.fam C
.nf
.nh
.IP "" 8
% work_queue_graph_log -u h -r :11 mylog

.fi
.hy
.fam
.P
Generate script text:

.fam C
.nf
.nh
.IP "" 8
% 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
.fi
.hy
.fam
.P

Specify gnuplot path:

.fam C
.nf
.nh
.IP "" 8
% work_queue_graph_log -c/some/dir/bin/gnuplot mylog
.fi
.hy
.fam
.P

.SH BUGS
.LP


.IP \(bu 4
Some formats need a special setup for their gnuplot output terminal. -T blindly passes the output format


.SH COPYRIGHT
.LP

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