X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?p=flatland.git;a=blobdiff_plain;f=README.md;h=d6e302caa8068552216f9a9c8b7bb894144b1552;hp=47633c05504d53425408b3cfc5caa13e1487b337;hb=HEAD;hpb=b8076332f83b24a86e727b4e4399b5965a983e7a

diff --git a/README.md b/README.md
index 47633c0..d6e302c 100644
--- a/README.md
+++ b/README.md
@@ -3,10 +3,41 @@
 This is an implementation of a simple 2d physics simulator usable from
 the pytorch framework.
 
+The main function is
+
+```
+torch.ByteTensor flatland.generate_sequence(bool pulling,
+                                            int nb_sequences,
+                                            int nb_images,
+                                            int image_height, int image_width,
+                                            int nb_shapes,
+                                            bool random_shape_size, bool random_colors)
+```
+
+where
+
+ * `pulling` indicates if one of the shape should be pulled upward,
+ * `nb_sequences` is the number of sequences to generate,
+ * `nb_images` is the number of frames per sequence,
+ * `image_height` and `image_width` is the individual image size,
+ * `nb_shapes` is the number of rectangular shapes in the simulation,
+ * `random_shape_size` states if the shapes should be of different sizes,
+ * `random_colors` states if they should be of different colors.
+
+The returned ByteTensor has five dimensions:
+
+ * Sequence index
+ * Image index
+ * Channel (3 since it is RGB)
+ * Pixel row
+ * Pixel col
+
+Warning: For improper parameters values (e.g. too many shapes, too
+small images), the simulation may be stuck.
+
 # Installation and test #
 
 ```
 make -j -k
-./built.py
-./flatland-test.py
+./test-flatland.py
 ```