Block-Structured AMR Software Framework
Loading...
Searching...
No Matches
AMReX_HypreIJIface.H
Go to the documentation of this file.
1#ifndef AMREX_HYPREIJIFACE_H
2#define AMREX_HYPREIJIFACE_H
3#include <AMReX_Config.H>
4
5#include <AMReX_MultiFab.H>
6
7#include <HYPRE.h>
8#include <HYPRE_parcsr_ls.h>
9#include <HYPRE_parcsr_mv.h>
10
11#include <memory>
12
19namespace amrex {
20
25{
26public:
27 using HypreIntType = HYPRE_Int;
28 using HypreRealType = HYPRE_Real;
29
39 int verbose);
40
42
43 HypreIJIface (HypreIJIface const&) = delete;
47
53 void parse_inputs(const std::string& prefix = "hypre");
54
62 void solve(HypreRealType rel_tol, HypreRealType abs_tol, HypreIntType max_iter);
63
65 [[nodiscard]] HYPRE_IJMatrix A() { return m_mat; }
66
68 [[nodiscard]] HYPRE_IJVector b() { return m_rhs; }
69
71 [[nodiscard]] HYPRE_IJVector x() { return m_sln; }
72
74 [[nodiscard]] HypreIntType getNumIters() const { return m_num_iterations; }
75
77 [[nodiscard]] HypreRealType getFinalResidualNorm() const { return m_final_res_norm; }
78
79 [[nodiscard]] bool adjustSingularMatrix() const { return m_adjust_singular_matrix; }
80
81private:
82 void init_preconditioner(const std::string& prefix, const std::string& name);
83 void init_solver(const std::string& prefix, const std::string& name);
84
86 void run_hypre_setup();
87 void run_hypre_solve();
88
89 // Preconditioners
90 void boomeramg_precond_configure(const std::string& prefix);
91 void euclid_precond_configure(const std::string& prefix);
92 void ilu_precond_configure(const std::string& prefix);
93
94 // Solvers
95 void boomeramg_solver_configure(const std::string& prefix);
96 void gmres_solver_configure(const std::string& prefix);
97 void cogmres_solver_configure(const std::string& prefix);
98 void lgmres_solver_configure(const std::string& prefix);
99 void flex_gmres_solver_configure(const std::string& prefix);
100 void bicgstab_solver_configure(const std::string& prefix);
101 void pcg_solver_configure(const std::string& prefix);
102 void hybrid_solver_configure(const std::string& prefix);
103
104
105 MPI_Comm m_comm{MPI_COMM_NULL};
106
107 HYPRE_IJMatrix m_mat{nullptr};
108 HYPRE_IJVector m_rhs{nullptr};
109 HYPRE_IJVector m_sln{nullptr};
110
111 HYPRE_ParCSRMatrix m_parA{nullptr};
112 HYPRE_ParVector m_parRhs{nullptr};
113 HYPRE_ParVector m_parSln{nullptr};
114
115 HYPRE_Solver m_solver{nullptr};
116 HYPRE_Solver m_precond{nullptr};
117
118 HypreIntType (*m_solverDestroyPtr)(HYPRE_Solver){nullptr};
119 HypreIntType (*m_solverSetupPtr)(
120 HYPRE_Solver, HYPRE_ParCSRMatrix, HYPRE_ParVector, HYPRE_ParVector){nullptr};
121 HypreIntType (*m_solverSolvePtr)(
122 HYPRE_Solver, HYPRE_ParCSRMatrix, HYPRE_ParVector, HYPRE_ParVector){nullptr};
123 HypreIntType (*m_solverPrecondPtr)(
124 HYPRE_Solver,
125 HYPRE_PtrToParSolverFcn,
126 HYPRE_PtrToParSolverFcn,
127 HYPRE_Solver){nullptr};
128
129 HypreIntType (*m_precondDestroyPtr)(HYPRE_Solver){nullptr};
130 HypreIntType (*m_precondSetupPtr)(
131 HYPRE_Solver, HYPRE_ParCSRMatrix, HYPRE_ParVector, HYPRE_ParVector){nullptr};
132 HypreIntType (*m_precondSolvePtr)(
133 HYPRE_Solver, HYPRE_ParCSRMatrix, HYPRE_ParVector, HYPRE_ParVector){nullptr};
134
135 HypreIntType (*m_solverSetTolPtr)(HYPRE_Solver, amrex::Real){nullptr};
136 HypreIntType (*m_solverSetAbsTolPtr)(HYPRE_Solver, amrex::Real){nullptr};
137 HypreIntType (*m_solverSetMaxIterPtr)(HYPRE_Solver, HypreIntType){nullptr};
138 HypreIntType (*m_solverNumItersPtr)(HYPRE_Solver, HypreIntType*){nullptr};
139 HypreIntType (*m_solverFinalResidualNormPtr)(HYPRE_Solver, amrex::Real*){nullptr};
140
141 HypreIntType m_ilower{0};
142 HypreIntType m_iupper{0};
143
144 HypreRealType m_final_res_norm;
145 HypreIntType m_num_iterations;
146
147 std::string m_solver_name{"BoomerAMG"};
148 std::string m_preconditioner_name{"none"};
149 std::string m_file_prefix{"IJ"};
150
152 int m_verbose{0};
153
154 unsigned int m_write_counter{0};
155
157 bool m_has_preconditioner{false};
158
160 bool m_need_setup{true};
161
163 bool m_recompute_preconditioner{true};
164
166 bool m_adjust_singular_matrix{false};
167
169 bool m_write_files{false};
170
172 bool m_overwrite_files{true};
173};
174
175} // namespace amrex
176
177#endif /* AMREX_HYPREIJIFACE_H */
Convenience interface for configuring and invoking HYPRE IJ solvers.
Definition AMReX_HypreIJIface.H:25
void parse_inputs(const std::string &prefix="hypre")
Parse runtime options (solver, preconditioner, tolerances).
Definition AMReX_HypreIJIface.cpp:162
~HypreIJIface()
Definition AMReX_HypreIJIface.cpp:71
HYPRE_IJMatrix A()
IJ matrix instance.
Definition AMReX_HypreIJIface.H:65
HYPRE_IJVector b()
Right hand side IJ vector instance.
Definition AMReX_HypreIJIface.H:68
HypreIJIface(HypreIJIface const &)=delete
HypreIntType getNumIters() const
Number of iterations taken by the solver to reach the desired tolerance.
Definition AMReX_HypreIJIface.H:74
HYPRE_Int HypreIntType
Definition AMReX_HypreIJIface.H:27
HypreIJIface(HypreIJIface &&)=delete
HypreIJIface & operator=(HypreIJIface const &)=delete
bool adjustSingularMatrix() const
Definition AMReX_HypreIJIface.H:79
HypreRealType getFinalResidualNorm() const
Final residual norm after a linear solve.
Definition AMReX_HypreIJIface.H:77
HYPRE_Real HypreRealType
Definition AMReX_HypreIJIface.H:28
HYPRE_IJVector x()
Solution IJ vector instance.
Definition AMReX_HypreIJIface.H:71
void solve(HypreRealType rel_tol, HypreRealType abs_tol, HypreIntType max_iter)
Solve the linear system using the configured solver/preconditioner.
Definition AMReX_HypreIJIface.cpp:111
amrex_real Real
Floating Point Type for Fields.
Definition AMReX_REAL.H:79
int MPI_Comm
Definition AMReX_ccse-mpi.H:51
static constexpr int MPI_COMM_NULL
Definition AMReX_ccse-mpi.H:59
Definition AMReX_Amr.cpp:49