From f4b74fe29d81952139cfa62eccfb25bcee8b6e4d Mon Sep 17 00:00:00 2001
From: David Warde-Farley <wardefar@iro.umontreal.ca>
Date: Sat, 16 Jul 2011 14:46:57 -0500
Subject: [PATCH] Documentation for the Olivetti Faces dataset.

---
 doc/datasets/olivetti_faces.rst | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 doc/datasets/olivetti_faces.rst

diff --git a/doc/datasets/olivetti_faces.rst b/doc/datasets/olivetti_faces.rst
new file mode 100644
index 0000000000..b9dbbc028f
--- /dev/null
+++ b/doc/datasets/olivetti_faces.rst
@@ -0,0 +1,33 @@
+The Olivetti faces dataset
+==========================
+
+
+This dataset contains a set of face images taken between April 1992 and April
+1994 at AT&T Laboratories Cambridge. The website describing the original
+dataset is now defunct, but archived copies can be accessed through
+`the Internet Archive's Wayback Machine`_.
+
+.. _the Internet Archive's Wayback Machine: http://wayback.archive.org/web/*/http://www.uk.research.att.com/facedatabase.html
+
+As described on the original website:
+
+    There are ten different images of each of 40 distinct subjects. For some
+    subjects, the images were taken at different times, varying the lighting,
+    facial expressions (open / closed eyes, smiling / not smiling) and facial
+    details (glasses / no glasses). All the images were taken against a dark
+    homogeneous background with the subjects in an upright, frontal position (with
+    tolerance for some side movement).
+
+The image is quantized to 256 grey levels and stored as unsigned 8-bit integers;
+the loader will convert these to floating point values on the interval [0, 1],
+which are easier to work with for many algorithms.
+
+The "target" for this database is an integer from 0 to 39 indicating the
+identity of the person pictured; however, with only 10 examples per class, this
+relatively small dataset is more interesting from an unsupervised or
+semi-supervised perspective.
+
+The original dataset consisted of 92 x 112, while the version available here
+consists of 64x64 images.
+
+When using these images, please give credit to AT&T Laboratories Cambridge.
-- 
GitLab