-----------------------------------------------------------------------------
Distributed Maple application software
README file
(c) 1998-2000, RISC-Linz, see file COPYRIGHT
http://www.risc.uni-linz.ac.at/software/distmaple
$Id: README,v 1.7 2001/07/26 05:29:02 schreine Exp $
-----------------------------------------------------------------------------
0) GENERAL
----------
This software contains the code of a number of functions that have been
parallelized with the help of Distributed Maple. It can be downloaded from
http://www.risc.uni-linz.ac.at/software/distmaple
It is partially based on code originally developed by
Wolfgang Schreiner
Christian Mittermaier
which in turn was based on code from CASA
http://www.risc.uni-linz.ac.at/software/casa
and from the standard Maple library.
1) CONTENTS
-----------
The subdirectories of the directory "distsoft" contain the code of the
parallel functions
'dist/maple/discrim' parallel versions of Maple functions
'dist/maple/gcd'
'dist/maple/realroot'
'dist/maple/resultant'
'dist/maple/singularities'
'dist/maple/Berlekamp'
'dist/casa/neighbGraph' parallel versions of CASA functions
'dist/casa/pacPlot'
'dist/casa/ssiPlot'
and of some utility functions
'dist/clock' wall clock time
'dist/load' load Maple code to all machines
2) INSTALLATION
---------------
See file "INSTALL" for on how to install the software
respectively prepare its execution.
3) USE
------
Call Maple by invoking one of the commands
maple
xmaple
and execute the commands
read `dist.maple`;
dist[initialize]([[KEY, MACHINE], ...]);
dist[visualize](600,400,2,120);
read `distsoft/init.maple`;
where KEY is a machine key in `dist.systems` and MACHINE is the
name of a machine described by this key. For instance,
in the RISC-Linz environment you can say
dist[initialize]([[andromeda,octane],[thetys,linux]]);
A window will pop up to show the state of every machine connected
to the session. You can start a parallel task and wait for the result e.g.
t0 := dist[start](int, x^n, x):
t1 := dist[start](int, x^n, n):
r0 := dist[wait](t0);
r1 := dist[wait](t1).
You can call every parallel Maple command e.g.
`dist/resultant`(x*y+x,x*x+y,x);
and (provided that CASA is installed on every machine) every
parallel CASA command
plotsetup(x11);
`dist/casa/pacPlot`(x^2+y^2-5);
Terminate the environment by calling
dist[terminate]();
quit;
4) EXAMPLES
-----------
See file "EXAMPLES" for further examples on the use of the system
in the RISC-Linz environment.
5) DOCUMENTATION
----------------
For further information, see the papers linked into the Web page
resultant: "Developing a Distributed System for Algebraic Geometry"
neighbGraph: "Analyzing Algebraic Curves by Cluster Computing"
"Manager-Worker Parallelism vs Dataflow in Distributed Maple"
pacPlot: "On Solving a Problem in Algebraic Geometry by Cluster Comp."
ssiPlot: "Plotting Algebraic Space Curves by Cluster Computing"
Berlekamp: "Parallelizing the Big Prime Berlekamp Algorithm with Distributed Maple"
and Christian Mittermaier's diploma thesis
"Parallel Algorithms in Constructive Algebraic Geometry"
in general.
-----------------------------------------------------------------------------
$Id: README,v 1.7 2001/07/26 05:29:02 schreine Exp $
-----------------------------------------------------------------------------