Tpetra_Details_unpackCrsGraphAndCombine_def.hpp

Go to the documentation of this file.

// @HEADER
// *****************************************************************************
//          Tpetra: Templated Linear Algebra Services Package
//
// Copyright 2008 NTESS and the Tpetra contributors.
// SPDX-License-Identifier: BSD-3-Clause
// *****************************************************************************
// @HEADER
 
#ifndef TPETRA_DETAILS_UNPACKCRSGRAPHANDCOMBINE_DEF_HPP
#define TPETRA_DETAILS_UNPACKCRSGRAPHANDCOMBINE_DEF_HPP
 
#include "TpetraCore_config.h"
#include "Teuchos_Array.hpp"
#include "Teuchos_ArrayView.hpp"
#include "Tpetra_Details_castAwayConstDualView.hpp"
#include "Tpetra_Details_computeOffsets.hpp"
#include "Tpetra_Details_createMirrorView.hpp"
#include "Tpetra_Details_OrdinalTraits.hpp"
#include "Tpetra_Details_Behavior.hpp"
#include "Tpetra_CrsGraph_decl.hpp"
#include "Tpetra_Details_getEntryOnHost.hpp"
#include "Tpetra_Details_crsUtils.hpp"
#include "Kokkos_Core.hpp"
#include <memory>
#include <string>
 
 
namespace Tpetra {
 
//
// Users must never rely on anything in the Details namespace.
//
namespace Details {
 
namespace UnpackAndCombineCrsGraphImpl {
 
template <class Packet, class GO, class Device, class BufferDevice>
KOKKOS_FUNCTION int
unpackRow(const Kokkos::View<GO*, Device, Kokkos::MemoryUnmanaged>& gids_out,
          const Kokkos::View<int*, Device, Kokkos::MemoryUnmanaged>& pids_out,
          const Kokkos::View<const Packet*, BufferDevice>& imports,
          const size_t offset,
          const size_t num_ent) {
  using size_type = typename Kokkos::View<GO*, Device>::size_type;
 
  if (num_ent == 0) {
    // Empty rows always take zero bytes, to ensure sparsity.
    return 0;
  }
 
  // Unpack GIDs
  for (size_type k = 0; k < num_ent; k++)
    gids_out(k) = imports(offset + k);
 
  // Unpack PIDs
  if (pids_out.size() > 0) {
    for (size_type k = 0; k < num_ent; k++) {
      pids_out(k) = static_cast<int>(imports(offset + num_ent + k));
    }
  }
 
  return 0;
}
 
template <class LocalOrdinal,
          class Packet,
          class RowView,
          class IndicesView,
          class BufferDevice>
class UnpackAndCombineFunctor {
  using LO                 = LocalOrdinal;
  using GO                 = typename IndicesView::value_type;
  using packet_type        = Packet;
  using row_ptrs_type      = RowView;
  using indices_type       = IndicesView;
  using buffer_device_type = BufferDevice;
 
  using device_type     = typename IndicesView::device_type;
  using execution_space = typename device_type::execution_space;
 
  using num_packets_per_lid_type = Kokkos::View<const size_t*, buffer_device_type>;
  using offsets_type             = Kokkos::View<const size_t*, device_type>;
  using input_buffer_type        = Kokkos::View<const packet_type*, buffer_device_type>;
  using import_lids_type         = Kokkos::View<const LO*, buffer_device_type>;
 
  using gids_scratch_type = Kokkos::View<GO*, device_type>;
  using pids_scratch_type = Kokkos::View<int*, device_type>;
 
  row_ptrs_type row_ptrs_beg;
  row_ptrs_type row_ptrs_end;
  indices_type indices;
  input_buffer_type imports;
  num_packets_per_lid_type num_packets_per_lid;
  import_lids_type import_lids;
  offsets_type offsets;
  size_t max_num_ent;
  bool unpack_pids;
  Kokkos::Experimental::UniqueToken<execution_space,
                                    Kokkos::Experimental::UniqueTokenScope::Global>
      tokens;
  gids_scratch_type gids_scratch;
  pids_scratch_type pids_scratch;
 
 public:
  using value_type = Kokkos::pair<int, LO>;
 
  UnpackAndCombineFunctor(
      const row_ptrs_type& row_ptrs_beg_in,
      const row_ptrs_type& row_ptrs_end_in,
      const indices_type& indices_in,
      const input_buffer_type& imports_in,
      const num_packets_per_lid_type& num_packets_per_lid_in,
      const import_lids_type& import_lids_in,
      const offsets_type& offsets_in,
      const size_t max_num_ent_in,
      const bool unpack_pids_in)
    : row_ptrs_beg(row_ptrs_beg_in)
    , row_ptrs_end(row_ptrs_end_in)
    , indices(indices_in)
    , imports(imports_in)
    , num_packets_per_lid(num_packets_per_lid_in)
    , import_lids(import_lids_in)
    , offsets(offsets_in)
    , max_num_ent(max_num_ent_in)
    , unpack_pids(unpack_pids_in)
    , tokens(execution_space())
    , gids_scratch("gids_scratch", tokens.size() * max_num_ent)
    , pids_scratch("pids_scratch", tokens.size() * max_num_ent) {}
 
  KOKKOS_INLINE_FUNCTION void init(value_type& dst) const {
    using Tpetra::Details::OrdinalTraits;
    dst = Kokkos::make_pair(0, OrdinalTraits<LO>::invalid());
  }
 
