#include <string> #include <sstream> #include <pybind11/pybind11.h> #include <arbor/context.hpp> #include <arbor/domain_decomposition.hpp> #include <arbor/load_balance.hpp> #include "context.hpp" #include "recipe.hpp" #include "strprintf.hpp" namespace pyarb { std::string gd_string(const arb::group_description& g) { std::stringstream s; s << "<cell group: " << g.gids.size() << " cells, gids [" << util::csv(g.gids, 5) << "]" << ", " << g.kind << ", " << g.backend << ">"; return s.str(); } std::string dd_string(const arb::domain_decomposition& d) { std::stringstream s; s << "<domain decomposition: domain " << d.domain_id << " of " << d.num_domains << ", " << d.num_local_cells << "/" << d.num_global_cells << " loc/glob cells, " << d.groups.size() << " groups>"; return s.str(); } void register_domain_decomposition(pybind11::module& m) { using namespace pybind11::literals; // Group description pybind11::class_<arb::group_description> group_description(m, "group_description", "The indexes of a set of cells of the same kind that are grouped together in a cell group."); group_description .def(pybind11::init<arb::cell_kind, std::vector<arb::cell_gid_type>, arb::backend_kind>(), "Construct a group description with cell kind, list of gids, and backend kind.", "kind"_a, "gids"_a, "backend"_a) .def_readonly("kind", &arb::group_description::kind, "The type of cell in the cell group.") .def_readonly("gids", &arb::group_description::gids, "The gids of the cells in the group in ascending order.") .def_readonly("backend", &arb::group_description::backend, "The hardware backend on which the cell group will run.") .def("__str__", &gd_string) .def("__repr__", &gd_string); // Domain decomposition pybind11::class_<arb::domain_decomposition> domain_decomposition(m, "domain_decomposition", "The domain decomposition is responsible for describing the distribution of cells across cell groups and domains."); domain_decomposition .def(pybind11::init<>()) .def("gid_domain", [](const arb::domain_decomposition& d, arb::cell_gid_type gid) { return d.gid_domain(gid); }, "Query the domain id that a cell assigned to (using global identifier gid).", "gid"_a) .def_readonly("num_domains", &arb::domain_decomposition::num_domains, "Number of domains that the model is distributed over.") .def_readonly("domain_id", &arb::domain_decomposition::domain_id, "The index of the local domain.\n" "Always 0 for non-distributed models, and corresponds to the MPI rank for distributed runs.") .def_readonly("num_local_cells", &arb::domain_decomposition::num_local_cells, "Total number of cells in the local domain.") .def_readonly("num_global_cells", &arb::domain_decomposition::num_global_cells, "Total number of cells in the global model (sum of num_local_cells over all domains).") .def_readonly("groups", &arb::domain_decomposition::groups, "Descriptions of the cell groups on the local domain.") .def("__str__", &dd_string) .def("__repr__", &dd_string); // Partition load balancer // The Python recipe has to be shimmed for passing to the function that // takes a C++ recipe. m.def("partition_load_balance", [](std::shared_ptr<py_recipe>& recipe, const context_shim& ctx) { return arb::partition_load_balance(py_recipe_shim(recipe), ctx.context); }, "Construct a domain_decomposition that distributes the cells in the model described by recipe\n" "over the distributed and local hardware resources described by context.", "recipe"_a, "context"_a); } } // namespace pyarb