Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Multigrid improvement and fix #982

Merged
merged 20 commits into from
Nov 8, 2022
Merged

Multigrid improvement and fix #982

merged 20 commits into from
Nov 8, 2022

Conversation

yhmtsai
Copy link
Member

@yhmtsai yhmtsai commented Mar 4, 2022

This pr is mainly for the status and the collection of recent multigrid improvement or fix.
the updates are splitted into #981 #980. Some changes related multigrid itself will be put here.
Please do not focus on this pr until #981 #980 are reviewed and merged

  • uses the MultigridState to cache the internal vector
  • changes the mid_smoother default behavior to standalone with nullptr. i.e. no smoother in the middle of F cycle and W cycle
  • deletes the KCycle from the public interface because I can not make it work well with the current mixed type design. I need more time to investigate it.
  • uses the same interface from ApplyWithInitialGuess not zero_guess now. i.e. factory.with_default_initial_guess(initial_guess_mode::zero) for preconditioned.
  • change the three bool (x_is_zero, is_first, is_end) to an enum.

TODO:

@yhmtsai yhmtsai added the 1:ST:WIP This PR is a work in progress. Not ready for review. label Mar 4, 2022
@yhmtsai yhmtsai self-assigned this Mar 4, 2022
@ginkgo-bot ginkgo-bot added mod:all This touches all Ginkgo modules. reg:build This is related to the build system. reg:example This is related to the examples. reg:testing This is related to testing. type:matrix-format This is related to the Matrix formats type:multigrid This is related to multigrid type:solver This is related to the solvers labels Mar 4, 2022
@tcojean tcojean added this to the Ginkgo 1.5.0 milestone Oct 20, 2022
@yhmtsai yhmtsai added the 1:ST:high-importance This issue/PR is of high importance and must be addressed as soon as possible. label Oct 28, 2022
core/solver/multigrid.cpp Outdated Show resolved Hide resolved
examples/mixed-multigrid-solver/mixed-multigrid-solver.cpp Outdated Show resolved Hide resolved
Copy link
Member

@tcojean tcojean left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some comments

cuda/CMakeLists.txt Outdated Show resolved Hide resolved
examples/mixed-multigrid-solver/mixed-multigrid-solver.cpp Outdated Show resolved Hide resolved
examples/mixed-multigrid-solver/mixed-multigrid-solver.cpp Outdated Show resolved Hide resolved
examples/mixed-multigrid-solver/mixed-multigrid-solver.cpp Outdated Show resolved Hide resolved
examples/mixed-multigrid-solver/mixed-multigrid-solver.cpp Outdated Show resolved Hide resolved
include/ginkgo/core/solver/solver_base.hpp Show resolved Hide resolved
core/solver/multigrid.cpp Outdated Show resolved Hide resolved
include/ginkgo/core/solver/multigrid.hpp Outdated Show resolved Hide resolved
include/ginkgo/core/solver/multigrid.hpp Outdated Show resolved Hide resolved
include/ginkgo/core/solver/multigrid.hpp Outdated Show resolved Hide resolved
@yhmtsai yhmtsai force-pushed the improve_multigrid branch 4 times, most recently from 56764af to b609166 Compare November 6, 2022 18:19
Copy link
Member

@thoasm thoasm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Initial review. So far, only nits and nothing serious found.

core/solver/multigrid.cpp Outdated Show resolved Hide resolved
Comment on lines 214 to 256
* @param b the right hand side
* @param x the input vectors
*/
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: missing documentation for x_is_zero, is_first and is_end

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

change it to the enum cycle info

include/ginkgo/core/solver/multigrid.hpp Outdated Show resolved Hide resolved
include/ginkgo/core/solver/multigrid.hpp Outdated Show resolved Hide resolved
core/solver/multigrid.cpp Outdated Show resolved Hide resolved
core/solver/multigrid.cpp Outdated Show resolved Hide resolved
core/solver/multigrid.cpp Outdated Show resolved Hide resolved
examples/mixed-multigrid-solver/mixed-multigrid-solver.cpp Outdated Show resolved Hide resolved
Copy link
Member

