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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
|
Scilab version 2.4
******************
12 July 1998
******************************************************************************
INSTALLATION GUIDE
******************************************************************************
0 - COPYRIGHT NOTICE
********************
Scilab is free software. It can be used both in academia and in industry
free of charge.
To use Scilab, you need to fill and return the end of the file notice.tex
or notice.ps (postscript file). You may email to Scilab@inria.fr.
******************************************************************************
In the following, all the paths are relative to the Scilab directory
(scilab-2.4 directory).
I - TO INSTALL SCILAB
*********************
A - IF YOU HAVE A COMPILED VERSION
----------------------------------
Simply do, in Scilab directory:
make
B - IF YOU HAVE A SOURCE VERSION
--------------------------------
This distribution has been tested on the following machines:
HP9000, SUN Sparcstation (Sun OS and Solaris 5.*), IBM RS6000,
DEC alpha, SGI and PC linux (a.out and ELF).
You need X Window (X11R4, X11R5 or X11R6), Athena Widgets libraries,
C compiler and fortran compiler.
1 - Configure your system by issuing the following command in the Scilab
directory:
./configure
This will create and/or modify a few Makefile and other files for your
system.
You can give options to configure command, see below.
2 - Do in the Scilab directory:
make all
This will compile Scilab and set everything.
Configure options:
------------------
-enable-debug: compile with "-g" option and do not optimize
-with-gcc: use gcc C compiler (note that the compilation options
have not been tested on all machines, see C below)
-with-g77: use g77 fortran compiler (note that the compilations
options have not been tested on all machines, see C below)
-with-gnu: use gcc C compiler and g77 fortran compiler (note that
the compilation options have not been tested on all machines,
see C below)
-x-libraries=DIR: X Window library files are in DIR
-x-includes=DIR: X Window include files are in DIR
-with-local-Xaw: compile and use Athena Widgets libraries given
with Scilab (don't use then for X11R4); configure chooses local
Athena Widgets library when needed, so the use of this option is not
recommanded (see below KNOWN PROBLEMS 3).
-with-tk: compile with TCL/TK library. You must have libraries of
TCL/TK 8.x and corresponding include files installed in standard
directory (configure is looking for them).
If your libraries and include files are in customized places,
you can specify them by hand with the following arguments:
-with-tcl-library=TCL_LIB_DIR: Tcl library is in TCL_LIB_DIR
-with-tcl-include=TCL_INC_DIR: Tcl include is in TCL_INC_DIR
-with-tk-library=TK_LIB_DIR: Tk library is in TK_LIB_DIR
-with-tk-include=TK_INC_DIR: Tk include is in TK_INC_DIR
C - CHANGING THE COMPILATION OPTIONS (source version only)
------------------------------------
You may want to change the options used to compile Scilab, names of the
compilers, compilation options, linker options, and so on; you can easily
do that.
The main Makefile of Scilab includes "Makefile.incl" and
"config/Makefile.<machine>":
"Makefile.incl" contains all the compilation options
"config/Makefile.<machine>" is only used for the link of the executable
"scilex" of Scilab
The file "Makefile.incl" is included by all the Makefiles of the
distribution, so it is THE place where you can change compilation
options (it is self documented).
Note that "Makefile.incl" is automatically generated by "configure"
from "Makefile.incl.in", so your modifications of "Makefile.incl" are
discarded every time you run "configure".
Users knowing the way "configure" works may want to modify directly the
"configure" file.
Even more, users knowing the way "autoconf" works may want to modify
the "configure.in" file and then run "autoconf" (version 2.12) to generate
the "configure" file.
D - CUSTOMIZING YOUR SCILAB
---------------------------
1 - If you want to recompile Scilab after modifications, execute only
the "make all" command in Scilab directory (source version only).
If you want to clean all executable, object files and libraries
and then recompile Scilab, execute the following commands
(source version only):
make distclean
make all
2 - To print your postscript figures, the list of printers is defined
in the environment variable "PRINTERS" or in the beginning of
the shell script "bin/scilab".
3 - Note that the functions "macros/util/edit" and
"macros/util/manedit" assume that your default editor
is emacs. You may change this in the corresponding function (or
explicitly specify your editor when you invoke these functions).
4 - Icons for windows managers: icons for Scilab, Scilab graphics windows
and Metanet graphics windows are given in the X11_defaults
subdirectory. See the README in this subdirectory.
5 - COLOR RESOURCES: if you want to change the colors of your
customization you need to modify the files in the X11_defaults
subdirectory (essentially the Xscilab file) or to copy the same
color resources in your personal resource file (home directory).
******************************************************************************
II - KNOWN PROBLEMS AND REMARKS
*******************************
0 - Note that C routines are not ANSI.
1 - If there is something wrong when you open the scilab window
check your ".Xdefault" file.
2 - The fortran compiler version 1.3.1 of SUN Sparcstations has a bug:
reading or writing (with implicit loop) arrays bigger than 4096
elements does not work. This may cause Scilab to abort.
The solution is to upgrade your fortran compiler, for instance get
version 1.4 (or use version 1.3.1 with object file "recio.o" from
newer version).
3 - Athena Widgets libraries libXaw.a and libXmu.a (and corresponding
include files) are not systematically provided in some X11
installations. If you are using X11R5 or X11R6, these libraries are
provided for convenience with Scilab.
"configure" first tries to find existing Athena Widgets libraries.
If none are found and X Window release is not X11R4, it uses
local Athena Widgets libraries. Otherwise an error is issued.
You can impose the use of local Athena Widgets libraries by using
the option "-with-local-Xaw" with "configure".
On some IBM RS6000 there exists a compatibility problem between the
X11-Mit distribution and the IBM version. If your system runs the IBM
X11 release you must use the IBM libXaw.a and libXmu.a libraries.
4 - For DEC ALPHA workstation you must use the 3.4 or newer version
of the fortran compiler (the 3.3 version aborts on floating
point exceptions). You are encouraged to use the OSF 3.0 system
release and the fortran 3.5 release (the incremental link works
fine as well as all the floating point exceptions).
5 - For HP workstation, programs to be incrementally linked should
be compiled with the option "+z" or "+Z".
6 - If you have any problem or suggestion to improve Scilab
send an email to:
Scilab@inria.fr
or better post a message to newsgroup:
comp.soft-sys.math.scilab
******************************************************************************
III - TO RUN SCILAB
*******************
Run Scilab by executing "scilab" (shell script in bin).
If the name of the directory of Scilab distribution is not the same on
your machine than on the machine where Scilab was installed, define the
environment variable SCI to point to the directory of Scilab distribution.
In a sh like shell, do:
SCI=<name of the directory>
export SCI
In a csh like shell, do:
setenv SCI <name of the directory>
******************************************************************************
IV - DOCUMENTATION
******************
In addition to Scilab online documentation (obtained by typing "help item" or
"apropos keyword" or clicking on the help button), you will find
compressed postscript documentation by anonymous ftp on
"ftp.inria.fr:/INRIA/Projects/Meta2/Scilab/doc" (internet# 192.93.2.54)
or from Web site
"http://www-rocq.inria.fr/scilab".
Comm.ps.Z
Internals.ps.Z
Intro.ps.Z
Lmi.ps.Z
Manual.ps.Z
Metanet.ps.Z
Scicos.ps.Z
Signal.ps.Z
******************************************************************************
V - SOME IMPORTANT FILES AND DIRECTORIES
****************************************
scilab.star: startup file for Scilab: instructions in this file
are executed when Scilab is executed. Note that
you can also have your own startup file ".scilab"
in your current directory.
configure.in: file used by "autoconf 2.12" to generate "configure"
configure: file used to configure Scilab
Makefile.incl.in: file used by configure to generate Makefile.incl.
Makefile.incl: file included by all Makefile's. It is automatically
generated by configure.
Path.incl: contains the scilab directory pathname. It is included by
scripts/Makefile. This file is automatically generated by
configure.
Version.incl: contains the scilab version. It is used by a few Makefile.
Makefile.in: file used by configure to generate Makefile.
Makefile: the main Makefile to make Scilab. It is automatically generated by
configure.
config/ : directory used by configure and by the main Makefile
Makefile.<host>: Makefile included by main Makefile. It depends
on the host and is used to created the
executable bin/scilex.
demos/ : demos directory. Some of the demos can be executed by clicking
on the "demos" button.
examples/ : examples of dynamic links and interface code.
macros/ : functions directory: this directory is divided into
subdirectories corresponding to specific topics
(control, polynomials,...). Each subdirectory contains
the source code of the macros (files *.sci).
xmetanet/ : Metanet routines.
geci/ : Geci (interprocess communication tool) routines.
libs/ : directory of libraries: archives of object files needed
to link Scilab.
routines/ : directory of fortran or C routines. Divided into subdirectories
(see below).
doc/ : directory of documentation. Usually LaTeX files.
man/ : man files and LaTeX manual.
tests/ : set of exec files to test Scilab.
util/ : useful routines and ASCII files to manage Scilab.
bin/ : executable code and scripts.
scilab : shell-script to call Scilab and miscellaneous tools
execute scilab -help scilab for help.
scilex : executable code of Scilab.
minfopr : shell script called by scilab -macro.
scilink : shell script called by scilab -link.
intersci: generator of interface program between Scilab and
routines.
intersci/ : Generator of interface program between Scilab and routines.
maple/ : Maple code to link Maple with Scilab.
pvm3/ : PVM 3.4 beta 6 for Scilab.
******************************************************************************
THAT'S ALL FOLKS
******************************************************************************
|