  KOKKOS_INLINE_FUNCTION void
  join(value_type& dst, const value_type& src) const {
    // `dst` should reflect the first (least) bad index and
    // all other associated error codes and data.  Thus, we need only
    // check if the `src` object shows an error and if its associated
    // bad index is less than `dst`'s bad index.
    using Tpetra::Details::OrdinalTraits;
    if (src.second != OrdinalTraits<LO>::invalid()) {
      // An error in the src; check if
      //   1. `dst` shows errors
      //   2. If `dst` does show errors, if src's bad index is less than
      //      *this' bad index
      if (dst.second == OrdinalTraits<LO>::invalid() ||
          src.second < dst.second) {
        dst = src;
      }
    }
  }
 
  KOKKOS_INLINE_FUNCTION
  void operator()(const LO i, value_type& dst) const {
    using Kokkos::MemoryUnmanaged;
    using Kokkos::subview;
    using Kokkos::View;
    using size_type = typename execution_space::size_type;
    using slice     = typename Kokkos::pair<size_type, size_type>;
 
    using pids_out_type = View<int*, device_type, MemoryUnmanaged>;
    using gids_out_type = View<GO*, device_type, MemoryUnmanaged>;
 
    const size_t num_packets_this_lid = num_packets_per_lid(i);
    const size_t num_ent              = (unpack_pids) ? num_packets_this_lid / 2
                                                      : num_packets_this_lid;
    if (unpack_pids && num_packets_this_lid % 2 != 0) {
      // Attempting to unpack PIDs, but num_packets_this_lid is not even; this
      // should never
      dst = Kokkos::make_pair(1, i);
      return;
    }
 
    // Only unpack data if there is a nonzero number to unpack
    if (num_ent == 0) {
      return;
    }
 
    // there is actually something in the row
    const size_t buf_size = imports.size();
    const size_t offset   = offsets(i);
 
    if (offset > buf_size || offset + num_packets_this_lid > buf_size) {
      dst = Kokkos::make_pair(2, i);  // out of bounds
      return;
    }
 
    // Get subviews in to the scratch arrays.  The token returned from acquire
    // is an integer in [0, tokens.size()).  It is used to grab a unique (to
    // this thread) subview of the scratch arrays.
    const size_type token  = tokens.acquire();
    const size_t a         = static_cast<size_t>(token) * max_num_ent;
    const size_t b         = a + num_ent;
    gids_out_type gids_out = subview(gids_scratch, slice(a, b));
    pids_out_type pids_out = subview(pids_scratch, slice(a, (unpack_pids ? b : a)));
 
    const int err = unpackRow(gids_out, pids_out, imports, offset, num_ent);
 
    if (err != 0) {
      dst = Kokkos::make_pair(3, i);
      tokens.release(token);
      return;
    }
 
    auto import_lid = import_lids(i);
    for (size_t k = 0; k < num_ent; ++k) {
      indices(row_ptrs_end(import_lid)) = gids_out(k);
      // this is OK; don't need atomic, since LIDs to pack don't have repeats.
      row_ptrs_end(import_lid) += 1;
    }
 
    tokens.release(token);
  }
};
 
template <class LocalOrdinal, class GlobalOrdinal, class Node,
          class RowView, class IndicesView, class BufferDevice>
void unpackAndCombine(const RowView& row_ptrs_beg,
                      const RowView& row_ptrs_end,
                      IndicesView& indices,
                      const Kokkos::View<const GlobalOrdinal*, BufferDevice,
                                         Kokkos::MemoryUnmanaged>& imports,
                      const Kokkos::View<const size_t*, BufferDevice,
                                         Kokkos::MemoryUnmanaged>& num_packets_per_lid,
                      const Kokkos::View<const LocalOrdinal*, BufferDevice,
                                         Kokkos::MemoryUnmanaged>& import_lids,
                      const typename CrsGraph<LocalOrdinal, GlobalOrdinal,
                                              Node>::padding_type& padding,
                      const bool unpack_pids,
                      const int myRank,
                      const bool verbose) {
  using LO              = LocalOrdinal;
  using GO              = GlobalOrdinal;
  using device_type     = typename Node::device_type;
  using execution_space = typename BufferDevice::execution_space;
  using range_policy =
      Kokkos::RangePolicy<execution_space, Kokkos::IndexType<LO>>;
  using unpack_functor_type =
      UnpackAndCombineFunctor<LO, GO, RowView, IndicesView, BufferDevice>;
 
  const char prefix[] =
      "Tpetra::Details::UnpackAndCombineCrsGraphImpl::unpackAndCombine: ";
 
  const size_t num_import_lids = static_cast<size_t>(import_lids.extent(0));
  if (num_import_lids == 0) {
    // Nothing to unpack
    return;
  }
 
  // Resize row pointers and indices to accommodate incoming data
  padCrsArrays(row_ptrs_beg, row_ptrs_end, indices, padding,
               myRank, verbose);
 
  // Get the offsets
  Kokkos::View<size_t*, device_type> offsets("offsets", num_import_lids + 1);
  computeOffsetsFromCounts(offsets, num_packets_per_lid);
 
  // Determine the maximum number of entries in any row in the graph.  The
  // maximum number of entries is needed to allocate unpack buffers on the
  // device.
  size_t max_num_ent;
  Kokkos::parallel_reduce(
      "MaxReduce",
      range_policy(0, LO(num_packets_per_lid.size())),
      KOKKOS_LAMBDA(const LO i, size_t& running_max_num_ent) {
        const size_t num_packets_this_lid = num_packets_per_lid(i);
        const size_t num_ent              = (unpack_pids) ? num_packets_this_lid / 2 : num_packets_this_lid;
        if (num_ent > running_max_num_ent) {
          running_max_num_ent = num_ent;
        }
      },
      Kokkos::Max<size_t>(max_num_ent));
 
  // Now do the actual unpack!
  unpack_functor_type f(row_ptrs_beg, row_ptrs_end, indices, imports,
                        num_packets_per_lid, import_lids, offsets,
                        max_num_ent, unpack_pids);
 
  typename unpack_functor_type::value_type x;
  Kokkos::parallel_reduce(range_policy(0, static_cast<LO>(num_import_lids)), f, x);
  auto x_h = x.to_std_pair();
  TEUCHOS_TEST_FOR_EXCEPTION(x_h.first != 0, std::runtime_error,
                             prefix << "UnpackAndCombineFunctor reported error code "
                                    << x_h.first << " for the first bad row " << x_h.second);
}
 
template <class Packet, class LocalGraph, class BufferDevice>
size_t
unpackAndCombineWithOwningPIDsCount(
    const LocalGraph& local_graph,
    const Kokkos::View<const typename LocalGraph::data_type*,
                       typename LocalGraph::device_type,
                       Kokkos::MemoryUnmanaged>
        permute_from_lids,
    const Kokkos::View<const Packet*, BufferDevice>& /* imports */,
    const Kokkos::View<const size_t*, BufferDevice>& num_packets_per_lid,
    const size_t num_same_ids) {
  using Kokkos::parallel_reduce;
  using local_graph_type = LocalGraph;
  using LO               = typename local_graph_type::data_type;
  using device_type      = typename local_graph_type::device_type;
  using execution_space  = typename device_type::execution_space;
  using range_policy     = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<LO>>;
 
  size_t count = 0;
  LO num_items;
 
  // Number of graph entries to unpack (returned by this function).
  num_items = static_cast<LO>(num_same_ids);
  if (num_items) {
    size_t kcnt = 0;
    parallel_reduce(
        range_policy(0, num_items),
        KOKKOS_LAMBDA(const LO lid, size_t& update) {
          update += static_cast<size_t>(local_graph.row_map[lid + 1] - local_graph.row_map[lid]);
        },
        kcnt);
    count += kcnt;
  }
 
  // Count entries copied directly from the source graph with permuting.
  num_items = static_cast<LO>(permute_from_lids.extent(0));
  if (num_items) {
    size_t kcnt = 0;
    parallel_reduce(
        range_policy(0, num_items),
        KOKKOS_LAMBDA(const LO i, size_t& update) {
          const LO lid = permute_from_lids(i);
          update += static_cast<size_t>(local_graph.row_map[lid + 1] - local_graph.row_map[lid]);
        },
        kcnt);
    count += kcnt;
  }
 
  {
    // Count entries received from other MPI processes.
    size_t tot_num_ent = 0;
    parallel_reduce(
        "SumReduce",
        range_policy(0, num_packets_per_lid.size()),
        KOKKOS_LAMBDA(const int& i, size_t& lsum) {
          lsum += num_packets_per_lid(i) / 2;
        },
        Kokkos::Sum<size_t>(tot_num_ent));
    count += tot_num_ent;
  }
 
  return count;
}
 
template <class Packet, class LO, class Device, class BufferDevice>
void setupRowPointersForRemotes(
    const Kokkos::View<size_t*, Device>& tgt_rowptr,
    const Kokkos::View<const LO*, BufferDevice>& import_lids,
    const Kokkos::View<const Packet*, BufferDevice>& /* imports */,
    const Kokkos::View<const size_t*, BufferDevice>& num_packets_per_lid) {
  using Kokkos::parallel_reduce;
  using device_type     = Device;
  using execution_space = typename device_type::execution_space;
  using size_type       = typename Kokkos::View<size_t*, device_type>::size_type;
  using range_policy    = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<size_type>>;
 
  const size_type N = num_packets_per_lid.extent(0);
  parallel_for(
      "Setup row pointers for remotes",
      range_policy(0, N),
      KOKKOS_LAMBDA(const size_t i) {
        using atomic_incr_type            = typename std::remove_reference<decltype(tgt_rowptr(0))>::type;
        const size_t num_packets_this_lid = num_packets_per_lid(i);
        const size_t num_ent              = num_packets_this_lid / 2;
        Kokkos::atomic_fetch_add(&tgt_rowptr(import_lids(i)), atomic_incr_type(num_ent));
      });
}
 
// Convert array of row lengths to a CRS pointer array
template <class Device>
void makeCrsRowPtrFromLengths(
    const Kokkos::View<size_t*, Device, Kokkos::MemoryUnmanaged>& tgt_rowptr,
    const Kokkos::View<size_t*, Device>& new_start_row) {
  using Kokkos::parallel_scan;
  using device_type     = Device;
  using execution_space = typename device_type::execution_space;
  using size_type       = typename Kokkos::View<size_t*, device_type>::size_type;
  using range_policy    = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<size_type>>;
  const size_type N     = new_start_row.extent(0);
  parallel_scan(
      range_policy(0, N),
      KOKKOS_LAMBDA(const size_t& i, size_t& update, const bool& final) {
        auto cur_val = tgt_rowptr(i);
        if (final) {
          tgt_rowptr(i)    = update;
          new_start_row(i) = tgt_rowptr(i);
        }
        update += cur_val;
      });
}
 
template <class LocalGraph, class LocalMap>
void copyDataFromSameIDs(
    const Kokkos::View<typename LocalMap::global_ordinal_type*,
                       typename LocalMap::device_type>& tgt_colind,
    const Kokkos::View<int*, typename LocalMap::device_type>& tgt_pids,
    const Kokkos::View<size_t*, typename LocalMap::device_type>& new_start_row,
    const Kokkos::View<size_t*, typename LocalMap::device_type>& tgt_rowptr,
    const Kokkos::View<const int*, typename LocalMap::device_type>& src_pids,
    const LocalGraph& local_graph,
    const LocalMap& local_col_map,
    const size_t num_same_ids,
    const int my_pid) {
  using Kokkos::parallel_for;
  using device_type     = typename LocalMap::device_type;
  using LO              = typename LocalMap::local_ordinal_type;
  using execution_space = typename device_type::execution_space;
  using range_policy    = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<size_t>>;
 
  parallel_for(
      range_policy(0, num_same_ids),
      KOKKOS_LAMBDA(const size_t i) {
        using atomic_incr_type = typename std::remove_reference<decltype(new_start_row(0))>::type;
 
        const LO src_lid = static_cast<LO>(i);
        size_t src_row   = local_graph.row_map(src_lid);
 
        const LO tgt_lid     = static_cast<LO>(i);
        const size_t tgt_row = tgt_rowptr(tgt_lid);
 
        const size_t nsr = local_graph.row_map(src_lid + 1) - local_graph.row_map(src_lid);
        Kokkos::atomic_fetch_add(&new_start_row(tgt_lid), atomic_incr_type(nsr));
 
        for (size_t j = local_graph.row_map(src_lid);
             j < local_graph.row_map(src_lid + 1); ++j) {
          LO src_col                        = local_graph.entries(j);
          tgt_colind(tgt_row + j - src_row) = local_col_map.getGlobalElement(src_col);
          tgt_pids(tgt_row + j - src_row)   = (src_pids(src_col) != my_pid) ? src_pids(src_col) : -1;
        }
      });
}
 
template <class LocalGraph, class LocalMap, class BufferDevice>
void copyDataFromPermuteIDs(
    const Kokkos::View<typename LocalMap::global_ordinal_type*,
                       typename LocalMap::device_type>& tgt_colind,
    const Kokkos::View<int*,
                       typename LocalMap::device_type>& tgt_pids,
    const Kokkos::View<size_t*,
                       typename LocalMap::device_type>& new_start_row,
    const Kokkos::View<size_t*,
                       typename LocalMap::device_type>& tgt_rowptr,
    const Kokkos::View<const int*,
                       typename LocalMap::device_type>& src_pids,
    const Kokkos::View<const typename LocalMap::local_ordinal_type*,
                       BufferDevice, Kokkos::MemoryUnmanaged>& permute_to_lids,
    const Kokkos::View<const typename LocalMap::local_ordinal_type*,
                       BufferDevice, Kokkos::MemoryUnmanaged>& permute_from_lids,
    const LocalGraph& local_graph,
    const LocalMap& local_col_map,
    const int my_pid) {
  using Kokkos::parallel_for;
  using device_type     = typename LocalMap::device_type;
  using LO              = typename LocalMap::local_ordinal_type;
  using execution_space = typename device_type::execution_space;
  using size_type       = typename Kokkos::View<LO*, device_type>::size_type;
  using range_policy    = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<size_type>>;
 
  const size_type num_permute_to_lids = permute_to_lids.extent(0);
 
  parallel_for(
      range_policy(0, num_permute_to_lids),
      KOKKOS_LAMBDA(const size_t i) {
        using atomic_incr_type = typename std::remove_reference<decltype(new_start_row(0))>::type;
 
        const LO src_lid     = permute_from_lids(i);
        const size_t src_row = local_graph.row_map(src_lid);
 
        const LO tgt_lid     = permute_to_lids(i);
        const size_t tgt_row = tgt_rowptr(tgt_lid);
 
        size_t nsr = local_graph.row_map(src_lid + 1) - local_graph.row_map(src_lid);
        Kokkos::atomic_fetch_add(&new_start_row(tgt_lid), atomic_incr_type(nsr));
 
        for (size_t j = local_graph.row_map(src_lid);
             j < local_graph.row_map(src_lid + 1); ++j) {
          LO src_col                        = local_graph.entries(j);
          tgt_colind(tgt_row + j - src_row) = local_col_map.getGlobalElement(src_col);
          tgt_pids(tgt_row + j - src_row)   = (src_pids(src_col) != my_pid) ? src_pids(src_col) : -1;
        }
      });
}
 
template <class Packet, class LocalGraph, class LocalMap, class BufferDevice>
void unpackAndCombineIntoCrsArrays2(
    const Kokkos::View<typename LocalMap::global_ordinal_type*, typename LocalMap::device_type>& tgt_colind,
    const Kokkos::View<int*, typename LocalMap::device_type>& tgt_pids,
    const Kokkos::View<size_t*, typename LocalMap::device_type>& new_start_row,
    const Kokkos::View<const size_t*, typename LocalMap::device_type>& offsets,
    const Kokkos::View<
        const typename LocalMap::local_ordinal_type*,
        BufferDevice,
        Kokkos::MemoryUnmanaged>& import_lids,
    const Kokkos::View<const Packet*, BufferDevice>& imports,
    const Kokkos::View<const size_t*, BufferDevice>& num_packets_per_lid,
    const LocalGraph& /* local_graph */,
    const LocalMap /*& local_col_map*/,
    const int my_pid) {
  using Kokkos::atomic_fetch_add;
  using Kokkos::MemoryUnmanaged;
  using Kokkos::parallel_reduce;
  using Kokkos::subview;
  using Kokkos::View;
 
  using device_type     = typename LocalMap::device_type;
  using LO              = typename LocalMap::local_ordinal_type;
  using GO              = typename LocalMap::global_ordinal_type;
  using execution_space = typename device_type::execution_space;
  using size_type       = typename Kokkos::View<LO*, device_type>::size_type;
  using slice           = typename Kokkos::pair<size_type, size_type>;
  using range_policy    = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<size_type>>;
 
  using pids_out_type = View<int*, device_type, MemoryUnmanaged>;
  using gids_out_type = View<GO*, device_type, MemoryUnmanaged>;
 
  const size_type num_import_lids = import_lids.size();
  const char prefix[]             = "UnpackAndCombineCrsGraphImpl::unpackAndCombineIntoCrsArrays2: ";
 
  // RemoteIDs: Loop structure following UnpackAndCombine
  int gbl_err_count;
  parallel_reduce(
      "Unpack and combine into CRS",
      range_policy(0, num_import_lids),
      KOKKOS_LAMBDA(const size_t i, int& err) {
        using atomic_incr_type            = typename std::remove_reference<decltype(new_start_row(0))>::type;
        const size_t num_packets_this_lid = num_packets_per_lid(i);
        const size_t num_ent              = num_packets_this_lid / 2;
        const size_t offset               = offsets(i);
        const LO lcl_row                  = import_lids(i);
        const size_t start_row            = atomic_fetch_add(&new_start_row(lcl_row), atomic_incr_type(num_ent));
        const size_t end_row              = start_row + num_ent;
 
        gids_out_type gids_out = subview(tgt_colind, slice(start_row, end_row));
        pids_out_type pids_out = subview(tgt_pids, slice(start_row, end_row));
 
        err += unpackRow(gids_out, pids_out, imports, offset, num_ent);
 
        // Correct target PIDs.
        for (size_t j = 0; j < static_cast<size_t>(num_ent); ++j) {
          const int pid = pids_out(j);
          pids_out(j)   = (pid != my_pid) ? pid : -1;
        }
      },
      gbl_err_count);
 
  TEUCHOS_TEST_FOR_EXCEPTION(gbl_err_count != 0,
                             std::invalid_argument, prefix << "Attempting to unpack PIDs, but num_ent is not even; this should never "
                                                              "happen!  Please report this bug to the Tpetra developers.");
 
  return;
}
 
template <class Packet, class LocalGraph, class LocalMap, class BufferDevice>
void unpackAndCombineIntoCrsArrays(
    const LocalGraph& local_graph,
    const LocalMap& local_col_map,
    const Kokkos::View<const typename LocalMap::local_ordinal_type*,
                       BufferDevice,
                       Kokkos::MemoryUnmanaged>& import_lids,
    const Kokkos::View<const Packet*, BufferDevice>& imports,
    const Kokkos::View<const size_t*, BufferDevice>& num_packets_per_lid,
    const Kokkos::View<const typename LocalMap::local_ordinal_type*,
                       BufferDevice,
                       Kokkos::MemoryUnmanaged>& permute_to_lids,
    const Kokkos::View<const typename LocalMap::local_ordinal_type*,
                       BufferDevice,
                       Kokkos::MemoryUnmanaged>& permute_from_lids,
    const Kokkos::View<size_t*,
                       typename LocalMap::device_type,
                       Kokkos::MemoryUnmanaged>& tgt_rowptr,
    const Kokkos::View<typename LocalMap::global_ordinal_type*,
                       typename LocalMap::device_type,
                       Kokkos::MemoryUnmanaged>& tgt_colind,
    const Kokkos::View<const int*,
                       typename LocalMap::device_type,
                       Kokkos::MemoryUnmanaged>& src_pids,
    const Kokkos::View<int*,
                       typename LocalMap::device_type,
                       Kokkos::MemoryUnmanaged>& tgt_pids,
    const size_t num_same_ids,
    const size_t tgt_num_rows,
    const size_t tgt_num_nonzeros,
    const int my_tgt_pid) {
  using Kokkos::MemoryUnmanaged;
  using Kokkos::parallel_for;
  using Kokkos::subview;
  using Kokkos::View;
  using packet_type        = Packet;
  using local_map_type     = LocalMap;
  using local_graph_type   = LocalGraph;
  using buffer_device_type = BufferDevice;
  using device_type        = typename LocalMap::device_type;
  using LO                 = typename LocalMap::local_ordinal_type;
  using execution_space    = typename device_type::execution_space;
  using size_type          = typename Kokkos::View<LO*, device_type>::size_type;
  using range_policy       = Kokkos::RangePolicy<execution_space, Kokkos::IndexType<size_t>>;
 
  const char prefix[] = "UnpackAndCombineCrsGraphImpl::unpackAndCombineIntoCrsArrays: ";
 
  const size_t N     = tgt_num_rows;
  const size_t mynnz = tgt_num_nonzeros;
 
  // In the case of reduced communicators, the sourceGraph won't have
  // the right "my_pid", so thus we have to supply it.
  const int my_pid = my_tgt_pid;
 
  // FIXME (mfh 24 Jun 2019)
  //
  // 1. Only zero the entries of tgt_rowptr that actually need it.
  // 2. Consider merging these three kernels into one.
 
  // Zero the rowptr
  parallel_for(
      range_policy(0, N + 1),
      KOKKOS_LAMBDA(const size_t i) {
        tgt_rowptr(i) = 0;
      });
 
  // same IDs: Always first, always in the same place
  parallel_for(
      range_policy(0, num_same_ids),
      KOKKOS_LAMBDA(const size_t i) {
        const LO tgt_lid    = static_cast<LO>(i);
        const LO src_lid    = static_cast<LO>(i);
        tgt_rowptr(tgt_lid) = local_graph.row_map(src_lid + 1) - local_graph.row_map(src_lid);
      });
 
  // Permute IDs: Still local, but reordered
  const size_type num_permute_to_lids = permute_to_lids.extent(0);
  parallel_for(
      range_policy(0, num_permute_to_lids),
      KOKKOS_LAMBDA(const size_t i) {
        const LO tgt_lid    = permute_to_lids(i);
        const LO src_lid    = permute_from_lids(i);
        tgt_rowptr(tgt_lid) = local_graph.row_map(src_lid + 1) - local_graph.row_map(src_lid);
      });
 
  // Get the offsets from the number of packets per LID
  const size_type num_import_lids = import_lids.extent(0);
  View<size_t*, device_type> offsets("offsets", num_import_lids + 1);
  computeOffsetsFromCounts(offsets, num_packets_per_lid);
 
#ifdef HAVE_TPETRA_DEBUG
  {
    auto nth_offset_h = getEntryOnHost(offsets, num_import_lids);
    const bool condition =
        nth_offset_h != static_cast<size_t>(imports.extent(0));
    TEUCHOS_TEST_FOR_EXCEPTION(condition, std::logic_error, prefix << "The final offset in bytes " << nth_offset_h << " != imports.size() = " << imports.extent(0) << ".  Please report this bug to the Tpetra developers.");
  }
#endif  // HAVE_TPETRA_DEBUG
 
  // Setup row pointers for remotes
  setupRowPointersForRemotes<packet_type, LO, device_type, buffer_device_type>(
      tgt_rowptr, import_lids, imports, num_packets_per_lid);
 
  // If multiple processes contribute to the same row, we may need to
  // update row offsets.  This tracks that.
  View<size_t*, device_type> new_start_row("new_start_row", N + 1);
 
  // Turn row length into a real CRS row pointer
  makeCrsRowPtrFromLengths(tgt_rowptr, new_start_row);
  {
    auto nth_tgt_rowptr_h = getEntryOnHost(tgt_rowptr, N);
    bool condition        = nth_tgt_rowptr_h != mynnz;
    TEUCHOS_TEST_FOR_EXCEPTION(condition, std::invalid_argument,
                               prefix << "CRS_rowptr[last] = " << nth_tgt_rowptr_h << "!= mynnz = " << mynnz << ".");
  }
 
  // SameIDs: Copy the data over
  copyDataFromSameIDs<LocalGraph, LocalMap>(tgt_colind, tgt_pids, new_start_row,
                                            tgt_rowptr, src_pids, local_graph, local_col_map, num_same_ids, my_pid);
 
  copyDataFromPermuteIDs<LocalGraph, LocalMap>(tgt_colind, tgt_pids, new_start_row,
                                               tgt_rowptr, src_pids, permute_to_lids, permute_from_lids,
                                               local_graph, local_col_map, my_pid);
 
  if (imports.extent(0) <= 0) {
    return;
  }
 
  unpackAndCombineIntoCrsArrays2<
      packet_type, local_graph_type, local_map_type, buffer_device_type>(
      tgt_colind, tgt_pids, new_start_row, offsets, import_lids, imports,
      num_packets_per_lid, local_graph, local_col_map, my_pid);
 
  return;
}
 
}  // namespace UnpackAndCombineCrsGraphImpl
 
template <class LocalOrdinal, class GlobalOrdinal, class Node>
size_t
unpackAndCombineWithOwningPIDsCount(
    const CrsGraph<LocalOrdinal, GlobalOrdinal, Node>& sourceGraph,
    const Teuchos::ArrayView<const LocalOrdinal>& importLIDs,
    const Teuchos::ArrayView<const typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::packet_type>& imports,
    const Teuchos::ArrayView<const size_t>& numPacketsPerLID,
    size_t /* constantNumPackets */,
    CombineMode /* combineMode */,
    size_t numSameIDs,
    const Teuchos::ArrayView<const LocalOrdinal>& permuteToLIDs,
    const Teuchos::ArrayView<const LocalOrdinal>& permuteFromLIDs) {
  using Kokkos::MemoryUnmanaged;
  using Kokkos::View;
  using device_type             = typename Node::device_type;
  using packet_type             = typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::packet_type;
  using local_graph_device_type = typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::local_graph_device_type;
  using buffer_device_type      = typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::buffer_device_type;
  const char prefix[]           = "unpackAndCombineWithOwningPIDsCount: ";
 
  TEUCHOS_TEST_FOR_EXCEPTION(permuteToLIDs.size() != permuteFromLIDs.size(), std::invalid_argument,
                             prefix << "permuteToLIDs.size() = " << permuteToLIDs.size() << " != "
                                                                                            "permuteFromLIDs.size() = "
                                    << permuteFromLIDs.size() << ".");
  // FIXME (mfh 26 Jan 2015) If there are no entries on the calling
  // process, then the graph is neither locally nor globally indexed.
  const bool locallyIndexed = sourceGraph.isLocallyIndexed();
  TEUCHOS_TEST_FOR_EXCEPTION(!locallyIndexed, std::invalid_argument, prefix << "The input "
                                                                               "CrsGraph 'sourceGraph' must be locally indexed.");
  TEUCHOS_TEST_FOR_EXCEPTION(importLIDs.size() != numPacketsPerLID.size(), std::invalid_argument,
                             prefix << "importLIDs.size() = " << importLIDs.size() << " != "
                                                                                      "numPacketsPerLID.size() = "
                                    << numPacketsPerLID.size() << ".");
 
  auto local_graph = sourceGraph.getLocalGraphDevice();
  auto permute_from_lids_d =
      create_mirror_view_from_raw_host_array(device_type(),
                                             permuteFromLIDs.getRawPtr(),
                                             permuteFromLIDs.size(), true,
                                             "permute_from_lids");
  auto imports_d =
      create_mirror_view_from_raw_host_array(buffer_device_type(),
                                             imports.getRawPtr(),
                                             imports.size(), true,
                                             "imports");
  auto num_packets_per_lid_d =
      create_mirror_view_from_raw_host_array(buffer_device_type(),
                                             numPacketsPerLID.getRawPtr(),
                                             numPacketsPerLID.size(), true,
                                             "num_packets_per_lid");
 
  return UnpackAndCombineCrsGraphImpl::unpackAndCombineWithOwningPIDsCount<
      packet_type, local_graph_device_type, buffer_device_type>(
      local_graph, permute_from_lids_d, imports_d, num_packets_per_lid_d, numSameIDs);
}
 
template <class LocalOrdinal, class GlobalOrdinal, class Node>
void unpackAndCombineIntoCrsArrays(
    const CrsGraph<LocalOrdinal, GlobalOrdinal, Node>& sourceGraph,
    const Teuchos::ArrayView<const LocalOrdinal>& importLIDs,
    const Teuchos::ArrayView<const typename CrsGraph<LocalOrdinal, GlobalOrdinal, Node>::packet_type>& imports,
    const Teuchos::ArrayView<const size_t>& numPacketsPerLID,
    const size_t /* constantNumPackets */,
    const CombineMode /* combineMode */,
    const size_t numSameIDs,
    const Teuchos::ArrayView<const LocalOrdinal>& permuteToLIDs,
    const Teuchos::ArrayView<const LocalOrdinal>& permuteFromLIDs,
    size_t TargetNumRows,
    size_t TargetNumNonzeros,
    const int MyTargetPID,
    const Teuchos::ArrayView<size_t>& CRS_rowptr,
    const Teuchos::ArrayView<GlobalOrdinal>& CRS_colind,
    const Teuchos::ArrayView<const int>& SourcePids,
    Teuchos::Array<int>& TargetPids) {
  using Kokkos::deep_copy;
  using Kokkos::View;
  using Teuchos::outArg;
  using Teuchos::REDUCE_MAX;
  using Teuchos::reduceAll;
  using LO                      = LocalOrdinal;
  using GO                      = GlobalOrdinal;
  using crs_graph_type          = CrsGraph<LO, GO, Node>;
  using packet_type             = typename crs_graph_type::packet_type;
  using local_graph_device_type = typename crs_graph_type::local_graph_device_type;
  using buffer_device_type      = typename crs_graph_type::buffer_device_type;
  using device_type             = typename Node::device_type;
  using size_type               = typename Teuchos::ArrayView<const LO>::size_type;
 
  const char prefix[] = "Tpetra::Details::unpackAndCombineIntoCrsArrays: ";
 
  TEUCHOS_TEST_FOR_EXCEPTION(
      TargetNumRows + 1 != static_cast<size_t>(CRS_rowptr.size()),
      std::invalid_argument, prefix << "CRS_rowptr.size() = " << CRS_rowptr.size() << "!= TargetNumRows+1 = " << TargetNumRows + 1 << ".");
 
  TEUCHOS_TEST_FOR_EXCEPTION(
      permuteToLIDs.size() != permuteFromLIDs.size(), std::invalid_argument,
      prefix << "permuteToLIDs.size() = " << permuteToLIDs.size()
             << "!= permuteFromLIDs.size() = " << permuteFromLIDs.size() << ".");
  const size_type numImportLIDs = importLIDs.size();
 
  TEUCHOS_TEST_FOR_EXCEPTION(
      numImportLIDs != numPacketsPerLID.size(), std::invalid_argument,
      prefix << "importLIDs.size() = " << numImportLIDs << " != "
                                                           "numPacketsPerLID.size() = "
             << numPacketsPerLID.size() << ".");
 
  // Preseed TargetPids with -1 for local
  if (static_cast<size_t>(TargetPids.size()) != TargetNumNonzeros) {
    TargetPids.resize(TargetNumNonzeros);
  }
  TargetPids.assign(TargetNumNonzeros, -1);
 
  // Grab pointers for sourceGraph
  auto local_graph   = sourceGraph.getLocalGraphDevice();
  auto local_col_map = sourceGraph.getColMap()->getLocalMap();
 
  // Convert input arrays to Kokkos::View
  device_type outputDevice;
  buffer_device_type bufferOutputDevice;
 
  Kokkos::View<const LO*, buffer_device_type> import_lids_d =
      create_mirror_view_from_raw_host_array(bufferOutputDevice, importLIDs.getRawPtr(),
                                             importLIDs.size(), true, "import_lids");
 
  Kokkos::View<const packet_type*, buffer_device_type> imports_d =
      create_mirror_view_from_raw_host_array(bufferOutputDevice, imports.getRawPtr(),
                                             imports.size(), true, "imports");
 
  Kokkos::View<const size_t*, buffer_device_type> num_packets_per_lid_d =
      create_mirror_view_from_raw_host_array(bufferOutputDevice,
                                             numPacketsPerLID.getRawPtr(), numPacketsPerLID.size(),
                                             true, "num_packets_per_lid");
 
  Kokkos::View<const LO*, buffer_device_type> permute_to_lids_d =
      create_mirror_view_from_raw_host_array(bufferOutputDevice,
                                             permuteToLIDs.getRawPtr(), permuteToLIDs.size(),
                                             true, "permute_to_lids");
 
  Kokkos::View<const LO*, buffer_device_type> permute_from_lids_d =
      create_mirror_view_from_raw_host_array(bufferOutputDevice,
                                             permuteFromLIDs.getRawPtr(), permuteFromLIDs.size(),
                                             true, "permute_from_lids");
 
  Kokkos::View<size_t*, device_type> crs_rowptr_d =
      create_mirror_view_from_raw_host_array(outputDevice,
                                             CRS_rowptr.getRawPtr(), CRS_rowptr.size(),
                                             true, "crs_rowptr");
 
  Kokkos::View<GO*, device_type> crs_colind_d =
      create_mirror_view_from_raw_host_array(outputDevice,
                                             CRS_colind.getRawPtr(), CRS_colind.size(),
                                             true, "crs_colidx");
 
  Kokkos::View<const int*, device_type> src_pids_d =
      create_mirror_view_from_raw_host_array(outputDevice,
                                             SourcePids.getRawPtr(), SourcePids.size(),
                                             true, "src_pids");
 
  Kokkos::View<int*, device_type> tgt_pids_d =
      create_mirror_view_from_raw_host_array(outputDevice,
                                             TargetPids.getRawPtr(), TargetPids.size(),
                                             true, "tgt_pids");
 
  using local_map_type = decltype(local_col_map);
  UnpackAndCombineCrsGraphImpl::unpackAndCombineIntoCrsArrays<
      packet_type, local_graph_device_type, local_map_type, buffer_device_type>(
      local_graph, local_col_map, import_lids_d, imports_d, num_packets_per_lid_d,
      permute_to_lids_d, permute_from_lids_d, crs_rowptr_d, crs_colind_d, src_pids_d,
      tgt_pids_d, numSameIDs, TargetNumRows, TargetNumNonzeros, MyTargetPID);
 
  // FIXME (mfh 25 Jun 2019) host_mirror_type of CudaUVMSpace is CudaUVMSpace!!!
 
  // Copy outputs back to host
  typename decltype(crs_rowptr_d)::host_mirror_type crs_rowptr_h(
      CRS_rowptr.getRawPtr(), CRS_rowptr.size());
  deep_copy(crs_rowptr_h, crs_rowptr_d);
 
  typename decltype(crs_colind_d)::host_mirror_type crs_colind_h(
      CRS_colind.getRawPtr(), CRS_colind.size());
  deep_copy(crs_colind_h, crs_colind_d);
 
  typename decltype(tgt_pids_d)::host_mirror_type tgt_pids_h(
      TargetPids.getRawPtr(), TargetPids.size());
  deep_copy(tgt_pids_h, tgt_pids_d);
}
 
}  // namespace Details
}  // namespace Tpetra
 
