README for PDL::SVDSLEPc

ABSTRACT
    PDL::SVDLIBC - PDL interface to SLEPc sparse singular value
    decomposition

REQUIREMENTS
    PDL Tested version 2.015.

    SLEPc
        "Scalable Library for Eigenvalue Problem Computations". Tested
        version 3.4.2, debian packages libslepc3.4.2, libslepc3.4.2-dev.

        Available from <http://slepc.upv.es/>.

    PETSc
        "Portable, Extensible Toolkit for Scientific Computation", required
        by SLEPc. Tested version 3.4.2, debian packages petsc3.4.2,
        petsc3.4.2-dev.

        Available from <http://www.mcs.anl.gov/petsc/>.

DESCRIPTION
    PDL::SVDSLEPc provides a PDL interface to the SLEPc routines for
    singular value decomposition of large sparse matrices.

BUILDING
    Build this module as you would any perl module, by doing something akin
    to the following:

     gzip -dc distname-XX.YY.tar.gz | tar -xof -
     cd distname-XX.YY/
     perl Makefile.PL
     make
     make test                                     # optional
     make install

    See perlmodinstall(1) for details.

    During the build process, you may be prompted for the locations of
    required libraries, header files, etc.

KNOWN BUGS
    You might see OpenMPI errors such as the following when trying to use
    this module:

     mca: base: component find: unable to open /usr/lib/openmpi/lib/openmpi/mca_paffinity_hwloc: perhaps a missing symbol, or compiled for a different version of Open MPI? (ignored)

    If you do, you probably need to configure your runtime linker to
    pre-load the OpenMPI libraries, e.g. with

     export LD_PRELOAD=/usr/lib/libmpi.so

    or similar. An alternative is to build OpenMPI with the
    "--disable-dlopen" option. See
    <http://www.open-mpi.org/faq/?category=troubleshooting#missing-symbols>
    for details.

AUTHOR
    Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE
    Copyright (c) 2015, Bryan Jurish. All rights reserved.

    This package is free software, and entirely without warranty. You may
    redistribute it and/or modify it under the same terms as Perl itself,
    either 5.20.2 or any newer version of Perl 5 you have available.