Subversion Repositories slepc-dev

Rev

Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
6 dsic.upv.es!jroman 1 
<html>
2 
<head>
3 
<title>installation</title>
4 
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
5 
 
6 
</head>
7 
 
47 dsic.upv.es!antodo 8 
<body bgcolor="#FFFFFF" text="#000000">
9 
 
10 
<div align ="center">
11 
[ <a href="manual.htm">Manual</a>
12 
| Installation
13 
| <a href="changes.htm">Changes</a>
14 
| <a href="faq.htm">FAQ</a>
15 
| <a href="mail_list.htm">Contact</a>
16 
] </div>
6 dsic.upv.es!jroman 17 
<table width="700" border="0" cellpadding="0" cellspacing="0">
18 
  <tr>
19 
    <td width="700" height="35"><p>&nbsp;</p>
20 
      <p>&nbsp;</p></td>
21 
  </tr>
22 
  <tr>
23 
    <td valign="top" height="984"> <div align="left">
944 ono.com!jroman 24 
        <p align="left"><font face="Arial, Helvetica, sans-serif"><font size="3">
25 
        <b>Installation Instructions</b></font> </font></p>
6 dsic.upv.es!jroman 26 
        <div align="left">
27 
          <p><font size="2" face="Arial, Helvetica, sans-serif">Previously to
28 
            the installation of SLEPc, the system must have an appropriate version
944 ono.com!jroman 29 
            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>
6 dsic.upv.es!jroman 30 
            section for a list of SLEPc versions and their corresponding PETSc
31 
            versions. </font></p>
32 
        </div>
33 
        <font face="Arial, Helvetica, sans-serif">
944 ono.com!jroman 34 
        <p><font size="2">
35 
        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>
36 
 
37 
        <p><font size="2">
38 
        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>
6 dsic.upv.es!jroman 39 
        </font></div>
40 
      <ol>
1099 slepc 41 
        <li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">
6 dsic.upv.es!jroman 42 
          Unbundle the distribution file <strong>slepc.tgz</strong> with a usual
43 
          command such as <font face="Courier New, Courier, mono">gunzip -c slepc.tgz
44 
          | tar xvf -</font>. This will create a directory and unpack the software
45 
          there.<br>
46 
          </font></font></li>
1099 slepc 47 
        <li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">Refer
6 dsic.upv.es!jroman 48 
          to the Patches section </font><font face="Arial, Helvetica, sans-serif"><font size="2">
1099 slepc 49 
          at the <a href="http://www.grycap.upv.es/slepc/download.htm" target="_parent">Download</a>
6 dsic.upv.es!jroman 50 
          page</font></font> <font size="2">for available patches to the latest
51 
          SLEPc release.<br>
52 
          </font></font></li>
1099 slepc 53 
        <li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">Set
6 dsic.upv.es!jroman 54 
          the environment variable <font face="Courier New, Courier, mono">SLEPC_DIR</font>
55 
          to the full path of the SLEPc home directory, for example,<br>
56 
          &nbsp;&nbsp;&nbsp; <font face="Courier New, Courier, mono">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;setenv
944 ono.com!jroman 57 
          SLEPC_DIR /home/username/slepc-2.3.x</font><br>
6 dsic.upv.es!jroman 58 
          In addition to this variable, <font face="Courier New, Courier, mono">PETSC_DIR</font>
1099 slepc 59 
          (and optionally <font face="Courier New, Courier, mono">PETSC_ARCH</font>) must also
60 
          be set appropriately.<br>
6 dsic.upv.es!jroman 61 
          </font></font></li>
1099 slepc 62 
        <li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">
944 ono.com!jroman 63 
          In the SLEPc directory, execute<br>
64 
          <font face="Arial, Helvetica, sans-serif">&nbsp;&nbsp;&nbsp;<font face="Courier New, Courier, mono">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;./config/configure.py</font><br>
65 
          </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>
6 dsic.upv.es!jroman 66 
          </font></font></li>
1099 slepc 67 
        <li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">
6 dsic.upv.es!jroman 68 
          In the SLEPc home directory, type<br>
69 
          <font face="Arial, Helvetica, sans-serif">&nbsp;&nbsp;&nbsp;<font face="Courier New, Courier, mono">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;make
944 ono.com!jroman 70 
          </font></font><br>
6 dsic.upv.es!jroman 71 
          </font></font></li>
1099 slepc 72 
        <li style="padding-top: 0.5em"><font face="Arial, Helvetica, sans-serif" align="left"><font size="2">If
73 
          the installation went smoothly, then try running some test examples with <br>
74 
          <font face="Arial, Helvetica, sans-serif">&nbsp;&nbsp;&nbsp;<font face="Courier New, Courier, mono">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;make test</font><br>
