;; nchang [3/12/2001]
;; srini [Feb 23, 1998 ] 
;; Edited from [march 22, 1992] Regier's ReadMe file.

In this assignment you will use Terry Regier's program to learn spatial
relation terms.

Steps
-----
[You may have already done the first few to get to this ReadMe file.]

a) copy the file space.tar.gz to your directory. 
	(type "cp ~cs182/programs space.tar.gz ~/.")

b) ungzip the .gz file in your directory.
	(type "gunzip space.tar.gz")

c) untar the .tar file.
	(type "tar -xf space.tar" in your directory)

d) type "cd NonPunctate" to get to the static scene learning directory.

e) Answer questions by training and testing on the data. 


Training and Testing
-------------------

To view all scenes in the training set for English "above", type
	do see above

To train on English "above", type
	do train above

To test on English "above" type
	do test above

To see/train/test scenes for other words, replace "above" with the
appropriate word. (Available words can be viewed by looking in the
"Scenes/English" directory.)

Note that these commands call a shell script ("do") which is a wrapper to
the "allscenes" program with default parameters. You may wish to
experiment with these as described below.

*********************************************************************

The information below is NOT REQUIRED for your assignment, but may be
useful if you want to play with the program on your own.

For playing around:
------------------

The "scenes" and "allscenes" programs are the precursors of "movie"
and "allmovie", respectively.  

To view all scenes in the training set for English "above", type
	allscene -c Scenes/English/above

To train on English "above", type
	train -c Scenes/English/above -a Arch/demo -t -s 100

To train on Dutch "aann", type
	train -c Scenes/Dutch/aan -a Arch/demo -t -s 100

	(The "Scenes" directory contains subdirectories for each language,
	and each of these has all the training/testing files for each
	spatial relation in that language.)

To edit a scene file, e.g. Scenes/English/above.0, type
	scene -s Scenes/English/above.0

.........................................................................

Stray tidbits:
   Some of the programs in here call each other:

	scene calls get_theta once the scene file has been written,
		so that get_theta can compute the proximal TR orientation
		for the scene.

	train calls allscene when done, so as to display all the 
		training set and the learned values for each of the scenes.

.........................................................................

Command line options you may care about include:

	-a <fname>:	Take fname as the architecture file
	-c <fname>:	Learn concept fname
	-o:		Use old weights (from an earlier training run)
	-t:		Want to train (not just show results)
	-T <fname>:	Use fname as the test set
	-m <num>:	Mode switch threshold for quickprop (if high, e.g.
			100, program basically uses ordinary backprop.
			See Fahlman's quickprop tech report for details.)
	-E <num>:	Epsilon (learning rate).
	-s <num>:	Start off with this many epochs.
	-[ <num>:	Freeze incoming weights for nodes <num> through ...
	-] <num>:	      ... <num>.
	-z:		Stop training when zero bits wrong

.........................................................................

The "demo" architecture file is the only one currently available.
You will probably want to use it as a model for whatever architectures
you put together.

.........................................................................

Motion:

Note that this version of the system does not have all the bells and
whistles needed to handle the motion cases. These are available in the
complete version of the system, available at:

	~cs182/programs/Space/Motion/

The ReadMe.Arch file in that directory describes the fancier system for
learning motion-based terms. You may also want to take a quick look at the
Arch/demo, which uses various options available in ../Motion/Arch/*.