X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;f=tools.h;h=ddaa3dd472bd417a2671842f543058ca00ec2fd3;hb=3742a88173bc958488370aefb7035426d3650e1d;hp=ec35551e5ca62bcc715caf62eb663b3991e24e3f;hpb=d922ad61d35e9a6996730bec24b16f8bf7bc426c;p=folded-ctf.git

diff --git a/tools.h b/tools.h
index ec35551..ddaa3dd 100644
--- a/tools.h
+++ b/tools.h
@@ -12,16 +12,28 @@
 // You should have received a copy of the GNU General Public License     //
 // along with this program. If not, see <http://www.gnu.org/licenses/>.  //
 //                                                                       //
-// Written by Francois Fleuret, (C) IDIAP                                //
+// Written by Francois Fleuret                                           //
+// (C) Idiap Research Institute                                          //
+//                                                                       //
 // Contact <francois.fleuret@idiap.ch> for comments & bug reports        //
 ///////////////////////////////////////////////////////////////////////////
 
+/*
+
+  Two handy functions to sample in a very large weighted sample set,
+  and to generate a ROC curve given a very large sample set.
+
+ */
+
 #ifndef TOOLS_H
 #define TOOLS_H
 
 #include <iostream>
 #include "misc.h"
 
+// This function is not trivial because it has to handle numerical
+// pitfalls due to the very large number of samples.
+
 scalar_t robust_sampling(int nb, scalar_t *weights, int nb_to_sample, int *sampled);
 
 void print_roc_small_pos(ostream *out,