Adding formating for paper references and code highlighting

pull/2/head
Soren Rasmussen 7 years ago
parent 1229f995bb
commit 10b14b9e20

@ -2,19 +2,19 @@ PSBLAS library, version 3.5.
============================ ============================
The architecture of the Fortran 2003 sparse BLAS is described in: The architecture of the Fortran 2003 sparse BLAS is described in:
S. Filippone, A. Buttari >S. Filippone, A. Buttari. Object-Oriented Techniques for Sparse Matrix
Object-Oriented Techniques for Sparse Matrix Computations in Fortran >Computations in Fortran 2003, ACM Trans. on Math. Software, vol. 38, No.
2003, ACM Trans. on Math. Software, vol. 38, No. 4, 2012. 4, 2012.
The ideas are explored further with the paper: The ideas are explored further with the paper:
V. Cardellini, S. Filippone and D. Rouson >V. Cardellini, S. Filippone and D. Rouson. Design Patterns for
Design Patterns for sparse-matrix computations on hybrid CPU/GPU >sparse-matrix computations on hybrid CPU/GPU platforms, Scientific
platforms, Scientific Programming, 22(2014), pp.1-19. >Programming, 22(2014), pp.1-19.
Version 1.0 of the library is described in: Version 1.0 of the library is described in:
S. Filippone, M. Colajanni >S. Filippone, M. Colajanni. PSBLAS: A library for parallel linear
PSBLAS: A library for parallel linear algebra computation on sparse >algebra computation on sparse matrices, ACM Trans. on Math. Software,
matrices, ACM Trans. on Math. Software, 26(4), Dec. 2000, pp. 527-550. >26(4), Dec. 2000, pp. 527-550.
UTILITIES UTILITIES
@ -36,9 +36,9 @@ We originally included a modified implementation of some of the Sparker
(serial sparse BLAS) material; this has been completely rewritten, way (serial sparse BLAS) material; this has been completely rewritten, way
beyond the intention(s) and responsibilities of the original developers. beyond the intention(s) and responsibilities of the original developers.
The main reference for the serial sparse BLAS is: The main reference for the serial sparse BLAS is:
Duff, I., Marrone, M., Radicati, G., and Vittoli, C. >Duff, I., Marrone, M., Radicati, G., and Vittoli, C. Level 3 basic
Level 3 basic linear algebra subprograms for sparse matrices: a user >linear algebra subprograms for sparse matrices: a user level interface,
level interface, ACM Trans. Math. Softw., 23(3), 379-401, 1997. >ACM Trans. Math. Softw., 23(3), 379-401, 1997.
INSTALLING INSTALLING
@ -55,20 +55,20 @@ prerequisites (see also SERIAL below):
3. We have had good results with the METIS library, from 3. We have had good results with the METIS library, from
http://www-users.cs.umn.edu/~karypis/metis/metis/main.html. http://www-users.cs.umn.edu/~karypis/metis/metis/main.html.
This is optional; it is used in the util and test/fileread This is optional; it is used in the util and test/fileread
directories but only if you specify --with-metis. directories but only if you specify `--with-metis`.
4. If you have the AMD package of Davis, Duff and Amestoy, you can 4. If you have the AMD package of Davis, Duff and Amestoy, you can
specify --with-amd (see ./configure --help for more details). specify `--with-amd` (see `./configure --help` for more details).
The configure script will generate a Make.inc file suitable for building The configure script will generate a Make.inc file suitable for building
the library. The script is capable of recognizing the needed libraries the library. The script is capable of recognizing the needed libraries
with their default names; if they are in unusual places consider adding with their default names; if they are in unusual places consider adding
the paths with --with-libs, or explicitly specifying the names in the paths with `--with-libs`, or explicitly specifying the names in
--with-blas, etc. Please note that a common way for the configure script `--with-blas`, etc. Please note that a common way for the configure script
to fail is to specify inconsistent MPI vs. plain compilers, either to fail is to specify inconsistent MPI vs. plain compilers, either
directly or indirectly via environment variables; e.g. specifying the directly or indirectly via environment variables; e.g. specifying the
Intel compiler with FC=ifort while at the same time having an Intel compiler with `FC=ifort` while at the same time having an
MPIFC=mpif90 which points to GNU Fortran. The best way to avoid this `MPIFC=mpif90` which points to GNU Fortran. The best way to avoid this
situation is (in our opinion) to use the environment modules package situation is (in our opinion) to use the environment modules package
(see http://modules.sourceforge.net/), and load the relevant (see http://modules.sourceforge.net/), and load the relevant
variables with (e.g.) variables with (e.g.)
@ -85,20 +85,20 @@ After you have Make.inc fixed, run
make make
``` ```
to compile the library; go to the test directory and its subdirectories to compile the library; go to the test directory and its subdirectories
to get test programs done. If you specify --prefix=/path you can do make to get test programs done. If you specify `--prefix=/path` you can do make
install and the libraries will be installed under /path/lib, while the install and the libraries will be installed under /path/lib, while the
module files will be installed under /path/include. module files will be installed under /path/include.
SERIAL SERIAL
------ ------
Configuring with --enable-serial will provide a fake MPI stub library Configuring with `--enable-serial` will provide a fake MPI stub library
that enables running in pure serial mode; no MPI installation is needed that enables running in pure serial mode; no MPI installation is needed
in this case (but note that the fake MPI stubs are only guaranteed to in this case (but note that the fake MPI stubs are only guaranteed to
cover what we use internally, it's not a complete replacement). cover what we use internally, it's not a complete replacement).
LONG INTEGERS LONG INTEGERS
------------- -------------
We have an experimental flag --enable-long-integers that will enable We have an experimental flag `--enable-long-integers` that will enable
having 8-byte integer data, allowing an index space larger than 2G; some having 8-byte integer data, allowing an index space larger than 2G; some
small cases have been tested but we do not offer full guarantee (yet). small cases have been tested but we do not offer full guarantee (yet).

Loading…
Cancel
Save