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


Ignore:
Timestamp:
Oct 3, 2008, 4:07:59 PM (16 years ago)
Author:
/C=IE/O=Grid-Ireland/OU=cs.tcd.ie/L=RA-TCD/CN=Stephen O. Childs
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Doc/compiler/scripts/BuildStats

    v1 v1  
     1{{{
     2#!html
     3
     4<h1 align=center>PANC&minus;BUILD&minus;STATS</h1>
     5<a href="#NAME">NAME</a><br>
     6<a href="#SYNOPSIS">SYNOPSIS</a><br>
     7<a href="#DESCRIPTION">DESCRIPTION</a><br>
     8<a href="#EXAMPLE">EXAMPLE</a><br>
     9<a href="#AUTHOR">AUTHOR</a><br>
     10
     11<hr>
     12<a name="NAME"></a>
     13<h2>NAME</h2>
     14<!-- INDENTATION -->
     15<table width="100%" border=0 rules="none" frame="void"
     16       cols="2" cellspacing="0" cellpadding="0">
     17<tr valign="top" align="left">
     18<td width="10%"></td>
     19<td width="89%">
     20<p>panc-build-stats.pl &minus; create a report of panc build
     21statistics</p>
     22</td>
     23</table>
     24<a name="SYNOPSIS"></a>
     25<h2>SYNOPSIS</h2>
     26<!-- INDENTATION -->
     27<table width="100%" border=0 rules="none" frame="void"
     28       cols="2" cellspacing="0" cellpadding="0">
     29<tr valign="top" align="left">
     30<td width="10%"></td>
     31<td width="89%">
     32<p><b>panc&minus;build&minus;stats.pl</b>
     33[<b>&minus;&minus;help</b>] {logfile}</p>
     34</td>
     35</table>
     36<a name="DESCRIPTION"></a>
     37<h2>DESCRIPTION</h2>
     38<!-- INDENTATION -->
     39<table width="100%" border=0 rules="none" frame="void"
     40       cols="2" cellspacing="0" cellpadding="0">
     41<tr valign="top" align="left">
     42<td width="10%"></td>
     43<td width="89%">
     44<p>The <b>panc&minus;build&minus;stats.pl</b> script will
     45analyze a panc log file and report build statistics. The
     46script takes the name of the log file as its only argument.
     47If no argument is given or the <b>&minus;&minus;help</b>
     48option is used, a short usage message is printed. <i>The log
     49file must have been created with &quot;task&quot; logging
     50enabled.</i></p>
     51<!-- INDENTATION -->
     52<p>The script will extract the time required to execute, to
     53set default values, to validate the configuration, to write
     54the XML file, and to write a dependency file. It will also
     55report the &quot;build&quot; time which is the time for
     56executing, setting defaults, and validating an object
     57file.</p>
     58<!-- INDENTATION -->
     59<p>The analysis is written to the standard output, but may
     60be saved in a file using standard IO stream redirection. The
     61format of the file is appropriate for the R statistical
     62analysis package, but should be trivial to import into excel
     63or any other analysis package.</p>
     64</td>
     65</table>
     66<a name="EXAMPLE"></a>
     67<h2>EXAMPLE</h2>
     68<!-- INDENTATION -->
     69<table width="100%" border=0 rules="none" frame="void"
     70       cols="2" cellspacing="0" cellpadding="0">
     71<tr valign="top" align="left">
     72<td width="10%"></td>
     73<td width="89%">
     74<p>If the output from the command is written to the file
     75build.txt, then the following R script will do a simple
     76analysis of the results. This will provide statistical
     77results on the various build phases and show histograms of
     78the distributions.</p>
     79</td>
     80</table>
     81<!-- INDENTATION -->
     82<table width="100%" border=0 rules="none" frame="void"
     83       cols="2" cellspacing="0" cellpadding="0">
     84<tr valign="top" align="left">
     85<td width="16%"></td>
     86<td width="83%">
     87<pre><small># R&minus;script for simple analysis of build report
     88bstats &lt;&minus;  read.table(&quot;build.txt&quot;)
     89attach(bstats)
     90summary(bstats)
     91hist(build, nclass=20)
     92hist(execute, nclass=20)
     93hist(execute, nclass=20)
     94hist(defaults, nclass=20)
     95hist(validation, nclass=20)
     96hist(xml, nclass=20)
     97hist(dep, nclass=20)
     98detach(bstats)
     99</small></pre>
     100</td>
     101</table>
     102<a name="AUTHOR"></a>
     103<h2>AUTHOR</h2>
     104<!-- INDENTATION -->
     105
     106<table width="100%" border=0 rules="none" frame="void"
     107       cols="2" cellspacing="0" cellpadding="0">
     108<tr valign="top" align="left">
     109<td width="10%"></td>
     110<td width="89%">
     111<p><b>Charles Loomis</b></p></td>
     112</table>
     113<!-- INDENTATION -->
     114<table width="100%" border=0 rules="none" frame="void"
     115       cols="2" cellspacing="0" cellpadding="0">
     116<tr valign="top" align="left">
     117<td width="16%"></td>
     118<td width="83%">
     119</table>
     120}}}