automatic commit
[folded-ctf.git] / tools.h
diff --git a/tools.h b/tools.h
index 99b1ade..ddaa3dd 100644 (file)
--- a/tools.h
+++ b/tools.h
 // 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,