Grammatical Picture Generation
A Tree-Based Approach
Frank Drewes

How to install TREEBAG as an application

1. TREEBAG is easy to install since it has been implemented in pure Java. All you need is Java, version 1.4.2 or later, being installed on your system. If this is the case, simply copy this archive, which contains the compiled TREEBAG classes, to a place on your local file system that suits you – that's all.

   To start TREEBAG without an argument, it should be sufficient to double-click the archive. However, you gain flexibility by executing TREEBAG from the command line. For this, let us assume that you have copied the TREEBAG archive to `<my directory>/treebag.jar`. Then you can start TREEBAG using the command

   `java -jar <my directory>/treebag.jar [<worksheet>]`
   where the last argument is optional and should, if present, be the file name of the TREEBAG worksheet to be opened. Under Windows, you may prefer to substitute `javaw` for `java` in order to suppress the console window which the former opens (and you should probably use Windows' path separator character '\' instead of '/'). Of course, you can also start TREEBAG in this way without copying it to your hard disk. For this, simply refer to the jar-archive on the CD when calling the Java interpreter.

   To avoid running out of stack or memory space, it is advisable to start the Java interpreter using the options `-Xss` and `-Xmx`, e.g., `-Xss8m` (8MB stack space) and `-Xmx800m` (800MB memory limit). This would turn the basic command displayed above into

   `java -Xss8m -Xmx800m -jar <my directory>/treebag.jar [<worksheet>]`.
   For convenience, one may define a small command called `treebag` or the like, which takes one optional argument and acts as an abbreviation for `java -Xss8m -Xmx800m -jar <my directory>/treebag.jar`. The way in which such a command can be defined (e.g., as a shell script under Unix, Linux, or Mac OS X) depends on the operation system used.

2. Once you have installed TREEBAG as an application, you may also wish to copy the examples from the CD to some place on your local hard disk so that you can modify them as you wish. They are found in the directory `examples/worksheets` on the CD (where they are organized in a manner similar to the structure used on the web pages). Alternatively, you may unpack this `zip`-file, which contains an exact copy of the directory `examples/worksheets`, in whichever place you like.

Back to main page