Changes between Initial Version and Version 1 of Doc/compiler/scripts/CompileStats

Timestamp:

Oct 3, 2008, 4:12:40 PM (16 years ago)

Author:

/C=IE/O=Grid-Ireland/OU=cs.tcd.ie/L=RA-TCD/CN=Stephen O. Childs

Comment:

--

Doc/compiler/scripts/CompileStats

@@ +1 @@
+<h1>PANC&minus;COMPILE&minus;STATS</h1>
+<a href="#NAME">NAME</a><br>
+<a href="#SYNOPSIS">SYNOPSIS</a><br>
+<a href="#DESCRIPTION">DESCRIPTION</a><br>
+<a href="#EXAMPLE">EXAMPLE</a><br>
+<a href="#AUTHOR">AUTHOR</a><br>
+
+<hr>
+<a name="NAME"></a>
+<h2>NAME</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p>panc-compile-stats.pl &minus; create a report of panc
+compilation statistics</p>
+</td>
+</table>
+<a name="SYNOPSIS"></a>
+<h2>SYNOPSIS</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p><b>panc&minus;compile&minus;stats.pl</b>
+[<b>&minus;&minus;help</b>] {logfile}</p>
+</td>
+</table>
+<a name="DESCRIPTION"></a>
+<h2>DESCRIPTION</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p>The <b>panc&minus;compile&minus;stats.pl</b> script will
+analyze a panc log file and report compilation statistics.
+The script takes the name of the log file as its only
+argument. If no argument is given or the
+<b>&minus;&minus;help</b> option is used, a short usage
+message is printed. <i>The log file must have been created
+with &quot;task&quot; logging enabled.</i></p>
+<!-- INDENTATION -->
+<p>The script will extract the start time of each
+compilation and its duration. This compilation is the time
+to parse a template file and create the internal
+representation of the template. The analysis is written to
+the standard output, but may be saved in a file using
+standard IO stream redirection. The format of the file is
+appropriate for the R statistical analysis package, but
+should be trivial to import into excel or any other analysis
+package.</p>
+</td>
+</table>
+<a name="EXAMPLE"></a>
+<h2>EXAMPLE</h2>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p>If the output from the command is written to the file
+compile.txt, then the following R script will create a
+&quot;high&minus;density&quot; plot of the information. This
+graph shows a vertical line for each compilation, where the
+horizontal location is related to the start time and the
+height of the line the duration.</p>
+</td>
+</table>
+<!-- INDENTATION -->
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="16%"></td>
+<td width="83%">
+<pre><small># R&minus;script for simple analysis of compile report
+cstats &lt;&minus;  read.table(&quot;compile.txt&quot;)
+attach(cstats)
+plot(start/1000, duration, type=&quot;h&quot;, xlab=&quot;time (s)&quot;, ylab=&quot;duration (ms)&quot;)
+detach(cstats)
+</small></pre>
+</td>
+</table>
+<a name="AUTHOR"></a>
+<h2>AUTHOR</h2>
+<!-- INDENTATION -->
+
+<table width="100%" border=0 rules="none" frame="void"
+       cols="2" cellspacing="0" cellpadding="0">
+<tr valign="top" align="left">
+<td width="10%"></td>
+<td width="89%">
+<p><b>Charles Loomis</b></p></td>
+</table>