#define TPETRA_DETAILS_UNPACKCRSGRAPHANDCOMBINE_INSTANT(LO, GO, NT)                \
  template void                                                                    \
  Details::unpackAndCombineIntoCrsArrays<LO, GO, NT>(                              \
      const CrsGraph<LO, GO, NT>&,                                                 \
      const Teuchos::ArrayView<const LO>&,                                         \
      const Teuchos::ArrayView<const typename CrsGraph<LO, GO, NT>::packet_type>&, \
      const Teuchos::ArrayView<const size_t>&,                                     \
      const size_t,                                                                \
      const CombineMode,                                                           \
      const size_t,                                                                \
      const Teuchos::ArrayView<const LO>&,                                         \
      const Teuchos::ArrayView<const LO>&,                                         \
      size_t,                                                                      \
      size_t,                                                                      \
      const int,                                                                   \
      const Teuchos::ArrayView<size_t>&,                                           \
      const Teuchos::ArrayView<GO>&,                                               \
      const Teuchos::ArrayView<const int>&,                                        \
      Teuchos::Array<int>&);                                                       \
  template size_t                                                                  \
  Details::unpackAndCombineWithOwningPIDsCount<LO, GO, NT>(                        \
      const CrsGraph<LO, GO, NT>&,                                                 \
      const Teuchos::ArrayView<const LO>&,                                         \
      const Teuchos::ArrayView<const typename CrsGraph<LO, GO, NT>::packet_type>&, \
      const Teuchos::ArrayView<const size_t>&,                                     \
      size_t,                                                                      \
      CombineMode,                                                                 \
      size_t,                                                                      \
      const Teuchos::ArrayView<const LO>&,                                         \
      const Teuchos::ArrayView<const LO>&);
 
#endif  // TPETRA_DETAILS_UNPACKCRSGRAPHANDCOMBINE_DEF_HPP