1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
The DsTool program is the property of:
Cornell University
Center of Applied Mathematics
Ithaca, NY 14853
dstool_bugs@macomb.tn.cornell.edu
and may be used, modified and distributed freely, subject to the following
restrictions:
Any product which incorporates source code from the DsTool
program or utilities, in whole or in part, is distributed
with a copy of that source code, including this notice. You
must give the recipients all the rights that you have with
respect to the use of this software. Modifications of the
software must carry prominent notices stating who changed
the files and the date of any change.
DsTool is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of FITNESS FOR A PARTICULAR PURPOSE.
The software is provided as is without any obligation on the part of Cornell
faculty, staff or students to assist in its use, correction, modification or
enhancement.
INSTALL
This version of DsTool uses the Tcl/Tk libraries and should run
on a variety of Unix workstations under X11.
It was developed on SGI Irix5 and Sun Sparcstations. It has also
been compiled under linux.
The Makefiles are setup to allow for installation on a network
with a variety of architectures.
REQUIREMENTS
============
Tcl/Tk: DsTool was developed using Tcl 7.4 and Tk 4.0.
OBTAINING SRC BIN
=================
The DsTool package is available by ftp from a network archive
server maintained by the Center for Applied Mathematics at Cornell
University. The server's address is:
macomb.cam.cornell.edu
(Internet address: 132.236.122.12)
Use ftp to download the program from the pub subdirectory,
after anonymous login.
INSTALLATION INSTRUCTIONS
=========================
1) Uncompress and unpack dstool, using e.g.:
gnutar -xvzf dstool_tk.tar.Z or
uncompress dstool_tk.tar.Z;tar -xvf dstool_tk.tar
2) Set DSTOOL environment variable to the dstool distribution directory
(the one contianing this file)
setenv DSTOOL $PWD
3) Set the ARCH environment variable to something architecture dependent.
For example:
setenv ARCH sun4 or
setenv ARCH iris or
setenv ARCH solaris or
setenv ARCH linux
4) Examine the Makefile components in $DSTOOL/config
Makefile.defs contains most of the definitions.
Make sure that a file exists called Makedefs.$ARCH, even if it is empty.
Entries in Makefile.defs are replaced on an architecture by
architecture basis by editing the file Makedefs.$ARCH.
Entries in the Makefile.defs and Makedefs.$ARCH are replaced by
entries in the site.def file.
If you wish to use solaris cc, uncomment the appropriate lines of
site.def.
COMPILATION INSTRUCTIONS
========================
5) Make everything:
make World
6) Note that libraries are built and copied into $DSTOOL/lib/$ARCH
and the executable is built into $DSTOOL/bin/$ARCH
7) To build on a different architecture, simply (on that machine)
set a new ARCH environment variable and issue the commands:
make clean
make all
8) The shell script $DSTOOL/bin/dstool_tk will attempt to start the
various executables. It either uses of tries to set appropriate values
of DSTOOL and ARCH to find an executable to run. This file may need to
be modified and can be installed someplace like /usr/local/bin.
If the environment variable MY_DSTOOL is set then the script tries
to start a user's customized version of DsTool which has been modified
to provide additional dynamical systems and/or computational modules.
For more details on this see the file $DSTOOL/my_dstool/README.
RUN TIME
========
The executable will be $DSTOOL/bin/$ARCH/dstool_tk
This is usually invoked through the script $DSTOOL/bin/dstool_tk
which may also be installed someplace like /usr/local/bin.
At runtime, the executable needs access to the directories:
(These are architecture independent)
$DSTOOL/oogl
$DSTOOL/help
$DSTOOL/src/models
$DSTOOL/tcl
The script $DSTOOL/bin/dstool_tk should be edited and installed someplace
like /usr/local/bin so that on each machine the correct binary is found
and executed.
|
