Update.
authorFrancois Fleuret <francois@fleuret.org>
Mon, 19 Jun 2017 12:28:07 +0000 (14:28 +0200)
committerFrancois Fleuret <francois@fleuret.org>
Mon, 19 Jun 2017 12:28:07 +0000 (14:28 +0200)
README.md

index 4efe67f..b6e29c7 100644 (file)
--- a/README.md
+++ b/README.md
@@ -4,23 +4,6 @@ This is a port of the Synthetic Visual Reasoning Test problems to the
 pytorch framework, with an implementation of two convolutional
 networks to solve them.
 
-The main function is
-
-```
-torch.ByteTensor svrt.generate_vignettes(int problem_number, torch.LongTensor labels)
-```
-
-where
-
- * `problem_number` indicates which of the 23 problem to use
- * `labels` indicates the boolean labels of the vignettes to generate
-
-The returned ByteTensor has three dimensions:
-
- * Vignette index
- * Pixel row
- * Pixel col
-
 # Installation and test #
 
 Executing
@@ -36,7 +19,41 @@ Note that the image generation does not take advantage of GPUs or
 multi-core, and can be as fast as 10,000 vignettes per second and as
 slow as 40 on a 4GHz i7-6700K.
 
-# Vignette compression #
+# Vignette generation and compression #
+
+## Vignette sets ##
+
+The svrtset.py implements the classes `VignetteSet` and
+`CompressedVignetteSet` with the following constructor
+
+```
+def __init__(self, problem_number, nb_samples, batch_size, cuda = False, logger = None):
+```
+
+and the following method to return one batch
+
+```
+def get_batch(self, b):
+```
+
+## Low-level functions ##
+
+The main function for genering vignettes is
+
+```
+torch.ByteTensor svrt.generate_vignettes(int problem_number, torch.LongTensor labels)
+```
+
+where
+
+ * `problem_number` indicates which of the 23 problem to use
+ * `labels` indicates the boolean labels of the vignettes to generate
+
+The returned ByteTensor has three dimensions:
+
+ * Vignette index
+ * Pixel row
+ * Pixel col
 
 The two additional functions