pardiso Class Reference

Solver for general sparse matrices. More...

#include <pardiso.hpp>

Detailed Description

Solver for general sparse matrices.

It solves the system of linear equations A * X = B with a general sparse matrix A. The RHS matrix B is a dense matrix.

The matrix A should be stored in the Compressed Sparse Row (CSR) format with one-based indexing. Use the call operator to set the parameters iparm for the solver.

The example usage can be seen as follows.

/*******************************************************************************
 * Copyright (C) 2025-2026 Theodore Chang
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 ******************************************************************************/
#include <ezp/pardiso.hpp>
#include <iomanip>
#include <iostream>
 
int main() {
#ifdef EZP_MKL
    const auto& comm_world{mpl::environment::comm_world()};
 
    auto solver = ezp::pardiso<double, int_t>(ezp::matrix_type::real_and_nonsymmetric, ezp::message_level::no_output);
 
    int N = 10, NRHS = 1;
 
    std::vector<int_t> ia, ja;
    std::vector<double> a, b;
 
    const auto populate = [&] {
        if(0 != comm_world.rank()) return;
 
        // initialise one-based CSR matrix on the root process
        ia.resize(N + 1);
        ja.resize(N);
        a.resize(N);
        b.resize(N * NRHS);
 
        for(auto i = 0; i < N; i++) ia[i] = ja[i] = a[i] = i + 1;
        ia[N] = N + 1;
 
        std::ranges::fill(b, 1.);
    };
 
    populate();
 
    // need to wrap the data in sparse_csr_mat objects
    auto info = solver.solve({N, N, ia.data(), ja.data(), a.data()}, {N, NRHS, b.data()});
 
    const auto print = [&] {
        if(0 != comm_world.rank()) return;
 
        std::cout << std::fixed << std::setprecision(10) << "Info: " << info << '\n';
        std::cout << "Solution:\n";
        for(const double i : b) std::cout << i << '\n';
    };
 
    print();
 
    N = 20;
 
    populate();
    info = solver.solve({N, N, ia.data(), ja.data(), a.data()}, {N, NRHS, b.data()});
    print();
 
    return info;
#else
    std::cerr << "MKL not enabled.\n";
    return 0;
#endif
}
 

Author

tlc

Date

23/03/2025

Version

1.0.0

---

The documentation for this class was generated from the following file:

• ezp/pardiso.hpp