README
1README
2************************************************************************
3* This SCILAB interface to MUMPS is provided to you free of charge. *
4* It is part of the MUMPS package (see ../Conditions_of_use) and is *
5* public domain. Up-to-date copies can be obtained from the Web *
6* pages http://www.enseeiht.fr/apo/MUMPS/ or *
7* http://graal.ens-lyon.fr/MUMPS *
8* *
9* THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY *
10* EXPRESSED OR IMPLIED. ANY USE IS AT YOUR OWN RISK. *
11* *
12* More info is available in the main MUMPS users' guide and in: *
13* *
14* [2006] Aurelia Fevre, Jean-Yves L'Excellent and Stephane Pralet *
15* MATLAB and Scilab interfaces to MUMPS. LIP Report RR2006-06. *
16* Also available as an INRIA and an ENSEEIHT-IRIT Technical Report. *
17* *
18************************************************************************
19
20CONTENT OF THE DIRECTORY:
21
22 README : this file
23 builder.sce : Scilab script to build the makefile, the loader_inc.sce
24 and to compile intdmumpsc.c and intzmumps.c
25 (to be executed once)
26 intdmumpsc.c : C interface file to double precision version of MUMPS
27 intzmumpsc.c : C interface file for double complex version of MUMPS
28 loader.sce : installation script (to be executed each time scilab is launched)
29 initmumps.sci : Scilab file for the initialisation of the mumps structure
30 dmumps.sci : Scilab file for double precision version
31 zmumps.sci : Scilab file for double complex version
32
33 loader_inc.sce, Makefile, object files: Generated when executing the builder
34
35 examples/
36 double_example.sce : file containing an example of using MUMPS in Scilab
37 cmplx_example.sce : file containing an example of using MUMPS in Scilab,
38 with a complex matrix
39 schur_example.sce : file containing an example of using MUMPS in Scilab,
40 with the schur option
41 sparseRHS_example.sce : file containing an example of using MUMPS in Scilab,
42 with a sparse multiple right hand side
43 ex.sci : small sparse matrix used to run the examples
44 ex2.sci : small sparse matrix used to run the schur_example
45 ex_rhs.sci : small sparse right hand side used to run the examples
46
47
48***************************************************************************************
49
50INSTALLATION for Scilab:
51
52You need:
53 1- scilab version 3.x or 4.x (not tested with scilab 5.x)
54 2- to have compiled/linked a sequential version of MUMPS with both double precision
55 and double complex arithmetics ("make d" and "make z", or "make all")
56 3- to modify the paths in the builder.sce. In particular you will need to give
57 the path to the runtime libraries of your FORTRAN 90 compiler.
58 4- to execute builder.sce and loader.sce by using the "exec"
59 instruction within Scilab:
60 exec('builder.sce');
61 exec('loader.sce');
62
63SOME EXPLANATIONS:
64- Modifications of builder.sce
65In this file, you will find a variable part to customize. The following modifications
66have to be done after the installation of MUMPS, i.e., after having a working MUMPS
67library.
68
69o First, the paths until libmpiseq.a, libdmumpsc.a and libpord.a. If you have not
70installed these libraries in specific places, and assuming that you are using MUMPS
71version 4.5.5, the path should be:
72 xxxx/MUMPS_4.5.5/Include/
73 xxxx/MUMPS_4.5.5/lib/
74 xxxx/MUMPS_4.5.5/libseq/
75o Second, the C compiler with the flag for compilation only. For example: cc -c -O or
76gcc -c -O.
77o Finally, the harder part: you must define the libraries used by the Fortran
78compiler that was used to compile MUMPS.
79
80- Modifications of loader.sce
81The only thing to do in this file is to change the path DIR_SCIMUMPS; it has to be the
82path to Scilab files
83
84
85***************************************************************************************
86
87LIMITATIONS:
88The behaviour of the interface strongly depends on the Fortran compilers
89and platform used. It has been tested on a limited set of these (for example,
90the g95 compiler with Scilab 3.0 and 3.1 under a Linux PC).
91This interface does not support MUMPS parallel versions, and has not
92been tested under Windows environments).
93
94