Amesos2_MatrixAdapter_decl.hpp

// @HEADER
// *****************************************************************************
//           Amesos2: Templated Direct Sparse Solver Package
//
// Copyright 2011 NTESS and the Amesos2 contributors.
// SPDX-License-Identifier: BSD-3-Clause
// *****************************************************************************
// @HEADER


#ifndef AMESOS2_MATRIXADAPTER_DECL_HPP
#define AMESOS2_MATRIXADAPTER_DECL_HPP

#include "Amesos2_config.h"

#include <Teuchos_Comm.hpp>
#include <Teuchos_ArrayView.hpp>
#include <Teuchos_VerbosityLevel.hpp>
#include <Teuchos_FancyOStream.hpp>

#include <Tpetra_ConfigDefs.hpp>        // for global_size_t

// #include "Amesos2_ConcreteMatrixAdapter_decl.hpp"
#include "Amesos2_Util.hpp"
#include "Amesos2_MatrixTraits.hpp"

namespace Amesos2 {

  template <class M> class ConcreteMatrixAdapter;
  
  template < class Matrix >
  class MatrixAdapter {

  public:

    typedef typename MatrixTraits<Matrix>::scalar_t                 scalar_t;
    typedef typename MatrixTraits<Matrix>::local_ordinal_t   local_ordinal_t;
    typedef typename MatrixTraits<Matrix>::global_ordinal_t global_ordinal_t;
    typedef typename MatrixTraits<Matrix>::node_t                     node_t;
    typedef Tpetra::global_size_t                              global_size_t;

    typedef Matrix                                                  matrix_t;
    typedef MatrixAdapter<Matrix>                                       type;
    typedef ConcreteMatrixAdapter<Matrix>                          adapter_t;
    typedef Tpetra::Map<local_ordinal_t, global_ordinal_t, node_t> map_t;

    typedef typename MatrixTraits<Matrix>::global_host_idx_type  global_host_idx_t;
    typedef typename MatrixTraits<Matrix>::global_host_val_type  global_host_val_t;

    // template<typename S, typename GO, typename GS, typename Op>
    // friend class Util::get_cxs_helper<MatrixAdapter<Matrix>,S,GO,GS,Op>;
    // template<class M, typename S, typename GO, typename GS, typename Op>
    // friend class Util::get_cxs_helper;

    MatrixAdapter(Teuchos::RCP<Matrix> m);


    template<typename KV_S, typename KV_GO, typename KV_GS>
    void getCrs_kokkos_view(KV_S & nzval,
                            KV_GO & colind,
                            KV_GS & rowptr,
                            global_size_t& nnz,
                            const Teuchos::Ptr<const map_t> rowmap,
                            EStorage_Ordering ordering=ARBITRARY,
                            EDistribution distribution=ROOTED) const; // This was placed as last argument to preserve API


    template<typename KV_S, typename KV_GO, typename KV_GS>
    void getCrs_kokkos_view(KV_S & nzval,
                            KV_GO & colind,
                            KV_GS & rowptr,
                            global_size_t& nnz,
                            EDistribution distribution=ROOTED,
                            EStorage_Ordering ordering=ARBITRARY) const; // This was placed as last argument to preserve API

    template<typename KV_S, typename KV_GO, typename KV_GS>
    void getCcs_kokkos_view(KV_S & nzval,
                            KV_GO & rowind,
                            KV_GS & colptr,
                            global_size_t& nnz,
                            const Teuchos::Ptr<const map_t> colmap,
                            EStorage_Ordering ordering=ARBITRARY,
                            EDistribution distribution=ROOTED) const; // This was placed as last argument to preserve API

    template<typename KV_S, typename KV_GO, typename KV_GS>
    void getCcs_kokkos_view(KV_S & nzval,
                            KV_GO & rowind,
                            KV_GS & colptr,
                            global_size_t& nnz,
                            EDistribution distribution=ROOTED,
                            EStorage_Ordering ordering=ARBITRARY) const; // This was placed as last argument to preserve API


    const Teuchos::RCP<const Teuchos::Comm<int> > getComm() const
    {
      return comm_;
    }

    global_size_t getGlobalNumRows() const;

    global_size_t getGlobalNumCols() const;

    global_size_t getRowIndexBase() const;

    global_size_t getColumnIndexBase() const;

    global_size_t getGlobalNNZ() const;

    size_t getLocalNumRows() const;

    size_t getLocalNumCols() const;

    size_t getLocalNNZ() const;

    Teuchos::RCP<const map_t>
    getMap() const {
      return static_cast<const adapter_t*>(this)->getMap_impl();
    }

    Teuchos::RCP<const map_t>
    getRowMap() const {
      return row_map_;
    }

    Teuchos::RCP<const map_t>
    getColMap() const {
      return col_map_;
    }

