next up previous contents
Next: Walkthrough Examples Up: main Previous: The Installation Script install_dstool   Contents


After Installing dstool

In this section, we assume that the central installation of dstool is complete. If not, refer to Section 0.4.2 and install dstool for the multi-user configuration.


The following discussion is for those who want to install their own dynamical systems or algorithms in dstool without modifying the shared files in DSTOOL. A private directory must be created where the user maintains a small number of files containing the dstool customizations. The compilation and linking of the user-modified dstool is done automatically using the Makefile in the user-dstool directory. See the Section 0.3.2.2 for more information.


Here are the step by step instructions.

1.
If you have not defined a DSTOOL environment variable in .login and .cshrc, do so now. This variable should contain the explicit path of the central dstool shared directory. For example, if the dstool libraries were installed in the system file /usr/local/dstool, as described in the example in Section 0.3.2.2, each user of dstool must also define the DSTOOL environment variable to be /usr/local/dstool. Each user will also want to set the environment variables DSTOOL_DATA_DIR and DSTOOL_COLOR_DIR, to obtain colortable information and set the default directory for reading and writing data files. Finally, the OPENWINHOME and LD_LIBRARY_PATH variables must be defined in accordance with the instruction given in the OpenWindows documentation.

2.
Choose a location for your private user-dstool directory. Any name may be selected, but you must have write permission for creating the directory.

3.
Execute the shellscript install_dsuser. This program will create the user-dstool directory and install a pre-configured package which the user can freely modify. The installation script may be invoked with the command:

install_dsuser

4.
Change your working directory to your user-dstool subdirectory and invoke the make facility with the command:

make dstool_u

The make utility will compile and link a new executable named dstool_u which will be placed in the user-dstool directory.


next up previous contents
Next: Walkthrough Examples Up: main Previous: The Installation Script install_dstool   Contents
root
1998-11-02