wiki:Doc/compiler/scripts/CompileStats

Version 1 (modified by /C=IE/O=Grid-Ireland/OU=cs.tcd.ie/L=RA-TCD/CN=Stephen O. Childs, 16 years ago) (diff)

--

<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>