    Teuchos::RCP<const type> get(const Teuchos::Ptr<const map_t> map, EDistribution distribution = ROOTED) const;

    Teuchos::RCP<const type> reindex(Teuchos::RCP<const map_t> &contigRowMap, Teuchos::RCP<const map_t> &contigColMap, const EPhase current_phase) const;

    template<typename KV_S, typename KV_GO, typename KV_GS, typename host_ordinal_type_array, typename host_scalar_type_array>
    local_ordinal_t gather(KV_S& nzvals, KV_GO& indices, KV_GS& pointers,
                           host_ordinal_type_array &recvCounts, host_ordinal_type_array &recvDispls,
                           host_ordinal_type_array &transpose_map, host_scalar_type_array &nzvals_t,
                           bool column_major, EPhase current_phase) const;

    std::string description() const;

    void describe(Teuchos::FancyOStream &out,
                  const Teuchos::EVerbosityLevel verbLevel=Teuchos::Describable::verbLevel_default) const;

    template<typename KV>
    void returnRowPtr_kokkos_view(KV & view) const;

    template<typename KV>
    void returnColInd_kokkos_view(KV & view) const;

    template<typename KV>
    void returnValues_kokkos_view(KV & view) const;


  private:
    template<typename KV_S, typename KV_GO, typename KV_GS>
    void help_getCrs_kokkos_view(KV_S & nzval,
         KV_GO & colind,
         KV_GS & rowptr,
         global_size_t& nnz,
         const Teuchos::Ptr<const Tpetra::Map<local_ordinal_t,global_ordinal_t,node_t> > rowmap,
         EDistribution distribution,
         EStorage_Ordering ordering,
         no_special_impl nsi) const;

    template<typename KV_S, typename KV_GO, typename KV_GS>
    void do_getCrs_kokkos_view(KV_S & nzval,
        KV_GO & colind,
        KV_GS & rowptr,
        global_size_t& nnz,
        const Teuchos::Ptr<const Tpetra::Map<local_ordinal_t,global_ordinal_t,node_t> > rowmap,
        EDistribution distribution,
        EStorage_Ordering ordering,
        row_access ra) const;

    template<typename KV_S, typename KV_GO, typename KV_GS>
    void help_getCcs_kokkos_view(KV_S & nzval,
         KV_GO & colind,
         KV_GS & rowptr,
         global_size_t& nnz,
         const Teuchos::Ptr<const Tpetra::Map<local_ordinal_t,global_ordinal_t,node_t> > rowmap,
         EDistribution distribution,
         EStorage_Ordering ordering,
         no_special_impl nsi) const;

    template<typename KV_S, typename KV_GO, typename KV_GS>
    void do_getCcs_kokkos_view(KV_S & nzval,
        KV_GO & rowind,
        KV_GS & colptr,
        global_size_t& nnz,
        const Teuchos::Ptr<const Tpetra::Map<local_ordinal_t,global_ordinal_t,node_t> > rowmap,
        EDistribution distribution,
        EStorage_Ordering ordering,
        row_access ra) const;

  protected:
    // These methods will link to concrete implementations, and may
    // also be used by them

    template<typename KV_GO, typename KV_S>
    void getGlobalRowCopy_kokkos_view(global_ordinal_t row,
                                      KV_GO & indices,
                                      KV_S & vals,
                                      size_t& nnz) const;

    size_t getMaxRowNNZ() const;

    size_t getMaxColNNZ() const;

    size_t getGlobalRowNNZ(global_ordinal_t row) const;

    size_t getLocalRowNNZ(local_ordinal_t row) const;

    size_t getGlobalColNNZ(global_ordinal_t col) const;

    size_t getLocalColNNZ(local_ordinal_t col) const;

    bool isLocallyIndexed() const;

    bool isGloballyIndexed() const;

  protected:
    const Teuchos::RCP<const Matrix> mat_;

    mutable Teuchos::RCP<const Tpetra::Map<local_ordinal_t,global_ordinal_t,node_t> > row_map_;

    mutable Teuchos::RCP<const Tpetra::Map<local_ordinal_t,global_ordinal_t,node_t> > col_map_;

    mutable Teuchos::RCP<const Teuchos::Comm<int> > comm_;
  };                                // end class MatrixAdapter


  // Factory creation method
  template <class Matrix>
  Teuchos::RCP<MatrixAdapter<Matrix> >
  createMatrixAdapter(Teuchos::RCP<Matrix> m);
    
  template <class Matrix>
  Teuchos::RCP<const MatrixAdapter<Matrix> >
  createConstMatrixAdapter(Teuchos::RCP<const Matrix> m);

} // end namespace Amesos2

#endif        // AMESOS2_MATRIXADAPTER_DECL_HPP