@tcojean tcojean left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

reference/test/solver/multigrid_kernels.cpp Show resolved Hide resolved
core/solver/multigrid.cpp Outdated Show resolved Hide resolved
Copy link
Member

@pratikvn pratikvn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some minor comments. LGTM!

auto smoother_gen = gko::share(
ir::build()
.with_solver(inner_solver_gen)
.with_relaxation_factor(0.9)
.with_relaxation_factor(static_cast<ValueType>(0.9))
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These static casts are a bit annoying. Can we remove them here by moving them to where the parameter is being initialized ?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Related to #1162 ;)

core/solver/multigrid.cpp Outdated Show resolved Hide resolved
core/solver/multigrid.cpp Show resolved Hide resolved
// origin or next or first
bool use_pre = (info & cycle_info::first_of_cycle) ||
mid_case == multigrid::mid_smooth_type::both ||
mid_case == multigrid::mid_smooth_type::pre_smoother;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we check for the case if the user wants a pre-smoother (has used the mid_smooth_type::pre_smoother option) but has not provided a pre_smoother list ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it will behave like pre_smoother, so it will not process smoother

@yhmtsai yhmtsai added 1:ST:ready-to-merge This PR is ready to merge. and removed 1:ST:WIP This PR is a work in progress. Not ready for review. labels Nov 7, 2022
Copy link
Member

@upsj upsj left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry I didn't get to this sooner, a few comments before this gets merged, I'll try to finish the rest tomorrow

Comment on lines 148 to +150
{
return !parameters_.zero_guess;
}

/**
* Gets the stopping criterion factory of the solver.
*
* @return the stopping criterion factory
*/
std::shared_ptr<const stop::CriterionFactory> get_stop_criterion_factory()
const
{
return stop_criterion_factory_;
}

/**
* Sets the stopping criterion of the solver.
*
* @param other the new stopping criterion factory
*/
void set_stop_criterion_factory(
std::shared_ptr<const stop::CriterionFactory> other)
{
stop_criterion_factory_ = std::move(other);
}

/**
* Gets the system operator of the linear system.
*
* @return the system operator
*/
std::shared_ptr<const LinOp> get_system_matrix() const
{
return system_matrix_;
return this->get_default_initial_guess() ==
initial_guess_mode::provided;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: This can go into the source file

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I moved the longer implementation to the source file

include/ginkgo/core/solver/solver_base.hpp Show resolved Hide resolved
}


TYPED_TEST(Multigrid, SolvesStencilSystem2ByFCycle)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

F cycles are still present, is this still obsolete?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Deleting System2 is mostly due to Mixed type. It will introduce single precision error when mixed_precision is off. It seems to make sense, but I want to check it more.

auto smoother_gen = gko::share(
ir::build()
.with_solver(inner_solver_gen)
.with_relaxation_factor(0.9)
.with_relaxation_factor(static_cast<ValueType>(0.9))
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Related to #1162 ;)

core/solver/multigrid.cpp Outdated Show resolved Hide resolved
@@ -52,6 +52,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#include "core/components/fill_array_kernels.hpp"
#include "core/solver/ir_kernels.hpp"
#include "core/solver/multigrid_kernels.hpp"
#include "core/solver/solver_base.hpp"


namespace gko {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

kcycle kernels below can be removed everywhere

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the kernel can be used when we add the kcycle back. It still contains the corresponding tests, so I will prefer keeping them for find them easily

Comment on lines 275 to 278
// current level's nrows x nrhs
std::vector<std::shared_ptr<LinOp>> r_list;
// next level's nrows x nrhs
std::vector<std::shared_ptr<LinOp>> g_list;
std::vector<std::shared_ptr<LinOp>> e_list;
// constant 1 x 1
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems like the comments no longer match the members? Was this left-over from the recursive storage attempt?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the comments is described in the current level fashion, so it also fits in the recursive thought.
level 0 -> r_list[0] has current level's #rows and g_list[0], e_list[0] has next level's #rows

@yhmtsai yhmtsai force-pushed the improve_multigrid branch 2 times, most recently from d3fbfd3 to a2f84eb Compare November 8, 2022 05:14
yhmtsai and others added 2 commits November 8, 2022 20:27
- use cycle_mode
- clean the example and use determinstic
- move the MultigridState into multigrid::detail namespace
- update the documentation
- fix the doxygen

Co-authored-by: Pratik Nayak <pratikvn@protonmail.com>
Co-authored-by: Terry Cojean <terry.cojean@kit.edu>
Co-authored-by: Thomas Grützmacher <thomas.gruetzmacher@kit.edu>
Co-authored-by: Tobias Ribizel <ribizel@kit.edu>
Co-authored-by: Tobias Ribizel <ribizel@kit.edu>
@ginkgo-bot
Copy link
Member

Note: This PR changes the Ginkgo ABI:

Functions changes summary: 187 Removed, 1 Changed (36 filtered out), 295 Added functions
Variables changes summary: 0 Removed, 0 Changed, 0 Added variable

For details check the full ABI diff under Artifacts here

@tcojean tcojean merged commit 03b6a5d into develop Nov 8, 2022
@tcojean tcojean deleted the improve_multigrid branch November 8, 2022 17:34
@sonarcloud
Copy link

sonarcloud bot commented Nov 9, 2022

Kudos, SonarCloud Quality Gate passed!    Quality Gate passed

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
No Duplication information No Duplication information

tcojean added a commit that referenced this pull request Nov 12, 2022
Advertise release 1.5.0 and last changes

+ Add changelog,
+ Update third party libraries
+ A small fix to a CMake file

See PR: #1195

The Ginkgo team is proud to announce the new Ginkgo minor release 1.5.0. This release brings many important new features such as:
- MPI-based multi-node support for all matrix formats and most solvers;
- full DPC++/SYCL support,
- functionality and interface for GPU-resident sparse direct solvers,
- an interface for wrapping solvers with scaling and reordering applied,
- a new algebraic Multigrid solver/preconditioner,
- improved mixed-precision support,
- support for device matrix assembly,

and much more.

If you face an issue, please first check our [known issues page](https://github.com/ginkgo-project/ginkgo/wiki/Known-Issues) and the [open issues list](https://github.com/ginkgo-project/ginkgo/issues) and if you do not find a solution, feel free to [open a new issue](https://github.com/ginkgo-project/ginkgo/issues/new/choose) or ask a question using the [github discussions](https://github.com/ginkgo-project/ginkgo/discussions).

Supported systems and requirements:
+ For all platforms, CMake 3.13+
+ C++14 compliant compiler
+ Linux and macOS
  + GCC: 5.5+
  + clang: 3.9+
  + Intel compiler: 2018+
  + Apple LLVM: 8.0+
  + NVHPC: 22.7+
  + Cray Compiler: 14.0.1+
  + CUDA module: CUDA 9.2+ or NVHPC 22.7+
  + HIP module: ROCm 4.0+
  + DPC++ module: Intel OneAPI 2021.3 with oneMKL and oneDPL. Set the CXX compiler to `dpcpp`.
+ Windows
  + MinGW and Cygwin: GCC 5.5+
  + Microsoft Visual Studio: VS 2019
  + CUDA module: CUDA 9.2+, Microsoft Visual Studio
  + OpenMP module: MinGW or Cygwin.


Algorithm and important feature additions:
+ Add MPI-based multi-node for all matrix formats and solvers (except GMRES and IDR). ([#676](#676), [#908](#908), [#909](#909), [#932](#932), [#951](#951), [#961](#961), [#971](#971), [#976](#976), [#985](#985), [#1007](#1007), [#1030](#1030), [#1054](#1054), [#1100](#1100), [#1148](#1148))
+ Porting the remaining algorithms (preconditioners like ISAI, Jacobi, Multigrid, ParILU(T) and ParIC(T)) to DPC++/SYCL, update to SYCL 2020, and improve support and performance ([#896](#896), [#924](#924), [#928](#928), [#929](#929), [#933](#933), [#943](#943), [#960](#960), [#1057](#1057), [#1110](#1110),  [#1142](#1142))
+ Add a Sparse Direct interface supporting GPU-resident numerical LU factorization, symbolic Cholesky factorization, improved triangular solvers, and more ([#957](#957), [#1058](#1058), [#1072](#1072), [#1082](#1082))
+ Add a ScaleReordered interface that can wrap solvers and automatically apply reorderings and scalings ([#1059](#1059))
+ Add a Multigrid solver and improve the aggregation based PGM coarsening scheme ([#542](#542), [#913](#913), [#980](#980), [#982](#982),  [#986](#986))
+ Add infrastructure for unified, lambda-based, backend agnostic, kernels and utilize it for some simple kernels ([#833](#833), [#910](#910), [#926](#926))
+ Merge different CUDA, HIP, DPC++ and OpenMP tests under a common interface ([#904](#904), [#973](#973), [#1044](#1044), [#1117](#1117))
+ Add a device_matrix_data type for device-side matrix assembly ([#886](#886), [#963](#963), [#965](#965))
+ Add support for mixed real/complex BLAS operations ([#864](#864))
+ Add a FFT LinOp for all but DPC++/SYCL ([#701](#701))
+ Add FBCSR support for NVIDIA and AMD GPUs and CPUs with OpenMP ([#775](#775))
+ Add CSR scaling ([#848](#848))
+ Add array::const_view and equivalent to create constant matrices from non-const data ([#890](#890))
+ Add a RowGatherer LinOp supporting mixed precision to gather dense matrix rows ([#901](#901))
+ Add mixed precision SparsityCsr SpMV support ([#970](#970))
+ Allow creating CSR submatrix including from (possibly discontinuous) index sets ([#885](#885), [#964](#964))
+ Add a scaled identity addition (M <- aI + bM) feature interface and impls for Csr and Dense ([#942](#942))


Deprecations and important changes:
+ Deprecate AmgxPgm in favor of the new Pgm name. ([#1149](#1149)).
+ Deprecate specialized residual norm classes in favor of a common `ResidualNorm` class ([#1101](#1101))
+ Deprecate CamelCase non-polymorphic types in favor of snake_case versions (like array, machine_topology, uninitialized_array, index_set) ([#1031](#1031), [#1052](#1052))
+ Bug fix: restrict gko::share to rvalue references (*possible interface break*) ([#1020](#1020))
+ Bug fix: when using cuSPARSE's triangular solvers, specifying the factory parameter `num_rhs` is now required when solving for more than one right-hand side, otherwise an exception is thrown ([#1184](#1184)).
+ Drop official support for old CUDA < 9.2 ([#887](#887))


Improved performance additions:
+ Reuse tmp storage in reductions in solvers and add a mutable workspace to all solvers ([#1013](#1013), [#1028](#1028))
+ Add HIP unsafe atomic option for AMD ([#1091](#1091))
+ Prefer vendor implementations for Dense dot, conj_dot and norm2 when available ([#967](#967)).
+ Tuned OpenMP SellP, COO, and ELL SpMV kernels for a small number of RHS ([#809](#809))


Fixes:
+ Fix various compilation warnings ([#1076](#1076), [#1183](#1183), [#1189](#1189))
+ Fix issues with hwloc-related tests ([#1074](#1074))
+ Fix include headers for GCC 12 ([#1071](#1071))
+ Fix for simple-solver-logging example ([#1066](#1066))
+ Fix for potential memory leak in Logger ([#1056](#1056))
+ Fix logging of mixin classes ([#1037](#1037))
+ Improve value semantics for LinOp types, like moved-from state in cross-executor copy/clones ([#753](#753))
+ Fix some matrix SpMV and conversion corner cases ([#905](#905), [#978](#978))
+ Fix uninitialized data ([#958](#958))
+ Fix CUDA version requirement for cusparseSpSM ([#953](#953))
+ Fix several issues within bash-script ([#1016](#1016))
+ Fixes for `NVHPC` compiler support ([#1194](#1194))


Other additions:
+ Simplify and properly name GMRES kernels ([#861](#861))
+ Improve pkg-config support for non-CMake libraries ([#923](#923), [#1109](#1109))
+ Improve gdb pretty printer ([#987](#987), [#1114](#1114))
+ Add a logger highlighting inefficient allocation and copy patterns ([#1035](#1035))
+ Improved and optimized test random matrix generation ([#954](#954), [#1032](#1032))
+ Better CSR strategy defaults ([#969](#969))
+ Add `move_from` to `PolymorphicObject` ([#997](#997))
+ Remove unnecessary device_guard usage ([#956](#956))
+ Improvements to the generic accessor for mixed-precision ([#727](#727))
+ Add a naive lower triangular solver implementation for CUDA ([#764](#764))
+ Add support for int64 indices from CUDA 11 onward with SpMV and SpGEMM ([#897](#897))
+ Add a L1 norm implementation ([#900](#900))
+ Add reduce_add for arrays ([#831](#831))
+ Add utility to simplify Dense View creation from an existing Dense vector ([#1136](#1136)).
+ Add a custom transpose implementation for Fbcsr and Csr transpose for unsupported vendor types ([#1123](#1123))
+ Make IDR random initilization deterministic ([#1116](#1116))
+ Move the algorithm choice for triangular solvers from Csr::strategy_type to a factory parameter ([#1088](#1088))
+ Update CUDA archCoresPerSM ([#1175](#1116))
+ Add kernels for Csr sparsity pattern lookup ([#994](#994))
+ Differentiate between structural and numerical zeros in Ell/Sellp ([#1027](#1027))
+ Add a binary IO format for matrix data ([#984](#984))
+ Add a tuple zip_iterator implementation ([#966](#966))
+ Simplify kernel stubs and declarations ([#888](#888))
+ Simplify GKO_REGISTER_OPERATION with lambdas ([#859](#859))
+ Simplify copy to device in tests and examples ([#863](#863))
+ More verbose output to array assertions ([#858](#858))
+ Allow parallel compilation for Jacobi kernels ([#871](#871))
+ Change clang-format pointer alignment to left ([#872](#872))
+ Various improvements and fixes to the benchmarking framework ([#750](#750), [#759](#759), [#870](#870), [#911](#911), [#1033](#1033), [#1137](#1137))
+ Various documentation improvements ([#892](#892), [#921](#921), [#950](#950), [#977](#977), [#1021](#1021), [#1068](#1068), [#1069](#1069), [#1080](#1080), [#1081](#1081), [#1108](#1108), [#1153](#1153), [#1154](#1154))
+ Various CI improvements ([#868](#868), [#874](#874), [#884](#884), [#889](#889), [#899](#899), [#903](#903),  [#922](#922), [#925](#925), [#930](#930), [#936](#936), [#937](#937), [#958](#958), [#882](#882), [#1011](#1011), [#1015](#1015), [#989](#989), [#1039](#1039), [#1042](#1042), [#1067](#1067), [#1073](#1073), [#1075](#1075), [#1083](#1083), [#1084](#1084), [#1085](#1085), [#1139](#1139), [#1178](#1178), [#1187](#1187))
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
1:ST:high-importance This issue/PR is of high importance and must be addressed as soon as possible. 1:ST:ready-to-merge This PR is ready to merge. mod:all This touches all Ginkgo modules. reg:build This is related to the build system. reg:example This is related to the examples. reg:testing This is related to testing. type:matrix-format This is related to the Matrix formats type:multigrid This is related to multigrid type:solver This is related to the solvers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants