<html>
<head>
<title>installation
</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div align ="center">
[
<a href="manual.htm">Manual
</a>
| Installation
|
<a href="changes.htm">Changes
</a>
|
<a href="faq.htm">FAQ
</a>
|
<a href="mail_list.htm">Contact
</a>
]
</div>
<table width="700" border="0" cellpadding="0" cellspacing="0">
<tr>
<td width="700" height="35"><p> </p>
<p> </p></td>
</tr>
<tr>
<td valign="top" height="984"> <div align="left">
<p align="left"><font face="Arial, Helvetica, sans-serif"><font size="3">
<b>Installation Instructions
</b></font> </font></p>
<div align="left">
<p><font size="2" face="Arial, Helvetica, sans-serif">Previously to
the installation of SLEPc, the system must have an appropriate version
of PETSc installed (see the
<a href="http://www-unix.mcs.anl.gov/petsc/petsc-as/documentation/installation.html" target="_blank">PETSc installation documentation
</a> for details). Check the
<a href="changes.htm">Changes
</a>
section for a list of SLEPc versions and their corresponding PETSc
versions.
</font></p>
</div>
<font face="Arial, Helvetica, sans-serif">
<p><font size="2">
The installation process for SLEPc is very similar to PETSc, with two stages: configuration and compilation. SLEPc configuration is much simpler because most of the configuration information is taken from PETSc, including compiler options and scalar type (real or complex). Several configurations can coexist in the same directory tree, being referred by different values of
<font face="Courier New, Courier, mono">PETSC_ARCH
</font>, so that one can, for instance, have a SLEPc compiled with real scalars and another one with complex scalars.
</font></p>
<p><font size="2">
The main steps for the installation are described next. Note that prior to this steps, optional packages must have been installed (see below). If any of these packages is installed afterwards, reconfiguration and recompilation is necessary.
</font></p>
</font></div>
<ol>
<li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">
Unbundle the distribution file
<strong>slepc.tgz
</strong> with a usual
command such as
<font face="Courier New, Courier, mono">gunzip -c slepc.tgz
| tar xvf -
</font>. This will create a directory and unpack the software
there.
<br>
</font></font></li>
<li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">Refer
to the Patches section
</font><font face="Arial, Helvetica, sans-serif"><font size="2">
at the
<a href="http://www.grycap.upv.es/slepc/download.htm" target="_parent">Download
</a>
page
</font></font> <font size="2">for available patches to the latest
SLEPc release.
<br>
</font></font></li>
<li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">Set
the environment variable
<font face="Courier New, Courier, mono">SLEPC_DIR
</font>
to the full path of the SLEPc home directory, for example,
<br>
<font face="Courier New, Courier, mono"> setenv
SLEPC_DIR /home/username/slepc-2.3.x
</font><br>
In addition to this variable,
<font face="Courier New, Courier, mono">PETSC_DIR
</font>
(and optionally
<font face="Courier New, Courier, mono">PETSC_ARCH
</font>) must also
be set appropriately.
<br>
</font></font></li>
<li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">
In the SLEPc directory, execute
<br>
<font face="Arial, Helvetica, sans-serif"> <font face="Courier New, Courier, mono"> ./config/configure.py
</font><br>
</font>Note that in order to enable external packages (see below), this command must be run with appropiate options. To see available options use
<font face="Courier New, Courier, mono">./config/configure.py --help
</font><br>
</font></font></li>
<li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">
In the SLEPc home directory, type
<br>
<font face="Arial, Helvetica, sans-serif"> <font face="Courier New, Courier, mono"> make
</font></font><br>
</font></font></li>
<li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">If
the installation went smoothly, then try running some test examples with
<br>
<font face="Arial, Helvetica, sans-serif"> <font face="Courier New, Courier, mono"> make test
</font><br>
</font></font><font size="2">Examine the output for any obvious errors
or problems.
<br>
</font></font></li>
<!--li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">If PETSc was configured with Fortran support, the SLEPc
Fortran libraries are built automatically during the installation outlined
above. To compile and test the Fortran examples, use the command<br>
</font><font face="Arial, Helvetica, sans-serif"><font size="2"><font face="Arial, Helvetica, sans-serif"> <font face="Courier New, Courier, mono"> make
testfortran</font></font></font></font></font></li-->
</ol>
<div align="left"><font face="Arial, Helvetica, sans-serif">
<p> </p>
<p><font size="3"><b>Optional Software
</b></font></p>
<p><font size="2">SLEPc provides an interface to several software packages.
These should be installed before installing SLEPc. These packages are
not developed, maintained, or supported by the SLEPc team; we merely
provide an interface to them. To integrate one of these libraries in
SLEPc:
</font></p>
</font></div>
<ul>
<li>
<div align="left"><font face="Arial, Helvetica, sans-serif"><font size="2">First
install the external package following its instructions. Make sure
you use the same compilers and MPI that you plan to use with PETSc/SLEPc.
These libraries should be linked also with the same LAPACK version
as PETSc.
<br>
</font></font></div>
</li>
<li>
<div align="left"><font face="Arial, Helvetica, sans-serif"><font size="2">Enable
the utilization of the external software from SLEPc by adding specific command-line parameters when executing
<font face="Courier New, Courier, mono">config/configure.py
</font>. For example, to use ARPACK, specify the following options (with the appropriate paths):
<br>
<br>
<font face="Courier New, Courier, mono">
config/configure.py --with-arpack-dir=/usr/software/ARPACK
<br>
--with-arpack-flags=-lparpack,-larpack
</font></font></font></div>
</li>
<li>
<div align="left"><font face="Arial, Helvetica, sans-serif"><font size="2">
Build the SLEPc libraries.
<br>
</font></font></div>
</li>
</ul>
<div align="left">
<p><font size="2" face="Arial, Helvetica, sans-serif">SLEPc currently
interfaces to the following libraries:
</font></p>
</div>
<ul>
<li>
<div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.caam.rice.edu/software/ARPACK" target="_blank">ARPACK
</a>
(Implicitly Restarted Arnoldi/Lanczos solver).
</font></div>
</li>
<li>
<div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.cs.wm.edu/~andreas/software" target="_blank">PRIMME
</a>
(PReconditioned Iterative MultiMethod Eigensolver).
</font></div>
</li>
<li>
<div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.nersc.gov/%7Eosni/#Software" target="_blank">BLZPACK
</a>
(Block Lanczos with selective and partial reorthogonalization).
</font></div>
</li>
<li>
<div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.nersc.gov/%7Ekewu/trlan.html" target="_blank">TRLAN
</a>
(Dynamic Thick Restart Lanczos solver).
</font></div>
</li>
<li>
<div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www-math.cudenver.edu/%7Eaknyazev/software/BLOPEX" target="_blank">BLOPEX
</a>
(Block Locally Optimal Preconditioned Eigenvalue Xolvers).
</font></div>
</li>
</ul>
<div align="left">
<p><font size="2" face="Arial, Helvetica, sans-serif">Additional information
about these packages can be found in the SLEPc Users Manual.
</font>
</p>
<p> </p>
<p> </p>
</div></td>
</tr>
</table>
</body>
</html>