ESPResSo
Extensible Simulation Package for Research on Soft Matter Systems
Loading...
Searching...
No Matches
walberla_init.cpp
Go to the documentation of this file.
1/*
2 * Copyright (C) 2019-2026 The ESPResSo project
3 *
4 * This file is part of ESPResSo.
5 *
6 * ESPResSo is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 3 of the License, or
9 * (at your option) any later version.
10 *
11 * ESPResSo is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
18 */
19
22
23#include <core/mpi/Environment.h>
24#include <core/mpi/MPIManager.h>
25
26#include <cassert>
27#include <memory>
28
29/** @brief waLBerla MPI communicator. */
30static std::shared_ptr<walberla::mpi::MPIManager> walberla_mpi_comm;
31/** @brief waLBerla MPI environment. */
32static std::shared_ptr<walberla::mpi::Environment> walberla_mpi_env;
33/**
34 * @brief waLBerla MPI Cartesian communicator observer.
35 * It is purposefully decoupled from @ref walberla_mpi_comm.
36 * We are not tracking the lifetime of @ref walberla_mpi_comm itself,
37 * but the lifetime of its ownership by the waLBerla MPI singleton.
38 */
39static std::shared_ptr<int> walberla_mpi_cart_comm_observer;
40
41namespace walberla {
42
43void mpi_init() {
44 assert(::walberla_mpi_env == nullptr);
45 assert(::walberla_mpi_comm == nullptr);
46 assert(::walberla_mpi_cart_comm_observer == nullptr);
47 int argc = 0;
48 char **argv = nullptr;
49 ::walberla_mpi_env = std::make_shared<walberla::mpi::Environment>(argc, argv);
50 ::walberla_mpi_comm = walberla::mpi::MPIManager::instance();
51 ::walberla_mpi_cart_comm_observer = std::make_shared<int>(0);
52}
53
54void mpi_reinit(int const *const cart_topol) {
55 assert(::walberla_mpi_env.use_count() >= 1);
56 assert(::walberla_mpi_comm.use_count() >= 1);
57 assert(::walberla_mpi_cart_comm_observer.use_count() == 1);
58 ::walberla_mpi_comm->resetMPI();
59 ::walberla_mpi_comm->createCartesianComm(cart_topol[0], cart_topol[1],
60 cart_topol[2], true, true, true);
61 ::walberla_mpi_cart_comm_observer = std::make_shared<int>(0);
62}
63
64void mpi_deinit() {
65 assert(::walberla_mpi_env.use_count() >= 1);
66 assert(::walberla_mpi_comm.use_count() >= 1);
67 assert(::walberla_mpi_cart_comm_observer.use_count() == 1);
68 ::walberla_mpi_env.reset();
69 ::walberla_mpi_comm.reset();
71}
72
73std::unique_ptr<ResourceManager> get_vtk_dependent_resources() {
74 auto vtk_dependencies = std::make_unique<ResourceManager>();
75 // waLBerla MPI communicator (singleton)
76 vtk_dependencies->acquire_lock(::walberla_mpi_comm);
77 // waLBerla MPI environment (destructor depends on the MPI communicator)
78 vtk_dependencies->acquire_lock(::walberla_mpi_env);
79 return vtk_dependencies;
80}
81
86
87} // namespace walberla
\file PackInfoPdfDoublePrecision.cpp \author pystencils
std::unique_ptr< ResourceManager > get_vtk_dependent_resources()
Get a lock on waLBerla's global resources for VTK.
void mpi_deinit()
Release waLBerla's MPI manager and environment.
void mpi_reinit(int const *cart_topol)
Re-initialize waLBerla's MPI Cartesian communicator.
void mpi_init()
Initialize waLBerla's MPI manager and environment.
ResourceObserver get_mpi_cart_comm_observer()
Get an observer on waLBerla's MPI Cartesian communicator status.
Observer to monitor the lifetime of a shared resource.
static std::shared_ptr< walberla::mpi::MPIManager > walberla_mpi_comm
waLBerla MPI communicator.
static std::shared_ptr< int > walberla_mpi_cart_comm_observer
waLBerla MPI Cartesian communicator observer.
static std::shared_ptr< walberla::mpi::Environment > walberla_mpi_env
waLBerla MPI environment.