blah

glathoud · glathoud · commit d221e0beb66a · 2017-02-22T20:23:54.000+01:00
diff --git a/lib/fastmath2d.js b/lib/fastmath2d.js
@@ -27,7 +27,7 @@
 fm2d_unittest
 
 fm2d_flatmatmul_inplace_of_ijk
-fm2d_flatmat_mu_sigma
+fm2d_flatmat_mu_sigma_of_dim
 fm2d_flatmat_xmV_M_xmV_of_dim
 
 zz_fm2d_flatmatmul_inplace_of_ijk_abc
@@ -152,6 +152,12 @@ function fm2d_flatmatmul_inplace_of_ijk( /*integer*/I, /*integer*/J, /*integer*/
 }
 
 function fm2d_flatmat_mu_sigma_of_dim( /*integer*/dim )
+// Returns a function `f` that computes the mean vector and covariance
+// (flat)matrix of an array of vectors `v_arr`.
+//
+// The returned function `f` itself takes as input `v_arr`, and
+// optionally pre-allocated output arrays: `maybe_mu` & `maybe_sigma`,
+// both (Float64)Arrays of numbers.  Returned value : `{mu,sigma}`
 {
     if (!(dim in fm2d_flatmat_mu_sigma_of_dim))
         fm2d_flatmat_mu_sigma_of_dim[ dim ] = zz_fm2d_flatmat_mu_sigma_of_dim( dim );
diff --git a/lib/fastmath2d_speedtest.html b/lib/fastmath2d_speedtest.html
@@ -38,6 +38,17 @@
   <body>
     <h1>fastmath2d_speedtest</h1>
 
+    <section>
+      <p>
+        <emph>This page provides interactive speed tests for <code>fastmath2d.js</code>, a
+          library of fast math functions for 2-D&nbsp;matrices stored as
+          flat&nbsp;(1-D) arrays of numbers.</emph>
+      </p>
+
+      <p>[to the <a href="../index.html">main article</a>, to the GitHub file <a href="https://github.com/glathoud/flatorize/blob/master/lib/fastmath2d.js">flatmat2d.js</a>]
+      </p>
+    </section>
+
     <section>
       <p>Measure the speed of the in-place multiplication of two matrices.</p>
       <div>
@@ -91,7 +102,9 @@ <h1>fastmath2d_speedtest</h1>
     
     
     <section>
-        
+
+      <p>The source files used for the tests. Alternatively you can look at them on <a href="https://github.com/glathoud/flatorize/blob/master/lib/">GitHub</a>
+      
       <div class="shown">
 
         <span id="src_fastmath2d_speedtest">
@@ -100,7 +113,7 @@ <h1>fastmath2d_speedtest</h1>
         <button class="src-btn" onclick="this.parentNode.classList[this.parentNode.classList.contains('shown')?'remove':'add']('shown')"><span class="when_hidden">show</span><span class="when_shown">hide</span> source</button>
         
         <div class="when_shown">
-          <object class="codesource prettyprint lang-js" data="fastmath2d_speedtest.js" type="text/javascript" style="height:1500px;">
+          <object class="codesource prettyprint lang-js" data="fastmath2d_speedtest.js" type="text/javascript" style="height:3400px;">
             <a href="fastmath2d_speedtest.js">fastmath2d_speedtest.js</a>
           </object>
         </div>
@@ -117,7 +130,7 @@ <h1>fastmath2d_speedtest</h1>
         <button class="src-btn" onclick="this.parentNode.classList[this.parentNode.classList.contains('shown')?'remove':'add']('shown')"><span class="when_hidden">show</span><span class="when_shown">hide</span> source</button>
         
         <div class="when_shown">
-          <object class="codesource prettyprint lang-js" data="fastmath2d.js" type="text/javascript" style="height:3500px;">
+          <object class="codesource prettyprint lang-js" data="fastmath2d.js" type="text/javascript" style="height:5200px;">
             <a href="fastmath2d.js">fastmath2d.js</a>
           </object>
         </div>
