...
 
Commits (16)
......@@ -2,6 +2,12 @@ Changelog for upcoming release
- not yet decided
Changelog for ELPA 2019.05.002
- repacking of the src since the legacy interface has been forgotten in the
2019.05.001 release
Changelog for ELPA 2019.05.001
- elpa_print_kernels supports GPU usage
......
......@@ -2,7 +2,7 @@
## Preamble ##
This file provides documentation on how to build the *ELPA* library in **version ELPA-2019.05.001**.
This file provides documentation on how to build the *ELPA* library in **version ELPA-2019.05.002**.
With release of **version ELPA-2017.05.001** the build process has been significantly simplified,
which makes it easier to install the *ELPA* library.
......@@ -16,8 +16,7 @@ With release ELPA 2019.05.001 the legacy API is disabled by default, however,
can be still switched on at build time.
Most likely with the release ELPA 2019.11.001 the legacy API will be deprecated and not supported anymore.
The release of ELPA 2019.05.001 changes the ABI and API, since it allows to also build the C-functions with optional error arguments
The release of ELPA 2019.05.002 does not change the API and ABI compared to the release 2019.05.001
## How to install *ELPA* ##
First of all, if you do not want to build *ELPA* yourself, and you run Linux,
......
# [Eigenvalue SoLvers for Petaflop-Applications (ELPA)] (http://elpa.mpcdf.mpg.de)
# [Eigenvalue SoLvers for Petaflop-Applications (ELPA)](http://elpa.mpcdf.mpg.de)
## Current Release ##
The current release is ELPA 2019.05.001 The current supported API version
The current release is ELPA 2019.05.002 The current supported API version
is 20190501. This release supports the earliest API version 20170403.
The old, obsolete legacy API will be deprecated in the future !
......@@ -22,9 +22,11 @@ status](https://gitlab.mpcdf.mpg.de/elpa/elpa/badges/master/build.svg)](https://
[![Code
coverage](https://gitlab.mpcdf.mpg.de/elpa/badges/master/coverage.svg)](http://elpa.pages.mpcdf.de/elpa/coverage_summary)
[![License: LGPL v3][license-badge]](LICENSE)
![License LGPL v3][license-badge]
[license-badge]: https://img.shields.io/badge/License-LGPL%20v3-blue.svg
## About *ELPA* ##
The computation of selected or all eigenvalues and eigenvectors of a symmetric
......@@ -63,8 +65,8 @@ GNU Lesser General Public License as published by the Free Software Foundation.
There exist several ways to obtain the *ELPA* library either as sources or pre-compiled packages:
- official release tar-gz sources from the [*ELPA* webpage] (http://elpa.mpcdf.mpg.de/elpa-tar-archive)
- from the [*ELPA* git repository] (https://gitlab.mpcdf.mpg.de/elpa/elpa)
- official release tar-gz sources from the *ELPA* [webpage](https://elpa.mpcdf.mpg.de/elpa-tar-archive)
- from the *ELPA* [git repository](https://gitlab.mpcdf.mpg.de/elpa/elpa)
- as packaged software for several Linux distributions (e.g. Debian, Fedora, OpenSuse)
## Terms of usage
......@@ -104,7 +106,7 @@ Nonetheless, we are grateful if you cite the following publications:
Kus; P.; Marek, A.; Koecher, S. S.; Kowalski H.-H.; Carbogno, Ch.; Scheurer, Ch.; Reuter, K.; Scheffler, M.; Lederer, H.
"Optimizations of the Eigenvaluesolvers in the ELPA Library",
Parllel Computing 85, 167-177 (2019)
Parallel Computing 85, 167-177 (2019)
## Installation of the *ELPA* library
......@@ -119,13 +121,12 @@ configure *ELPA*):
- Scalapack routines
- a working MPI library
Please refer to the **INSTALL document** on details of the installation process and
Please refer to the [INSTALL document](INSTALL.md) on details of the installation process and
the possible configure options.
## Using *ELPA*
Please have a look at the "**USERS_GUIDE**" file, to get a documentation or at the [online]
(http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001/html/index.html) doxygen
Please have a look at the [USERS_GUIDE](USERS_GUIDE.md) file, to get a documentation or at the [online](http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.002/html/index.html) doxygen
documentation, where you find the definition of the interfaces.
## Contributing to *ELPA*
......@@ -134,6 +135,6 @@ It has been, and is, a tremendous effort to develop and maintain the
*ELPA* library. A lot of things can still be done, but our man-power is limited.
Thus every effort and help to improve the *ELPA* library is highly appreciated.
For details please see the CONTRIBUTING document.
For details please see the [CONTRIBUTING](CONTRIBUTING.md) document.
This file contains the release notes for the ELPA 2019.05.001 version
This file contains the release notes for the ELPA 2019.05.002 version
What is new?
-------------
For detailed information about changes since release ELPA 2018.11 please have a look at the Changelog file
- user can define a default kernel at build time
- ELPA VERSION number is exported to the C-header
- C functions can have an optional error argument, if compiler supports this
=> ABI and API change
- as anounced, removal of deprecated routines
- new kernels for Arm arch64
- repackaging of src files, to include forgotten files of the legacy interface
ABI change
---------------------
Since release 2018.10.001 the ABI has changed.
Since release 2019.05.001 the ABI has not changed.
Any incompatibilities to previous version?
---------------------------------------
For Fortran:
Break of ABI compatibility, since all routines announced as deperecated have been removed
For C:
Break of ABI and API compatibility, since all functions obtained a required int* argument of the error code.
no
......@@ -146,7 +146,7 @@ Local documentation (via man pages) should be available (if *ELPA* has been inst
For example "man elpa2_print_kernels" should provide the documentation for the *ELPA* program which prints all
the available kernels.
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001/html/index.html)
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.002/html/index.html)
for each *ELPA* release is available.
......@@ -13,7 +13,7 @@ Local documentation (via man pages) should be available (if *ELPA* has been inst
For example "man elpa2_print_kernels" should provide the documentation for the *ELPA* program, which prints all
the available kernels.
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001/html/index.html)
Also a [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.002/html/index.html)
for each *ELPA* release is available.
......@@ -201,7 +201,7 @@ The following table gives a list of all supported parameters which can be used t
## III) List of computational routines ##
The following compute routines are available in *ELPA*: Please have a look at the man pages or [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001/html/index.html) for details.
The following compute routines are available in *ELPA*: Please have a look at the man pages or [online doxygen documentation] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.002/html/index.html) for details.
| Name | Purpose | since API version |
......
......@@ -22,7 +22,7 @@ The *ELPA* library consists of two main parts:
Both variants of the *ELPA* solvers are available for real or complex singe and double precision valued matrices.
Thus *ELPA* provides the following user functions (see man pages or [online] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.001/html/index.html) for details):
Thus *ELPA* provides the following user functions (see man pages or [online] (http://elpa.mpcdf.mpg.de/html/Documentation/ELPA-2019.05.002/html/index.html) for details):
- elpa_get_communicators : set the row / column communicators for *ELPA*
- elpa_solve_evp_complex_1stage_{single|double} : solve a {single|double} precision complex eigenvalue proplem with the *ELPA 1stage* solver
......
......@@ -19,7 +19,7 @@
%define with_openmp 0
Name: elpa
Version: 2019.05.001
Version: 2019.05.002
Release: 1
Summary: A massively parallel eigenvector solver
License: LGPL-3.0
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2019.05.001], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001"
AC_INIT([elpa_test_project],[2019.05.002], elpa-library@rzg.mpg.de)
elpaversion="2019.05.002"
AC_CONFIG_SRCDIR([src/test_real.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2019.05.001], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001"
AC_INIT([elpa_test_project],[2019.05.002], elpa-library@rzg.mpg.de)
elpaversion="2019.05.002"
AC_CONFIG_SRCDIR([src/test_real.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2019.05.001], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001"
AC_INIT([elpa_test_project],[2019.05.002], elpa-library@rzg.mpg.de)
elpaversion="2019.05.002"
AC_CONFIG_SRCDIR([src/test_real2.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa2_test_project],[2019.05.001], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001"
AC_INIT([elpa2_test_project],[2019.05.002], elpa-library@rzg.mpg.de)
elpaversion="2019.05.002"
AC_CONFIG_SRCDIR([src/test_real2.F90])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2019.05.001], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001"
AC_INIT([elpa_test_project],[2019.05.002], elpa-library@rzg.mpg.de)
elpaversion="2019.05.002"
AC_CONFIG_SRCDIR([src/test_real.c])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......
AC_PREREQ([2.69])
AC_INIT([elpa_test_project],[2019.05.001], elpa-library@rzg.mpg.de)
elpaversion="2019.05.001"
AC_INIT([elpa_test_project],[2019.05.002], elpa-library@rzg.mpg.de)
elpaversion="2019.05.002"
AC_CONFIG_SRCDIR([src/test_real2.c])
AM_INIT_AUTOMAKE([foreign -Wall subdir-objects])
......