-
Notifications
You must be signed in to change notification settings - Fork 7
/
Copy pathINSTALL
153 lines (112 loc) · 5.12 KB
/
INSTALL
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
Copyright 2001, Regents of the University of Minnesota.
PARMGRIDGEN-1.0 was written by George Karypis ([email protected])
and Irene Moulitsas ([email protected]).
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
THE SERIAL LIBRARY MGRIDGEN
---------------------------
INTRODUCTION
------------
MGRIDGEN is a software package for generating coarse grids.
The documentation of MGRIDGEN can be found in the Doc/manual-parmgridgen.ps file.
MGRIDGEN is written in ANSI C and should compile on Unix systems that have
a ANSI C compiler. It has been extensively tested on the following
architectures:
AIX
SunOS
Solaris
IRIX
Unicos
Linux
FreeBSD
INSTALLATION INSTRUCTIONS
-------------------------
In order to build MGRIDGEN you need
(a) a C compiler that is ANSI compatible
(b) make
Edit the file Makefile.in that resides in the same directory as this file
according to the requirements of your system. In particular you may need
to modify the following:
1. The executable for GNU make (gmake)
2. The CC and LD variables, to be the name of the ANSI C compiler
in your system. The GNU C compiler (gcc) will do.
3. The settings for the AR and RANLIB variables that are suitable for
you system. Note that some systems do not have 'ranlib' but they use
'ar -ts' instead, or it is not needed all together.
4. You can use COPTIONS and LDOPTIONS to provide additional command line
options that are required by your compiler and linker.
After saving the modified Makefile.in, type 'make' at the prompt. This will
build MGRIDGEN's library, and a program that tests the algorithm.
Upon successful completion, make creates the following files:
MGridGen/IMlib/libIMlib.a
libmgrid.a
mgridgen
Please read the instructions in the file Graphs/README on how to go and
test the various programs.
The header file mgridgen.h can be used to provide the prototype for the
main routine in MGRIDGEN.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
THE PARALLEL LIBRARY PARMGRIDGEN
--------------------------------
INTRODUCTION
------------
PARMGRIDGEN is a parallel software package for generating coarse grids.
The documentation of PARMGRIDGEN can be found in the Doc/manual-parmgridgen.ps
file.
PARMGRIDGEN is written in ANSI C, using Message Passing Interface (MPI)
for communication between the processors, and should compile on Unix systems
that have a ANSI C compiler and an installation of MPI. It has been extensively
tested on the following architectures:
AIX
IRIX
Unicos
Linux
INSTALLATION INSTRUCTIONS
-------------------------
In order to build PARMGRIDGEN you need
(a) an MPI C compiler
(b) make
Edit the file Makefile.in that resides in the same directory as this file
according to the requirements of your system. In particular you may need
to modify the following:
1. The executable for GNU make (gmake)
2. The CC and LD variables, to be the name of the ANSI C compiler
in your system. The GNU C compiler (gcc) will do.
3. The PARCC and PARLD variables, to be the name of the compiler in
your system. The default is to use mpicc from MPICH.
4. The settings for the AR and RANLIB variables that are suitable for
you system. Note that some systems do not have 'ranlib' but they use
'ar -ts' instead, or it is not needed all together.
5. You can use COPTIONS and LDOPTIONS to provide additional command line
options that are required by your compiler and linker.
After saving the modified Makefile.in, type 'make parallel' at the prompt. This
will build PARMGRIDGEN's library, and a program that tests the algorithm.
Upon successful completion, make creates the following files:
ParMGridGen/IMParMetis-2.0/libIMparmetis.a
libparmgrid.a
parmgridgen
Please read the instructions in the file Graphs/README on how to go and
test the various programs.
The header file parmgridgen.h can be used to provide the prototype for the
main routine in PARMGRIDGEN.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
NOTE-1: The results on your machine will most likely look different
because of differences in the random number generators.
Look if the test programs reports any 'incorrect' results.
If the test goes through correctly, then you have compiled
PARMGRIDGEN successfully!
NOTE-2: FYI, the header files mgridgen.h and parmgridgen.h contain
definitions for the datatypes to be used for integer and real
arithmetic. If you wish to switch to short (for integer) or
float (for real) you need to edit the files
o MGridGen/IMlib/IMlib.h
o ParMGridGen/IMParMetis-2.0/ParMETISLib/struct.h
and comment the defintion accordigly.
CONTACT INFORMATION
-------------------
If you have any comments, suggestions, or bug reports, please send them
Any bug fixes and upgrades of the MGRIDGEN/PARMGRIDGEN package is available
on WWW at URL: http://www.cs.umn.edu/~moulitsa/software.html
Irene Moulitsas
Tue Dec 4 18:24:47 CST 2001