Date: 2025-03-29T05:58:33+00:00

Actual source code: aijkok.hpp

      1: #pragma once
      2: #include <petsc_kokkos.hpp>
      3: #include <petscmat_kokkos.hpp>
      4: #include <petsc/private/kokkosimpl.hpp>
      5: #include <../src/mat/impls/aij/seq/aij.h>
      6: #include <KokkosSparse_CrsMatrix.hpp>
      7: #include <KokkosSparse_spiluk.hpp>
      8: #include <string>

     10: namespace
     11: {
     12: PETSC_NODISCARD inline decltype(auto) NoInit(std::string label)
     13: {
     14:   return Kokkos::view_alloc(Kokkos::WithoutInitializing, std::move(label));
     15: }
     16: } // namespace

     18: using MatRowMapType = PetscInt;
     19: using MatColIdxType = PetscInt;
     20: using MatScalarType = PetscScalar;

     22: template <class MemorySpace>
     23: using KokkosCsrMatrixType = typename KokkosSparse::CrsMatrix<MatScalarType, MatColIdxType, MemorySpace, void /* MemoryTraits */, MatRowMapType>;
     24: template <class MemorySpace>
     25: using KokkosCsrGraphType = typename KokkosCsrMatrixType<MemorySpace>::staticcrsgraph_type;

     27: using KokkosCsrGraph     = KokkosCsrGraphType<DefaultMemorySpace>;
     28: using KokkosCsrGraphHost = KokkosCsrGraphType<HostMirrorMemorySpace>;

     30: using KokkosCsrMatrix     = KokkosCsrMatrixType<DefaultMemorySpace>;
     31: using KokkosCsrMatrixHost = KokkosCsrMatrixType<HostMirrorMemorySpace>;

     33: using MatRowMapKokkosView = KokkosCsrGraph::row_map_type::non_const_type;
     34: using MatColIdxKokkosView = KokkosCsrGraph::entries_type::non_const_type;
     35: using MatScalarKokkosView = KokkosCsrMatrix::values_type::non_const_type;

     37: using MatRowMapKokkosViewHost = KokkosCsrGraphHost::row_map_type::non_const_type;
     38: using MatColIdxKokkosViewHost = KokkosCsrGraphHost::entries_type::non_const_type;
     39: using MatScalarKokkosViewHost = KokkosCsrMatrixHost::values_type::non_const_type;

     41: using ConstMatRowMapKokkosView = KokkosCsrGraph::row_map_type::const_type;
     42: using ConstMatColIdxKokkosView = KokkosCsrGraph::entries_type::const_type;
     43: using ConstMatScalarKokkosView = KokkosCsrMatrix::values_type::const_type;

     45: using ConstMatRowMapKokkosViewHost = KokkosCsrGraphHost::row_map_type::const_type;
     46: using ConstMatColIdxKokkosViewHost = KokkosCsrGraphHost::entries_type::const_type;
     47: using ConstMatScalarKokkosViewHost = KokkosCsrMatrixHost::values_type::const_type;

     49: using MatRowMapKokkosDualView = Kokkos::DualView<MatRowMapType *>;
     50: using MatColIdxKokkosDualView = Kokkos::DualView<MatColIdxType *>;
     51: using MatScalarKokkosDualView = Kokkos::DualView<MatScalarType *>;

     53: using KernelHandle = KokkosKernels::Experimental::KokkosKernelsHandle<MatRowMapType, MatColIdxType, MatScalarType, DefaultExecutionSpace, DefaultMemorySpace, DefaultMemorySpace>;

     55: using KokkosTeamMemberType = Kokkos::TeamPolicy<DefaultExecutionSpace>::member_type;

     57: /* For mat->spptr of a factorized matrix */
     58: struct Mat_SeqAIJKokkosTriFactors {
     59:   MatRowMapKokkosView   iL_d, iU_d, iLt_d, iUt_d; /* rowmap for L, U, L^t, U^t of A=LU */
     60:   MatColIdxKokkosView   jL_d, jU_d, jLt_d, jUt_d; /* column ids */
     61:   MatScalarKokkosView   aL_d, aU_d, aLt_d, aUt_d; /* matrix values */
     62:   KernelHandle          kh, khL, khU, khLt, khUt; /* Kernel handles for ILU factorization of A, and TRSV of L, U, L^t, U^t */
     63:   PetscScalarKokkosView workVector;
     64:   PetscBool             transpose_updated;         /* Are L^T, U^T updated wrt L, U*/
     65:   PetscBool             sptrsv_symbolic_completed; /* Have we completed the symbolic solve for L and U */

     67:   MatRowMapKokkosViewHost iL_h, iU_h, iLt_h, iUt_h; // temp. buffers when we do factorization with PETSc on host. We copy L, U to these buffers and then copy to device
     68:   MatColIdxKokkosViewHost jL_h, jU_h, jLt_h, jUt_h;
     69:   MatScalarKokkosViewHost aL_h, aU_h, aLt_h, aUt_h, D_h; // D is for LDLT factorization
     70:   MatScalarKokkosView     D_d;
     71:   Mat                     L, U, Lt, Ut; // MATSEQAIJ on host if needed. Their arrays are alias to (iL_h, jL_h, aL_h), (iU_h, jU_h, aU_h) and their transpose.
     72:                                         // MatTranspose() on host might be faster than KK's csr transpose on device.

     74:   PetscIntKokkosView rowperm, colperm; // row permutation and column permutation

     76:   Mat_SeqAIJKokkosTriFactors(PetscInt n) : workVector("workVector", n)
     77:   {
     78:     L = U = Lt = Ut   = nullptr;
     79:     transpose_updated = sptrsv_symbolic_completed = PETSC_FALSE;
     80:   }

     82:   ~Mat_SeqAIJKokkosTriFactors() { Destroy(); }

     84:   void Destroy()
     85:   {
     86:     PetscFunctionBeginUser;
     87:     kh.destroy_spiluk_handle();
     88:     khL.destroy_sptrsv_handle();
     89:     khU.destroy_sptrsv_handle();
     90:     khLt.destroy_sptrsv_handle();
     91:     khUt.destroy_sptrsv_handle();
     92:     PetscCallVoid(MatDestroy(&L));
     93:     PetscCallVoid(MatDestroy(&U));
     94:     PetscCallVoid(MatDestroy(&Lt));
     95:     PetscCallVoid(MatDestroy(&Ut));
     96:     L = U = Lt = Ut   = nullptr;
     97:     transpose_updated = sptrsv_symbolic_completed = PETSC_FALSE;
     98:     PetscFunctionReturnVoid();
     99:   }
    100: };

    102: /* For mat->spptr of a regular matrix */
    103: struct Mat_SeqAIJKokkos {
    104:   MatRowMapKokkosDualView i_dual;
    105:   MatColIdxKokkosDualView j_dual;
    106:   MatScalarKokkosDualView a_dual;

    108:   MatRowMapKokkosDualView diag_dual; /* Diagonal pointer, built on demand */

    110:   KokkosCsrMatrix  csrmat;       /* The CSR matrix, used to call KK functions */
    111:   PetscObjectState nonzerostate; /* State of the nonzero pattern (graph) on device */

    113:   KokkosCsrMatrix     csrmatT, csrmatH;                     /* Transpose and Hermitian of the matrix (built on demand) */
    114:   PetscBool           transpose_updated, hermitian_updated; /* Are At, Ah updated wrt the matrix? */
    115:   MatRowMapKokkosView transpose_perm;                       // A permutation array making Ta(i) = Aa(perm(i)), where T = A^t

    117:   /* Construct a nrows by ncols matrix with given aseq on host. Caller also specifies a nonzero state */
    118:   Mat_SeqAIJKokkos(PetscInt nrows, PetscInt ncols, Mat_SeqAIJ *aseq, PetscObjectState nzstate, PetscBool copyValues = PETSC_TRUE)
    119:   {
    120:     auto exec = PetscGetKokkosExecutionSpace();

    122:     MatScalarKokkosViewHost a_h(aseq->a, aseq->nz);
    123:     MatRowMapKokkosViewHost i_h(const_cast<MatRowMapType *>(aseq->i), nrows + 1);
    124:     MatColIdxKokkosViewHost j_h(aseq->j, aseq->nz);
    125:     MatRowMapKokkosViewHost diag_h(aseq->diag, nrows);

    127:     auto a_d    = Kokkos::create_mirror_view(Kokkos::WithoutInitializing, exec, a_h);
    128:     auto i_d    = Kokkos::create_mirror_view_and_copy(exec, i_h);
    129:     auto j_d    = Kokkos::create_mirror_view_and_copy(exec, j_h);
    130:     auto diag_d = Kokkos::create_mirror_view_and_copy(exec, diag_h);
    131:     a_dual      = MatScalarKokkosDualView(a_d, a_h);
    132:     i_dual      = MatRowMapKokkosDualView(i_d, i_h);
    133:     j_dual      = MatColIdxKokkosDualView(j_d, j_h);
    134:     diag_dual   = MatColIdxKokkosDualView(diag_d, diag_h);

    136:     a_dual.modify_host(); /* Since caller provided values on host */
    137:     if (copyValues) a_dual.sync_device(exec);

    139:     csrmat = KokkosCsrMatrix("csrmat", ncols, a_d, KokkosCsrGraph(j_d, i_d));
    140:     Init(nzstate);
    141:   }

    143:   /* Construct with a KokkosCsrMatrix. For performance, only i, j are copied to host, but not the matrix values. */
    144:   Mat_SeqAIJKokkos(const KokkosCsrMatrix &csr) : csrmat(csr) /* Shallow-copy csr's views to csrmat */
    145:   {
    146:     auto a_d = csr.values;
    147:     /* Get a non-const version since I don't want to deal with DualView<const T*>, which is not well defined */
    148:     MatRowMapKokkosView i_d(const_cast<MatRowMapType *>(csr.graph.row_map.data()), csr.graph.row_map.extent(0));
    149:     auto                j_d = csr.graph.entries;
    150:     auto                a_h = Kokkos::create_mirror_view(Kokkos::WithoutInitializing, HostMirrorMemorySpace(), a_d);
    151:     auto                i_h = Kokkos::create_mirror_view_and_copy(HostMirrorMemorySpace(), i_d);
    152:     auto                j_h = Kokkos::create_mirror_view_and_copy(HostMirrorMemorySpace(), j_d);

    154:     // diag_dual is set until MatAssemblyEnd() where we copy diag from host to device
    155:     a_dual = MatScalarKokkosDualView(a_d, a_h);
    156:     a_dual.modify_device(); /* since we did not copy a_d to a_h, we mark device has the latest data */
    157:     i_dual = MatRowMapKokkosDualView(i_d, i_h);
    158:     j_dual = MatColIdxKokkosDualView(j_d, j_h);
    159:     Init();
    160:   }

    162:   Mat_SeqAIJKokkos(PetscInt nrows, PetscInt ncols, PetscInt nnz, MatRowMapKokkosDualView &i, MatColIdxKokkosDualView &j, MatScalarKokkosDualView a) : i_dual(i), j_dual(j), a_dual(a)
    163:   {
    164:     csrmat = KokkosCsrMatrix("csrmat", nrows, ncols, nnz, a.view_device(), i.view_device(), j.view_device());
    165:     Init();
    166:   }

    168:   MatScalarType *a_host_data() { return a_dual.view_host().data(); }
    169:   MatRowMapType *i_host_data() { return i_dual.view_host().data(); }
    170:   MatColIdxType *j_host_data() { return j_dual.view_host().data(); }

    172:   MatScalarType *a_device_data() { return a_dual.view_device().data(); }
    173:   MatRowMapType *i_device_data() { return i_dual.view_device().data(); }
    174:   MatColIdxType *j_device_data() { return j_dual.view_device().data(); }

    176:   MatColIdxType nrows() { return csrmat.numRows(); }
    177:   MatColIdxType ncols() { return csrmat.numCols(); }
    178:   MatRowMapType nnz() { return csrmat.nnz(); }

    180:   /* Change the csrmat size to n */
    181:   void SetColSize(MatColIdxType n) { csrmat = KokkosCsrMatrix("csrmat", n, a_dual.view_device(), csrmat.graph); }

    183:   void SetDiagonal(const MatRowMapType *diag)
    184:   {
    185:     MatRowMapKokkosViewHost diag_h(const_cast<MatRowMapType *>(diag), nrows());
    186:     auto                    diag_d = Kokkos::create_mirror_view_and_copy(DefaultMemorySpace(), diag_h);
    187:     diag_dual                      = MatRowMapKokkosDualView(diag_d, diag_h);
    188:   }

    190:   /* Shared init stuff */
    191:   void Init(PetscObjectState nzstate = 0)
    192:   {
    193:     nonzerostate      = nzstate;
    194:     transpose_updated = PETSC_FALSE;
    195:     hermitian_updated = PETSC_FALSE;
    196:   }

    198:   PetscErrorCode DestroyMatTranspose(void)
    199:   {
    200:     PetscFunctionBegin;
    201:     csrmatT = KokkosCsrMatrix(); /* Overwrite with empty matrices */
    202:     csrmatH = KokkosCsrMatrix();
    203:     PetscFunctionReturn(PETSC_SUCCESS);
    204:   }
    205: };

    207: struct MatProductData_SeqAIJKokkos {
    208:   KernelHandle kh;
    209:   PetscBool    reusesym;
    210:   MatProductData_SeqAIJKokkos() : reusesym(PETSC_FALSE) { }
    211: };

    213: PETSC_INTERN PetscErrorCode MatSetSeqAIJKokkosWithCSRMatrix(Mat, Mat_SeqAIJKokkos *);
    214: PETSC_INTERN PetscErrorCode MatCreateSeqAIJKokkosWithCSRMatrix(MPI_Comm, Mat_SeqAIJKokkos *, Mat *);
    215: PETSC_INTERN PetscErrorCode MatSeqAIJKokkosMergeMats(Mat, Mat, MatReuse, Mat *);
    216: PETSC_INTERN PetscErrorCode MatSeqAIJKokkosSyncDevice(Mat);
    217: PETSC_INTERN PetscErrorCode MatSeqAIJKokkosGetKokkosCsrMatrix(Mat, KokkosCsrMatrix *);
    218: PETSC_INTERN PetscErrorCode MatCreateSeqAIJKokkosWithKokkosCsrMatrix(MPI_Comm, KokkosCsrMatrix, Mat *);
    219: PETSC_INTERN PetscErrorCode PrintCsrMatrix(const KokkosCsrMatrix &csrmat);
    220: PETSC_INTERN PetscErrorCode MatConvert_SeqAIJ_SeqAIJKokkos(Mat, MatType, MatReuse, Mat *);
    221: PETSC_INTERN PetscErrorCode MatSeqAIJKokkosModifyDevice(Mat);
    222: PETSC_INTERN PetscErrorCode MatSeqAIJKokkosGenerateTranspose_Private(Mat, KokkosCsrMatrix *);

    224: PETSC_INTERN PetscErrorCode MatSeqAIJGetKokkosView(Mat, MatScalarKokkosView *);
    225: PETSC_INTERN PetscErrorCode MatSeqAIJRestoreKokkosView(Mat, MatScalarKokkosView *);
    226: PETSC_INTERN PetscErrorCode MatSeqAIJGetKokkosViewWrite(Mat, MatScalarKokkosView *);
    227: PETSC_INTERN PetscErrorCode MatSeqAIJRestoreKokkosViewWrite(Mat, MatScalarKokkosView *);
    228: PETSC_INTERN PetscErrorCode MatInvertVariableBlockDiagonal_SeqAIJKokkos(Mat, const PetscIntKokkosView &, const PetscIntKokkosView &, const PetscIntKokkosView &, PetscScalarKokkosView &, PetscScalarKokkosView &);