From: Francois Fleuret <francois@fleuret.org>
Date: Mon, 29 Jun 2020 21:30:01 +0000 (+0200)
Subject: Added REAME.md
X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=commitdiff_plain;h=710261483c33cac17ebe246c3092ea52e883c1a3;p=svrt.git

Added REAME.md
---

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2b12c06
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# Introduction
+
+[`Don Geman`](http://www.cis.jhu.edu/faculty/cvs/geman/) and I
+developed a series of synthetic image recognition problems which
+require to go beyond local descriptors and simple statistics of the
+image to be solved properly, and that we used to compare humans and
+machine-learning
+([`Fleuret et al. 2011b`](publications.html#fleuret-et-al-2011b)).
+
+This software should compile on any standard GNU/Linux machine, and
+UNIX machine in general. It only requires the jpeg and png library.
+
+To test it on a list of problems, just run the script `doit.sh` with
+the problem numbers as arguments. For instance:
+
+```
+./doit.sh 1 2 3
+```
+
+It will compile the source and run the executable on the specified
+problems to generate sample images and test a Boosted classifier. If
+no argument is given, it will run on all the problems by default.