6 dsic.upv.es!jroman 75 
          </font></font><font size="2">Examine the output for any obvious errors
76 
          or problems.<br>
77 
          </font></font></li>
1099 slepc 78 
        <!--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  
6 dsic.upv.es!jroman 79 
          Fortran libraries are built automatically during the installation outlined
80 
          above. To compile and test the Fortran examples, use the command<br>
81 
          </font><font face="Arial, Helvetica, sans-serif"><font size="2"><font face="Arial, Helvetica, sans-serif">&nbsp;&nbsp;&nbsp;<font face="Courier New, Courier, mono">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;make
1099 slepc 82 
          testfortran</font></font></font></font></font></li-->
6 dsic.upv.es!jroman 83 
      </ol>
84 
      <div align="left"><font face="Arial, Helvetica, sans-serif">
85 
        <p>&nbsp;</p>
944 ono.com!jroman 86 
 
6 dsic.upv.es!jroman 87 
        <p><font size="3"><b>Optional Software</b></font></p>
88 
        <p><font size="2">SLEPc provides an interface to several software packages.
89 
          These should be installed before installing SLEPc. These packages are
90 
          not developed, maintained, or supported by the SLEPc team; we merely
91 
          provide an interface to them. To integrate one of these libraries in
92 
          SLEPc:</font></p>
93 
        </font></div>
94 
      <ul>
95 
        <li>
96 
          <div align="left"><font face="Arial, Helvetica, sans-serif"><font size="2">First
97 
            install the external package following its instructions. Make sure
1099 slepc 98 
            you use the same compilers and MPI that you plan to use with PETSc/SLEPc.
99 
            These libraries should be linked also with the same LAPACK version
100 
            as PETSc.<br>
6 dsic.upv.es!jroman 101 
            </font></font></div>
102 
        </li>
103 
        <li>
104 
          <div align="left"><font face="Arial, Helvetica, sans-serif"><font size="2">Enable
944 ono.com!jroman 105 
            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>
6 dsic.upv.es!jroman 106 
            <br>
944 ono.com!jroman 107 
            <font face="Courier New, Courier, mono">&nbsp;&nbsp;&nbsp;
108 
        config/configure.py --with-arpack-dir=/usr/software/ARPACK <br>
109 
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--with-arpack-flags=-lparpack,-larpack
110 
            </font></font></font></div>
6 dsic.upv.es!jroman 111 
        </li>
944 ono.com!jroman 112 
        <li>
113 
          <div align="left"><font face="Arial, Helvetica, sans-serif"><font size="2">
114 
            Build the SLEPc libraries.  <br>
115 
            </font></font></div>
116 
        </li>
6 dsic.upv.es!jroman 117 
      </ul>
118 
      <div align="left">
119 
        <p><font size="2" face="Arial, Helvetica, sans-serif">SLEPc currently
120 
          interfaces to the following libraries:</font></p>
121 
      </div>
122 
      <ul>
123 
        <li>
124 
          <div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.caam.rice.edu/software/ARPACK" target="_blank">ARPACK</a>
125 
            (Implicitly Restarted Arnoldi/Lanczos solver).</font></div>
126 
        </li>
127 
        <li>
128 
          <div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.nersc.gov/%7Eosni/#Software" target="_blank">BLZPACK</a>
129 
            (Block Lanczos with selective and partial reorthogonalization). </font></div>
130 
        </li>
131 
        <li>
619 dsic.upv.es!jroman 132 
          <div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.nersc.gov/%7Ekewu/planso.html" target="_blank">PLANSO</a>
6 dsic.upv.es!jroman 133 
            (Lanczos with partial reorthogonalization).</font></div>
134 
        </li>
135 
        <li>
136 
          <div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www.nersc.gov/%7Ekewu/trlan.html" target="_blank">TRLAN</a>
137 
            (Dynamic Thick Restart Lanczos solver).</font></div>
138 
        </li>
944 ono.com!jroman 139 
        <li>
140 
          <div align="left"><font size="2" face="Arial, Helvetica, sans-serif"><a href="http://www-math.cudenver.edu/%7Eaknyazev/software/CG" target="_blank">LOBPCG</a>
141 
            (Locally Optimal Block Preconditioned Conjugate Gradient).</font></div>
142 
        </li>
6 dsic.upv.es!jroman 143 
      </ul>
144 
      <div align="left">
145 
        <p><font size="2" face="Arial, Helvetica, sans-serif">Additional information
944 ono.com!jroman 146 
          about these packages can be found in the SLEPc Users Manual.</font>
6 dsic.upv.es!jroman 147 
        </p>
148 
        <p>&nbsp;</p>
149 
        <p>&nbsp;</p>
150 
      </div></td>
151 
  </tr>
152 
</table>
153 
</body>
154 
</html>