xref: /petsc/src/mat/impls/aij/mpi/mpiaij.c (revision a3156c1c25e80d44946ced3e1fe7fa9f1df6cc0b)
1c6db04a5SJed Brown #include <../src/mat/impls/aij/mpi/mpiaij.h> /*I "petscmat.h" I*/
2af0996ceSBarry Smith #include <petsc/private/vecimpl.h>
397929ea7SJunchao Zhang #include <petsc/private/sfimpl.h>
4af0996ceSBarry Smith #include <petsc/private/isimpl.h>
5c6db04a5SJed Brown #include <petscblaslapack.h>
60c312b8eSJed Brown #include <petscsf.h>
7bc8e477aSFande Kong #include <petsc/private/hashmapi.h>
88a729477SBarry Smith 
9674b392bSAlexander /* defines MatSetValues_MPI_Hash(), MatAssemblyBegin_MPI_Hash(), and MatAssemblyEnd_MPI_Hash() */
10674b392bSAlexander #define TYPE AIJ
11674b392bSAlexander #define TYPE_AIJ
12674b392bSAlexander #include "../src/mat/impls/aij/mpi/mpihashmat.h"
13674b392bSAlexander #undef TYPE
14674b392bSAlexander #undef TYPE_AIJ
15674b392bSAlexander 
16674b392bSAlexander static PetscErrorCode MatReset_MPIAIJ(Mat mat)
1726cec326SBarry Smith {
1826cec326SBarry Smith   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
1926cec326SBarry Smith 
2026cec326SBarry Smith   PetscFunctionBegin;
2126cec326SBarry Smith   PetscCall(PetscLogObjectState((PetscObject)mat, "Rows=%" PetscInt_FMT ", Cols=%" PetscInt_FMT, mat->rmap->N, mat->cmap->N));
2226cec326SBarry Smith   PetscCall(MatStashDestroy_Private(&mat->stash));
2326cec326SBarry Smith   PetscCall(VecDestroy(&aij->diag));
2426cec326SBarry Smith   PetscCall(MatDestroy(&aij->A));
2526cec326SBarry Smith   PetscCall(MatDestroy(&aij->B));
2626cec326SBarry Smith #if defined(PETSC_USE_CTABLE)
2726cec326SBarry Smith   PetscCall(PetscHMapIDestroy(&aij->colmap));
2826cec326SBarry Smith #else
2926cec326SBarry Smith   PetscCall(PetscFree(aij->colmap));
3026cec326SBarry Smith #endif
3126cec326SBarry Smith   PetscCall(PetscFree(aij->garray));
3226cec326SBarry Smith   PetscCall(VecDestroy(&aij->lvec));
3326cec326SBarry Smith   PetscCall(VecScatterDestroy(&aij->Mvctx));
3426cec326SBarry Smith   PetscCall(PetscFree2(aij->rowvalues, aij->rowindices));
3526cec326SBarry Smith   PetscCall(PetscFree(aij->ld));
36674b392bSAlexander   PetscFunctionReturn(PETSC_SUCCESS);
37674b392bSAlexander }
38674b392bSAlexander 
39674b392bSAlexander static PetscErrorCode MatResetHash_MPIAIJ(Mat mat)
40674b392bSAlexander {
41674b392bSAlexander   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
42674b392bSAlexander   /* Save the nonzero states of the component matrices because those are what are used to determine
43674b392bSAlexander     the nonzero state of mat */
44674b392bSAlexander   PetscObjectState Astate = aij->A->nonzerostate, Bstate = aij->B->nonzerostate;
45674b392bSAlexander 
46674b392bSAlexander   PetscFunctionBegin;
47674b392bSAlexander   PetscCall(MatReset_MPIAIJ(mat));
48674b392bSAlexander   PetscCall(MatSetUp_MPI_Hash(mat));
49674b392bSAlexander   aij->A->nonzerostate = ++Astate, aij->B->nonzerostate = ++Bstate;
50674b392bSAlexander   PetscFunctionReturn(PETSC_SUCCESS);
51674b392bSAlexander }
52674b392bSAlexander 
53674b392bSAlexander PetscErrorCode MatDestroy_MPIAIJ(Mat mat)
54674b392bSAlexander {
55674b392bSAlexander   PetscFunctionBegin;
56674b392bSAlexander   PetscCall(MatReset_MPIAIJ(mat));
5726cec326SBarry Smith 
5826cec326SBarry Smith   PetscCall(PetscFree(mat->data));
5926cec326SBarry Smith 
6026cec326SBarry Smith   /* may be created by MatCreateMPIAIJSumSeqAIJSymbolic */
6126cec326SBarry Smith   PetscCall(PetscObjectCompose((PetscObject)mat, "MatMergeSeqsToMPI", NULL));
6226cec326SBarry Smith 
6326cec326SBarry Smith   PetscCall(PetscObjectChangeTypeName((PetscObject)mat, NULL));
6426cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatStoreValues_C", NULL));
6526cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatRetrieveValues_C", NULL));
6626cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatIsTranspose_C", NULL));
6726cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatMPIAIJSetPreallocation_C", NULL));
6826cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatResetPreallocation_C", NULL));
69674b392bSAlexander   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatResetHash_C", NULL));
7026cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatMPIAIJSetPreallocationCSR_C", NULL));
7126cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatDiagonalScaleLocal_C", NULL));
7226cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpibaij_C", NULL));
7326cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpisbaij_C", NULL));
7426cec326SBarry Smith #if defined(PETSC_HAVE_CUDA)
7526cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijcusparse_C", NULL));
7626cec326SBarry Smith #endif
7726cec326SBarry Smith #if defined(PETSC_HAVE_HIP)
7826cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijhipsparse_C", NULL));
7926cec326SBarry Smith #endif
8026cec326SBarry Smith #if defined(PETSC_HAVE_KOKKOS_KERNELS)
8126cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijkokkos_C", NULL));
8226cec326SBarry Smith #endif
8326cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpidense_C", NULL));
8426cec326SBarry Smith #if defined(PETSC_HAVE_ELEMENTAL)
8526cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_elemental_C", NULL));
8626cec326SBarry Smith #endif
8726cec326SBarry Smith #if defined(PETSC_HAVE_SCALAPACK)
8826cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_scalapack_C", NULL));
8926cec326SBarry Smith #endif
9026cec326SBarry Smith #if defined(PETSC_HAVE_HYPRE)
9126cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_hypre_C", NULL));
9226cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatProductSetFromOptions_transpose_mpiaij_mpiaij_C", NULL));
9326cec326SBarry Smith #endif
9426cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_is_C", NULL));
9526cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatProductSetFromOptions_is_mpiaij_C", NULL));
9626cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatProductSetFromOptions_mpiaij_mpiaij_C", NULL));
9726cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatMPIAIJSetUseScalableIncreaseOverlap_C", NULL));
9826cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijperm_C", NULL));
9926cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijsell_C", NULL));
10026cec326SBarry Smith #if defined(PETSC_HAVE_MKL_SPARSE)
10126cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijmkl_C", NULL));
10226cec326SBarry Smith #endif
10326cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpiaijcrl_C", NULL));
10426cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_is_C", NULL));
10526cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatConvert_mpiaij_mpisell_C", NULL));
10626cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatSetPreallocationCOO_C", NULL));
10726cec326SBarry Smith   PetscCall(PetscObjectComposeFunction((PetscObject)mat, "MatSetValuesCOO_C", NULL));
10826cec326SBarry Smith   PetscFunctionReturn(PETSC_SUCCESS);
10926cec326SBarry Smith }
11026cec326SBarry Smith 
111ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetRowIJ_MPIAIJ(Mat A, PetscInt oshift, PetscBool symmetric, PetscBool inodecompressed, PetscInt *m, const PetscInt *ia[], const PetscInt *ja[], PetscBool *done)
112d71ae5a4SJacob Faibussowitsch {
1138a9c020eSBarry Smith   Mat B;
1148a9c020eSBarry Smith 
1158a9c020eSBarry Smith   PetscFunctionBegin;
1168a9c020eSBarry Smith   PetscCall(MatMPIAIJGetLocalMat(A, MAT_INITIAL_MATRIX, &B));
1178a9c020eSBarry Smith   PetscCall(PetscObjectCompose((PetscObject)A, "MatGetRowIJ_MPIAIJ", (PetscObject)B));
1188a9c020eSBarry Smith   PetscCall(MatGetRowIJ(B, oshift, symmetric, inodecompressed, m, ia, ja, done));
119501b8e33SLisandro Dalcin   PetscCall(MatDestroy(&B));
1203ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1218a9c020eSBarry Smith }
1228a9c020eSBarry Smith 
123ba38deedSJacob Faibussowitsch static PetscErrorCode MatRestoreRowIJ_MPIAIJ(Mat A, PetscInt oshift, PetscBool symmetric, PetscBool inodecompressed, PetscInt *m, const PetscInt *ia[], const PetscInt *ja[], PetscBool *done)
124d71ae5a4SJacob Faibussowitsch {
1258a9c020eSBarry Smith   Mat B;
1268a9c020eSBarry Smith 
1278a9c020eSBarry Smith   PetscFunctionBegin;
1288a9c020eSBarry Smith   PetscCall(PetscObjectQuery((PetscObject)A, "MatGetRowIJ_MPIAIJ", (PetscObject *)&B));
1298a9c020eSBarry Smith   PetscCall(MatRestoreRowIJ(B, oshift, symmetric, inodecompressed, m, ia, ja, done));
130501b8e33SLisandro Dalcin   PetscCall(PetscObjectCompose((PetscObject)A, "MatGetRowIJ_MPIAIJ", NULL));
1313ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1328a9c020eSBarry Smith }
1338a9c020eSBarry Smith 
13401bebe75SBarry Smith /*MC
13501bebe75SBarry Smith    MATAIJ - MATAIJ = "aij" - A matrix type to be used for sparse matrices.
13601bebe75SBarry Smith 
13711a5261eSBarry Smith    This matrix type is identical to` MATSEQAIJ` when constructed with a single process communicator,
13811a5261eSBarry Smith    and `MATMPIAIJ` otherwise.  As a result, for single process communicators,
13911a5261eSBarry Smith   `MatSeqAIJSetPreallocation()` is supported, and similarly `MatMPIAIJSetPreallocation()` is supported
14001bebe75SBarry Smith   for communicators controlling multiple processes.  It is recommended that you call both of
14101bebe75SBarry Smith   the above preallocation routines for simplicity.
14201bebe75SBarry Smith 
14327430b45SBarry Smith    Options Database Key:
14411a5261eSBarry Smith . -mat_type aij - sets the matrix type to `MATAIJ` during a call to `MatSetFromOptions()`
14501bebe75SBarry Smith 
14611a5261eSBarry Smith   Developer Note:
1472ef1f0ffSBarry Smith   Level: beginner
1482ef1f0ffSBarry Smith 
14911a5261eSBarry Smith     Subclasses include `MATAIJCUSPARSE`, `MATAIJPERM`, `MATAIJSELL`, `MATAIJMKL`, `MATAIJCRL`, `MATAIJKOKKOS`,and also automatically switches over to use inodes when
15001bebe75SBarry Smith    enough exist.
15101bebe75SBarry Smith 
1521cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MATSEQAIJ`, `MatCreateAIJ()`, `MatCreateSeqAIJ()`, `MATSEQAIJ`, `MATMPIAIJ`
15301bebe75SBarry Smith M*/
15401bebe75SBarry Smith 
15501bebe75SBarry Smith /*MC
15601bebe75SBarry Smith    MATAIJCRL - MATAIJCRL = "aijcrl" - A matrix type to be used for sparse matrices.
15701bebe75SBarry Smith 
15811a5261eSBarry Smith    This matrix type is identical to `MATSEQAIJCRL` when constructed with a single process communicator,
15911a5261eSBarry Smith    and `MATMPIAIJCRL` otherwise.  As a result, for single process communicators,
16011a5261eSBarry Smith    `MatSeqAIJSetPreallocation()` is supported, and similarly `MatMPIAIJSetPreallocation()` is supported
16101bebe75SBarry Smith   for communicators controlling multiple processes.  It is recommended that you call both of
16201bebe75SBarry Smith   the above preallocation routines for simplicity.
16301bebe75SBarry Smith 
16427430b45SBarry Smith    Options Database Key:
16511a5261eSBarry Smith . -mat_type aijcrl - sets the matrix type to `MATMPIAIJCRL` during a call to `MatSetFromOptions()`
16601bebe75SBarry Smith 
16701bebe75SBarry Smith   Level: beginner
16801bebe75SBarry Smith 
1691cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MatCreateMPIAIJCRL`, `MATSEQAIJCRL`, `MATMPIAIJCRL`, `MATSEQAIJCRL`, `MATMPIAIJCRL`
17001bebe75SBarry Smith M*/
17101bebe75SBarry Smith 
172d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatBindToCPU_MPIAIJ(Mat A, PetscBool flg)
173d71ae5a4SJacob Faibussowitsch {
174f74ef234SStefano Zampini   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
175f74ef234SStefano Zampini 
176f74ef234SStefano Zampini   PetscFunctionBegin;
177d5e393b6SSuyash Tandon #if defined(PETSC_HAVE_CUDA) || defined(PETSC_HAVE_HIP) || defined(PETSC_HAVE_VIENNACL)
178b470e4b4SRichard Tran Mills   A->boundtocpu = flg;
179f74ef234SStefano Zampini #endif
1801baa6e33SBarry Smith   if (a->A) PetscCall(MatBindToCPU(a->A, flg));
1811baa6e33SBarry Smith   if (a->B) PetscCall(MatBindToCPU(a->B, flg));
1823120d049SRichard Tran Mills 
1833120d049SRichard Tran Mills   /* In addition to binding the diagonal and off-diagonal matrices, bind the local vectors used for matrix-vector products.
1843120d049SRichard Tran Mills    * This maybe seems a little odd for a MatBindToCPU() call to do, but it makes no sense for the binding of these vectors
1853120d049SRichard Tran Mills    * to differ from the parent matrix. */
1861baa6e33SBarry Smith   if (a->lvec) PetscCall(VecBindToCPU(a->lvec, flg));
1871baa6e33SBarry Smith   if (a->diag) PetscCall(VecBindToCPU(a->diag, flg));
1883ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
189f74ef234SStefano Zampini }
190f74ef234SStefano Zampini 
191ba38deedSJacob Faibussowitsch static PetscErrorCode MatSetBlockSizes_MPIAIJ(Mat M, PetscInt rbs, PetscInt cbs)
192d71ae5a4SJacob Faibussowitsch {
19326bda2c4Sstefano_zampini   Mat_MPIAIJ *mat = (Mat_MPIAIJ *)M->data;
19426bda2c4Sstefano_zampini 
19526bda2c4Sstefano_zampini   PetscFunctionBegin;
19646533700Sstefano_zampini   if (mat->A) {
1979566063dSJacob Faibussowitsch     PetscCall(MatSetBlockSizes(mat->A, rbs, cbs));
1989566063dSJacob Faibussowitsch     PetscCall(MatSetBlockSizes(mat->B, rbs, 1));
19946533700Sstefano_zampini   }
2003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
20126bda2c4Sstefano_zampini }
20226bda2c4Sstefano_zampini 
203ba38deedSJacob Faibussowitsch static PetscErrorCode MatFindNonzeroRows_MPIAIJ(Mat M, IS *keptrows)
204d71ae5a4SJacob Faibussowitsch {
20527d4218bSShri Abhyankar   Mat_MPIAIJ      *mat = (Mat_MPIAIJ *)M->data;
20627d4218bSShri Abhyankar   Mat_SeqAIJ      *a   = (Mat_SeqAIJ *)mat->A->data;
20727d4218bSShri Abhyankar   Mat_SeqAIJ      *b   = (Mat_SeqAIJ *)mat->B->data;
20827d4218bSShri Abhyankar   const PetscInt  *ia, *ib;
209ce496241SStefano Zampini   const MatScalar *aa, *bb, *aav, *bav;
21027d4218bSShri Abhyankar   PetscInt         na, nb, i, j, *rows, cnt = 0, n0rows;
21127d4218bSShri Abhyankar   PetscInt         m = M->rmap->n, rstart = M->rmap->rstart;
21227d4218bSShri Abhyankar 
21327d4218bSShri Abhyankar   PetscFunctionBegin;
214f4259b30SLisandro Dalcin   *keptrows = NULL;
215ce496241SStefano Zampini 
21627d4218bSShri Abhyankar   ia = a->i;
21727d4218bSShri Abhyankar   ib = b->i;
2189566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(mat->A, &aav));
2199566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(mat->B, &bav));
22027d4218bSShri Abhyankar   for (i = 0; i < m; i++) {
22127d4218bSShri Abhyankar     na = ia[i + 1] - ia[i];
22227d4218bSShri Abhyankar     nb = ib[i + 1] - ib[i];
22327d4218bSShri Abhyankar     if (!na && !nb) {
22427d4218bSShri Abhyankar       cnt++;
22527d4218bSShri Abhyankar       goto ok1;
22627d4218bSShri Abhyankar     }
227ce496241SStefano Zampini     aa = aav + ia[i];
22827d4218bSShri Abhyankar     for (j = 0; j < na; j++) {
22927d4218bSShri Abhyankar       if (aa[j] != 0.0) goto ok1;
23027d4218bSShri Abhyankar     }
2318e3a54c0SPierre Jolivet     bb = PetscSafePointerPlusOffset(bav, ib[i]);
23227d4218bSShri Abhyankar     for (j = 0; j < nb; j++) {
23327d4218bSShri Abhyankar       if (bb[j] != 0.0) goto ok1;
23427d4218bSShri Abhyankar     }
23527d4218bSShri Abhyankar     cnt++;
23627d4218bSShri Abhyankar   ok1:;
23727d4218bSShri Abhyankar   }
238462c564dSBarry Smith   PetscCallMPI(MPIU_Allreduce(&cnt, &n0rows, 1, MPIU_INT, MPI_SUM, PetscObjectComm((PetscObject)M)));
239ce496241SStefano Zampini   if (!n0rows) {
2409566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(mat->A, &aav));
2419566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(mat->B, &bav));
2423ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
243ce496241SStefano Zampini   }
2449566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(M->rmap->n - cnt, &rows));
24527d4218bSShri Abhyankar   cnt = 0;
24627d4218bSShri Abhyankar   for (i = 0; i < m; i++) {
24727d4218bSShri Abhyankar     na = ia[i + 1] - ia[i];
24827d4218bSShri Abhyankar     nb = ib[i + 1] - ib[i];
24927d4218bSShri Abhyankar     if (!na && !nb) continue;
250ce496241SStefano Zampini     aa = aav + ia[i];
25127d4218bSShri Abhyankar     for (j = 0; j < na; j++) {
25227d4218bSShri Abhyankar       if (aa[j] != 0.0) {
25327d4218bSShri Abhyankar         rows[cnt++] = rstart + i;
25427d4218bSShri Abhyankar         goto ok2;
25527d4218bSShri Abhyankar       }
25627d4218bSShri Abhyankar     }
2578e3a54c0SPierre Jolivet     bb = PetscSafePointerPlusOffset(bav, ib[i]);
25827d4218bSShri Abhyankar     for (j = 0; j < nb; j++) {
25927d4218bSShri Abhyankar       if (bb[j] != 0.0) {
26027d4218bSShri Abhyankar         rows[cnt++] = rstart + i;
26127d4218bSShri Abhyankar         goto ok2;
26227d4218bSShri Abhyankar       }
26327d4218bSShri Abhyankar     }
26427d4218bSShri Abhyankar   ok2:;
26527d4218bSShri Abhyankar   }
2669566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PetscObjectComm((PetscObject)M), cnt, rows, PETSC_OWN_POINTER, keptrows));
2679566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(mat->A, &aav));
2689566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(mat->B, &bav));
2693ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
27027d4218bSShri Abhyankar }
27127d4218bSShri Abhyankar 
272ba38deedSJacob Faibussowitsch static PetscErrorCode MatDiagonalSet_MPIAIJ(Mat Y, Vec D, InsertMode is)
273d71ae5a4SJacob Faibussowitsch {
27499e65526SBarry Smith   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)Y->data;
27594342113SStefano Zampini   PetscBool   cong;
27699e65526SBarry Smith 
27799e65526SBarry Smith   PetscFunctionBegin;
2789566063dSJacob Faibussowitsch   PetscCall(MatHasCongruentLayouts(Y, &cong));
27994342113SStefano Zampini   if (Y->assembled && cong) {
2809566063dSJacob Faibussowitsch     PetscCall(MatDiagonalSet(aij->A, D, is));
28199e65526SBarry Smith   } else {
2829566063dSJacob Faibussowitsch     PetscCall(MatDiagonalSet_Default(Y, D, is));
28399e65526SBarry Smith   }
2843ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
28599e65526SBarry Smith }
28699e65526SBarry Smith 
287ba38deedSJacob Faibussowitsch static PetscErrorCode MatFindZeroDiagonals_MPIAIJ(Mat M, IS *zrows)
288d71ae5a4SJacob Faibussowitsch {
289f1f41ecbSJed Brown   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)M->data;
290f1f41ecbSJed Brown   PetscInt    i, rstart, nrows, *rows;
291f1f41ecbSJed Brown 
292f1f41ecbSJed Brown   PetscFunctionBegin;
2930298fd71SBarry Smith   *zrows = NULL;
2949566063dSJacob Faibussowitsch   PetscCall(MatFindZeroDiagonals_SeqAIJ_Private(aij->A, &nrows, &rows));
2959566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(M, &rstart, NULL));
296f1f41ecbSJed Brown   for (i = 0; i < nrows; i++) rows[i] += rstart;
2979566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PetscObjectComm((PetscObject)M), nrows, rows, PETSC_OWN_POINTER, zrows));
2983ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
299f1f41ecbSJed Brown }
300f1f41ecbSJed Brown 
301ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetColumnReductions_MPIAIJ(Mat A, PetscInt type, PetscReal *reductions)
302d71ae5a4SJacob Faibussowitsch {
3030716a85fSBarry Smith   Mat_MPIAIJ        *aij = (Mat_MPIAIJ *)A->data;
304a873a8cdSSam Reynolds   PetscInt           i, m, n, *garray = aij->garray;
3050716a85fSBarry Smith   Mat_SeqAIJ        *a_aij = (Mat_SeqAIJ *)aij->A->data;
3060716a85fSBarry Smith   Mat_SeqAIJ        *b_aij = (Mat_SeqAIJ *)aij->B->data;
3070716a85fSBarry Smith   PetscReal         *work;
308ce496241SStefano Zampini   const PetscScalar *dummy;
3090716a85fSBarry Smith 
3100716a85fSBarry Smith   PetscFunctionBegin;
3119566063dSJacob Faibussowitsch   PetscCall(MatGetSize(A, &m, &n));
3129566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(n, &work));
3139566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(aij->A, &dummy));
3149566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(aij->A, &dummy));
3159566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(aij->B, &dummy));
3169566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(aij->B, &dummy));
317857cbf51SRichard Tran Mills   if (type == NORM_2) {
318ad540459SPierre Jolivet     for (i = 0; i < a_aij->i[aij->A->rmap->n]; i++) work[A->cmap->rstart + a_aij->j[i]] += PetscAbsScalar(a_aij->a[i] * a_aij->a[i]);
319ad540459SPierre Jolivet     for (i = 0; i < b_aij->i[aij->B->rmap->n]; i++) work[garray[b_aij->j[i]]] += PetscAbsScalar(b_aij->a[i] * b_aij->a[i]);
320857cbf51SRichard Tran Mills   } else if (type == NORM_1) {
321ad540459SPierre Jolivet     for (i = 0; i < a_aij->i[aij->A->rmap->n]; i++) work[A->cmap->rstart + a_aij->j[i]] += PetscAbsScalar(a_aij->a[i]);
322ad540459SPierre Jolivet     for (i = 0; i < b_aij->i[aij->B->rmap->n]; i++) work[garray[b_aij->j[i]]] += PetscAbsScalar(b_aij->a[i]);
323857cbf51SRichard Tran Mills   } else if (type == NORM_INFINITY) {
324ad540459SPierre Jolivet     for (i = 0; i < a_aij->i[aij->A->rmap->n]; i++) work[A->cmap->rstart + a_aij->j[i]] = PetscMax(PetscAbsScalar(a_aij->a[i]), work[A->cmap->rstart + a_aij->j[i]]);
325ad540459SPierre Jolivet     for (i = 0; i < b_aij->i[aij->B->rmap->n]; i++) work[garray[b_aij->j[i]]] = PetscMax(PetscAbsScalar(b_aij->a[i]), work[garray[b_aij->j[i]]]);
326857cbf51SRichard Tran Mills   } else if (type == REDUCTION_SUM_REALPART || type == REDUCTION_MEAN_REALPART) {
327ad540459SPierre Jolivet     for (i = 0; i < a_aij->i[aij->A->rmap->n]; i++) work[A->cmap->rstart + a_aij->j[i]] += PetscRealPart(a_aij->a[i]);
328ad540459SPierre Jolivet     for (i = 0; i < b_aij->i[aij->B->rmap->n]; i++) work[garray[b_aij->j[i]]] += PetscRealPart(b_aij->a[i]);
329857cbf51SRichard Tran Mills   } else if (type == REDUCTION_SUM_IMAGINARYPART || type == REDUCTION_MEAN_IMAGINARYPART) {
330ad540459SPierre Jolivet     for (i = 0; i < a_aij->i[aij->A->rmap->n]; i++) work[A->cmap->rstart + a_aij->j[i]] += PetscImaginaryPart(a_aij->a[i]);
331ad540459SPierre Jolivet     for (i = 0; i < b_aij->i[aij->B->rmap->n]; i++) work[garray[b_aij->j[i]]] += PetscImaginaryPart(b_aij->a[i]);
332857cbf51SRichard Tran Mills   } else SETERRQ(PetscObjectComm((PetscObject)A), PETSC_ERR_ARG_WRONG, "Unknown reduction type");
333857cbf51SRichard Tran Mills   if (type == NORM_INFINITY) {
334e91c04dfSPierre Jolivet     PetscCallMPI(MPIU_Allreduce(work, reductions, n, MPIU_REAL, MPIU_MAX, PetscObjectComm((PetscObject)A)));
3350716a85fSBarry Smith   } else {
336e91c04dfSPierre Jolivet     PetscCallMPI(MPIU_Allreduce(work, reductions, n, MPIU_REAL, MPIU_SUM, PetscObjectComm((PetscObject)A)));
3370716a85fSBarry Smith   }
3389566063dSJacob Faibussowitsch   PetscCall(PetscFree(work));
339857cbf51SRichard Tran Mills   if (type == NORM_2) {
340a873a8cdSSam Reynolds     for (i = 0; i < n; i++) reductions[i] = PetscSqrtReal(reductions[i]);
341857cbf51SRichard Tran Mills   } else if (type == REDUCTION_MEAN_REALPART || type == REDUCTION_MEAN_IMAGINARYPART) {
342a873a8cdSSam Reynolds     for (i = 0; i < n; i++) reductions[i] /= m;
3430716a85fSBarry Smith   }
3443ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3450716a85fSBarry Smith }
3460716a85fSBarry Smith 
347ba38deedSJacob Faibussowitsch static PetscErrorCode MatFindOffBlockDiagonalEntries_MPIAIJ(Mat A, IS *is)
348d71ae5a4SJacob Faibussowitsch {
349e52d2c62SBarry Smith   Mat_MPIAIJ     *a = (Mat_MPIAIJ *)A->data;
350e52d2c62SBarry Smith   IS              sis, gis;
351e52d2c62SBarry Smith   const PetscInt *isis, *igis;
352e52d2c62SBarry Smith   PetscInt        n, *iis, nsis, ngis, rstart, i;
353e52d2c62SBarry Smith 
354e52d2c62SBarry Smith   PetscFunctionBegin;
3559566063dSJacob Faibussowitsch   PetscCall(MatFindOffBlockDiagonalEntries(a->A, &sis));
3569566063dSJacob Faibussowitsch   PetscCall(MatFindNonzeroRows(a->B, &gis));
3579566063dSJacob Faibussowitsch   PetscCall(ISGetSize(gis, &ngis));
3589566063dSJacob Faibussowitsch   PetscCall(ISGetSize(sis, &nsis));
3599566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(sis, &isis));
3609566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(gis, &igis));
361e52d2c62SBarry Smith 
3629566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(ngis + nsis, &iis));
3639566063dSJacob Faibussowitsch   PetscCall(PetscArraycpy(iis, igis, ngis));
3649566063dSJacob Faibussowitsch   PetscCall(PetscArraycpy(iis + ngis, isis, nsis));
365e52d2c62SBarry Smith   n = ngis + nsis;
3669566063dSJacob Faibussowitsch   PetscCall(PetscSortRemoveDupsInt(&n, iis));
3679566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(A, &rstart, NULL));
368e52d2c62SBarry Smith   for (i = 0; i < n; i++) iis[i] += rstart;
3699566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PetscObjectComm((PetscObject)A), n, iis, PETSC_OWN_POINTER, is));
370e52d2c62SBarry Smith 
3719566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(sis, &isis));
3729566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(gis, &igis));
3739566063dSJacob Faibussowitsch   PetscCall(ISDestroy(&sis));
3749566063dSJacob Faibussowitsch   PetscCall(ISDestroy(&gis));
3753ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
376e52d2c62SBarry Smith }
377e52d2c62SBarry Smith 
378dd6ea824SBarry Smith /*
3790f5bd95cSBarry Smith   Local utility routine that creates a mapping from the global column
3809e25ed09SBarry Smith number to the local number in the off-diagonal part of the local
3810f5bd95cSBarry Smith storage of the matrix.  When PETSC_USE_CTABLE is used this is scalable at
3820f5bd95cSBarry Smith a slightly higher hash table cost; without it it is not scalable (each processor
38372fa4726SStefano Zampini has an order N integer array but is fast to access.
3849e25ed09SBarry Smith */
385d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateColmap_MPIAIJ_Private(Mat mat)
386d71ae5a4SJacob Faibussowitsch {
38744a69424SLois Curfman McInnes   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
388d0f46423SBarry Smith   PetscInt    n   = aij->B->cmap->n, i;
389dbb450caSBarry Smith 
3903a40ed3dSBarry Smith   PetscFunctionBegin;
39108401ef6SPierre Jolivet   PetscCheck(!n || aij->garray, PETSC_COMM_SELF, PETSC_ERR_PLIB, "MPIAIJ Matrix was assembled but is missing garray");
392aa482453SBarry Smith #if defined(PETSC_USE_CTABLE)
393eec179cfSJacob Faibussowitsch   PetscCall(PetscHMapICreateWithSize(n, &aij->colmap));
394c76ffc5fSJacob Faibussowitsch   for (i = 0; i < n; i++) PetscCall(PetscHMapISet(aij->colmap, aij->garray[i] + 1, i + 1));
395b1fc9764SSatish Balay #else
3969566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(mat->cmap->N + 1, &aij->colmap));
397905e6a2fSBarry Smith   for (i = 0; i < n; i++) aij->colmap[aij->garray[i]] = i + 1;
398b1fc9764SSatish Balay #endif
3993ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4009e25ed09SBarry Smith }
4019e25ed09SBarry Smith 
402d40312a9SBarry Smith #define MatSetValues_SeqAIJ_A_Private(row, col, value, addv, orow, ocol) \
403a8f51744SPierre Jolivet   do { \
404db4deed7SKarl Rupp     if (col <= lastcol1) low1 = 0; \
405db4deed7SKarl Rupp     else high1 = nrow1; \
406fd3458f5SBarry Smith     lastcol1 = col; \
407fd3458f5SBarry Smith     while (high1 - low1 > 5) { \
408fd3458f5SBarry Smith       t = (low1 + high1) / 2; \
409fd3458f5SBarry Smith       if (rp1[t] > col) high1 = t; \
410fd3458f5SBarry Smith       else low1 = t; \
411ba4e3ef2SSatish Balay     } \
412fd3458f5SBarry Smith     for (_i = low1; _i < high1; _i++) { \
413fd3458f5SBarry Smith       if (rp1[_i] > col) break; \
414fd3458f5SBarry Smith       if (rp1[_i] == col) { \
4150c0d7e18SFande Kong         if (addv == ADD_VALUES) { \
4160c0d7e18SFande Kong           ap1[_i] += value; \
4170c0d7e18SFande Kong           /* Not sure LogFlops will slow dow the code or not */ \
4180c0d7e18SFande Kong           (void)PetscLogFlops(1.0); \
4199371c9d4SSatish Balay         } else ap1[_i] = value; \
42030770e4dSSatish Balay         goto a_noinsert; \
4210520107fSSatish Balay       } \
4220520107fSSatish Balay     } \
4239371c9d4SSatish Balay     if (value == 0.0 && ignorezeroentries && row != col) { \
4249371c9d4SSatish Balay       low1  = 0; \
4259371c9d4SSatish Balay       high1 = nrow1; \
4269371c9d4SSatish Balay       goto a_noinsert; \
4279371c9d4SSatish Balay     } \
4289371c9d4SSatish Balay     if (nonew == 1) { \
4299371c9d4SSatish Balay       low1  = 0; \
4309371c9d4SSatish Balay       high1 = nrow1; \
4319371c9d4SSatish Balay       goto a_noinsert; \
4329371c9d4SSatish Balay     } \
43308401ef6SPierre Jolivet     PetscCheck(nonew != -1, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Inserting a new nonzero at global row/column (%" PetscInt_FMT ", %" PetscInt_FMT ") into matrix", orow, ocol); \
434fef13f97SBarry Smith     MatSeqXAIJReallocateAIJ(A, am, 1, nrow1, row, col, rmax1, aa, ai, aj, rp1, ap1, aimax, nonew, MatScalar); \
4359371c9d4SSatish Balay     N = nrow1++ - 1; \
4369371c9d4SSatish Balay     a->nz++; \
4379371c9d4SSatish Balay     high1++; \
4380520107fSSatish Balay     /* shift up all the later entries in this row */ \
4399566063dSJacob Faibussowitsch     PetscCall(PetscArraymove(rp1 + _i + 1, rp1 + _i, N - _i + 1)); \
4409566063dSJacob Faibussowitsch     PetscCall(PetscArraymove(ap1 + _i + 1, ap1 + _i, N - _i + 1)); \
441fd3458f5SBarry Smith     rp1[_i] = col; \
442fd3458f5SBarry Smith     ap1[_i] = value; \
44330770e4dSSatish Balay   a_noinsert:; \
444fd3458f5SBarry Smith     ailen[row] = nrow1; \
445a8f51744SPierre Jolivet   } while (0)
4460a198c4cSBarry Smith 
447d40312a9SBarry Smith #define MatSetValues_SeqAIJ_B_Private(row, col, value, addv, orow, ocol) \
448a8f51744SPierre Jolivet   do { \
449db4deed7SKarl Rupp     if (col <= lastcol2) low2 = 0; \
450db4deed7SKarl Rupp     else high2 = nrow2; \
451fd3458f5SBarry Smith     lastcol2 = col; \
452fd3458f5SBarry Smith     while (high2 - low2 > 5) { \
453fd3458f5SBarry Smith       t = (low2 + high2) / 2; \
454fd3458f5SBarry Smith       if (rp2[t] > col) high2 = t; \
455fd3458f5SBarry Smith       else low2 = t; \
456ba4e3ef2SSatish Balay     } \
457fd3458f5SBarry Smith     for (_i = low2; _i < high2; _i++) { \
458fd3458f5SBarry Smith       if (rp2[_i] > col) break; \
459fd3458f5SBarry Smith       if (rp2[_i] == col) { \
4600c0d7e18SFande Kong         if (addv == ADD_VALUES) { \
4610c0d7e18SFande Kong           ap2[_i] += value; \
4620c0d7e18SFande Kong           (void)PetscLogFlops(1.0); \
4639371c9d4SSatish Balay         } else ap2[_i] = value; \
46430770e4dSSatish Balay         goto b_noinsert; \
46530770e4dSSatish Balay       } \
46630770e4dSSatish Balay     } \
4679371c9d4SSatish Balay     if (value == 0.0 && ignorezeroentries) { \
4689371c9d4SSatish Balay       low2  = 0; \
4699371c9d4SSatish Balay       high2 = nrow2; \
4709371c9d4SSatish Balay       goto b_noinsert; \
4719371c9d4SSatish Balay     } \
4729371c9d4SSatish Balay     if (nonew == 1) { \
4739371c9d4SSatish Balay       low2  = 0; \
4749371c9d4SSatish Balay       high2 = nrow2; \
4759371c9d4SSatish Balay       goto b_noinsert; \
4769371c9d4SSatish Balay     } \
47708401ef6SPierre Jolivet     PetscCheck(nonew != -1, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Inserting a new nonzero at global row/column (%" PetscInt_FMT ", %" PetscInt_FMT ") into matrix", orow, ocol); \
478fef13f97SBarry Smith     MatSeqXAIJReallocateAIJ(B, bm, 1, nrow2, row, col, rmax2, ba, bi, bj, rp2, ap2, bimax, nonew, MatScalar); \
4799371c9d4SSatish Balay     N = nrow2++ - 1; \
4809371c9d4SSatish Balay     b->nz++; \
4819371c9d4SSatish Balay     high2++; \
48230770e4dSSatish Balay     /* shift up all the later entries in this row */ \
4839566063dSJacob Faibussowitsch     PetscCall(PetscArraymove(rp2 + _i + 1, rp2 + _i, N - _i + 1)); \
4849566063dSJacob Faibussowitsch     PetscCall(PetscArraymove(ap2 + _i + 1, ap2 + _i, N - _i + 1)); \
485fd3458f5SBarry Smith     rp2[_i] = col; \
486fd3458f5SBarry Smith     ap2[_i] = value; \
48730770e4dSSatish Balay   b_noinsert:; \
488fd3458f5SBarry Smith     bilen[row] = nrow2; \
489a8f51744SPierre Jolivet   } while (0)
49030770e4dSSatish Balay 
491ba38deedSJacob Faibussowitsch static PetscErrorCode MatSetValuesRow_MPIAIJ(Mat A, PetscInt row, const PetscScalar v[])
492d71ae5a4SJacob Faibussowitsch {
4932fd7e33dSBarry Smith   Mat_MPIAIJ  *mat = (Mat_MPIAIJ *)A->data;
4942fd7e33dSBarry Smith   Mat_SeqAIJ  *a = (Mat_SeqAIJ *)mat->A->data, *b = (Mat_SeqAIJ *)mat->B->data;
4952fd7e33dSBarry Smith   PetscInt     l, *garray                         = mat->garray, diag;
496fff043a9SJunchao Zhang   PetscScalar *aa, *ba;
4972fd7e33dSBarry Smith 
4982fd7e33dSBarry Smith   PetscFunctionBegin;
4992fd7e33dSBarry Smith   /* code only works for square matrices A */
5002fd7e33dSBarry Smith 
5012fd7e33dSBarry Smith   /* find size of row to the left of the diagonal part */
5029566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(A, &diag, NULL));
5032fd7e33dSBarry Smith   row = row - diag;
5042fd7e33dSBarry Smith   for (l = 0; l < b->i[row + 1] - b->i[row]; l++) {
5052fd7e33dSBarry Smith     if (garray[b->j[b->i[row] + l]] > diag) break;
5062fd7e33dSBarry Smith   }
507fff043a9SJunchao Zhang   if (l) {
5089566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArray(mat->B, &ba));
5099566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(ba + b->i[row], v, l));
5109566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArray(mat->B, &ba));
511fff043a9SJunchao Zhang   }
5122fd7e33dSBarry Smith 
5132fd7e33dSBarry Smith   /* diagonal part */
514fff043a9SJunchao Zhang   if (a->i[row + 1] - a->i[row]) {
5159566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArray(mat->A, &aa));
51657508eceSPierre Jolivet     PetscCall(PetscArraycpy(aa + a->i[row], v + l, a->i[row + 1] - a->i[row]));
5179566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArray(mat->A, &aa));
518fff043a9SJunchao Zhang   }
5192fd7e33dSBarry Smith 
5202fd7e33dSBarry Smith   /* right of diagonal part */
521fff043a9SJunchao Zhang   if (b->i[row + 1] - b->i[row] - l) {
5229566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArray(mat->B, &ba));
5239566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(ba + b->i[row] + l, v + l + a->i[row + 1] - a->i[row], b->i[row + 1] - b->i[row] - l));
5249566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArray(mat->B, &ba));
525fff043a9SJunchao Zhang   }
5263ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5272fd7e33dSBarry Smith }
5282fd7e33dSBarry Smith 
529d71ae5a4SJacob Faibussowitsch PetscErrorCode MatSetValues_MPIAIJ(Mat mat, PetscInt m, const PetscInt im[], PetscInt n, const PetscInt in[], const PetscScalar v[], InsertMode addv)
530d71ae5a4SJacob Faibussowitsch {
53144a69424SLois Curfman McInnes   Mat_MPIAIJ *aij   = (Mat_MPIAIJ *)mat->data;
532071fcb05SBarry Smith   PetscScalar value = 0.0;
533d0f46423SBarry Smith   PetscInt    i, j, rstart = mat->rmap->rstart, rend = mat->rmap->rend;
534d0f46423SBarry Smith   PetscInt    cstart = mat->cmap->rstart, cend = mat->cmap->rend, row, col;
535ace3abfcSBarry Smith   PetscBool   roworiented = aij->roworiented;
5368a729477SBarry Smith 
5370520107fSSatish Balay   /* Some Variables required in the macro */
5384ee7247eSSatish Balay   Mat         A     = aij->A;
5394ee7247eSSatish Balay   Mat_SeqAIJ *a     = (Mat_SeqAIJ *)A->data;
54057809a77SBarry Smith   PetscInt   *aimax = a->imax, *ai = a->i, *ailen = a->ilen, *aj = a->j;
541ace3abfcSBarry Smith   PetscBool   ignorezeroentries = a->ignorezeroentries;
54230770e4dSSatish Balay   Mat         B                 = aij->B;
54330770e4dSSatish Balay   Mat_SeqAIJ *b                 = (Mat_SeqAIJ *)B->data;
544d0f46423SBarry Smith   PetscInt   *bimax = b->imax, *bi = b->i, *bilen = b->ilen, *bj = b->j, bm = aij->B->rmap->n, am = aij->A->rmap->n;
545ce496241SStefano Zampini   MatScalar  *aa, *ba;
546fd3458f5SBarry Smith   PetscInt   *rp1, *rp2, ii, nrow1, nrow2, _i, rmax1, rmax2, N, low1, high1, low2, high2, t, lastcol1, lastcol2;
5478d76821aSHong Zhang   PetscInt    nonew;
548a77337e4SBarry Smith   MatScalar  *ap1, *ap2;
5494ee7247eSSatish Balay 
5503a40ed3dSBarry Smith   PetscFunctionBegin;
5519566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(A, &aa));
5529566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(B, &ba));
5538a729477SBarry Smith   for (i = 0; i < m; i++) {
5545ef9f2a5SBarry Smith     if (im[i] < 0) continue;
55508401ef6SPierre Jolivet     PetscCheck(im[i] < mat->rmap->N, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Row too large: row %" PetscInt_FMT " max %" PetscInt_FMT, im[i], mat->rmap->N - 1);
5564b0e389bSBarry Smith     if (im[i] >= rstart && im[i] < rend) {
5574b0e389bSBarry Smith       row      = im[i] - rstart;
558fd3458f5SBarry Smith       lastcol1 = -1;
5598e3a54c0SPierre Jolivet       rp1      = PetscSafePointerPlusOffset(aj, ai[row]);
5608e3a54c0SPierre Jolivet       ap1      = PetscSafePointerPlusOffset(aa, ai[row]);
561fd3458f5SBarry Smith       rmax1    = aimax[row];
562fd3458f5SBarry Smith       nrow1    = ailen[row];
563fd3458f5SBarry Smith       low1     = 0;
564fd3458f5SBarry Smith       high1    = nrow1;
565fd3458f5SBarry Smith       lastcol2 = -1;
5668e3a54c0SPierre Jolivet       rp2      = PetscSafePointerPlusOffset(bj, bi[row]);
5678e3a54c0SPierre Jolivet       ap2      = PetscSafePointerPlusOffset(ba, bi[row]);
568fd3458f5SBarry Smith       rmax2    = bimax[row];
569d498b1e9SBarry Smith       nrow2    = bilen[row];
570fd3458f5SBarry Smith       low2     = 0;
571fd3458f5SBarry Smith       high2    = nrow2;
572fd3458f5SBarry Smith 
5731eb62cbbSBarry Smith       for (j = 0; j < n; j++) {
574071fcb05SBarry Smith         if (v) value = roworiented ? v[i * n + j] : v[i + j * m];
575c80a64e6SBarry Smith         if (ignorezeroentries && value == 0.0 && (addv == ADD_VALUES) && im[i] != in[j]) continue;
576fd3458f5SBarry Smith         if (in[j] >= cstart && in[j] < cend) {
577fd3458f5SBarry Smith           col   = in[j] - cstart;
5788d76821aSHong Zhang           nonew = a->nonew;
579d40312a9SBarry Smith           MatSetValues_SeqAIJ_A_Private(row, col, value, addv, im[i], in[j]);
580f7d195e4SLawrence Mitchell         } else if (in[j] < 0) {
581f7d195e4SLawrence Mitchell           continue;
582f7d195e4SLawrence Mitchell         } else {
583f7d195e4SLawrence Mitchell           PetscCheck(in[j] < mat->cmap->N, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Column too large: col %" PetscInt_FMT " max %" PetscInt_FMT, in[j], mat->cmap->N - 1);
584227d817aSBarry Smith           if (mat->was_assembled) {
58548a46eb9SPierre Jolivet             if (!aij->colmap) PetscCall(MatCreateColmap_MPIAIJ_Private(mat));
586aa482453SBarry Smith #if defined(PETSC_USE_CTABLE)
587eec179cfSJacob Faibussowitsch             PetscCall(PetscHMapIGetWithDefault(aij->colmap, in[j] + 1, 0, &col)); /* map global col ids to local ones */
588fa46199cSSatish Balay             col--;
589b1fc9764SSatish Balay #else
590905e6a2fSBarry Smith             col = aij->colmap[in[j]] - 1;
591b1fc9764SSatish Balay #endif
592f4f49eeaSPierre Jolivet             if (col < 0 && !((Mat_SeqAIJ *)aij->B->data)->nonew) { /* col < 0 means in[j] is a new col for B */
593eb14dd14SAlex Lindsay               PetscCall(MatDisAssemble_MPIAIJ(mat, PETSC_FALSE));  /* Change aij->B from reduced/local format to expanded/global format */
5944b0e389bSBarry Smith               col = in[j];
5959bf004c3SSatish Balay               /* Reinitialize the variables required by MatSetValues_SeqAIJ_B_Private() */
596f9508a3cSSatish Balay               B     = aij->B;
597f9508a3cSSatish Balay               b     = (Mat_SeqAIJ *)B->data;
5989371c9d4SSatish Balay               bimax = b->imax;
5999371c9d4SSatish Balay               bi    = b->i;
6009371c9d4SSatish Balay               bilen = b->ilen;
6019371c9d4SSatish Balay               bj    = b->j;
6029371c9d4SSatish Balay               ba    = b->a;
603cff58d65SJunchao Zhang               rp2   = PetscSafePointerPlusOffset(bj, bi[row]);
604cff58d65SJunchao Zhang               ap2   = PetscSafePointerPlusOffset(ba, bi[row]);
605d498b1e9SBarry Smith               rmax2 = bimax[row];
606d498b1e9SBarry Smith               nrow2 = bilen[row];
607d498b1e9SBarry Smith               low2  = 0;
608d498b1e9SBarry Smith               high2 = nrow2;
609d0f46423SBarry Smith               bm    = aij->B->rmap->n;
610f9508a3cSSatish Balay               ba    = b->a;
611d707bf6cSMatthew Knepley             } else if (col < 0 && !(ignorezeroentries && value == 0.0)) {
612f4f49eeaSPierre Jolivet               if (1 == ((Mat_SeqAIJ *)aij->B->data)->nonew) {
6139566063dSJacob Faibussowitsch                 PetscCall(PetscInfo(mat, "Skipping of insertion of new nonzero location in off-diagonal portion of matrix %g(%" PetscInt_FMT ",%" PetscInt_FMT ")\n", (double)PetscRealPart(value), im[i], in[j]));
61498921bdaSJacob Faibussowitsch               } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Inserting a new nonzero at global row/column (%" PetscInt_FMT ", %" PetscInt_FMT ") into matrix", im[i], in[j]);
6150587a0fcSBarry Smith             }
616c48de900SBarry Smith           } else col = in[j];
6178d76821aSHong Zhang           nonew = b->nonew;
618d40312a9SBarry Smith           MatSetValues_SeqAIJ_B_Private(row, col, value, addv, im[i], in[j]);
6191eb62cbbSBarry Smith         }
6201eb62cbbSBarry Smith       }
6215ef9f2a5SBarry Smith     } else {
62228b400f6SJacob Faibussowitsch       PetscCheck(!mat->nooffprocentries, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Setting off process row %" PetscInt_FMT " even though MatSetOption(,MAT_NO_OFF_PROC_ENTRIES,PETSC_TRUE) was set", im[i]);
62390f02eecSBarry Smith       if (!aij->donotstash) {
6245080c13bSMatthew G Knepley         mat->assembled = PETSC_FALSE;
625d36fbae8SSatish Balay         if (roworiented) {
6268e3a54c0SPierre Jolivet           PetscCall(MatStashValuesRow_Private(&mat->stash, im[i], n, in, PetscSafePointerPlusOffset(v, i * n), (PetscBool)(ignorezeroentries && (addv == ADD_VALUES))));
627d36fbae8SSatish Balay         } else {
6288e3a54c0SPierre Jolivet           PetscCall(MatStashValuesCol_Private(&mat->stash, im[i], n, in, PetscSafePointerPlusOffset(v, i), m, (PetscBool)(ignorezeroentries && (addv == ADD_VALUES))));
6294b0e389bSBarry Smith         }
6301eb62cbbSBarry Smith       }
6318a729477SBarry Smith     }
63290f02eecSBarry Smith   }
6335519a089SJose E. Roman   PetscCall(MatSeqAIJRestoreArray(A, &aa)); /* aa, bb might have been free'd due to reallocation above. But we don't access them here */
6349566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArray(B, &ba));
6353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6368a729477SBarry Smith }
6378a729477SBarry Smith 
6382b08fdbeSandi selinger /*
639904d1e70Sandi selinger     This function sets the j and ilen arrays (of the diagonal and off-diagonal part) of an MPIAIJ-matrix.
6402b08fdbeSandi selinger     The values in mat_i have to be sorted and the values in mat_j have to be sorted for each row (CSR-like).
641904d1e70Sandi selinger     No off-processor parts off the matrix are allowed here and mat->was_assembled has to be PETSC_FALSE.
6422b08fdbeSandi selinger */
643d71ae5a4SJacob Faibussowitsch PetscErrorCode MatSetValues_MPIAIJ_CopyFromCSRFormat_Symbolic(Mat mat, const PetscInt mat_j[], const PetscInt mat_i[])
644d71ae5a4SJacob Faibussowitsch {
645904d1e70Sandi selinger   Mat_MPIAIJ *aij    = (Mat_MPIAIJ *)mat->data;
646904d1e70Sandi selinger   Mat         A      = aij->A; /* diagonal part of the matrix */
6474cf0e950SBarry Smith   Mat         B      = aij->B; /* off-diagonal part of the matrix */
648904d1e70Sandi selinger   Mat_SeqAIJ *a      = (Mat_SeqAIJ *)A->data;
649904d1e70Sandi selinger   Mat_SeqAIJ *b      = (Mat_SeqAIJ *)B->data;
650904d1e70Sandi selinger   PetscInt    cstart = mat->cmap->rstart, cend = mat->cmap->rend, col;
651904d1e70Sandi selinger   PetscInt   *ailen = a->ilen, *aj = a->j;
652904d1e70Sandi selinger   PetscInt   *bilen = b->ilen, *bj = b->j;
6536dc1ffa3Sandi selinger   PetscInt    am          = aij->A->rmap->n, j;
654904d1e70Sandi selinger   PetscInt    diag_so_far = 0, dnz;
655904d1e70Sandi selinger   PetscInt    offd_so_far = 0, onz;
656904d1e70Sandi selinger 
657904d1e70Sandi selinger   PetscFunctionBegin;
658904d1e70Sandi selinger   /* Iterate over all rows of the matrix */
659904d1e70Sandi selinger   for (j = 0; j < am; j++) {
660904d1e70Sandi selinger     dnz = onz = 0;
661904d1e70Sandi selinger     /*  Iterate over all non-zero columns of the current row */
6626dc1ffa3Sandi selinger     for (col = mat_i[j]; col < mat_i[j + 1]; col++) {
663904d1e70Sandi selinger       /* If column is in the diagonal */
664904d1e70Sandi selinger       if (mat_j[col] >= cstart && mat_j[col] < cend) {
665904d1e70Sandi selinger         aj[diag_so_far++] = mat_j[col] - cstart;
666904d1e70Sandi selinger         dnz++;
667904d1e70Sandi selinger       } else { /* off-diagonal entries */
668904d1e70Sandi selinger         bj[offd_so_far++] = mat_j[col];
669904d1e70Sandi selinger         onz++;
670904d1e70Sandi selinger       }
671904d1e70Sandi selinger     }
672904d1e70Sandi selinger     ailen[j] = dnz;
673904d1e70Sandi selinger     bilen[j] = onz;
674904d1e70Sandi selinger   }
6753ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
676904d1e70Sandi selinger }
677904d1e70Sandi selinger 
678904d1e70Sandi selinger /*
679904d1e70Sandi selinger     This function sets the local j, a and ilen arrays (of the diagonal and off-diagonal part) of an MPIAIJ-matrix.
680904d1e70Sandi selinger     The values in mat_i have to be sorted and the values in mat_j have to be sorted for each row (CSR-like).
6811de21080Sandi selinger     No off-processor parts off the matrix are allowed here, they are set at a later point by MatSetValues_MPIAIJ.
6821de21080Sandi selinger     Also, mat->was_assembled has to be false, otherwise the statement aj[rowstart_diag+dnz_row] = mat_j[col] - cstart;
6831de21080Sandi selinger     would not be true and the more complex MatSetValues_MPIAIJ has to be used.
684904d1e70Sandi selinger */
685d71ae5a4SJacob Faibussowitsch PetscErrorCode MatSetValues_MPIAIJ_CopyFromCSRFormat(Mat mat, const PetscInt mat_j[], const PetscInt mat_i[], const PetscScalar mat_a[])
686d71ae5a4SJacob Faibussowitsch {
6873a063d27Sandi selinger   Mat_MPIAIJ  *aij  = (Mat_MPIAIJ *)mat->data;
6883a063d27Sandi selinger   Mat          A    = aij->A; /* diagonal part of the matrix */
6894cf0e950SBarry Smith   Mat          B    = aij->B; /* off-diagonal part of the matrix */
690f4f49eeaSPierre Jolivet   Mat_SeqAIJ  *aijd = (Mat_SeqAIJ *)aij->A->data, *aijo = (Mat_SeqAIJ *)aij->B->data;
6913a063d27Sandi selinger   Mat_SeqAIJ  *a      = (Mat_SeqAIJ *)A->data;
6923a063d27Sandi selinger   Mat_SeqAIJ  *b      = (Mat_SeqAIJ *)B->data;
6933a063d27Sandi selinger   PetscInt     cstart = mat->cmap->rstart, cend = mat->cmap->rend;
6943a063d27Sandi selinger   PetscInt    *ailen = a->ilen, *aj = a->j;
6953a063d27Sandi selinger   PetscInt    *bilen = b->ilen, *bj = b->j;
6966dc1ffa3Sandi selinger   PetscInt     am          = aij->A->rmap->n, j;
6971de21080Sandi selinger   PetscInt    *full_diag_i = aijd->i, *full_offd_i = aijo->i; /* These variables can also include non-local elements, which are set at a later point. */
698904d1e70Sandi selinger   PetscInt     col, dnz_row, onz_row, rowstart_diag, rowstart_offd;
699904d1e70Sandi selinger   PetscScalar *aa = a->a, *ba = b->a;
7003a063d27Sandi selinger 
7013a063d27Sandi selinger   PetscFunctionBegin;
7023a063d27Sandi selinger   /* Iterate over all rows of the matrix */
7033a063d27Sandi selinger   for (j = 0; j < am; j++) {
704904d1e70Sandi selinger     dnz_row = onz_row = 0;
705904d1e70Sandi selinger     rowstart_offd     = full_offd_i[j];
706904d1e70Sandi selinger     rowstart_diag     = full_diag_i[j];
707e9ede7d0Sandi selinger     /*  Iterate over all non-zero columns of the current row */
708e9ede7d0Sandi selinger     for (col = mat_i[j]; col < mat_i[j + 1]; col++) {
709ae8e66a0Sandi selinger       /* If column is in the diagonal */
7103a063d27Sandi selinger       if (mat_j[col] >= cstart && mat_j[col] < cend) {
711904d1e70Sandi selinger         aj[rowstart_diag + dnz_row] = mat_j[col] - cstart;
712904d1e70Sandi selinger         aa[rowstart_diag + dnz_row] = mat_a[col];
713904d1e70Sandi selinger         dnz_row++;
714ae8e66a0Sandi selinger       } else { /* off-diagonal entries */
715904d1e70Sandi selinger         bj[rowstart_offd + onz_row] = mat_j[col];
716904d1e70Sandi selinger         ba[rowstart_offd + onz_row] = mat_a[col];
717904d1e70Sandi selinger         onz_row++;
7183a063d27Sandi selinger       }
7193a063d27Sandi selinger     }
720904d1e70Sandi selinger     ailen[j] = dnz_row;
721904d1e70Sandi selinger     bilen[j] = onz_row;
7223a063d27Sandi selinger   }
7233ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7243a063d27Sandi selinger }
7253a063d27Sandi selinger 
726ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetValues_MPIAIJ(Mat mat, PetscInt m, const PetscInt idxm[], PetscInt n, const PetscInt idxn[], PetscScalar v[])
727d71ae5a4SJacob Faibussowitsch {
728b49de8d1SLois Curfman McInnes   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
729d0f46423SBarry Smith   PetscInt    i, j, rstart = mat->rmap->rstart, rend = mat->rmap->rend;
730d0f46423SBarry Smith   PetscInt    cstart = mat->cmap->rstart, cend = mat->cmap->rend, row, col;
731b49de8d1SLois Curfman McInnes 
7323a40ed3dSBarry Smith   PetscFunctionBegin;
733b49de8d1SLois Curfman McInnes   for (i = 0; i < m; i++) {
73454c59aa7SJacob Faibussowitsch     if (idxm[i] < 0) continue; /* negative row */
73554c59aa7SJacob Faibussowitsch     PetscCheck(idxm[i] < mat->rmap->N, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Row too large: row %" PetscInt_FMT " max %" PetscInt_FMT, idxm[i], mat->rmap->N - 1);
73685835d77SBarry Smith     PetscCheck(idxm[i] >= rstart && idxm[i] < rend, PETSC_COMM_SELF, PETSC_ERR_SUP, "Only local values currently supported, row requested %" PetscInt_FMT " range [%" PetscInt_FMT " %" PetscInt_FMT ")", idxm[i], rstart, rend);
737b49de8d1SLois Curfman McInnes     row = idxm[i] - rstart;
738b49de8d1SLois Curfman McInnes     for (j = 0; j < n; j++) {
73954c59aa7SJacob Faibussowitsch       if (idxn[j] < 0) continue; /* negative column */
74054c59aa7SJacob Faibussowitsch       PetscCheck(idxn[j] < mat->cmap->N, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Column too large: col %" PetscInt_FMT " max %" PetscInt_FMT, idxn[j], mat->cmap->N - 1);
741b49de8d1SLois Curfman McInnes       if (idxn[j] >= cstart && idxn[j] < cend) {
742b49de8d1SLois Curfman McInnes         col = idxn[j] - cstart;
7439566063dSJacob Faibussowitsch         PetscCall(MatGetValues(aij->A, 1, &row, 1, &col, v + i * n + j));
744fa852ad4SSatish Balay       } else {
74548a46eb9SPierre Jolivet         if (!aij->colmap) PetscCall(MatCreateColmap_MPIAIJ_Private(mat));
746aa482453SBarry Smith #if defined(PETSC_USE_CTABLE)
747eec179cfSJacob Faibussowitsch         PetscCall(PetscHMapIGetWithDefault(aij->colmap, idxn[j] + 1, 0, &col));
748fa46199cSSatish Balay         col--;
749b1fc9764SSatish Balay #else
750905e6a2fSBarry Smith         col = aij->colmap[idxn[j]] - 1;
751b1fc9764SSatish Balay #endif
752e60e1c95SSatish Balay         if ((col < 0) || (aij->garray[col] != idxn[j])) *(v + i * n + j) = 0.0;
75348a46eb9SPierre Jolivet         else PetscCall(MatGetValues(aij->B, 1, &row, 1, &col, v + i * n + j));
754b49de8d1SLois Curfman McInnes       }
755b49de8d1SLois Curfman McInnes     }
756b49de8d1SLois Curfman McInnes   }
7573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
758b49de8d1SLois Curfman McInnes }
759bc5ccf88SSatish Balay 
760ba38deedSJacob Faibussowitsch static PetscErrorCode MatAssemblyBegin_MPIAIJ(Mat mat, MatAssemblyType mode)
761d71ae5a4SJacob Faibussowitsch {
762bc5ccf88SSatish Balay   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
763b1d57f15SBarry Smith   PetscInt    nstash, reallocs;
764bc5ccf88SSatish Balay 
765bc5ccf88SSatish Balay   PetscFunctionBegin;
7663ba16761SJacob Faibussowitsch   if (aij->donotstash || mat->nooffprocentries) PetscFunctionReturn(PETSC_SUCCESS);
767bc5ccf88SSatish Balay 
7689566063dSJacob Faibussowitsch   PetscCall(MatStashScatterBegin_Private(mat, &mat->stash, mat->rmap->range));
7699566063dSJacob Faibussowitsch   PetscCall(MatStashGetInfo_Private(&mat->stash, &nstash, &reallocs));
7709566063dSJacob Faibussowitsch   PetscCall(PetscInfo(aij->A, "Stash has %" PetscInt_FMT " entries, uses %" PetscInt_FMT " mallocs.\n", nstash, reallocs));
7713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
772bc5ccf88SSatish Balay }
773bc5ccf88SSatish Balay 
774d71ae5a4SJacob Faibussowitsch PetscErrorCode MatAssemblyEnd_MPIAIJ(Mat mat, MatAssemblyType mode)
775d71ae5a4SJacob Faibussowitsch {
776bc5ccf88SSatish Balay   Mat_MPIAIJ  *aij = (Mat_MPIAIJ *)mat->data;
777b1d57f15SBarry Smith   PetscMPIInt  n;
778b1d57f15SBarry Smith   PetscInt     i, j, rstart, ncols, flg;
779e44c0bd4SBarry Smith   PetscInt    *row, *col;
780ace3abfcSBarry Smith   PetscBool    other_disassembled;
78187828ca2SBarry Smith   PetscScalar *val;
782bc5ccf88SSatish Balay 
78391c97fd4SSatish Balay   /* do not use 'b = (Mat_SeqAIJ*)aij->B->data' as B can be reset in disassembly */
7846e111a19SKarl Rupp 
785bc5ccf88SSatish Balay   PetscFunctionBegin;
7864cb17eb5SBarry Smith   if (!aij->donotstash && !mat->nooffprocentries) {
787a2d1c673SSatish Balay     while (1) {
7889566063dSJacob Faibussowitsch       PetscCall(MatStashScatterGetMesg_Private(&mat->stash, &n, &row, &col, &val, &flg));
789a2d1c673SSatish Balay       if (!flg) break;
790a2d1c673SSatish Balay 
791bc5ccf88SSatish Balay       for (i = 0; i < n;) {
792bc5ccf88SSatish Balay         /* Now identify the consecutive vals belonging to the same row */
7932205254eSKarl Rupp         for (j = i, rstart = row[j]; j < n; j++) {
7942205254eSKarl Rupp           if (row[j] != rstart) break;
7952205254eSKarl Rupp         }
796bc5ccf88SSatish Balay         if (j < n) ncols = j - i;
797bc5ccf88SSatish Balay         else ncols = n - i;
798bc5ccf88SSatish Balay         /* Now assemble all these values with a single function call */
7999566063dSJacob Faibussowitsch         PetscCall(MatSetValues_MPIAIJ(mat, 1, row + i, ncols, col + i, val + i, mat->insertmode));
800bc5ccf88SSatish Balay         i = j;
801bc5ccf88SSatish Balay       }
802bc5ccf88SSatish Balay     }
8039566063dSJacob Faibussowitsch     PetscCall(MatStashScatterEnd_Private(&mat->stash));
804bc5ccf88SSatish Balay   }
8058c3ff71bSJunchao Zhang #if defined(PETSC_HAVE_DEVICE)
806c70f7ee4SJunchao Zhang   if (mat->offloadmask == PETSC_OFFLOAD_CPU) aij->A->offloadmask = PETSC_OFFLOAD_CPU;
8079ecce9b1SRichard Tran Mills   /* We call MatBindToCPU() on aij->A and aij->B here, because if MatBindToCPU_MPIAIJ() is called before assembly, it cannot bind these. */
8089ecce9b1SRichard Tran Mills   if (mat->boundtocpu) {
8099566063dSJacob Faibussowitsch     PetscCall(MatBindToCPU(aij->A, PETSC_TRUE));
8109566063dSJacob Faibussowitsch     PetscCall(MatBindToCPU(aij->B, PETSC_TRUE));
8119ecce9b1SRichard Tran Mills   }
812e2cf4d64SStefano Zampini #endif
8139566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(aij->A, mode));
8149566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(aij->A, mode));
815bc5ccf88SSatish Balay 
816bc5ccf88SSatish Balay   /* determine if any processor has disassembled, if so we must
817071fcb05SBarry Smith      also disassemble ourself, in order that we may reassemble. */
818bc5ccf88SSatish Balay   /*
819bc5ccf88SSatish Balay      if nonzero structure of submatrix B cannot change then we know that
820bc5ccf88SSatish Balay      no processor disassembled thus we can skip this stuff
821bc5ccf88SSatish Balay   */
822bc5ccf88SSatish Balay   if (!((Mat_SeqAIJ *)aij->B->data)->nonew) {
823462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&mat->was_assembled, &other_disassembled, 1, MPIU_BOOL, MPI_LAND, PetscObjectComm((PetscObject)mat)));
82435cb6cd3SPierre Jolivet     if (mat->was_assembled && !other_disassembled) { /* mat on this rank has reduced off-diag B with local col ids, but globally it does not */
825eb14dd14SAlex Lindsay       PetscCall(MatDisAssemble_MPIAIJ(mat, PETSC_FALSE));
826ad59fb31SSatish Balay     }
827ad59fb31SSatish Balay   }
82848a46eb9SPierre Jolivet   if (!mat->was_assembled && mode == MAT_FINAL_ASSEMBLY) PetscCall(MatSetUpMultiply_MPIAIJ(mat));
8299566063dSJacob Faibussowitsch   PetscCall(MatSetOption(aij->B, MAT_USE_INODES, PETSC_FALSE));
8308c3ff71bSJunchao Zhang #if defined(PETSC_HAVE_DEVICE)
831c70f7ee4SJunchao Zhang   if (mat->offloadmask == PETSC_OFFLOAD_CPU && aij->B->offloadmask != PETSC_OFFLOAD_UNALLOCATED) aij->B->offloadmask = PETSC_OFFLOAD_CPU;
832e2cf4d64SStefano Zampini #endif
8339566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(aij->B, mode));
8349566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(aij->B, mode));
835bc5ccf88SSatish Balay 
8369566063dSJacob Faibussowitsch   PetscCall(PetscFree2(aij->rowvalues, aij->rowindices));
8372205254eSKarl Rupp 
838f4259b30SLisandro Dalcin   aij->rowvalues = NULL;
839a30b2313SHong Zhang 
8409566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&aij->diag));
841e56f5c9eSBarry Smith 
8424f9cfa9eSBarry Smith   /* if no new nonzero locations are allowed in matrix then only set the matrix state the first time through */
843f4f49eeaSPierre Jolivet   if ((!mat->was_assembled && mode == MAT_FINAL_ASSEMBLY) || !((Mat_SeqAIJ *)aij->A->data)->nonew) {
844e56f5c9eSBarry Smith     PetscObjectState state = aij->A->nonzerostate + aij->B->nonzerostate;
845462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&state, &mat->nonzerostate, 1, MPIU_INT64, MPI_SUM, PetscObjectComm((PetscObject)mat)));
846e56f5c9eSBarry Smith   }
8478c3ff71bSJunchao Zhang #if defined(PETSC_HAVE_DEVICE)
848c70f7ee4SJunchao Zhang   mat->offloadmask = PETSC_OFFLOAD_BOTH;
849e2cf4d64SStefano Zampini #endif
8503ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
851bc5ccf88SSatish Balay }
852bc5ccf88SSatish Balay 
853ba38deedSJacob Faibussowitsch static PetscErrorCode MatZeroEntries_MPIAIJ(Mat A)
854d71ae5a4SJacob Faibussowitsch {
85544a69424SLois Curfman McInnes   Mat_MPIAIJ *l = (Mat_MPIAIJ *)A->data;
8563a40ed3dSBarry Smith 
8573a40ed3dSBarry Smith   PetscFunctionBegin;
8589566063dSJacob Faibussowitsch   PetscCall(MatZeroEntries(l->A));
8599566063dSJacob Faibussowitsch   PetscCall(MatZeroEntries(l->B));
8603ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
8611eb62cbbSBarry Smith }
8621eb62cbbSBarry Smith 
863ba38deedSJacob Faibussowitsch static PetscErrorCode MatZeroRows_MPIAIJ(Mat A, PetscInt N, const PetscInt rows[], PetscScalar diag, Vec x, Vec b)
864d71ae5a4SJacob Faibussowitsch {
8651b1dd7adSMatthew G. Knepley   Mat_MPIAIJ *mat = (Mat_MPIAIJ *)A->data;
8661b1dd7adSMatthew G. Knepley   PetscInt   *lrows;
8676e520ac8SStefano Zampini   PetscInt    r, len;
8689939a2d1SBarry Smith   PetscBool   cong;
8691eb62cbbSBarry Smith 
8703a40ed3dSBarry Smith   PetscFunctionBegin;
8716e520ac8SStefano Zampini   /* get locally owned rows */
8729566063dSJacob Faibussowitsch   PetscCall(MatZeroRowsMapLocal_Private(A, N, rows, &len, &lrows));
8739566063dSJacob Faibussowitsch   PetscCall(MatHasCongruentLayouts(A, &cong));
874dd8e379bSPierre Jolivet   /* fix right-hand side if needed */
87597b48c8fSBarry Smith   if (x && b) {
8761b1dd7adSMatthew G. Knepley     const PetscScalar *xx;
8771b1dd7adSMatthew G. Knepley     PetscScalar       *bb;
8781b1dd7adSMatthew G. Knepley 
87928b400f6SJacob Faibussowitsch     PetscCheck(cong, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "Need matching row/col layout");
8809566063dSJacob Faibussowitsch     PetscCall(VecGetArrayRead(x, &xx));
8819566063dSJacob Faibussowitsch     PetscCall(VecGetArray(b, &bb));
8821b1dd7adSMatthew G. Knepley     for (r = 0; r < len; ++r) bb[lrows[r]] = diag * xx[lrows[r]];
8839566063dSJacob Faibussowitsch     PetscCall(VecRestoreArrayRead(x, &xx));
8849566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(b, &bb));
88597b48c8fSBarry Smith   }
886a92ad425SStefano Zampini 
887a92ad425SStefano Zampini   if (diag != 0.0 && cong) {
8889566063dSJacob Faibussowitsch     PetscCall(MatZeroRows(mat->A, len, lrows, diag, NULL, NULL));
8899566063dSJacob Faibussowitsch     PetscCall(MatZeroRows(mat->B, len, lrows, 0.0, NULL, NULL));
890a92ad425SStefano Zampini   } else if (diag != 0.0) { /* non-square or non congruent layouts -> if keepnonzeropattern is false, we allow for new insertion */
891a92ad425SStefano Zampini     Mat_SeqAIJ *aijA = (Mat_SeqAIJ *)mat->A->data;
892a92ad425SStefano Zampini     Mat_SeqAIJ *aijB = (Mat_SeqAIJ *)mat->B->data;
893a92ad425SStefano Zampini     PetscInt    nnwA, nnwB;
894a92ad425SStefano Zampini     PetscBool   nnzA, nnzB;
895a92ad425SStefano Zampini 
896a92ad425SStefano Zampini     nnwA = aijA->nonew;
897a92ad425SStefano Zampini     nnwB = aijB->nonew;
898a92ad425SStefano Zampini     nnzA = aijA->keepnonzeropattern;
899a92ad425SStefano Zampini     nnzB = aijB->keepnonzeropattern;
900a92ad425SStefano Zampini     if (!nnzA) {
9019566063dSJacob Faibussowitsch       PetscCall(PetscInfo(mat->A, "Requested to not keep the pattern and add a nonzero diagonal; may encounter reallocations on diagonal block.\n"));
902a92ad425SStefano Zampini       aijA->nonew = 0;
903a92ad425SStefano Zampini     }
904a92ad425SStefano Zampini     if (!nnzB) {
9059566063dSJacob Faibussowitsch       PetscCall(PetscInfo(mat->B, "Requested to not keep the pattern and add a nonzero diagonal; may encounter reallocations on off-diagonal block.\n"));
906a92ad425SStefano Zampini       aijB->nonew = 0;
907a92ad425SStefano Zampini     }
908a92ad425SStefano Zampini     /* Must zero here before the next loop */
9099566063dSJacob Faibussowitsch     PetscCall(MatZeroRows(mat->A, len, lrows, 0.0, NULL, NULL));
9109566063dSJacob Faibussowitsch     PetscCall(MatZeroRows(mat->B, len, lrows, 0.0, NULL, NULL));
9111b1dd7adSMatthew G. Knepley     for (r = 0; r < len; ++r) {
9121b1dd7adSMatthew G. Knepley       const PetscInt row = lrows[r] + A->rmap->rstart;
913a92ad425SStefano Zampini       if (row >= A->cmap->N) continue;
9149566063dSJacob Faibussowitsch       PetscCall(MatSetValues(A, 1, &row, 1, &row, &diag, INSERT_VALUES));
915e2d53e46SBarry Smith     }
916a92ad425SStefano Zampini     aijA->nonew = nnwA;
917a92ad425SStefano Zampini     aijB->nonew = nnwB;
9186eb55b6aSBarry Smith   } else {
9199566063dSJacob Faibussowitsch     PetscCall(MatZeroRows(mat->A, len, lrows, 0.0, NULL, NULL));
9209566063dSJacob Faibussowitsch     PetscCall(MatZeroRows(mat->B, len, lrows, 0.0, NULL, NULL));
9216eb55b6aSBarry Smith   }
9229566063dSJacob Faibussowitsch   PetscCall(PetscFree(lrows));
9239566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(A, MAT_FINAL_ASSEMBLY));
9249566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(A, MAT_FINAL_ASSEMBLY));
9254f9cfa9eSBarry Smith 
9269939a2d1SBarry Smith   /* only change matrix nonzero state if pattern was allowed to be changed */
927f4f49eeaSPierre Jolivet   if (!((Mat_SeqAIJ *)mat->A->data)->keepnonzeropattern || !((Mat_SeqAIJ *)mat->A->data)->nonew) {
9289939a2d1SBarry Smith     PetscObjectState state = mat->A->nonzerostate + mat->B->nonzerostate;
929462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&state, &A->nonzerostate, 1, MPIU_INT64, MPI_SUM, PetscObjectComm((PetscObject)A)));
9309939a2d1SBarry Smith   }
9313ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
9321eb62cbbSBarry Smith }
9331eb62cbbSBarry Smith 
934ba38deedSJacob Faibussowitsch static PetscErrorCode MatZeroRowsColumns_MPIAIJ(Mat A, PetscInt N, const PetscInt rows[], PetscScalar diag, Vec x, Vec b)
935d71ae5a4SJacob Faibussowitsch {
9369c7c4993SBarry Smith   Mat_MPIAIJ        *l = (Mat_MPIAIJ *)A->data;
9376497c311SBarry Smith   PetscInt           n = A->rmap->n;
938131c27b5Sprj-   PetscInt           i, j, r, m, len = 0;
93954bd4135SMatthew G. Knepley   PetscInt          *lrows, *owners = A->rmap->range;
940131c27b5Sprj-   PetscMPIInt        p = 0;
94154bd4135SMatthew G. Knepley   PetscSFNode       *rrows;
94254bd4135SMatthew G. Knepley   PetscSF            sf;
9439c7c4993SBarry Smith   const PetscScalar *xx;
944fff043a9SJunchao Zhang   PetscScalar       *bb, *mask, *aij_a;
945564f14d6SBarry Smith   Vec                xmask, lmask;
946564f14d6SBarry Smith   Mat_SeqAIJ        *aij = (Mat_SeqAIJ *)l->B->data;
947564f14d6SBarry Smith   const PetscInt    *aj, *ii, *ridx;
948564f14d6SBarry Smith   PetscScalar       *aa;
9499c7c4993SBarry Smith 
9509c7c4993SBarry Smith   PetscFunctionBegin;
95154bd4135SMatthew G. Knepley   /* Create SF where leaves are input rows and roots are owned rows */
9529566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(n, &lrows));
95354bd4135SMatthew G. Knepley   for (r = 0; r < n; ++r) lrows[r] = -1;
9549566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(N, &rrows));
95554bd4135SMatthew G. Knepley   for (r = 0; r < N; ++r) {
95654bd4135SMatthew G. Knepley     const PetscInt idx = rows[r];
957aed4548fSBarry Smith     PetscCheck(idx >= 0 && A->rmap->N > idx, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Row %" PetscInt_FMT " out of range [0,%" PetscInt_FMT ")", idx, A->rmap->N);
9585ba17502SJed Brown     if (idx < owners[p] || owners[p + 1] <= idx) { /* short-circuit the search if the last p owns this row too */
9599566063dSJacob Faibussowitsch       PetscCall(PetscLayoutFindOwner(A->rmap, idx, &p));
9605ba17502SJed Brown     }
96154bd4135SMatthew G. Knepley     rrows[r].rank  = p;
96254bd4135SMatthew G. Knepley     rrows[r].index = rows[r] - owners[p];
9639c7c4993SBarry Smith   }
9649566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)A), &sf));
9659566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraph(sf, n, N, NULL, PETSC_OWN_POINTER, rrows, PETSC_OWN_POINTER));
96654bd4135SMatthew G. Knepley   /* Collect flags for rows to be zeroed */
9679566063dSJacob Faibussowitsch   PetscCall(PetscSFReduceBegin(sf, MPIU_INT, (PetscInt *)rows, lrows, MPI_LOR));
9689566063dSJacob Faibussowitsch   PetscCall(PetscSFReduceEnd(sf, MPIU_INT, (PetscInt *)rows, lrows, MPI_LOR));
9699566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sf));
97054bd4135SMatthew G. Knepley   /* Compress and put in row numbers */
9719371c9d4SSatish Balay   for (r = 0; r < n; ++r)
9729371c9d4SSatish Balay     if (lrows[r] >= 0) lrows[len++] = r;
973564f14d6SBarry Smith   /* zero diagonal part of matrix */
9749566063dSJacob Faibussowitsch   PetscCall(MatZeroRowsColumns(l->A, len, lrows, diag, x, b));
9754cf0e950SBarry Smith   /* handle off-diagonal part of matrix */
9769566063dSJacob Faibussowitsch   PetscCall(MatCreateVecs(A, &xmask, NULL));
9779566063dSJacob Faibussowitsch   PetscCall(VecDuplicate(l->lvec, &lmask));
9789566063dSJacob Faibussowitsch   PetscCall(VecGetArray(xmask, &bb));
97954bd4135SMatthew G. Knepley   for (i = 0; i < len; i++) bb[lrows[i]] = 1;
9809566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(xmask, &bb));
9819566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(l->Mvctx, xmask, lmask, ADD_VALUES, SCATTER_FORWARD));
9829566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(l->Mvctx, xmask, lmask, ADD_VALUES, SCATTER_FORWARD));
9839566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&xmask));
984a92ad425SStefano Zampini   if (x && b) { /* this code is buggy when the row and column layout don't match */
985a92ad425SStefano Zampini     PetscBool cong;
986a92ad425SStefano Zampini 
9879566063dSJacob Faibussowitsch     PetscCall(MatHasCongruentLayouts(A, &cong));
98828b400f6SJacob Faibussowitsch     PetscCheck(cong, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "Need matching row/col layout");
9899566063dSJacob Faibussowitsch     PetscCall(VecScatterBegin(l->Mvctx, x, l->lvec, INSERT_VALUES, SCATTER_FORWARD));
9909566063dSJacob Faibussowitsch     PetscCall(VecScatterEnd(l->Mvctx, x, l->lvec, INSERT_VALUES, SCATTER_FORWARD));
9919566063dSJacob Faibussowitsch     PetscCall(VecGetArrayRead(l->lvec, &xx));
9929566063dSJacob Faibussowitsch     PetscCall(VecGetArray(b, &bb));
993377aa5a1SBarry Smith   }
9949566063dSJacob Faibussowitsch   PetscCall(VecGetArray(lmask, &mask));
9954cf0e950SBarry Smith   /* remove zeroed rows of off-diagonal matrix */
9969566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(l->B, &aij_a));
997564f14d6SBarry Smith   ii = aij->i;
9988e3a54c0SPierre Jolivet   for (i = 0; i < len; i++) PetscCall(PetscArrayzero(PetscSafePointerPlusOffset(aij_a, ii[lrows[i]]), ii[lrows[i] + 1] - ii[lrows[i]]));
999564f14d6SBarry Smith   /* loop over all elements of off process part of matrix zeroing removed columns*/
1000564f14d6SBarry Smith   if (aij->compressedrow.use) {
1001564f14d6SBarry Smith     m    = aij->compressedrow.nrows;
1002564f14d6SBarry Smith     ii   = aij->compressedrow.i;
1003564f14d6SBarry Smith     ridx = aij->compressedrow.rindex;
1004564f14d6SBarry Smith     for (i = 0; i < m; i++) {
1005564f14d6SBarry Smith       n  = ii[i + 1] - ii[i];
1006564f14d6SBarry Smith       aj = aij->j + ii[i];
1007fff043a9SJunchao Zhang       aa = aij_a + ii[i];
1008564f14d6SBarry Smith 
1009564f14d6SBarry Smith       for (j = 0; j < n; j++) {
101025266a92SSatish Balay         if (PetscAbsScalar(mask[*aj])) {
1011377aa5a1SBarry Smith           if (b) bb[*ridx] -= *aa * xx[*aj];
1012564f14d6SBarry Smith           *aa = 0.0;
1013564f14d6SBarry Smith         }
1014564f14d6SBarry Smith         aa++;
1015564f14d6SBarry Smith         aj++;
1016564f14d6SBarry Smith       }
1017564f14d6SBarry Smith       ridx++;
1018564f14d6SBarry Smith     }
1019564f14d6SBarry Smith   } else { /* do not use compressed row format */
1020564f14d6SBarry Smith     m = l->B->rmap->n;
1021564f14d6SBarry Smith     for (i = 0; i < m; i++) {
1022564f14d6SBarry Smith       n  = ii[i + 1] - ii[i];
1023564f14d6SBarry Smith       aj = aij->j + ii[i];
1024fff043a9SJunchao Zhang       aa = aij_a + ii[i];
1025564f14d6SBarry Smith       for (j = 0; j < n; j++) {
102625266a92SSatish Balay         if (PetscAbsScalar(mask[*aj])) {
1027377aa5a1SBarry Smith           if (b) bb[i] -= *aa * xx[*aj];
1028564f14d6SBarry Smith           *aa = 0.0;
1029564f14d6SBarry Smith         }
1030564f14d6SBarry Smith         aa++;
1031564f14d6SBarry Smith         aj++;
1032564f14d6SBarry Smith       }
1033564f14d6SBarry Smith     }
1034564f14d6SBarry Smith   }
1035a92ad425SStefano Zampini   if (x && b) {
10369566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(b, &bb));
10379566063dSJacob Faibussowitsch     PetscCall(VecRestoreArrayRead(l->lvec, &xx));
1038377aa5a1SBarry Smith   }
10399566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArray(l->B, &aij_a));
10409566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(lmask, &mask));
10419566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&lmask));
10429566063dSJacob Faibussowitsch   PetscCall(PetscFree(lrows));
10434f9cfa9eSBarry Smith 
10444f9cfa9eSBarry Smith   /* only change matrix nonzero state if pattern was allowed to be changed */
1045f4f49eeaSPierre Jolivet   if (!((Mat_SeqAIJ *)l->A->data)->nonew) {
10464f9cfa9eSBarry Smith     PetscObjectState state = l->A->nonzerostate + l->B->nonzerostate;
1047462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&state, &A->nonzerostate, 1, MPIU_INT64, MPI_SUM, PetscObjectComm((PetscObject)A)));
10484f9cfa9eSBarry Smith   }
10493ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
10509c7c4993SBarry Smith }
10519c7c4993SBarry Smith 
1052ba38deedSJacob Faibussowitsch static PetscErrorCode MatMult_MPIAIJ(Mat A, Vec xx, Vec yy)
1053d71ae5a4SJacob Faibussowitsch {
1054416022c9SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
1055b1d57f15SBarry Smith   PetscInt    nt;
105619b3b6edSHong Zhang   VecScatter  Mvctx = a->Mvctx;
1057416022c9SBarry Smith 
10583a40ed3dSBarry Smith   PetscFunctionBegin;
10599566063dSJacob Faibussowitsch   PetscCall(VecGetLocalSize(xx, &nt));
106008401ef6SPierre Jolivet   PetscCheck(nt == A->cmap->n, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Incompatible partition of A (%" PetscInt_FMT ") and xx (%" PetscInt_FMT ")", A->cmap->n, nt);
10619566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(Mvctx, xx, a->lvec, INSERT_VALUES, SCATTER_FORWARD));
1062296d8154SBarry Smith   PetscUseTypeMethod(a->A, mult, xx, yy);
10639566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(Mvctx, xx, a->lvec, INSERT_VALUES, SCATTER_FORWARD));
1064296d8154SBarry Smith   PetscUseTypeMethod(a->B, multadd, a->lvec, yy, yy);
10653ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
10661eb62cbbSBarry Smith }
10671eb62cbbSBarry Smith 
1068ba38deedSJacob Faibussowitsch static PetscErrorCode MatMultDiagonalBlock_MPIAIJ(Mat A, Vec bb, Vec xx)
1069d71ae5a4SJacob Faibussowitsch {
1070bd0c2dcbSBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
1071bd0c2dcbSBarry Smith 
1072bd0c2dcbSBarry Smith   PetscFunctionBegin;
10739566063dSJacob Faibussowitsch   PetscCall(MatMultDiagonalBlock(a->A, bb, xx));
10743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1075bd0c2dcbSBarry Smith }
1076bd0c2dcbSBarry Smith 
1077ba38deedSJacob Faibussowitsch static PetscErrorCode MatMultAdd_MPIAIJ(Mat A, Vec xx, Vec yy, Vec zz)
1078d71ae5a4SJacob Faibussowitsch {
1079416022c9SBarry Smith   Mat_MPIAIJ *a     = (Mat_MPIAIJ *)A->data;
108001ad2aeeSHong Zhang   VecScatter  Mvctx = a->Mvctx;
10813a40ed3dSBarry Smith 
10823a40ed3dSBarry Smith   PetscFunctionBegin;
10839566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(Mvctx, xx, a->lvec, INSERT_VALUES, SCATTER_FORWARD));
10849566063dSJacob Faibussowitsch   PetscCall((*a->A->ops->multadd)(a->A, xx, yy, zz));
10859566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(Mvctx, xx, a->lvec, INSERT_VALUES, SCATTER_FORWARD));
10869566063dSJacob Faibussowitsch   PetscCall((*a->B->ops->multadd)(a->B, a->lvec, zz, zz));
10873ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1088da3a660dSBarry Smith }
1089da3a660dSBarry Smith 
1090ba38deedSJacob Faibussowitsch static PetscErrorCode MatMultTranspose_MPIAIJ(Mat A, Vec xx, Vec yy)
1091d71ae5a4SJacob Faibussowitsch {
1092416022c9SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
1093da3a660dSBarry Smith 
10943a40ed3dSBarry Smith   PetscFunctionBegin;
1095da3a660dSBarry Smith   /* do nondiagonal part */
10969566063dSJacob Faibussowitsch   PetscCall((*a->B->ops->multtranspose)(a->B, xx, a->lvec));
1097da3a660dSBarry Smith   /* do local part */
10989566063dSJacob Faibussowitsch   PetscCall((*a->A->ops->multtranspose)(a->A, xx, yy));
10999613dc34SJunchao Zhang   /* add partial results together */
11009566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(a->Mvctx, a->lvec, yy, ADD_VALUES, SCATTER_REVERSE));
11019566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(a->Mvctx, a->lvec, yy, ADD_VALUES, SCATTER_REVERSE));
11023ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1103da3a660dSBarry Smith }
1104da3a660dSBarry Smith 
1105ba38deedSJacob Faibussowitsch static PetscErrorCode MatIsTranspose_MPIAIJ(Mat Amat, Mat Bmat, PetscReal tol, PetscBool *f)
1106d71ae5a4SJacob Faibussowitsch {
11074f423910Svictorle   MPI_Comm    comm;
1108ad79cf63SBarry Smith   Mat_MPIAIJ *Aij = (Mat_MPIAIJ *)Amat->data, *Bij = (Mat_MPIAIJ *)Bmat->data;
1109ad79cf63SBarry Smith   Mat         Adia = Aij->A, Bdia = Bij->A, Aoff, Boff, *Aoffs, *Boffs;
1110cd0d46ebSvictorle   IS          Me, Notme;
1111b1d57f15SBarry Smith   PetscInt    M, N, first, last, *notme, i;
111254d735aeSStefano Zampini   PetscBool   lf;
1113b1d57f15SBarry Smith   PetscMPIInt size;
1114cd0d46ebSvictorle 
1115cd0d46ebSvictorle   PetscFunctionBegin;
111642e5f5b4Svictorle   /* Easy test: symmetric diagonal block */
11179566063dSJacob Faibussowitsch   PetscCall(MatIsTranspose(Adia, Bdia, tol, &lf));
1118462c564dSBarry Smith   PetscCallMPI(MPIU_Allreduce(&lf, f, 1, MPIU_BOOL, MPI_LAND, PetscObjectComm((PetscObject)Amat)));
11193ba16761SJacob Faibussowitsch   if (!*f) PetscFunctionReturn(PETSC_SUCCESS);
11209566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)Amat, &comm));
11219566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
11223ba16761SJacob Faibussowitsch   if (size == 1) PetscFunctionReturn(PETSC_SUCCESS);
112342e5f5b4Svictorle 
11247dae84e0SHong Zhang   /* Hard test: off-diagonal block. This takes a MatCreateSubMatrix. */
11259566063dSJacob Faibussowitsch   PetscCall(MatGetSize(Amat, &M, &N));
11269566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(Amat, &first, &last));
11279566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(N - last + first, &notme));
1128cd0d46ebSvictorle   for (i = 0; i < first; i++) notme[i] = i;
1129cd0d46ebSvictorle   for (i = last; i < M; i++) notme[i - last + first] = i;
11309566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(MPI_COMM_SELF, N - last + first, notme, PETSC_COPY_VALUES, &Notme));
11319566063dSJacob Faibussowitsch   PetscCall(ISCreateStride(MPI_COMM_SELF, last - first, first, 1, &Me));
11329566063dSJacob Faibussowitsch   PetscCall(MatCreateSubMatrices(Amat, 1, &Me, &Notme, MAT_INITIAL_MATRIX, &Aoffs));
113366501d38Svictorle   Aoff = Aoffs[0];
11349566063dSJacob Faibussowitsch   PetscCall(MatCreateSubMatrices(Bmat, 1, &Notme, &Me, MAT_INITIAL_MATRIX, &Boffs));
113566501d38Svictorle   Boff = Boffs[0];
11369566063dSJacob Faibussowitsch   PetscCall(MatIsTranspose(Aoff, Boff, tol, f));
11379566063dSJacob Faibussowitsch   PetscCall(MatDestroyMatrices(1, &Aoffs));
11389566063dSJacob Faibussowitsch   PetscCall(MatDestroyMatrices(1, &Boffs));
11399566063dSJacob Faibussowitsch   PetscCall(ISDestroy(&Me));
11409566063dSJacob Faibussowitsch   PetscCall(ISDestroy(&Notme));
11419566063dSJacob Faibussowitsch   PetscCall(PetscFree(notme));
11423ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1143cd0d46ebSvictorle }
1144cd0d46ebSvictorle 
1145ba38deedSJacob Faibussowitsch static PetscErrorCode MatMultTransposeAdd_MPIAIJ(Mat A, Vec xx, Vec yy, Vec zz)
1146d71ae5a4SJacob Faibussowitsch {
1147416022c9SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
1148da3a660dSBarry Smith 
11493a40ed3dSBarry Smith   PetscFunctionBegin;
1150da3a660dSBarry Smith   /* do nondiagonal part */
11519566063dSJacob Faibussowitsch   PetscCall((*a->B->ops->multtranspose)(a->B, xx, a->lvec));
1152da3a660dSBarry Smith   /* do local part */
11539566063dSJacob Faibussowitsch   PetscCall((*a->A->ops->multtransposeadd)(a->A, xx, yy, zz));
11549613dc34SJunchao Zhang   /* add partial results together */
11559566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(a->Mvctx, a->lvec, zz, ADD_VALUES, SCATTER_REVERSE));
11569566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(a->Mvctx, a->lvec, zz, ADD_VALUES, SCATTER_REVERSE));
11573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1158da3a660dSBarry Smith }
1159da3a660dSBarry Smith 
11601eb62cbbSBarry Smith /*
11611eb62cbbSBarry Smith   This only works correctly for square matrices where the subblock A->A is the
11621eb62cbbSBarry Smith    diagonal block
11631eb62cbbSBarry Smith */
1164ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetDiagonal_MPIAIJ(Mat A, Vec v)
1165d71ae5a4SJacob Faibussowitsch {
1166416022c9SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
11673a40ed3dSBarry Smith 
11683a40ed3dSBarry Smith   PetscFunctionBegin;
116908401ef6SPierre Jolivet   PetscCheck(A->rmap->N == A->cmap->N, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "Supports only square matrix where A->A is diag block");
1170aed4548fSBarry Smith   PetscCheck(A->rmap->rstart == A->cmap->rstart && A->rmap->rend == A->cmap->rend, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "row partition must equal col partition");
11719566063dSJacob Faibussowitsch   PetscCall(MatGetDiagonal(a->A, v));
11723ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
11731eb62cbbSBarry Smith }
11741eb62cbbSBarry Smith 
1175ba38deedSJacob Faibussowitsch static PetscErrorCode MatScale_MPIAIJ(Mat A, PetscScalar aa)
1176d71ae5a4SJacob Faibussowitsch {
1177052efed2SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
11783a40ed3dSBarry Smith 
11793a40ed3dSBarry Smith   PetscFunctionBegin;
11809566063dSJacob Faibussowitsch   PetscCall(MatScale(a->A, aa));
11819566063dSJacob Faibussowitsch   PetscCall(MatScale(a->B, aa));
11823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1183052efed2SBarry Smith }
1184052efed2SBarry Smith 
1185ba38deedSJacob Faibussowitsch static PetscErrorCode MatView_MPIAIJ_Binary(Mat mat, PetscViewer viewer)
1186d71ae5a4SJacob Faibussowitsch {
11878e2fed03SBarry Smith   Mat_MPIAIJ        *aij    = (Mat_MPIAIJ *)mat->data;
11888e2fed03SBarry Smith   Mat_SeqAIJ        *A      = (Mat_SeqAIJ *)aij->A->data;
11898e2fed03SBarry Smith   Mat_SeqAIJ        *B      = (Mat_SeqAIJ *)aij->B->data;
11903ea6fe3dSLisandro Dalcin   const PetscInt    *garray = aij->garray;
11912e5835c6SStefano Zampini   const PetscScalar *aa, *ba;
119217a3732bSBarry Smith   PetscInt           header[4], M, N, m, rs, cs, cnt, i, ja, jb;
119317a3732bSBarry Smith   PetscInt64         nz, hnz;
11943ea6fe3dSLisandro Dalcin   PetscInt          *rowlens;
11953ea6fe3dSLisandro Dalcin   PetscInt          *colidxs;
11963ea6fe3dSLisandro Dalcin   PetscScalar       *matvals;
119717a3732bSBarry Smith   PetscMPIInt        rank;
11988e2fed03SBarry Smith 
11998e2fed03SBarry Smith   PetscFunctionBegin;
12009566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetUp(viewer));
12013ea6fe3dSLisandro Dalcin 
12023ea6fe3dSLisandro Dalcin   M  = mat->rmap->N;
12033ea6fe3dSLisandro Dalcin   N  = mat->cmap->N;
12043ea6fe3dSLisandro Dalcin   m  = mat->rmap->n;
12053ea6fe3dSLisandro Dalcin   rs = mat->rmap->rstart;
12063ea6fe3dSLisandro Dalcin   cs = mat->cmap->rstart;
12078e2fed03SBarry Smith   nz = A->nz + B->nz;
12083ea6fe3dSLisandro Dalcin 
12093ea6fe3dSLisandro Dalcin   /* write matrix header */
12100700a824SBarry Smith   header[0] = MAT_FILE_CLASSID;
12119371c9d4SSatish Balay   header[1] = M;
12129371c9d4SSatish Balay   header[2] = N;
121317a3732bSBarry Smith   PetscCallMPI(MPI_Reduce(&nz, &hnz, 1, MPIU_INT64, MPI_SUM, 0, PetscObjectComm((PetscObject)mat)));
121417a3732bSBarry Smith   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)mat), &rank));
1215835f2295SStefano Zampini   if (rank == 0) PetscCall(PetscIntCast(hnz, &header[3]));
12169566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryWrite(viewer, header, 4, PETSC_INT));
12178e2fed03SBarry Smith 
12183ea6fe3dSLisandro Dalcin   /* fill in and store row lengths  */
12199566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m, &rowlens));
12203ea6fe3dSLisandro Dalcin   for (i = 0; i < m; i++) rowlens[i] = A->i[i + 1] - A->i[i] + B->i[i + 1] - B->i[i];
12219566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryWriteAll(viewer, rowlens, m, rs, M, PETSC_INT));
12229566063dSJacob Faibussowitsch   PetscCall(PetscFree(rowlens));
12238e2fed03SBarry Smith 
12243ea6fe3dSLisandro Dalcin   /* fill in and store column indices */
12259566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(nz, &colidxs));
12263ea6fe3dSLisandro Dalcin   for (cnt = 0, i = 0; i < m; i++) {
12273ea6fe3dSLisandro Dalcin     for (jb = B->i[i]; jb < B->i[i + 1]; jb++) {
12283ea6fe3dSLisandro Dalcin       if (garray[B->j[jb]] > cs) break;
12293ea6fe3dSLisandro Dalcin       colidxs[cnt++] = garray[B->j[jb]];
12308e2fed03SBarry Smith     }
12319371c9d4SSatish Balay     for (ja = A->i[i]; ja < A->i[i + 1]; ja++) colidxs[cnt++] = A->j[ja] + cs;
12329371c9d4SSatish Balay     for (; jb < B->i[i + 1]; jb++) colidxs[cnt++] = garray[B->j[jb]];
12338e2fed03SBarry Smith   }
123417a3732bSBarry Smith   PetscCheck(cnt == nz, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Internal PETSc error: cnt = %" PetscInt_FMT " nz = %" PetscInt64_FMT, cnt, nz);
12359566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryWriteAll(viewer, colidxs, nz, PETSC_DETERMINE, PETSC_DETERMINE, PETSC_INT));
12369566063dSJacob Faibussowitsch   PetscCall(PetscFree(colidxs));
12378e2fed03SBarry Smith 
12383ea6fe3dSLisandro Dalcin   /* fill in and store nonzero values */
12399566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(aij->A, &aa));
12409566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(aij->B, &ba));
12419566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(nz, &matvals));
12423ea6fe3dSLisandro Dalcin   for (cnt = 0, i = 0; i < m; i++) {
12433ea6fe3dSLisandro Dalcin     for (jb = B->i[i]; jb < B->i[i + 1]; jb++) {
12443ea6fe3dSLisandro Dalcin       if (garray[B->j[jb]] > cs) break;
12452e5835c6SStefano Zampini       matvals[cnt++] = ba[jb];
12468e2fed03SBarry Smith     }
12479371c9d4SSatish Balay     for (ja = A->i[i]; ja < A->i[i + 1]; ja++) matvals[cnt++] = aa[ja];
12489371c9d4SSatish Balay     for (; jb < B->i[i + 1]; jb++) matvals[cnt++] = ba[jb];
12498e2fed03SBarry Smith   }
12509566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(aij->A, &aa));
12519566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(aij->B, &ba));
125217a3732bSBarry Smith   PetscCheck(cnt == nz, PETSC_COMM_SELF, PETSC_ERR_LIB, "Internal PETSc error: cnt = %" PetscInt_FMT " nz = %" PetscInt64_FMT, cnt, nz);
12539566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryWriteAll(viewer, matvals, nz, PETSC_DETERMINE, PETSC_DETERMINE, PETSC_SCALAR));
12549566063dSJacob Faibussowitsch   PetscCall(PetscFree(matvals));
12558e2fed03SBarry Smith 
12563ea6fe3dSLisandro Dalcin   /* write block size option to the viewer's .info file */
12579566063dSJacob Faibussowitsch   PetscCall(MatView_Binary_BlockSizes(mat, viewer));
12583ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
12598e2fed03SBarry Smith }
12608e2fed03SBarry Smith 
12619804daf3SBarry Smith #include <petscdraw.h>
1262ba38deedSJacob Faibussowitsch static PetscErrorCode MatView_MPIAIJ_ASCIIorDraworSocket(Mat mat, PetscViewer viewer)
1263d71ae5a4SJacob Faibussowitsch {
126444a69424SLois Curfman McInnes   Mat_MPIAIJ       *aij  = (Mat_MPIAIJ *)mat->data;
126532dcc486SBarry Smith   PetscMPIInt       rank = aij->rank, size = aij->size;
1266ace3abfcSBarry Smith   PetscBool         isdraw, iascii, isbinary;
1267b0a32e0cSBarry Smith   PetscViewer       sviewer;
1268f3ef73ceSBarry Smith   PetscViewerFormat format;
1269416022c9SBarry Smith 
12703a40ed3dSBarry Smith   PetscFunctionBegin;
12719566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERDRAW, &isdraw));
12729566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERASCII, &iascii));
12739566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERBINARY, &isbinary));
127432077d6dSBarry Smith   if (iascii) {
12759566063dSJacob Faibussowitsch     PetscCall(PetscViewerGetFormat(viewer, &format));
1276ef5fdb51SBarry Smith     if (format == PETSC_VIEWER_LOAD_BALANCE) {
12771690c2aeSBarry Smith       PetscInt i, nmax = 0, nmin = PETSC_INT_MAX, navg = 0, *nz, nzlocal = ((Mat_SeqAIJ *)aij->A->data)->nz + ((Mat_SeqAIJ *)aij->B->data)->nz;
12789566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(size, &nz));
12799566063dSJacob Faibussowitsch       PetscCallMPI(MPI_Allgather(&nzlocal, 1, MPIU_INT, nz, 1, MPIU_INT, PetscObjectComm((PetscObject)mat)));
1280835f2295SStefano Zampini       for (i = 0; i < size; i++) {
1281ef5fdb51SBarry Smith         nmax = PetscMax(nmax, nz[i]);
1282ef5fdb51SBarry Smith         nmin = PetscMin(nmin, nz[i]);
1283ef5fdb51SBarry Smith         navg += nz[i];
1284ef5fdb51SBarry Smith       }
12859566063dSJacob Faibussowitsch       PetscCall(PetscFree(nz));
1286ef5fdb51SBarry Smith       navg = navg / size;
12879566063dSJacob Faibussowitsch       PetscCall(PetscViewerASCIIPrintf(viewer, "Load Balance - Nonzeros: Min %" PetscInt_FMT "  avg %" PetscInt_FMT "  max %" PetscInt_FMT "\n", nmin, navg, nmax));
12883ba16761SJacob Faibussowitsch       PetscFunctionReturn(PETSC_SUCCESS);
1289ef5fdb51SBarry Smith     }
12909566063dSJacob Faibussowitsch     PetscCall(PetscViewerGetFormat(viewer, &format));
1291456192e2SBarry Smith     if (format == PETSC_VIEWER_ASCII_INFO_DETAIL) {
12924e220ebcSLois Curfman McInnes       MatInfo   info;
12936335e310SSatish Balay       PetscInt *inodes = NULL;
1294923f20ffSKris Buschelman 
12959566063dSJacob Faibussowitsch       PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)mat), &rank));
12969566063dSJacob Faibussowitsch       PetscCall(MatGetInfo(mat, MAT_LOCAL, &info));
12979566063dSJacob Faibussowitsch       PetscCall(MatInodeGetInodeSizes(aij->A, NULL, &inodes, NULL));
12989566063dSJacob Faibussowitsch       PetscCall(PetscViewerASCIIPushSynchronized(viewer));
1299923f20ffSKris Buschelman       if (!inodes) {
13009371c9d4SSatish Balay         PetscCall(PetscViewerASCIISynchronizedPrintf(viewer, "[%d] Local rows %" PetscInt_FMT " nz %" PetscInt_FMT " nz alloced %" PetscInt_FMT " mem %g, not using I-node routines\n", rank, mat->rmap->n, (PetscInt)info.nz_used, (PetscInt)info.nz_allocated,
1301835f2295SStefano Zampini                                                      info.memory));
13026831982aSBarry Smith       } else {
1303835f2295SStefano Zampini         PetscCall(
1304835f2295SStefano Zampini           PetscViewerASCIISynchronizedPrintf(viewer, "[%d] Local rows %" PetscInt_FMT " nz %" PetscInt_FMT " nz alloced %" PetscInt_FMT " mem %g, using I-node routines\n", rank, mat->rmap->n, (PetscInt)info.nz_used, (PetscInt)info.nz_allocated, info.memory));
13056831982aSBarry Smith       }
13069566063dSJacob Faibussowitsch       PetscCall(MatGetInfo(aij->A, MAT_LOCAL, &info));
13079566063dSJacob Faibussowitsch       PetscCall(PetscViewerASCIISynchronizedPrintf(viewer, "[%d] on-diagonal part: nz %" PetscInt_FMT " \n", rank, (PetscInt)info.nz_used));
13089566063dSJacob Faibussowitsch       PetscCall(MatGetInfo(aij->B, MAT_LOCAL, &info));
13099566063dSJacob Faibussowitsch       PetscCall(PetscViewerASCIISynchronizedPrintf(viewer, "[%d] off-diagonal part: nz %" PetscInt_FMT " \n", rank, (PetscInt)info.nz_used));
13109566063dSJacob Faibussowitsch       PetscCall(PetscViewerFlush(viewer));
13119566063dSJacob Faibussowitsch       PetscCall(PetscViewerASCIIPopSynchronized(viewer));
13129566063dSJacob Faibussowitsch       PetscCall(PetscViewerASCIIPrintf(viewer, "Information on VecScatter used in matrix-vector product: \n"));
13139566063dSJacob Faibussowitsch       PetscCall(VecScatterView(aij->Mvctx, viewer));
13143ba16761SJacob Faibussowitsch       PetscFunctionReturn(PETSC_SUCCESS);
1315fb9695e5SSatish Balay     } else if (format == PETSC_VIEWER_ASCII_INFO) {
1316923f20ffSKris Buschelman       PetscInt inodecount, inodelimit, *inodes;
13179566063dSJacob Faibussowitsch       PetscCall(MatInodeGetInodeSizes(aij->A, &inodecount, &inodes, &inodelimit));
1318923f20ffSKris Buschelman       if (inodes) {
13199566063dSJacob Faibussowitsch         PetscCall(PetscViewerASCIIPrintf(viewer, "using I-node (on process 0) routines: found %" PetscInt_FMT " nodes, limit used is %" PetscInt_FMT "\n", inodecount, inodelimit));
1320d38fa0fbSBarry Smith       } else {
13219566063dSJacob Faibussowitsch         PetscCall(PetscViewerASCIIPrintf(viewer, "not using I-node (on process 0) routines\n"));
1322d38fa0fbSBarry Smith       }
13233ba16761SJacob Faibussowitsch       PetscFunctionReturn(PETSC_SUCCESS);
13244aedb280SBarry Smith     } else if (format == PETSC_VIEWER_ASCII_FACTOR_INFO) {
13253ba16761SJacob Faibussowitsch       PetscFunctionReturn(PETSC_SUCCESS);
132608480c60SBarry Smith     }
13278e2fed03SBarry Smith   } else if (isbinary) {
13288e2fed03SBarry Smith     if (size == 1) {
13299566063dSJacob Faibussowitsch       PetscCall(PetscObjectSetName((PetscObject)aij->A, ((PetscObject)mat)->name));
13309566063dSJacob Faibussowitsch       PetscCall(MatView(aij->A, viewer));
13318e2fed03SBarry Smith     } else {
13329566063dSJacob Faibussowitsch       PetscCall(MatView_MPIAIJ_Binary(mat, viewer));
13338e2fed03SBarry Smith     }
13343ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
133571e56450SStefano Zampini   } else if (iascii && size == 1) {
13369566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)aij->A, ((PetscObject)mat)->name));
13379566063dSJacob Faibussowitsch     PetscCall(MatView(aij->A, viewer));
13383ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
13390f5bd95cSBarry Smith   } else if (isdraw) {
1340b0a32e0cSBarry Smith     PetscDraw draw;
1341ace3abfcSBarry Smith     PetscBool isnull;
13429566063dSJacob Faibussowitsch     PetscCall(PetscViewerDrawGetDraw(viewer, 0, &draw));
13439566063dSJacob Faibussowitsch     PetscCall(PetscDrawIsNull(draw, &isnull));
13443ba16761SJacob Faibussowitsch     if (isnull) PetscFunctionReturn(PETSC_SUCCESS);
134519bcc07fSBarry Smith   }
134619bcc07fSBarry Smith 
134771e56450SStefano Zampini   { /* assemble the entire matrix onto first processor */
134871e56450SStefano Zampini     Mat A = NULL, Av;
134971e56450SStefano Zampini     IS  isrow, iscol;
13502ee70a88SLois Curfman McInnes 
13519566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PetscObjectComm((PetscObject)mat), rank == 0 ? mat->rmap->N : 0, 0, 1, &isrow));
13529566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PetscObjectComm((PetscObject)mat), rank == 0 ? mat->cmap->N : 0, 0, 1, &iscol));
13539566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrix(mat, isrow, iscol, MAT_INITIAL_MATRIX, &A));
13549566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJGetSeqAIJ(A, &Av, NULL, NULL));
135571e56450SStefano Zampini     /*  The commented code uses MatCreateSubMatrices instead */
135671e56450SStefano Zampini     /*
135771e56450SStefano Zampini     Mat *AA, A = NULL, Av;
135871e56450SStefano Zampini     IS  isrow,iscol;
135971e56450SStefano Zampini 
13609566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PetscObjectComm((PetscObject)mat),rank == 0 ? mat->rmap->N : 0,0,1,&isrow));
13619566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PetscObjectComm((PetscObject)mat),rank == 0 ? mat->cmap->N : 0,0,1,&iscol));
13629566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrices(mat,1,&isrow,&iscol,MAT_INITIAL_MATRIX,&AA));
1363dd400576SPatrick Sanan     if (rank == 0) {
13649566063dSJacob Faibussowitsch        PetscCall(PetscObjectReference((PetscObject)AA[0]));
136571e56450SStefano Zampini        A    = AA[0];
136671e56450SStefano Zampini        Av   = AA[0];
136795373324SBarry Smith     }
13689566063dSJacob Faibussowitsch     PetscCall(MatDestroySubMatrices(1,&AA));
136971e56450SStefano Zampini */
13709566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscol));
13719566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&isrow));
137255843e3eSBarry Smith     /*
137355843e3eSBarry Smith        Everyone has to call to draw the matrix since the graphics waits are
1374b0a32e0cSBarry Smith        synchronized across all processors that share the PetscDraw object
137555843e3eSBarry Smith     */
13769566063dSJacob Faibussowitsch     PetscCall(PetscViewerGetSubViewer(viewer, PETSC_COMM_SELF, &sviewer));
1377dd400576SPatrick Sanan     if (rank == 0) {
137848a46eb9SPierre Jolivet       if (((PetscObject)mat)->name) PetscCall(PetscObjectSetName((PetscObject)Av, ((PetscObject)mat)->name));
13799566063dSJacob Faibussowitsch       PetscCall(MatView_SeqAIJ(Av, sviewer));
138095373324SBarry Smith     }
13819566063dSJacob Faibussowitsch     PetscCall(PetscViewerRestoreSubViewer(viewer, PETSC_COMM_SELF, &sviewer));
13829566063dSJacob Faibussowitsch     PetscCall(MatDestroy(&A));
138395373324SBarry Smith   }
13843ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
13851eb62cbbSBarry Smith }
13861eb62cbbSBarry Smith 
1387d71ae5a4SJacob Faibussowitsch PetscErrorCode MatView_MPIAIJ(Mat mat, PetscViewer viewer)
1388d71ae5a4SJacob Faibussowitsch {
1389ace3abfcSBarry Smith   PetscBool iascii, isdraw, issocket, isbinary;
1390416022c9SBarry Smith 
13913a40ed3dSBarry Smith   PetscFunctionBegin;
13929566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERASCII, &iascii));
13939566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERDRAW, &isdraw));
13949566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERBINARY, &isbinary));
13959566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERSOCKET, &issocket));
139648a46eb9SPierre Jolivet   if (iascii || isdraw || isbinary || issocket) PetscCall(MatView_MPIAIJ_ASCIIorDraworSocket(mat, viewer));
13973ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1398416022c9SBarry Smith }
1399416022c9SBarry Smith 
1400ba38deedSJacob Faibussowitsch static PetscErrorCode MatSOR_MPIAIJ(Mat matin, Vec bb, PetscReal omega, MatSORType flag, PetscReal fshift, PetscInt its, PetscInt lits, Vec xx)
1401d71ae5a4SJacob Faibussowitsch {
140244a69424SLois Curfman McInnes   Mat_MPIAIJ *mat = (Mat_MPIAIJ *)matin->data;
1403f4259b30SLisandro Dalcin   Vec         bb1 = NULL;
1404ace3abfcSBarry Smith   PetscBool   hasop;
14058a729477SBarry Smith 
14063a40ed3dSBarry Smith   PetscFunctionBegin;
1407a2b30743SBarry Smith   if (flag == SOR_APPLY_UPPER) {
14089566063dSJacob Faibussowitsch     PetscCall((*mat->A->ops->sor)(mat->A, bb, omega, flag, fshift, lits, 1, xx));
14093ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
1410a2b30743SBarry Smith   }
1411a2b30743SBarry Smith 
141248a46eb9SPierre Jolivet   if (its > 1 || ~flag & SOR_ZERO_INITIAL_GUESS || flag & SOR_EISENSTAT) PetscCall(VecDuplicate(bb, &bb1));
14134e980039SJed Brown 
1414c16cb8f2SBarry Smith   if ((flag & SOR_LOCAL_SYMMETRIC_SWEEP) == SOR_LOCAL_SYMMETRIC_SWEEP) {
1415da3a660dSBarry Smith     if (flag & SOR_ZERO_INITIAL_GUESS) {
14169566063dSJacob Faibussowitsch       PetscCall((*mat->A->ops->sor)(mat->A, bb, omega, flag, fshift, lits, 1, xx));
14172798e883SHong Zhang       its--;
1418da3a660dSBarry Smith     }
14192798e883SHong Zhang 
14202798e883SHong Zhang     while (its--) {
14219566063dSJacob Faibussowitsch       PetscCall(VecScatterBegin(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14229566063dSJacob Faibussowitsch       PetscCall(VecScatterEnd(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14232798e883SHong Zhang 
1424c14dc6b6SHong Zhang       /* update rhs: bb1 = bb - B*x */
14259566063dSJacob Faibussowitsch       PetscCall(VecScale(mat->lvec, -1.0));
14269566063dSJacob Faibussowitsch       PetscCall((*mat->B->ops->multadd)(mat->B, mat->lvec, bb, bb1));
14272798e883SHong Zhang 
1428c14dc6b6SHong Zhang       /* local sweep */
14299566063dSJacob Faibussowitsch       PetscCall((*mat->A->ops->sor)(mat->A, bb1, omega, SOR_SYMMETRIC_SWEEP, fshift, lits, 1, xx));
14302798e883SHong Zhang     }
14313a40ed3dSBarry Smith   } else if (flag & SOR_LOCAL_FORWARD_SWEEP) {
1432da3a660dSBarry Smith     if (flag & SOR_ZERO_INITIAL_GUESS) {
14339566063dSJacob Faibussowitsch       PetscCall((*mat->A->ops->sor)(mat->A, bb, omega, flag, fshift, lits, 1, xx));
14342798e883SHong Zhang       its--;
1435da3a660dSBarry Smith     }
14362798e883SHong Zhang     while (its--) {
14379566063dSJacob Faibussowitsch       PetscCall(VecScatterBegin(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14389566063dSJacob Faibussowitsch       PetscCall(VecScatterEnd(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14392798e883SHong Zhang 
1440c14dc6b6SHong Zhang       /* update rhs: bb1 = bb - B*x */
14419566063dSJacob Faibussowitsch       PetscCall(VecScale(mat->lvec, -1.0));
14429566063dSJacob Faibussowitsch       PetscCall((*mat->B->ops->multadd)(mat->B, mat->lvec, bb, bb1));
1443c14dc6b6SHong Zhang 
1444c14dc6b6SHong Zhang       /* local sweep */
14459566063dSJacob Faibussowitsch       PetscCall((*mat->A->ops->sor)(mat->A, bb1, omega, SOR_FORWARD_SWEEP, fshift, lits, 1, xx));
14462798e883SHong Zhang     }
14473a40ed3dSBarry Smith   } else if (flag & SOR_LOCAL_BACKWARD_SWEEP) {
1448da3a660dSBarry Smith     if (flag & SOR_ZERO_INITIAL_GUESS) {
14499566063dSJacob Faibussowitsch       PetscCall((*mat->A->ops->sor)(mat->A, bb, omega, flag, fshift, lits, 1, xx));
14502798e883SHong Zhang       its--;
1451da3a660dSBarry Smith     }
14522798e883SHong Zhang     while (its--) {
14539566063dSJacob Faibussowitsch       PetscCall(VecScatterBegin(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14549566063dSJacob Faibussowitsch       PetscCall(VecScatterEnd(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14552798e883SHong Zhang 
1456c14dc6b6SHong Zhang       /* update rhs: bb1 = bb - B*x */
14579566063dSJacob Faibussowitsch       PetscCall(VecScale(mat->lvec, -1.0));
14589566063dSJacob Faibussowitsch       PetscCall((*mat->B->ops->multadd)(mat->B, mat->lvec, bb, bb1));
14592798e883SHong Zhang 
1460c14dc6b6SHong Zhang       /* local sweep */
14619566063dSJacob Faibussowitsch       PetscCall((*mat->A->ops->sor)(mat->A, bb1, omega, SOR_BACKWARD_SWEEP, fshift, lits, 1, xx));
14622798e883SHong Zhang     }
1463a7420bb7SBarry Smith   } else if (flag & SOR_EISENSTAT) {
1464a7420bb7SBarry Smith     Vec xx1;
1465a7420bb7SBarry Smith 
14669566063dSJacob Faibussowitsch     PetscCall(VecDuplicate(bb, &xx1));
14679566063dSJacob Faibussowitsch     PetscCall((*mat->A->ops->sor)(mat->A, bb, omega, (MatSORType)(SOR_ZERO_INITIAL_GUESS | SOR_LOCAL_BACKWARD_SWEEP), fshift, lits, 1, xx));
1468a7420bb7SBarry Smith 
14699566063dSJacob Faibussowitsch     PetscCall(VecScatterBegin(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
14709566063dSJacob Faibussowitsch     PetscCall(VecScatterEnd(mat->Mvctx, xx, mat->lvec, INSERT_VALUES, SCATTER_FORWARD));
1471a7420bb7SBarry Smith     if (!mat->diag) {
14729566063dSJacob Faibussowitsch       PetscCall(MatCreateVecs(matin, &mat->diag, NULL));
14739566063dSJacob Faibussowitsch       PetscCall(MatGetDiagonal(matin, mat->diag));
1474a7420bb7SBarry Smith     }
14759566063dSJacob Faibussowitsch     PetscCall(MatHasOperation(matin, MATOP_MULT_DIAGONAL_BLOCK, &hasop));
1476bd0c2dcbSBarry Smith     if (hasop) {
14779566063dSJacob Faibussowitsch       PetscCall(MatMultDiagonalBlock(matin, xx, bb1));
1478bd0c2dcbSBarry Smith     } else {
14799566063dSJacob Faibussowitsch       PetscCall(VecPointwiseMult(bb1, mat->diag, xx));
1480bd0c2dcbSBarry Smith     }
14819566063dSJacob Faibussowitsch     PetscCall(VecAYPX(bb1, (omega - 2.0) / omega, bb));
1482887ee2caSBarry Smith 
14839566063dSJacob Faibussowitsch     PetscCall(MatMultAdd(mat->B, mat->lvec, bb1, bb1));
1484a7420bb7SBarry Smith 
1485a7420bb7SBarry Smith     /* local sweep */
14869566063dSJacob Faibussowitsch     PetscCall((*mat->A->ops->sor)(mat->A, bb1, omega, (MatSORType)(SOR_ZERO_INITIAL_GUESS | SOR_LOCAL_FORWARD_SWEEP), fshift, lits, 1, xx1));
14879566063dSJacob Faibussowitsch     PetscCall(VecAXPY(xx, 1.0, xx1));
14889566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&xx1));
1489ce94432eSBarry Smith   } else SETERRQ(PetscObjectComm((PetscObject)matin), PETSC_ERR_SUP, "Parallel SOR not supported");
1490c14dc6b6SHong Zhang 
14919566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&bb1));
1492a0808db4SHong Zhang 
14937b6c816cSBarry Smith   matin->factorerrortype = mat->A->factorerrortype;
14943ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
14958a729477SBarry Smith }
1496a66be287SLois Curfman McInnes 
1497ba38deedSJacob Faibussowitsch static PetscErrorCode MatPermute_MPIAIJ(Mat A, IS rowp, IS colp, Mat *B)
1498d71ae5a4SJacob Faibussowitsch {
149972e6a0cfSJed Brown   Mat             aA, aB, Aperm;
150072e6a0cfSJed Brown   const PetscInt *rwant, *cwant, *gcols, *ai, *bi, *aj, *bj;
150172e6a0cfSJed Brown   PetscScalar    *aa, *ba;
150272e6a0cfSJed Brown   PetscInt        i, j, m, n, ng, anz, bnz, *dnnz, *onnz, *tdnnz, *tonnz, *rdest, *cdest, *work, *gcdest;
150372e6a0cfSJed Brown   PetscSF         rowsf, sf;
15040298fd71SBarry Smith   IS              parcolp = NULL;
150572e6a0cfSJed Brown   PetscBool       done;
150642e855d1Svictor 
150742e855d1Svictor   PetscFunctionBegin;
15089566063dSJacob Faibussowitsch   PetscCall(MatGetLocalSize(A, &m, &n));
15099566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(rowp, &rwant));
15109566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(colp, &cwant));
15119566063dSJacob Faibussowitsch   PetscCall(PetscMalloc3(PetscMax(m, n), &work, m, &rdest, n, &cdest));
151272e6a0cfSJed Brown 
151372e6a0cfSJed Brown   /* Invert row permutation to find out where my rows should go */
15149566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)A), &rowsf));
15159566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraphLayout(rowsf, A->rmap, A->rmap->n, NULL, PETSC_OWN_POINTER, rwant));
15169566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(rowsf));
151772e6a0cfSJed Brown   for (i = 0; i < m; i++) work[i] = A->rmap->rstart + i;
15189566063dSJacob Faibussowitsch   PetscCall(PetscSFReduceBegin(rowsf, MPIU_INT, work, rdest, MPI_REPLACE));
15199566063dSJacob Faibussowitsch   PetscCall(PetscSFReduceEnd(rowsf, MPIU_INT, work, rdest, MPI_REPLACE));
152072e6a0cfSJed Brown 
152172e6a0cfSJed Brown   /* Invert column permutation to find out where my columns should go */
15229566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)A), &sf));
15239566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraphLayout(sf, A->cmap, A->cmap->n, NULL, PETSC_OWN_POINTER, cwant));
15249566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(sf));
152572e6a0cfSJed Brown   for (i = 0; i < n; i++) work[i] = A->cmap->rstart + i;
15269566063dSJacob Faibussowitsch   PetscCall(PetscSFReduceBegin(sf, MPIU_INT, work, cdest, MPI_REPLACE));
15279566063dSJacob Faibussowitsch   PetscCall(PetscSFReduceEnd(sf, MPIU_INT, work, cdest, MPI_REPLACE));
15289566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sf));
152972e6a0cfSJed Brown 
15309566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(rowp, &rwant));
15319566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(colp, &cwant));
15329566063dSJacob Faibussowitsch   PetscCall(MatMPIAIJGetSeqAIJ(A, &aA, &aB, &gcols));
153372e6a0cfSJed Brown 
153472e6a0cfSJed Brown   /* Find out where my gcols should go */
15359566063dSJacob Faibussowitsch   PetscCall(MatGetSize(aB, NULL, &ng));
15369566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(ng, &gcdest));
15379566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)A), &sf));
15389566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraphLayout(sf, A->cmap, ng, NULL, PETSC_OWN_POINTER, gcols));
15399566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(sf));
15409566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(sf, MPIU_INT, cdest, gcdest, MPI_REPLACE));
15419566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(sf, MPIU_INT, cdest, gcdest, MPI_REPLACE));
15429566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sf));
154372e6a0cfSJed Brown 
15449566063dSJacob Faibussowitsch   PetscCall(PetscCalloc4(m, &dnnz, m, &onnz, m, &tdnnz, m, &tonnz));
15459566063dSJacob Faibussowitsch   PetscCall(MatGetRowIJ(aA, 0, PETSC_FALSE, PETSC_FALSE, &anz, &ai, &aj, &done));
15469566063dSJacob Faibussowitsch   PetscCall(MatGetRowIJ(aB, 0, PETSC_FALSE, PETSC_FALSE, &bnz, &bi, &bj, &done));
154772e6a0cfSJed Brown   for (i = 0; i < m; i++) {
1548131c27b5Sprj-     PetscInt    row = rdest[i];
1549131c27b5Sprj-     PetscMPIInt rowner;
15509566063dSJacob Faibussowitsch     PetscCall(PetscLayoutFindOwner(A->rmap, row, &rowner));
155172e6a0cfSJed Brown     for (j = ai[i]; j < ai[i + 1]; j++) {
1552131c27b5Sprj-       PetscInt    col = cdest[aj[j]];
1553131c27b5Sprj-       PetscMPIInt cowner;
15549566063dSJacob Faibussowitsch       PetscCall(PetscLayoutFindOwner(A->cmap, col, &cowner)); /* Could build an index for the columns to eliminate this search */
155572e6a0cfSJed Brown       if (rowner == cowner) dnnz[i]++;
155672e6a0cfSJed Brown       else onnz[i]++;
155772e6a0cfSJed Brown     }
155872e6a0cfSJed Brown     for (j = bi[i]; j < bi[i + 1]; j++) {
1559131c27b5Sprj-       PetscInt    col = gcdest[bj[j]];
1560131c27b5Sprj-       PetscMPIInt cowner;
15619566063dSJacob Faibussowitsch       PetscCall(PetscLayoutFindOwner(A->cmap, col, &cowner));
156272e6a0cfSJed Brown       if (rowner == cowner) dnnz[i]++;
156372e6a0cfSJed Brown       else onnz[i]++;
156472e6a0cfSJed Brown     }
156572e6a0cfSJed Brown   }
15669566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(rowsf, MPIU_INT, dnnz, tdnnz, MPI_REPLACE));
15679566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(rowsf, MPIU_INT, dnnz, tdnnz, MPI_REPLACE));
15689566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(rowsf, MPIU_INT, onnz, tonnz, MPI_REPLACE));
15699566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(rowsf, MPIU_INT, onnz, tonnz, MPI_REPLACE));
15709566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&rowsf));
157172e6a0cfSJed Brown 
15729566063dSJacob Faibussowitsch   PetscCall(MatCreateAIJ(PetscObjectComm((PetscObject)A), A->rmap->n, A->cmap->n, A->rmap->N, A->cmap->N, 0, tdnnz, 0, tonnz, &Aperm));
15739566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(aA, &aa));
15749566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(aB, &ba));
157572e6a0cfSJed Brown   for (i = 0; i < m; i++) {
157672e6a0cfSJed Brown     PetscInt *acols = dnnz, *bcols = onnz; /* Repurpose now-unneeded arrays */
1577970468b0SJed Brown     PetscInt  j0, rowlen;
157872e6a0cfSJed Brown     rowlen = ai[i + 1] - ai[i];
1579970468b0SJed Brown     for (j0 = j = 0; j < rowlen; j0 = j) { /* rowlen could be larger than number of rows m, so sum in batches */
1580970468b0SJed Brown       for (; j < PetscMin(rowlen, j0 + m); j++) acols[j - j0] = cdest[aj[ai[i] + j]];
15819566063dSJacob Faibussowitsch       PetscCall(MatSetValues(Aperm, 1, &rdest[i], j - j0, acols, aa + ai[i] + j0, INSERT_VALUES));
1582970468b0SJed Brown     }
158372e6a0cfSJed Brown     rowlen = bi[i + 1] - bi[i];
1584970468b0SJed Brown     for (j0 = j = 0; j < rowlen; j0 = j) {
1585970468b0SJed Brown       for (; j < PetscMin(rowlen, j0 + m); j++) bcols[j - j0] = gcdest[bj[bi[i] + j]];
15869566063dSJacob Faibussowitsch       PetscCall(MatSetValues(Aperm, 1, &rdest[i], j - j0, bcols, ba + bi[i] + j0, INSERT_VALUES));
1587970468b0SJed Brown     }
158872e6a0cfSJed Brown   }
15899566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(Aperm, MAT_FINAL_ASSEMBLY));
15909566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(Aperm, MAT_FINAL_ASSEMBLY));
15919566063dSJacob Faibussowitsch   PetscCall(MatRestoreRowIJ(aA, 0, PETSC_FALSE, PETSC_FALSE, &anz, &ai, &aj, &done));
15929566063dSJacob Faibussowitsch   PetscCall(MatRestoreRowIJ(aB, 0, PETSC_FALSE, PETSC_FALSE, &bnz, &bi, &bj, &done));
15939566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArray(aA, &aa));
15949566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArray(aB, &ba));
15959566063dSJacob Faibussowitsch   PetscCall(PetscFree4(dnnz, onnz, tdnnz, tonnz));
15969566063dSJacob Faibussowitsch   PetscCall(PetscFree3(work, rdest, cdest));
15979566063dSJacob Faibussowitsch   PetscCall(PetscFree(gcdest));
15989566063dSJacob Faibussowitsch   if (parcolp) PetscCall(ISDestroy(&colp));
159972e6a0cfSJed Brown   *B = Aperm;
16003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
160142e855d1Svictor }
160242e855d1Svictor 
1603ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetGhosts_MPIAIJ(Mat mat, PetscInt *nghosts, const PetscInt *ghosts[])
1604d71ae5a4SJacob Faibussowitsch {
1605c5e4d11fSDmitry Karpeev   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
1606c5e4d11fSDmitry Karpeev 
1607c5e4d11fSDmitry Karpeev   PetscFunctionBegin;
16089566063dSJacob Faibussowitsch   PetscCall(MatGetSize(aij->B, NULL, nghosts));
1609c5e4d11fSDmitry Karpeev   if (ghosts) *ghosts = aij->garray;
16103ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1611c5e4d11fSDmitry Karpeev }
1612c5e4d11fSDmitry Karpeev 
1613ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetInfo_MPIAIJ(Mat matin, MatInfoType flag, MatInfo *info)
1614d71ae5a4SJacob Faibussowitsch {
1615a66be287SLois Curfman McInnes   Mat_MPIAIJ    *mat = (Mat_MPIAIJ *)matin->data;
1616a66be287SLois Curfman McInnes   Mat            A = mat->A, B = mat->B;
16173966268fSBarry Smith   PetscLogDouble isend[5], irecv[5];
1618a66be287SLois Curfman McInnes 
16193a40ed3dSBarry Smith   PetscFunctionBegin;
16204e220ebcSLois Curfman McInnes   info->block_size = 1.0;
16219566063dSJacob Faibussowitsch   PetscCall(MatGetInfo(A, MAT_LOCAL, info));
16222205254eSKarl Rupp 
16239371c9d4SSatish Balay   isend[0] = info->nz_used;
16249371c9d4SSatish Balay   isend[1] = info->nz_allocated;
16259371c9d4SSatish Balay   isend[2] = info->nz_unneeded;
16269371c9d4SSatish Balay   isend[3] = info->memory;
16279371c9d4SSatish Balay   isend[4] = info->mallocs;
16282205254eSKarl Rupp 
16299566063dSJacob Faibussowitsch   PetscCall(MatGetInfo(B, MAT_LOCAL, info));
16302205254eSKarl Rupp 
16319371c9d4SSatish Balay   isend[0] += info->nz_used;
16329371c9d4SSatish Balay   isend[1] += info->nz_allocated;
16339371c9d4SSatish Balay   isend[2] += info->nz_unneeded;
16349371c9d4SSatish Balay   isend[3] += info->memory;
16359371c9d4SSatish Balay   isend[4] += info->mallocs;
1636a66be287SLois Curfman McInnes   if (flag == MAT_LOCAL) {
16374e220ebcSLois Curfman McInnes     info->nz_used      = isend[0];
16384e220ebcSLois Curfman McInnes     info->nz_allocated = isend[1];
16394e220ebcSLois Curfman McInnes     info->nz_unneeded  = isend[2];
16404e220ebcSLois Curfman McInnes     info->memory       = isend[3];
16414e220ebcSLois Curfman McInnes     info->mallocs      = isend[4];
1642a66be287SLois Curfman McInnes   } else if (flag == MAT_GLOBAL_MAX) {
1643462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(isend, irecv, 5, MPIU_PETSCLOGDOUBLE, MPI_MAX, PetscObjectComm((PetscObject)matin)));
16442205254eSKarl Rupp 
16454e220ebcSLois Curfman McInnes     info->nz_used      = irecv[0];
16464e220ebcSLois Curfman McInnes     info->nz_allocated = irecv[1];
16474e220ebcSLois Curfman McInnes     info->nz_unneeded  = irecv[2];
16484e220ebcSLois Curfman McInnes     info->memory       = irecv[3];
16494e220ebcSLois Curfman McInnes     info->mallocs      = irecv[4];
1650a66be287SLois Curfman McInnes   } else if (flag == MAT_GLOBAL_SUM) {
1651462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(isend, irecv, 5, MPIU_PETSCLOGDOUBLE, MPI_SUM, PetscObjectComm((PetscObject)matin)));
16522205254eSKarl Rupp 
16534e220ebcSLois Curfman McInnes     info->nz_used      = irecv[0];
16544e220ebcSLois Curfman McInnes     info->nz_allocated = irecv[1];
16554e220ebcSLois Curfman McInnes     info->nz_unneeded  = irecv[2];
16564e220ebcSLois Curfman McInnes     info->memory       = irecv[3];
16574e220ebcSLois Curfman McInnes     info->mallocs      = irecv[4];
1658a66be287SLois Curfman McInnes   }
16594e220ebcSLois Curfman McInnes   info->fill_ratio_given  = 0; /* no parallel LU/ILU/Cholesky */
16604e220ebcSLois Curfman McInnes   info->fill_ratio_needed = 0;
16614e220ebcSLois Curfman McInnes   info->factor_mallocs    = 0;
16623ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1663a66be287SLois Curfman McInnes }
1664a66be287SLois Curfman McInnes 
1665d71ae5a4SJacob Faibussowitsch PetscErrorCode MatSetOption_MPIAIJ(Mat A, MatOption op, PetscBool flg)
1666d71ae5a4SJacob Faibussowitsch {
1667c0bbcb79SLois Curfman McInnes   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
1668c74985f6SBarry Smith 
16693a40ed3dSBarry Smith   PetscFunctionBegin;
167012c028f9SKris Buschelman   switch (op) {
1671512a5fc5SBarry Smith   case MAT_NEW_NONZERO_LOCATIONS:
167212c028f9SKris Buschelman   case MAT_NEW_NONZERO_ALLOCATION_ERR:
167328b2fa4aSMatthew Knepley   case MAT_UNUSED_NONZERO_LOCATION_ERR:
1674a9817697SBarry Smith   case MAT_KEEP_NONZERO_PATTERN:
167512c028f9SKris Buschelman   case MAT_NEW_NONZERO_LOCATION_ERR:
16760ad02fcaSStefano Zampini   case MAT_USE_INODES:
167712c028f9SKris Buschelman   case MAT_IGNORE_ZERO_ENTRIES:
16781a2c6b5cSJunchao Zhang   case MAT_FORM_EXPLICIT_TRANSPOSE:
1679fa1f0d2cSMatthew G Knepley     MatCheckPreallocated(A, 1);
16809566063dSJacob Faibussowitsch     PetscCall(MatSetOption(a->A, op, flg));
16819566063dSJacob Faibussowitsch     PetscCall(MatSetOption(a->B, op, flg));
168212c028f9SKris Buschelman     break;
168312c028f9SKris Buschelman   case MAT_ROW_ORIENTED:
168443674050SBarry Smith     MatCheckPreallocated(A, 1);
16854e0d8c25SBarry Smith     a->roworiented = flg;
16862205254eSKarl Rupp 
16879566063dSJacob Faibussowitsch     PetscCall(MatSetOption(a->A, op, flg));
16889566063dSJacob Faibussowitsch     PetscCall(MatSetOption(a->B, op, flg));
168912c028f9SKris Buschelman     break;
1690d71ae5a4SJacob Faibussowitsch   case MAT_IGNORE_OFF_PROC_ENTRIES:
1691d71ae5a4SJacob Faibussowitsch     a->donotstash = flg;
1692d71ae5a4SJacob Faibussowitsch     break;
1693c8ca1fbcSVaclav Hapla   /* Symmetry flags are handled directly by MatSetOption() and they don't affect preallocation */
1694ffa07934SHong Zhang   case MAT_SPD:
169577e54ba9SKris Buschelman   case MAT_SYMMETRIC:
169677e54ba9SKris Buschelman   case MAT_STRUCTURALLY_SYMMETRIC:
1697bf108f30SBarry Smith   case MAT_HERMITIAN:
1698bf108f30SBarry Smith   case MAT_SYMMETRY_ETERNAL:
1699b94d7dedSBarry Smith   case MAT_STRUCTURAL_SYMMETRY_ETERNAL:
1700b94d7dedSBarry Smith   case MAT_SPD_ETERNAL:
1701b94d7dedSBarry Smith     /* if the diagonal matrix is square it inherits some of the properties above */
17029725ddffSPierre Jolivet     if (a->A && A->rmap->n == A->cmap->n) PetscCall(MatSetOption(a->A, op, flg));
170377e54ba9SKris Buschelman     break;
1704d71ae5a4SJacob Faibussowitsch   case MAT_SUBMAT_SINGLEIS:
1705d71ae5a4SJacob Faibussowitsch     A->submat_singleis = flg;
1706d71ae5a4SJacob Faibussowitsch     break;
1707d71ae5a4SJacob Faibussowitsch   default:
1708888c827cSStefano Zampini     break;
17093a40ed3dSBarry Smith   }
17103ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1711c74985f6SBarry Smith }
1712c74985f6SBarry Smith 
1713d71ae5a4SJacob Faibussowitsch PetscErrorCode MatGetRow_MPIAIJ(Mat matin, PetscInt row, PetscInt *nz, PetscInt **idx, PetscScalar **v)
1714d71ae5a4SJacob Faibussowitsch {
1715154123eaSLois Curfman McInnes   Mat_MPIAIJ  *mat = (Mat_MPIAIJ *)matin->data;
171687828ca2SBarry Smith   PetscScalar *vworkA, *vworkB, **pvA, **pvB, *v_p;
1717d0f46423SBarry Smith   PetscInt     i, *cworkA, *cworkB, **pcA, **pcB, cstart = matin->cmap->rstart;
1718d0f46423SBarry Smith   PetscInt     nztot, nzA, nzB, lrow, rstart = matin->rmap->rstart, rend = matin->rmap->rend;
1719b1d57f15SBarry Smith   PetscInt    *cmap, *idx_p;
172039e00950SLois Curfman McInnes 
17213a40ed3dSBarry Smith   PetscFunctionBegin;
172228b400f6SJacob Faibussowitsch   PetscCheck(!mat->getrowactive, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Already active");
17237a0afa10SBarry Smith   mat->getrowactive = PETSC_TRUE;
17247a0afa10SBarry Smith 
172570f0671dSBarry Smith   if (!mat->rowvalues && (idx || v)) {
17267a0afa10SBarry Smith     /*
17277a0afa10SBarry Smith         allocate enough space to hold information from the longest row.
17287a0afa10SBarry Smith     */
17297a0afa10SBarry Smith     Mat_SeqAIJ *Aa = (Mat_SeqAIJ *)mat->A->data, *Ba = (Mat_SeqAIJ *)mat->B->data;
1730b1d57f15SBarry Smith     PetscInt    max = 1, tmp;
1731d0f46423SBarry Smith     for (i = 0; i < matin->rmap->n; i++) {
17327a0afa10SBarry Smith       tmp = Aa->i[i + 1] - Aa->i[i] + Ba->i[i + 1] - Ba->i[i];
17332205254eSKarl Rupp       if (max < tmp) max = tmp;
17347a0afa10SBarry Smith     }
17359566063dSJacob Faibussowitsch     PetscCall(PetscMalloc2(max, &mat->rowvalues, max, &mat->rowindices));
17367a0afa10SBarry Smith   }
17377a0afa10SBarry Smith 
1738aed4548fSBarry Smith   PetscCheck(row >= rstart && row < rend, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Only local rows");
1739abc0e9e4SLois Curfman McInnes   lrow = row - rstart;
174039e00950SLois Curfman McInnes 
17419371c9d4SSatish Balay   pvA = &vworkA;
17429371c9d4SSatish Balay   pcA = &cworkA;
17439371c9d4SSatish Balay   pvB = &vworkB;
17449371c9d4SSatish Balay   pcB = &cworkB;
17459371c9d4SSatish Balay   if (!v) {
17469371c9d4SSatish Balay     pvA = NULL;
17479371c9d4SSatish Balay     pvB = NULL;
17489371c9d4SSatish Balay   }
17499371c9d4SSatish Balay   if (!idx) {
17509371c9d4SSatish Balay     pcA = NULL;
17519371c9d4SSatish Balay     if (!v) pcB = NULL;
17529371c9d4SSatish Balay   }
17539566063dSJacob Faibussowitsch   PetscCall((*mat->A->ops->getrow)(mat->A, lrow, &nzA, pcA, pvA));
17549566063dSJacob Faibussowitsch   PetscCall((*mat->B->ops->getrow)(mat->B, lrow, &nzB, pcB, pvB));
1755154123eaSLois Curfman McInnes   nztot = nzA + nzB;
1756154123eaSLois Curfman McInnes 
175770f0671dSBarry Smith   cmap = mat->garray;
1758154123eaSLois Curfman McInnes   if (v || idx) {
1759154123eaSLois Curfman McInnes     if (nztot) {
1760154123eaSLois Curfman McInnes       /* Sort by increasing column numbers, assuming A and B already sorted */
1761b1d57f15SBarry Smith       PetscInt imark = -1;
1762154123eaSLois Curfman McInnes       if (v) {
176370f0671dSBarry Smith         *v = v_p = mat->rowvalues;
176439e00950SLois Curfman McInnes         for (i = 0; i < nzB; i++) {
176570f0671dSBarry Smith           if (cmap[cworkB[i]] < cstart) v_p[i] = vworkB[i];
1766154123eaSLois Curfman McInnes           else break;
1767154123eaSLois Curfman McInnes         }
1768154123eaSLois Curfman McInnes         imark = i;
176970f0671dSBarry Smith         for (i = 0; i < nzA; i++) v_p[imark + i] = vworkA[i];
177070f0671dSBarry Smith         for (i = imark; i < nzB; i++) v_p[nzA + i] = vworkB[i];
1771154123eaSLois Curfman McInnes       }
1772154123eaSLois Curfman McInnes       if (idx) {
177370f0671dSBarry Smith         *idx = idx_p = mat->rowindices;
177470f0671dSBarry Smith         if (imark > -1) {
1775ad540459SPierre Jolivet           for (i = 0; i < imark; i++) idx_p[i] = cmap[cworkB[i]];
177670f0671dSBarry Smith         } else {
1777154123eaSLois Curfman McInnes           for (i = 0; i < nzB; i++) {
177870f0671dSBarry Smith             if (cmap[cworkB[i]] < cstart) idx_p[i] = cmap[cworkB[i]];
1779154123eaSLois Curfman McInnes             else break;
1780154123eaSLois Curfman McInnes           }
1781154123eaSLois Curfman McInnes           imark = i;
178270f0671dSBarry Smith         }
178370f0671dSBarry Smith         for (i = 0; i < nzA; i++) idx_p[imark + i] = cstart + cworkA[i];
178470f0671dSBarry Smith         for (i = imark; i < nzB; i++) idx_p[nzA + i] = cmap[cworkB[i]];
178539e00950SLois Curfman McInnes       }
17863f97c4b0SBarry Smith     } else {
1787f4259b30SLisandro Dalcin       if (idx) *idx = NULL;
1788f4259b30SLisandro Dalcin       if (v) *v = NULL;
17891ca473b0SSatish Balay     }
1790154123eaSLois Curfman McInnes   }
179139e00950SLois Curfman McInnes   *nz = nztot;
17929566063dSJacob Faibussowitsch   PetscCall((*mat->A->ops->restorerow)(mat->A, lrow, &nzA, pcA, pvA));
17939566063dSJacob Faibussowitsch   PetscCall((*mat->B->ops->restorerow)(mat->B, lrow, &nzB, pcB, pvB));
17943ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
179539e00950SLois Curfman McInnes }
179639e00950SLois Curfman McInnes 
1797d71ae5a4SJacob Faibussowitsch PetscErrorCode MatRestoreRow_MPIAIJ(Mat mat, PetscInt row, PetscInt *nz, PetscInt **idx, PetscScalar **v)
1798d71ae5a4SJacob Faibussowitsch {
17997a0afa10SBarry Smith   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
18003a40ed3dSBarry Smith 
18013a40ed3dSBarry Smith   PetscFunctionBegin;
180228b400f6SJacob Faibussowitsch   PetscCheck(aij->getrowactive, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "MatGetRow() must be called first");
18037a0afa10SBarry Smith   aij->getrowactive = PETSC_FALSE;
18043ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
180539e00950SLois Curfman McInnes }
180639e00950SLois Curfman McInnes 
1807ba38deedSJacob Faibussowitsch static PetscErrorCode MatNorm_MPIAIJ(Mat mat, NormType type, PetscReal *norm)
1808d71ae5a4SJacob Faibussowitsch {
1809855ac2c5SLois Curfman McInnes   Mat_MPIAIJ      *aij  = (Mat_MPIAIJ *)mat->data;
1810ec8511deSBarry Smith   Mat_SeqAIJ      *amat = (Mat_SeqAIJ *)aij->A->data, *bmat = (Mat_SeqAIJ *)aij->B->data;
1811d0f46423SBarry Smith   PetscInt         i, j, cstart = mat->cmap->rstart;
1812329f5518SBarry Smith   PetscReal        sum = 0.0;
1813fff043a9SJunchao Zhang   const MatScalar *v, *amata, *bmata;
181404ca555eSLois Curfman McInnes 
18153a40ed3dSBarry Smith   PetscFunctionBegin;
181617699dbbSLois Curfman McInnes   if (aij->size == 1) {
18179566063dSJacob Faibussowitsch     PetscCall(MatNorm(aij->A, type, norm));
181837fa93a5SLois Curfman McInnes   } else {
18199566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(aij->A, &amata));
18209566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(aij->B, &bmata));
182104ca555eSLois Curfman McInnes     if (type == NORM_FROBENIUS) {
1822fff043a9SJunchao Zhang       v = amata;
182304ca555eSLois Curfman McInnes       for (i = 0; i < amat->nz; i++) {
18249371c9d4SSatish Balay         sum += PetscRealPart(PetscConj(*v) * (*v));
18259371c9d4SSatish Balay         v++;
182604ca555eSLois Curfman McInnes       }
1827fff043a9SJunchao Zhang       v = bmata;
182804ca555eSLois Curfman McInnes       for (i = 0; i < bmat->nz; i++) {
18299371c9d4SSatish Balay         sum += PetscRealPart(PetscConj(*v) * (*v));
18309371c9d4SSatish Balay         v++;
183104ca555eSLois Curfman McInnes       }
1832462c564dSBarry Smith       PetscCallMPI(MPIU_Allreduce(&sum, norm, 1, MPIU_REAL, MPIU_SUM, PetscObjectComm((PetscObject)mat)));
18338f1a2a5eSBarry Smith       *norm = PetscSqrtReal(*norm);
18349566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(2.0 * amat->nz + 2.0 * bmat->nz));
18353a40ed3dSBarry Smith     } else if (type == NORM_1) { /* max column norm */
1836e91c04dfSPierre Jolivet       PetscReal *tmp;
1837b1d57f15SBarry Smith       PetscInt  *jj, *garray = aij->garray;
18389566063dSJacob Faibussowitsch       PetscCall(PetscCalloc1(mat->cmap->N + 1, &tmp));
183904ca555eSLois Curfman McInnes       *norm = 0.0;
18409371c9d4SSatish Balay       v     = amata;
18419371c9d4SSatish Balay       jj    = amat->j;
184204ca555eSLois Curfman McInnes       for (j = 0; j < amat->nz; j++) {
18439371c9d4SSatish Balay         tmp[cstart + *jj++] += PetscAbsScalar(*v);
18449371c9d4SSatish Balay         v++;
184504ca555eSLois Curfman McInnes       }
18469371c9d4SSatish Balay       v  = bmata;
18479371c9d4SSatish Balay       jj = bmat->j;
184804ca555eSLois Curfman McInnes       for (j = 0; j < bmat->nz; j++) {
18499371c9d4SSatish Balay         tmp[garray[*jj++]] += PetscAbsScalar(*v);
18509371c9d4SSatish Balay         v++;
185104ca555eSLois Curfman McInnes       }
1852e91c04dfSPierre Jolivet       PetscCallMPI(MPIU_Allreduce(MPI_IN_PLACE, tmp, mat->cmap->N, MPIU_REAL, MPIU_SUM, PetscObjectComm((PetscObject)mat)));
1853d0f46423SBarry Smith       for (j = 0; j < mat->cmap->N; j++) {
1854e91c04dfSPierre Jolivet         if (tmp[j] > *norm) *norm = tmp[j];
185504ca555eSLois Curfman McInnes       }
18569566063dSJacob Faibussowitsch       PetscCall(PetscFree(tmp));
18579566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(PetscMax(amat->nz + bmat->nz - 1, 0)));
18583a40ed3dSBarry Smith     } else if (type == NORM_INFINITY) { /* max row norm */
1859329f5518SBarry Smith       PetscReal ntemp = 0.0;
1860d0f46423SBarry Smith       for (j = 0; j < aij->A->rmap->n; j++) {
18618e3a54c0SPierre Jolivet         v   = PetscSafePointerPlusOffset(amata, amat->i[j]);
186204ca555eSLois Curfman McInnes         sum = 0.0;
186304ca555eSLois Curfman McInnes         for (i = 0; i < amat->i[j + 1] - amat->i[j]; i++) {
18649371c9d4SSatish Balay           sum += PetscAbsScalar(*v);
18659371c9d4SSatish Balay           v++;
186604ca555eSLois Curfman McInnes         }
18678e3a54c0SPierre Jolivet         v = PetscSafePointerPlusOffset(bmata, bmat->i[j]);
186804ca555eSLois Curfman McInnes         for (i = 0; i < bmat->i[j + 1] - bmat->i[j]; i++) {
18699371c9d4SSatish Balay           sum += PetscAbsScalar(*v);
18709371c9d4SSatish Balay           v++;
187104ca555eSLois Curfman McInnes         }
1872515d9167SLois Curfman McInnes         if (sum > ntemp) ntemp = sum;
187304ca555eSLois Curfman McInnes       }
1874462c564dSBarry Smith       PetscCallMPI(MPIU_Allreduce(&ntemp, norm, 1, MPIU_REAL, MPIU_MAX, PetscObjectComm((PetscObject)mat)));
18759566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(PetscMax(amat->nz + bmat->nz - 1, 0)));
1876ce94432eSBarry Smith     } else SETERRQ(PetscObjectComm((PetscObject)mat), PETSC_ERR_SUP, "No support for two norm");
18779566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(aij->A, &amata));
18789566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(aij->B, &bmata));
187937fa93a5SLois Curfman McInnes   }
18803ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1881855ac2c5SLois Curfman McInnes }
1882855ac2c5SLois Curfman McInnes 
1883ba38deedSJacob Faibussowitsch static PetscErrorCode MatTranspose_MPIAIJ(Mat A, MatReuse reuse, Mat *matout)
1884d71ae5a4SJacob Faibussowitsch {
1885a8661f62Sandi selinger   Mat_MPIAIJ      *a    = (Mat_MPIAIJ *)A->data, *b;
1886a8661f62Sandi selinger   Mat_SeqAIJ      *Aloc = (Mat_SeqAIJ *)a->A->data, *Bloc = (Mat_SeqAIJ *)a->B->data, *sub_B_diag;
1887071fcb05SBarry Smith   PetscInt         M = A->rmap->N, N = A->cmap->N, ma, na, mb, nb, row, *cols, *cols_tmp, *B_diag_ilen, i, ncol, A_diag_ncol;
1888071fcb05SBarry Smith   const PetscInt  *ai, *aj, *bi, *bj, *B_diag_i;
1889a8661f62Sandi selinger   Mat              B, A_diag, *B_diag;
1890ce496241SStefano Zampini   const MatScalar *pbv, *bv;
1891b7c46309SBarry Smith 
18923a40ed3dSBarry Smith   PetscFunctionBegin;
18937fb60732SBarry Smith   if (reuse == MAT_REUSE_MATRIX) PetscCall(MatTransposeCheckNonzeroState_Private(A, *matout));
18949371c9d4SSatish Balay   ma = A->rmap->n;
18959371c9d4SSatish Balay   na = A->cmap->n;
18969371c9d4SSatish Balay   mb = a->B->rmap->n;
18979371c9d4SSatish Balay   nb = a->B->cmap->n;
18989371c9d4SSatish Balay   ai = Aloc->i;
18999371c9d4SSatish Balay   aj = Aloc->j;
19009371c9d4SSatish Balay   bi = Bloc->i;
19019371c9d4SSatish Balay   bj = Bloc->j;
1902fc73b1b3SBarry Smith   if (reuse == MAT_INITIAL_MATRIX || *matout == A) {
190380bcc5a1SJed Brown     PetscInt            *d_nnz, *g_nnz, *o_nnz;
190480bcc5a1SJed Brown     PetscSFNode         *oloc;
1905713c93b4SJed Brown     PETSC_UNUSED PetscSF sf;
190680bcc5a1SJed Brown 
19079566063dSJacob Faibussowitsch     PetscCall(PetscMalloc4(na, &d_nnz, na, &o_nnz, nb, &g_nnz, nb, &oloc));
190880bcc5a1SJed Brown     /* compute d_nnz for preallocation */
19099566063dSJacob Faibussowitsch     PetscCall(PetscArrayzero(d_nnz, na));
1910cbc6b225SStefano Zampini     for (i = 0; i < ai[ma]; i++) d_nnz[aj[i]]++;
191180bcc5a1SJed Brown     /* compute local off-diagonal contributions */
19129566063dSJacob Faibussowitsch     PetscCall(PetscArrayzero(g_nnz, nb));
191380bcc5a1SJed Brown     for (i = 0; i < bi[ma]; i++) g_nnz[bj[i]]++;
191480bcc5a1SJed Brown     /* map those to global */
19159566063dSJacob Faibussowitsch     PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)A), &sf));
19169566063dSJacob Faibussowitsch     PetscCall(PetscSFSetGraphLayout(sf, A->cmap, nb, NULL, PETSC_USE_POINTER, a->garray));
19179566063dSJacob Faibussowitsch     PetscCall(PetscSFSetFromOptions(sf));
19189566063dSJacob Faibussowitsch     PetscCall(PetscArrayzero(o_nnz, na));
191957168dbeSPierre Jolivet     PetscCall(PetscSFReduceBegin(sf, MPIU_INT, g_nnz, o_nnz, MPI_SUM));
192057168dbeSPierre Jolivet     PetscCall(PetscSFReduceEnd(sf, MPIU_INT, g_nnz, o_nnz, MPI_SUM));
19219566063dSJacob Faibussowitsch     PetscCall(PetscSFDestroy(&sf));
1922d4bb536fSBarry Smith 
19239566063dSJacob Faibussowitsch     PetscCall(MatCreate(PetscObjectComm((PetscObject)A), &B));
19249566063dSJacob Faibussowitsch     PetscCall(MatSetSizes(B, A->cmap->n, A->rmap->n, N, M));
192558b7e2c1SStefano Zampini     PetscCall(MatSetBlockSizes(B, A->cmap->bs, A->rmap->bs));
19269566063dSJacob Faibussowitsch     PetscCall(MatSetType(B, ((PetscObject)A)->type_name));
19279566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(B, 0, d_nnz, 0, o_nnz));
19289566063dSJacob Faibussowitsch     PetscCall(PetscFree4(d_nnz, o_nnz, g_nnz, oloc));
1929fc4dec0aSBarry Smith   } else {
1930fc4dec0aSBarry Smith     B = *matout;
19319566063dSJacob Faibussowitsch     PetscCall(MatSetOption(B, MAT_NEW_NONZERO_ALLOCATION_ERR, PETSC_TRUE));
1932fc4dec0aSBarry Smith   }
1933b7c46309SBarry Smith 
1934f79cb1a0Sandi selinger   b           = (Mat_MPIAIJ *)B->data;
1935a8661f62Sandi selinger   A_diag      = a->A;
1936a8661f62Sandi selinger   B_diag      = &b->A;
1937a8661f62Sandi selinger   sub_B_diag  = (Mat_SeqAIJ *)(*B_diag)->data;
1938a8661f62Sandi selinger   A_diag_ncol = A_diag->cmap->N;
1939a8661f62Sandi selinger   B_diag_ilen = sub_B_diag->ilen;
1940a8661f62Sandi selinger   B_diag_i    = sub_B_diag->i;
1941f79cb1a0Sandi selinger 
1942f79cb1a0Sandi selinger   /* Set ilen for diagonal of B */
1943ad540459SPierre Jolivet   for (i = 0; i < A_diag_ncol; i++) B_diag_ilen[i] = B_diag_i[i + 1] - B_diag_i[i];
1944f79cb1a0Sandi selinger 
19454cf0e950SBarry Smith   /* Transpose the diagonal part of the matrix. In contrast to the off-diagonal part, this can be done
1946a8661f62Sandi selinger   very quickly (=without using MatSetValues), because all writes are local. */
19477fb60732SBarry Smith   PetscCall(MatTransposeSetPrecursor(A_diag, *B_diag));
19489566063dSJacob Faibussowitsch   PetscCall(MatTranspose(A_diag, MAT_REUSE_MATRIX, B_diag));
1949f79cb1a0Sandi selinger 
1950b7c46309SBarry Smith   /* copy over the B part */
19519566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(bi[mb], &cols));
19529566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(a->B, &bv));
1953ce496241SStefano Zampini   pbv = bv;
1954d0f46423SBarry Smith   row = A->rmap->rstart;
19552205254eSKarl Rupp   for (i = 0; i < bi[mb]; i++) cols[i] = a->garray[bj[i]];
195661a2fbbaSHong Zhang   cols_tmp = cols;
1957da668accSHong Zhang   for (i = 0; i < mb; i++) {
1958da668accSHong Zhang     ncol = bi[i + 1] - bi[i];
19599566063dSJacob Faibussowitsch     PetscCall(MatSetValues(B, ncol, cols_tmp, 1, &row, pbv, INSERT_VALUES));
19602205254eSKarl Rupp     row++;
1961720a2405SPierre Jolivet     if (pbv) pbv += ncol;
1962720a2405SPierre Jolivet     if (cols_tmp) cols_tmp += ncol;
1963b7c46309SBarry Smith   }
19649566063dSJacob Faibussowitsch   PetscCall(PetscFree(cols));
19659566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(a->B, &bv));
1966fc73b1b3SBarry Smith 
19679566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(B, MAT_FINAL_ASSEMBLY));
19689566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(B, MAT_FINAL_ASSEMBLY));
1969cf37664fSBarry Smith   if (reuse == MAT_INITIAL_MATRIX || reuse == MAT_REUSE_MATRIX) {
19700de55854SLois Curfman McInnes     *matout = B;
19710de55854SLois Curfman McInnes   } else {
19729566063dSJacob Faibussowitsch     PetscCall(MatHeaderMerge(A, &B));
19730de55854SLois Curfman McInnes   }
19743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1975b7c46309SBarry Smith }
1976b7c46309SBarry Smith 
1977ba38deedSJacob Faibussowitsch static PetscErrorCode MatDiagonalScale_MPIAIJ(Mat mat, Vec ll, Vec rr)
1978d71ae5a4SJacob Faibussowitsch {
19794b967eb1SSatish Balay   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
19804b967eb1SSatish Balay   Mat         a = aij->A, b = aij->B;
1981b1d57f15SBarry Smith   PetscInt    s1, s2, s3;
1982a008b906SSatish Balay 
19833a40ed3dSBarry Smith   PetscFunctionBegin;
19849566063dSJacob Faibussowitsch   PetscCall(MatGetLocalSize(mat, &s2, &s3));
19854b967eb1SSatish Balay   if (rr) {
19869566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(rr, &s1));
198708401ef6SPierre Jolivet     PetscCheck(s1 == s3, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "right vector non-conforming local size");
19884b967eb1SSatish Balay     /* Overlap communication with computation. */
19899566063dSJacob Faibussowitsch     PetscCall(VecScatterBegin(aij->Mvctx, rr, aij->lvec, INSERT_VALUES, SCATTER_FORWARD));
1990a008b906SSatish Balay   }
19914b967eb1SSatish Balay   if (ll) {
19929566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(ll, &s1));
199308401ef6SPierre Jolivet     PetscCheck(s1 == s2, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "left vector non-conforming local size");
1994dbbe0bcdSBarry Smith     PetscUseTypeMethod(b, diagonalscale, ll, NULL);
19954b967eb1SSatish Balay   }
19964b967eb1SSatish Balay   /* scale  the diagonal block */
1997dbbe0bcdSBarry Smith   PetscUseTypeMethod(a, diagonalscale, ll, rr);
19984b967eb1SSatish Balay 
19994b967eb1SSatish Balay   if (rr) {
20004b967eb1SSatish Balay     /* Do a scatter end and then right scale the off-diagonal block */
20019566063dSJacob Faibussowitsch     PetscCall(VecScatterEnd(aij->Mvctx, rr, aij->lvec, INSERT_VALUES, SCATTER_FORWARD));
2002dbbe0bcdSBarry Smith     PetscUseTypeMethod(b, diagonalscale, NULL, aij->lvec);
20034b967eb1SSatish Balay   }
20043ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2005a008b906SSatish Balay }
2006a008b906SSatish Balay 
2007ba38deedSJacob Faibussowitsch static PetscErrorCode MatSetUnfactored_MPIAIJ(Mat A)
2008d71ae5a4SJacob Faibussowitsch {
2009bb5a7306SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
20103a40ed3dSBarry Smith 
20113a40ed3dSBarry Smith   PetscFunctionBegin;
20129566063dSJacob Faibussowitsch   PetscCall(MatSetUnfactored(a->A));
20133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2014bb5a7306SBarry Smith }
2015bb5a7306SBarry Smith 
2016ba38deedSJacob Faibussowitsch static PetscErrorCode MatEqual_MPIAIJ(Mat A, Mat B, PetscBool *flag)
2017d71ae5a4SJacob Faibussowitsch {
2018d4bb536fSBarry Smith   Mat_MPIAIJ *matB = (Mat_MPIAIJ *)B->data, *matA = (Mat_MPIAIJ *)A->data;
2019d4bb536fSBarry Smith   Mat         a, b, c, d;
2020ace3abfcSBarry Smith   PetscBool   flg;
2021d4bb536fSBarry Smith 
20223a40ed3dSBarry Smith   PetscFunctionBegin;
20239371c9d4SSatish Balay   a = matA->A;
20249371c9d4SSatish Balay   b = matA->B;
20259371c9d4SSatish Balay   c = matB->A;
20269371c9d4SSatish Balay   d = matB->B;
2027d4bb536fSBarry Smith 
20289566063dSJacob Faibussowitsch   PetscCall(MatEqual(a, c, &flg));
202948a46eb9SPierre Jolivet   if (flg) PetscCall(MatEqual(b, d, &flg));
2030462c564dSBarry Smith   PetscCallMPI(MPIU_Allreduce(&flg, flag, 1, MPIU_BOOL, MPI_LAND, PetscObjectComm((PetscObject)A)));
20313ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2032d4bb536fSBarry Smith }
2033d4bb536fSBarry Smith 
2034ba38deedSJacob Faibussowitsch static PetscErrorCode MatCopy_MPIAIJ(Mat A, Mat B, MatStructure str)
2035d71ae5a4SJacob Faibussowitsch {
2036cb5b572fSBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
2037cb5b572fSBarry Smith   Mat_MPIAIJ *b = (Mat_MPIAIJ *)B->data;
2038cb5b572fSBarry Smith 
2039cb5b572fSBarry Smith   PetscFunctionBegin;
204033f4a19fSKris Buschelman   /* If the two matrices don't have the same copy implementation, they aren't compatible for fast copy. */
204133f4a19fSKris Buschelman   if ((str != SAME_NONZERO_PATTERN) || (A->ops->copy != B->ops->copy)) {
2042cb5b572fSBarry Smith     /* because of the column compression in the off-processor part of the matrix a->B,
2043cb5b572fSBarry Smith        the number of columns in a->B and b->B may be different, hence we cannot call
2044cb5b572fSBarry Smith        the MatCopy() directly on the two parts. If need be, we can provide a more
2045cb5b572fSBarry Smith        efficient copy than the MatCopy_Basic() by first uncompressing the a->B matrices
2046cb5b572fSBarry Smith        then copying the submatrices */
20479566063dSJacob Faibussowitsch     PetscCall(MatCopy_Basic(A, B, str));
2048cb5b572fSBarry Smith   } else {
20499566063dSJacob Faibussowitsch     PetscCall(MatCopy(a->A, b->A, str));
20509566063dSJacob Faibussowitsch     PetscCall(MatCopy(a->B, b->B, str));
2051cb5b572fSBarry Smith   }
20529566063dSJacob Faibussowitsch   PetscCall(PetscObjectStateIncrease((PetscObject)B));
20533ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2054cb5b572fSBarry Smith }
2055cb5b572fSBarry Smith 
2056001ddc4fSHong Zhang /*
2057001ddc4fSHong Zhang    Computes the number of nonzeros per row needed for preallocation when X and Y
2058001ddc4fSHong Zhang    have different nonzero structure.
2059001ddc4fSHong Zhang */
2060d71ae5a4SJacob Faibussowitsch PetscErrorCode MatAXPYGetPreallocation_MPIX_private(PetscInt m, const PetscInt *xi, const PetscInt *xj, const PetscInt *xltog, const PetscInt *yi, const PetscInt *yj, const PetscInt *yltog, PetscInt *nnz)
2061d71ae5a4SJacob Faibussowitsch {
2062001ddc4fSHong Zhang   PetscInt i, j, k, nzx, nzy;
206395b7e79eSJed Brown 
206495b7e79eSJed Brown   PetscFunctionBegin;
206595b7e79eSJed Brown   /* Set the number of nonzeros in the new matrix */
206695b7e79eSJed Brown   for (i = 0; i < m; i++) {
20678e3a54c0SPierre Jolivet     const PetscInt *xjj = PetscSafePointerPlusOffset(xj, xi[i]), *yjj = PetscSafePointerPlusOffset(yj, yi[i]);
2068001ddc4fSHong Zhang     nzx    = xi[i + 1] - xi[i];
2069001ddc4fSHong Zhang     nzy    = yi[i + 1] - yi[i];
207095b7e79eSJed Brown     nnz[i] = 0;
207195b7e79eSJed Brown     for (j = 0, k = 0; j < nzx; j++) {                                /* Point in X */
2072001ddc4fSHong Zhang       for (; k < nzy && yltog[yjj[k]] < xltog[xjj[j]]; k++) nnz[i]++; /* Catch up to X */
2073001ddc4fSHong Zhang       if (k < nzy && yltog[yjj[k]] == xltog[xjj[j]]) k++;             /* Skip duplicate */
207495b7e79eSJed Brown       nnz[i]++;
207595b7e79eSJed Brown     }
207695b7e79eSJed Brown     for (; k < nzy; k++) nnz[i]++;
207795b7e79eSJed Brown   }
20783ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
207995b7e79eSJed Brown }
208095b7e79eSJed Brown 
2081001ddc4fSHong Zhang /* This is the same as MatAXPYGetPreallocation_SeqAIJ, except that the local-to-global map is provided */
2082d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatAXPYGetPreallocation_MPIAIJ(Mat Y, const PetscInt *yltog, Mat X, const PetscInt *xltog, PetscInt *nnz)
2083d71ae5a4SJacob Faibussowitsch {
2084001ddc4fSHong Zhang   PetscInt    m = Y->rmap->N;
2085001ddc4fSHong Zhang   Mat_SeqAIJ *x = (Mat_SeqAIJ *)X->data;
2086001ddc4fSHong Zhang   Mat_SeqAIJ *y = (Mat_SeqAIJ *)Y->data;
2087001ddc4fSHong Zhang 
2088001ddc4fSHong Zhang   PetscFunctionBegin;
20899566063dSJacob Faibussowitsch   PetscCall(MatAXPYGetPreallocation_MPIX_private(m, x->i, x->j, xltog, y->i, y->j, yltog, nnz));
20903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2091001ddc4fSHong Zhang }
2092001ddc4fSHong Zhang 
2093ba38deedSJacob Faibussowitsch static PetscErrorCode MatAXPY_MPIAIJ(Mat Y, PetscScalar a, Mat X, MatStructure str)
2094d71ae5a4SJacob Faibussowitsch {
2095ac90fabeSBarry Smith   Mat_MPIAIJ *xx = (Mat_MPIAIJ *)X->data, *yy = (Mat_MPIAIJ *)Y->data;
2096ac90fabeSBarry Smith 
2097ac90fabeSBarry Smith   PetscFunctionBegin;
2098ac90fabeSBarry Smith   if (str == SAME_NONZERO_PATTERN) {
20999566063dSJacob Faibussowitsch     PetscCall(MatAXPY(yy->A, a, xx->A, str));
21009566063dSJacob Faibussowitsch     PetscCall(MatAXPY(yy->B, a, xx->B, str));
2101ab784542SHong Zhang   } else if (str == SUBSET_NONZERO_PATTERN) { /* nonzeros of X is a subset of Y's */
21029566063dSJacob Faibussowitsch     PetscCall(MatAXPY_Basic(Y, a, X, str));
2103ac90fabeSBarry Smith   } else {
21049f5f6813SShri Abhyankar     Mat       B;
21059f5f6813SShri Abhyankar     PetscInt *nnz_d, *nnz_o;
2106d9d719b4SStefano Zampini 
21079566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(yy->A->rmap->N, &nnz_d));
21089566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(yy->B->rmap->N, &nnz_o));
21099566063dSJacob Faibussowitsch     PetscCall(MatCreate(PetscObjectComm((PetscObject)Y), &B));
21109566063dSJacob Faibussowitsch     PetscCall(PetscObjectSetName((PetscObject)B, ((PetscObject)Y)->name));
21119566063dSJacob Faibussowitsch     PetscCall(MatSetLayouts(B, Y->rmap, Y->cmap));
21129566063dSJacob Faibussowitsch     PetscCall(MatSetType(B, ((PetscObject)Y)->type_name));
21139566063dSJacob Faibussowitsch     PetscCall(MatAXPYGetPreallocation_SeqAIJ(yy->A, xx->A, nnz_d));
21149566063dSJacob Faibussowitsch     PetscCall(MatAXPYGetPreallocation_MPIAIJ(yy->B, yy->garray, xx->B, xx->garray, nnz_o));
21159566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(B, 0, nnz_d, 0, nnz_o));
21169566063dSJacob Faibussowitsch     PetscCall(MatAXPY_BasicWithPreallocation(B, Y, a, X, str));
21179566063dSJacob Faibussowitsch     PetscCall(MatHeaderMerge(Y, &B));
21189566063dSJacob Faibussowitsch     PetscCall(PetscFree(nnz_d));
21199566063dSJacob Faibussowitsch     PetscCall(PetscFree(nnz_o));
2120ac90fabeSBarry Smith   }
21213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2122ac90fabeSBarry Smith }
2123ac90fabeSBarry Smith 
21242726fb6dSPierre Jolivet PETSC_INTERN PetscErrorCode MatConjugate_SeqAIJ(Mat);
2125354c94deSBarry Smith 
2126ba38deedSJacob Faibussowitsch static PetscErrorCode MatConjugate_MPIAIJ(Mat mat)
2127d71ae5a4SJacob Faibussowitsch {
21285f80ce2aSJacob Faibussowitsch   PetscFunctionBegin;
21295f80ce2aSJacob Faibussowitsch   if (PetscDefined(USE_COMPLEX)) {
2130354c94deSBarry Smith     Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
2131354c94deSBarry Smith 
21329566063dSJacob Faibussowitsch     PetscCall(MatConjugate_SeqAIJ(aij->A));
21339566063dSJacob Faibussowitsch     PetscCall(MatConjugate_SeqAIJ(aij->B));
21345f80ce2aSJacob Faibussowitsch   }
21353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2136354c94deSBarry Smith }
2137354c94deSBarry Smith 
2138ba38deedSJacob Faibussowitsch static PetscErrorCode MatRealPart_MPIAIJ(Mat A)
2139d71ae5a4SJacob Faibussowitsch {
214099cafbc1SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
214199cafbc1SBarry Smith 
214299cafbc1SBarry Smith   PetscFunctionBegin;
21439566063dSJacob Faibussowitsch   PetscCall(MatRealPart(a->A));
21449566063dSJacob Faibussowitsch   PetscCall(MatRealPart(a->B));
21453ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
214699cafbc1SBarry Smith }
214799cafbc1SBarry Smith 
2148ba38deedSJacob Faibussowitsch static PetscErrorCode MatImaginaryPart_MPIAIJ(Mat A)
2149d71ae5a4SJacob Faibussowitsch {
215099cafbc1SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
215199cafbc1SBarry Smith 
215299cafbc1SBarry Smith   PetscFunctionBegin;
21539566063dSJacob Faibussowitsch   PetscCall(MatImaginaryPart(a->A));
21549566063dSJacob Faibussowitsch   PetscCall(MatImaginaryPart(a->B));
21553ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
215699cafbc1SBarry Smith }
215799cafbc1SBarry Smith 
2158ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetRowMaxAbs_MPIAIJ(Mat A, Vec v, PetscInt idx[])
2159d71ae5a4SJacob Faibussowitsch {
2160c91732d9SHong Zhang   Mat_MPIAIJ        *a = (Mat_MPIAIJ *)A->data;
2161475b8b61SHong Zhang   PetscInt           i, *idxb = NULL, m = A->rmap->n;
216262e5df07SMark Adams   PetscScalar       *vv;
2163475b8b61SHong Zhang   Vec                vB, vA;
216462e5df07SMark Adams   const PetscScalar *va, *vb;
2165c91732d9SHong Zhang 
2166c91732d9SHong Zhang   PetscFunctionBegin;
2167c7b600bfSPierre Jolivet   PetscCall(MatCreateVecs(a->A, NULL, &vA));
21689566063dSJacob Faibussowitsch   PetscCall(MatGetRowMaxAbs(a->A, vA, idx));
2169475b8b61SHong Zhang 
217062e5df07SMark Adams   PetscCall(VecGetArrayRead(vA, &va));
2171c91732d9SHong Zhang   if (idx) {
2172475b8b61SHong Zhang     for (i = 0; i < m; i++) {
2173d0f46423SBarry Smith       if (PetscAbsScalar(va[i])) idx[i] += A->cmap->rstart;
2174c91732d9SHong Zhang     }
2175c91732d9SHong Zhang   }
2176c91732d9SHong Zhang 
2177c7b600bfSPierre Jolivet   PetscCall(MatCreateVecs(a->B, NULL, &vB));
21789566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m, &idxb));
21799566063dSJacob Faibussowitsch   PetscCall(MatGetRowMaxAbs(a->B, vB, idxb));
2180c91732d9SHong Zhang 
21819566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(v, &vv));
21829566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(vB, &vb));
2183475b8b61SHong Zhang   for (i = 0; i < m; i++) {
2184c91732d9SHong Zhang     if (PetscAbsScalar(va[i]) < PetscAbsScalar(vb[i])) {
2185475b8b61SHong Zhang       vv[i] = vb[i];
2186c91732d9SHong Zhang       if (idx) idx[i] = a->garray[idxb[i]];
2187475b8b61SHong Zhang     } else {
2188475b8b61SHong Zhang       vv[i] = va[i];
21899371c9d4SSatish Balay       if (idx && PetscAbsScalar(va[i]) == PetscAbsScalar(vb[i]) && idxb[i] != -1 && idx[i] > a->garray[idxb[i]]) idx[i] = a->garray[idxb[i]];
2190c91732d9SHong Zhang     }
2191c91732d9SHong Zhang   }
219262e5df07SMark Adams   PetscCall(VecRestoreArrayWrite(v, &vv));
219362e5df07SMark Adams   PetscCall(VecRestoreArrayRead(vA, &va));
21949566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(vB, &vb));
21959566063dSJacob Faibussowitsch   PetscCall(PetscFree(idxb));
21969566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&vA));
21979566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&vB));
21983ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2199c91732d9SHong Zhang }
2200c91732d9SHong Zhang 
2201eede4a3fSMark Adams static PetscErrorCode MatGetRowSumAbs_MPIAIJ(Mat A, Vec v)
2202eede4a3fSMark Adams {
2203eede4a3fSMark Adams   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
2204eede4a3fSMark Adams   Vec         vB, vA;
2205eede4a3fSMark Adams 
2206eede4a3fSMark Adams   PetscFunctionBegin;
2207c7b600bfSPierre Jolivet   PetscCall(MatCreateVecs(a->A, NULL, &vA));
2208eede4a3fSMark Adams   PetscCall(MatGetRowSumAbs(a->A, vA));
2209c7b600bfSPierre Jolivet   PetscCall(MatCreateVecs(a->B, NULL, &vB));
2210eede4a3fSMark Adams   PetscCall(MatGetRowSumAbs(a->B, vB));
2211eede4a3fSMark Adams   PetscCall(VecAXPY(vA, 1.0, vB));
2212eede4a3fSMark Adams   PetscCall(VecDestroy(&vB));
2213eede4a3fSMark Adams   PetscCall(VecCopy(vA, v));
2214eede4a3fSMark Adams   PetscCall(VecDestroy(&vA));
2215eede4a3fSMark Adams   PetscFunctionReturn(PETSC_SUCCESS);
2216eede4a3fSMark Adams }
2217eede4a3fSMark Adams 
2218ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetRowMinAbs_MPIAIJ(Mat A, Vec v, PetscInt idx[])
2219d71ae5a4SJacob Faibussowitsch {
2220f07e67edSHong Zhang   Mat_MPIAIJ        *mat = (Mat_MPIAIJ *)A->data;
2221f07e67edSHong Zhang   PetscInt           m = A->rmap->n, n = A->cmap->n;
2222f07e67edSHong Zhang   PetscInt           cstart = A->cmap->rstart, cend = A->cmap->rend;
2223f07e67edSHong Zhang   PetscInt          *cmap = mat->garray;
2224f07e67edSHong Zhang   PetscInt          *diagIdx, *offdiagIdx;
2225f07e67edSHong Zhang   Vec                diagV, offdiagV;
2226ce496241SStefano Zampini   PetscScalar       *a, *diagA, *offdiagA;
2227ce496241SStefano Zampini   const PetscScalar *ba, *bav;
2228f07e67edSHong Zhang   PetscInt           r, j, col, ncols, *bi, *bj;
2229f07e67edSHong Zhang   Mat                B = mat->B;
2230f07e67edSHong Zhang   Mat_SeqAIJ        *b = (Mat_SeqAIJ *)B->data;
2231c87e5d42SMatthew Knepley 
2232c87e5d42SMatthew Knepley   PetscFunctionBegin;
2233f07e67edSHong Zhang   /* When a process holds entire A and other processes have no entry */
2234f07e67edSHong Zhang   if (A->cmap->N == n) {
22359566063dSJacob Faibussowitsch     PetscCall(VecGetArrayWrite(v, &diagA));
22369566063dSJacob Faibussowitsch     PetscCall(VecCreateSeqWithArray(PETSC_COMM_SELF, 1, m, diagA, &diagV));
22379566063dSJacob Faibussowitsch     PetscCall(MatGetRowMinAbs(mat->A, diagV, idx));
22389566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&diagV));
22399566063dSJacob Faibussowitsch     PetscCall(VecRestoreArrayWrite(v, &diagA));
22403ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
2241f07e67edSHong Zhang   } else if (n == 0) {
2242f07e67edSHong Zhang     if (m) {
22439566063dSJacob Faibussowitsch       PetscCall(VecGetArrayWrite(v, &a));
22449371c9d4SSatish Balay       for (r = 0; r < m; r++) {
22459371c9d4SSatish Balay         a[r] = 0.0;
22469371c9d4SSatish Balay         if (idx) idx[r] = -1;
22479371c9d4SSatish Balay       }
22489566063dSJacob Faibussowitsch       PetscCall(VecRestoreArrayWrite(v, &a));
2249f07e67edSHong Zhang     }
22503ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
2251f07e67edSHong Zhang   }
2252f07e67edSHong Zhang 
22539566063dSJacob Faibussowitsch   PetscCall(PetscMalloc2(m, &diagIdx, m, &offdiagIdx));
22549566063dSJacob Faibussowitsch   PetscCall(VecCreateSeq(PETSC_COMM_SELF, m, &diagV));
22559566063dSJacob Faibussowitsch   PetscCall(VecCreateSeq(PETSC_COMM_SELF, m, &offdiagV));
22569566063dSJacob Faibussowitsch   PetscCall(MatGetRowMinAbs(mat->A, diagV, diagIdx));
2257f07e67edSHong Zhang 
2258f07e67edSHong Zhang   /* Get offdiagIdx[] for implicit 0.0 */
22599566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(B, &bav));
2260ce496241SStefano Zampini   ba = bav;
2261f07e67edSHong Zhang   bi = b->i;
2262f07e67edSHong Zhang   bj = b->j;
22639566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(offdiagV, &offdiagA));
2264f07e67edSHong Zhang   for (r = 0; r < m; r++) {
2265f07e67edSHong Zhang     ncols = bi[r + 1] - bi[r];
2266f07e67edSHong Zhang     if (ncols == A->cmap->N - n) { /* Brow is dense */
22679371c9d4SSatish Balay       offdiagA[r]   = *ba;
22689371c9d4SSatish Balay       offdiagIdx[r] = cmap[0];
2269f07e67edSHong Zhang     } else { /* Brow is sparse so already KNOW maximum is 0.0 or higher */
2270f07e67edSHong Zhang       offdiagA[r] = 0.0;
2271f07e67edSHong Zhang 
2272f07e67edSHong Zhang       /* Find first hole in the cmap */
2273f07e67edSHong Zhang       for (j = 0; j < ncols; j++) {
2274f07e67edSHong Zhang         col = cmap[bj[j]]; /* global column number = cmap[B column number] */
2275f07e67edSHong Zhang         if (col > j && j < cstart) {
2276f07e67edSHong Zhang           offdiagIdx[r] = j; /* global column number of first implicit 0.0 */
2277f07e67edSHong Zhang           break;
2278f07e67edSHong Zhang         } else if (col > j + n && j >= cstart) {
2279f07e67edSHong Zhang           offdiagIdx[r] = j + n; /* global column number of first implicit 0.0 */
2280f07e67edSHong Zhang           break;
2281f07e67edSHong Zhang         }
2282f07e67edSHong Zhang       }
22834e879edeSHong Zhang       if (j == ncols && ncols < A->cmap->N - n) {
2284f07e67edSHong Zhang         /* a hole is outside compressed Bcols */
2285f07e67edSHong Zhang         if (ncols == 0) {
2286f07e67edSHong Zhang           if (cstart) {
2287f07e67edSHong Zhang             offdiagIdx[r] = 0;
2288f07e67edSHong Zhang           } else offdiagIdx[r] = cend;
2289f07e67edSHong Zhang         } else { /* ncols > 0 */
2290f07e67edSHong Zhang           offdiagIdx[r] = cmap[ncols - 1] + 1;
2291f07e67edSHong Zhang           if (offdiagIdx[r] == cstart) offdiagIdx[r] += n;
2292f07e67edSHong Zhang         }
2293f07e67edSHong Zhang       }
2294f07e67edSHong Zhang     }
2295f07e67edSHong Zhang 
2296f07e67edSHong Zhang     for (j = 0; j < ncols; j++) {
22979371c9d4SSatish Balay       if (PetscAbsScalar(offdiagA[r]) > PetscAbsScalar(*ba)) {
22989371c9d4SSatish Balay         offdiagA[r]   = *ba;
22999371c9d4SSatish Balay         offdiagIdx[r] = cmap[*bj];
23009371c9d4SSatish Balay       }
23019371c9d4SSatish Balay       ba++;
23029371c9d4SSatish Balay       bj++;
2303f07e67edSHong Zhang     }
2304f07e67edSHong Zhang   }
2305f07e67edSHong Zhang 
23069566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(v, &a));
23079566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(diagV, (const PetscScalar **)&diagA));
2308f07e67edSHong Zhang   for (r = 0; r < m; ++r) {
2309f07e67edSHong Zhang     if (PetscAbsScalar(diagA[r]) < PetscAbsScalar(offdiagA[r])) {
2310f07e67edSHong Zhang       a[r] = diagA[r];
2311f07e67edSHong Zhang       if (idx) idx[r] = cstart + diagIdx[r];
2312f07e67edSHong Zhang     } else if (PetscAbsScalar(diagA[r]) == PetscAbsScalar(offdiagA[r])) {
2313f07e67edSHong Zhang       a[r] = diagA[r];
2314c87e5d42SMatthew Knepley       if (idx) {
2315f07e67edSHong Zhang         if (cstart + diagIdx[r] <= offdiagIdx[r]) {
2316f07e67edSHong Zhang           idx[r] = cstart + diagIdx[r];
2317f07e67edSHong Zhang         } else idx[r] = offdiagIdx[r];
2318f07e67edSHong Zhang       }
2319f07e67edSHong Zhang     } else {
2320f07e67edSHong Zhang       a[r] = offdiagA[r];
2321f07e67edSHong Zhang       if (idx) idx[r] = offdiagIdx[r];
2322c87e5d42SMatthew Knepley     }
2323c87e5d42SMatthew Knepley   }
23249566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(B, &bav));
23259566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(v, &a));
23269566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(diagV, (const PetscScalar **)&diagA));
23279566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(offdiagV, &offdiagA));
23289566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&diagV));
23299566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&offdiagV));
23309566063dSJacob Faibussowitsch   PetscCall(PetscFree2(diagIdx, offdiagIdx));
23313ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2332c87e5d42SMatthew Knepley }
2333c87e5d42SMatthew Knepley 
2334ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetRowMin_MPIAIJ(Mat A, Vec v, PetscInt idx[])
2335d71ae5a4SJacob Faibussowitsch {
233603bc72f1SMatthew Knepley   Mat_MPIAIJ        *mat = (Mat_MPIAIJ *)A->data;
2337fa213d2fSHong Zhang   PetscInt           m = A->rmap->n, n = A->cmap->n;
2338fa213d2fSHong Zhang   PetscInt           cstart = A->cmap->rstart, cend = A->cmap->rend;
233903bc72f1SMatthew Knepley   PetscInt          *cmap = mat->garray;
234003bc72f1SMatthew Knepley   PetscInt          *diagIdx, *offdiagIdx;
234103bc72f1SMatthew Knepley   Vec                diagV, offdiagV;
2342ce496241SStefano Zampini   PetscScalar       *a, *diagA, *offdiagA;
2343ce496241SStefano Zampini   const PetscScalar *ba, *bav;
2344fa213d2fSHong Zhang   PetscInt           r, j, col, ncols, *bi, *bj;
2345fa213d2fSHong Zhang   Mat                B = mat->B;
2346fa213d2fSHong Zhang   Mat_SeqAIJ        *b = (Mat_SeqAIJ *)B->data;
234703bc72f1SMatthew Knepley 
234803bc72f1SMatthew Knepley   PetscFunctionBegin;
2349fa213d2fSHong Zhang   /* When a process holds entire A and other processes have no entry */
2350fa213d2fSHong Zhang   if (A->cmap->N == n) {
23519566063dSJacob Faibussowitsch     PetscCall(VecGetArrayWrite(v, &diagA));
23529566063dSJacob Faibussowitsch     PetscCall(VecCreateSeqWithArray(PETSC_COMM_SELF, 1, m, diagA, &diagV));
23539566063dSJacob Faibussowitsch     PetscCall(MatGetRowMin(mat->A, diagV, idx));
23549566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&diagV));
23559566063dSJacob Faibussowitsch     PetscCall(VecRestoreArrayWrite(v, &diagA));
23563ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
2357fa213d2fSHong Zhang   } else if (n == 0) {
2358fa213d2fSHong Zhang     if (m) {
23599566063dSJacob Faibussowitsch       PetscCall(VecGetArrayWrite(v, &a));
23609371c9d4SSatish Balay       for (r = 0; r < m; r++) {
23619371c9d4SSatish Balay         a[r] = PETSC_MAX_REAL;
23629371c9d4SSatish Balay         if (idx) idx[r] = -1;
23639371c9d4SSatish Balay       }
23649566063dSJacob Faibussowitsch       PetscCall(VecRestoreArrayWrite(v, &a));
2365fa213d2fSHong Zhang     }
23663ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
2367fa213d2fSHong Zhang   }
2368fa213d2fSHong Zhang 
23699566063dSJacob Faibussowitsch   PetscCall(PetscCalloc2(m, &diagIdx, m, &offdiagIdx));
23709566063dSJacob Faibussowitsch   PetscCall(VecCreateSeq(PETSC_COMM_SELF, m, &diagV));
23719566063dSJacob Faibussowitsch   PetscCall(VecCreateSeq(PETSC_COMM_SELF, m, &offdiagV));
23729566063dSJacob Faibussowitsch   PetscCall(MatGetRowMin(mat->A, diagV, diagIdx));
2373fa213d2fSHong Zhang 
2374fa213d2fSHong Zhang   /* Get offdiagIdx[] for implicit 0.0 */
23759566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(B, &bav));
2376ce496241SStefano Zampini   ba = bav;
2377fa213d2fSHong Zhang   bi = b->i;
2378fa213d2fSHong Zhang   bj = b->j;
23799566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(offdiagV, &offdiagA));
2380fa213d2fSHong Zhang   for (r = 0; r < m; r++) {
2381fa213d2fSHong Zhang     ncols = bi[r + 1] - bi[r];
2382fa213d2fSHong Zhang     if (ncols == A->cmap->N - n) { /* Brow is dense */
23839371c9d4SSatish Balay       offdiagA[r]   = *ba;
23849371c9d4SSatish Balay       offdiagIdx[r] = cmap[0];
2385fa213d2fSHong Zhang     } else { /* Brow is sparse so already KNOW maximum is 0.0 or higher */
2386fa213d2fSHong Zhang       offdiagA[r] = 0.0;
2387fa213d2fSHong Zhang 
2388fa213d2fSHong Zhang       /* Find first hole in the cmap */
2389fa213d2fSHong Zhang       for (j = 0; j < ncols; j++) {
2390fa213d2fSHong Zhang         col = cmap[bj[j]]; /* global column number = cmap[B column number] */
2391fa213d2fSHong Zhang         if (col > j && j < cstart) {
2392fa213d2fSHong Zhang           offdiagIdx[r] = j; /* global column number of first implicit 0.0 */
2393fa213d2fSHong Zhang           break;
2394fa213d2fSHong Zhang         } else if (col > j + n && j >= cstart) {
2395fa213d2fSHong Zhang           offdiagIdx[r] = j + n; /* global column number of first implicit 0.0 */
2396fa213d2fSHong Zhang           break;
2397fa213d2fSHong Zhang         }
2398fa213d2fSHong Zhang       }
23994e879edeSHong Zhang       if (j == ncols && ncols < A->cmap->N - n) {
2400fa213d2fSHong Zhang         /* a hole is outside compressed Bcols */
2401fa213d2fSHong Zhang         if (ncols == 0) {
2402fa213d2fSHong Zhang           if (cstart) {
2403fa213d2fSHong Zhang             offdiagIdx[r] = 0;
2404fa213d2fSHong Zhang           } else offdiagIdx[r] = cend;
2405fa213d2fSHong Zhang         } else { /* ncols > 0 */
2406fa213d2fSHong Zhang           offdiagIdx[r] = cmap[ncols - 1] + 1;
2407fa213d2fSHong Zhang           if (offdiagIdx[r] == cstart) offdiagIdx[r] += n;
2408fa213d2fSHong Zhang         }
2409fa213d2fSHong Zhang       }
2410fa213d2fSHong Zhang     }
2411fa213d2fSHong Zhang 
2412fa213d2fSHong Zhang     for (j = 0; j < ncols; j++) {
24139371c9d4SSatish Balay       if (PetscRealPart(offdiagA[r]) > PetscRealPart(*ba)) {
24149371c9d4SSatish Balay         offdiagA[r]   = *ba;
24159371c9d4SSatish Balay         offdiagIdx[r] = cmap[*bj];
24169371c9d4SSatish Balay       }
24179371c9d4SSatish Balay       ba++;
24189371c9d4SSatish Balay       bj++;
2419fa213d2fSHong Zhang     }
2420fa213d2fSHong Zhang   }
2421fa213d2fSHong Zhang 
24229566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(v, &a));
24239566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(diagV, (const PetscScalar **)&diagA));
2424fa213d2fSHong Zhang   for (r = 0; r < m; ++r) {
2425fa213d2fSHong Zhang     if (PetscRealPart(diagA[r]) < PetscRealPart(offdiagA[r])) {
242603bc72f1SMatthew Knepley       a[r] = diagA[r];
2427fa213d2fSHong Zhang       if (idx) idx[r] = cstart + diagIdx[r];
2428fa213d2fSHong Zhang     } else if (PetscRealPart(diagA[r]) == PetscRealPart(offdiagA[r])) {
2429fa213d2fSHong Zhang       a[r] = diagA[r];
2430fa213d2fSHong Zhang       if (idx) {
2431fa213d2fSHong Zhang         if (cstart + diagIdx[r] <= offdiagIdx[r]) {
243203bc72f1SMatthew Knepley           idx[r] = cstart + diagIdx[r];
2433fa213d2fSHong Zhang         } else idx[r] = offdiagIdx[r];
2434fa213d2fSHong Zhang       }
243503bc72f1SMatthew Knepley     } else {
243603bc72f1SMatthew Knepley       a[r] = offdiagA[r];
2437fa213d2fSHong Zhang       if (idx) idx[r] = offdiagIdx[r];
243803bc72f1SMatthew Knepley     }
243903bc72f1SMatthew Knepley   }
24409566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(B, &bav));
24419566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(v, &a));
24429566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(diagV, (const PetscScalar **)&diagA));
24439566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(offdiagV, &offdiagA));
24449566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&diagV));
24459566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&offdiagV));
24469566063dSJacob Faibussowitsch   PetscCall(PetscFree2(diagIdx, offdiagIdx));
24473ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
244803bc72f1SMatthew Knepley }
244903bc72f1SMatthew Knepley 
2450ba38deedSJacob Faibussowitsch static PetscErrorCode MatGetRowMax_MPIAIJ(Mat A, Vec v, PetscInt idx[])
2451d71ae5a4SJacob Faibussowitsch {
2452c87e5d42SMatthew Knepley   Mat_MPIAIJ        *mat = (Mat_MPIAIJ *)A->data;
24531a254869SHong Zhang   PetscInt           m = A->rmap->n, n = A->cmap->n;
24541a254869SHong Zhang   PetscInt           cstart = A->cmap->rstart, cend = A->cmap->rend;
2455c87e5d42SMatthew Knepley   PetscInt          *cmap = mat->garray;
2456c87e5d42SMatthew Knepley   PetscInt          *diagIdx, *offdiagIdx;
2457c87e5d42SMatthew Knepley   Vec                diagV, offdiagV;
2458ce496241SStefano Zampini   PetscScalar       *a, *diagA, *offdiagA;
2459ce496241SStefano Zampini   const PetscScalar *ba, *bav;
24601a254869SHong Zhang   PetscInt           r, j, col, ncols, *bi, *bj;
24611a254869SHong Zhang   Mat                B = mat->B;
24621a254869SHong Zhang   Mat_SeqAIJ        *b = (Mat_SeqAIJ *)B->data;
2463c87e5d42SMatthew Knepley 
2464c87e5d42SMatthew Knepley   PetscFunctionBegin;
24651a254869SHong Zhang   /* When a process holds entire A and other processes have no entry */
24661a254869SHong Zhang   if (A->cmap->N == n) {
24679566063dSJacob Faibussowitsch     PetscCall(VecGetArrayWrite(v, &diagA));
24689566063dSJacob Faibussowitsch     PetscCall(VecCreateSeqWithArray(PETSC_COMM_SELF, 1, m, diagA, &diagV));
24699566063dSJacob Faibussowitsch     PetscCall(MatGetRowMax(mat->A, diagV, idx));
24709566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&diagV));
24719566063dSJacob Faibussowitsch     PetscCall(VecRestoreArrayWrite(v, &diagA));
24723ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
24731a254869SHong Zhang   } else if (n == 0) {
24741a254869SHong Zhang     if (m) {
24759566063dSJacob Faibussowitsch       PetscCall(VecGetArrayWrite(v, &a));
24769371c9d4SSatish Balay       for (r = 0; r < m; r++) {
24779371c9d4SSatish Balay         a[r] = PETSC_MIN_REAL;
24789371c9d4SSatish Balay         if (idx) idx[r] = -1;
24799371c9d4SSatish Balay       }
24809566063dSJacob Faibussowitsch       PetscCall(VecRestoreArrayWrite(v, &a));
24811a254869SHong Zhang     }
24823ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
24831a254869SHong Zhang   }
24841a254869SHong Zhang 
24859566063dSJacob Faibussowitsch   PetscCall(PetscMalloc2(m, &diagIdx, m, &offdiagIdx));
24869566063dSJacob Faibussowitsch   PetscCall(VecCreateSeq(PETSC_COMM_SELF, m, &diagV));
24879566063dSJacob Faibussowitsch   PetscCall(VecCreateSeq(PETSC_COMM_SELF, m, &offdiagV));
24889566063dSJacob Faibussowitsch   PetscCall(MatGetRowMax(mat->A, diagV, diagIdx));
24891a254869SHong Zhang 
24901a254869SHong Zhang   /* Get offdiagIdx[] for implicit 0.0 */
24919566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(B, &bav));
2492ce496241SStefano Zampini   ba = bav;
24931a254869SHong Zhang   bi = b->i;
24941a254869SHong Zhang   bj = b->j;
24959566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(offdiagV, &offdiagA));
24961a254869SHong Zhang   for (r = 0; r < m; r++) {
24971a254869SHong Zhang     ncols = bi[r + 1] - bi[r];
24981a254869SHong Zhang     if (ncols == A->cmap->N - n) { /* Brow is dense */
24999371c9d4SSatish Balay       offdiagA[r]   = *ba;
25009371c9d4SSatish Balay       offdiagIdx[r] = cmap[0];
25011a254869SHong Zhang     } else { /* Brow is sparse so already KNOW maximum is 0.0 or higher */
25021a254869SHong Zhang       offdiagA[r] = 0.0;
25031a254869SHong Zhang 
25041a254869SHong Zhang       /* Find first hole in the cmap */
25051a254869SHong Zhang       for (j = 0; j < ncols; j++) {
25061a254869SHong Zhang         col = cmap[bj[j]]; /* global column number = cmap[B column number] */
25071a254869SHong Zhang         if (col > j && j < cstart) {
25081a254869SHong Zhang           offdiagIdx[r] = j; /* global column number of first implicit 0.0 */
25091a254869SHong Zhang           break;
25101a254869SHong Zhang         } else if (col > j + n && j >= cstart) {
25111a254869SHong Zhang           offdiagIdx[r] = j + n; /* global column number of first implicit 0.0 */
25121a254869SHong Zhang           break;
25131a254869SHong Zhang         }
25141a254869SHong Zhang       }
25154e879edeSHong Zhang       if (j == ncols && ncols < A->cmap->N - n) {
25161a254869SHong Zhang         /* a hole is outside compressed Bcols */
25171a254869SHong Zhang         if (ncols == 0) {
25181a254869SHong Zhang           if (cstart) {
25191a254869SHong Zhang             offdiagIdx[r] = 0;
25201a254869SHong Zhang           } else offdiagIdx[r] = cend;
25211a254869SHong Zhang         } else { /* ncols > 0 */
25221a254869SHong Zhang           offdiagIdx[r] = cmap[ncols - 1] + 1;
25231a254869SHong Zhang           if (offdiagIdx[r] == cstart) offdiagIdx[r] += n;
25241a254869SHong Zhang         }
25251a254869SHong Zhang       }
25261a254869SHong Zhang     }
25271a254869SHong Zhang 
25281a254869SHong Zhang     for (j = 0; j < ncols; j++) {
25299371c9d4SSatish Balay       if (PetscRealPart(offdiagA[r]) < PetscRealPart(*ba)) {
25309371c9d4SSatish Balay         offdiagA[r]   = *ba;
25319371c9d4SSatish Balay         offdiagIdx[r] = cmap[*bj];
25329371c9d4SSatish Balay       }
25339371c9d4SSatish Balay       ba++;
25349371c9d4SSatish Balay       bj++;
25351a254869SHong Zhang     }
25361a254869SHong Zhang   }
25371a254869SHong Zhang 
25389566063dSJacob Faibussowitsch   PetscCall(VecGetArrayWrite(v, &a));
25399566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(diagV, (const PetscScalar **)&diagA));
25401a254869SHong Zhang   for (r = 0; r < m; ++r) {
25411a254869SHong Zhang     if (PetscRealPart(diagA[r]) > PetscRealPart(offdiagA[r])) {
2542c87e5d42SMatthew Knepley       a[r] = diagA[r];
25431a254869SHong Zhang       if (idx) idx[r] = cstart + diagIdx[r];
25441a254869SHong Zhang     } else if (PetscRealPart(diagA[r]) == PetscRealPart(offdiagA[r])) {
25451a254869SHong Zhang       a[r] = diagA[r];
25461a254869SHong Zhang       if (idx) {
25471a254869SHong Zhang         if (cstart + diagIdx[r] <= offdiagIdx[r]) {
2548c87e5d42SMatthew Knepley           idx[r] = cstart + diagIdx[r];
25491a254869SHong Zhang         } else idx[r] = offdiagIdx[r];
25501a254869SHong Zhang       }
2551c87e5d42SMatthew Knepley     } else {
2552c87e5d42SMatthew Knepley       a[r] = offdiagA[r];
25531a254869SHong Zhang       if (idx) idx[r] = offdiagIdx[r];
2554c87e5d42SMatthew Knepley     }
2555c87e5d42SMatthew Knepley   }
25569566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(B, &bav));
25579566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(v, &a));
25589566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(diagV, (const PetscScalar **)&diagA));
25599566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayWrite(offdiagV, &offdiagA));
25609566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&diagV));
25619566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&offdiagV));
25629566063dSJacob Faibussowitsch   PetscCall(PetscFree2(diagIdx, offdiagIdx));
25633ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2564c87e5d42SMatthew Knepley }
2565c87e5d42SMatthew Knepley 
2566d71ae5a4SJacob Faibussowitsch PetscErrorCode MatGetSeqNonzeroStructure_MPIAIJ(Mat mat, Mat *newmat)
2567d71ae5a4SJacob Faibussowitsch {
2568f6d58c54SBarry Smith   Mat *dummy;
25695494a064SHong Zhang 
25705494a064SHong Zhang   PetscFunctionBegin;
25719566063dSJacob Faibussowitsch   PetscCall(MatCreateSubMatrix_MPIAIJ_All(mat, MAT_DO_NOT_GET_VALUES, MAT_INITIAL_MATRIX, &dummy));
2572f6d58c54SBarry Smith   *newmat = *dummy;
25739566063dSJacob Faibussowitsch   PetscCall(PetscFree(dummy));
25743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
25755494a064SHong Zhang }
25765494a064SHong Zhang 
2577ba38deedSJacob Faibussowitsch static PetscErrorCode MatInvertBlockDiagonal_MPIAIJ(Mat A, const PetscScalar **values)
2578d71ae5a4SJacob Faibussowitsch {
2579bbead8a2SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
2580bbead8a2SBarry Smith 
2581bbead8a2SBarry Smith   PetscFunctionBegin;
25829566063dSJacob Faibussowitsch   PetscCall(MatInvertBlockDiagonal(a->A, values));
25837b6c816cSBarry Smith   A->factorerrortype = a->A->factorerrortype;
25843ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2585bbead8a2SBarry Smith }
2586bbead8a2SBarry Smith 
2587d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatSetRandom_MPIAIJ(Mat x, PetscRandom rctx)
2588d71ae5a4SJacob Faibussowitsch {
258973a71a0fSBarry Smith   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)x->data;
259073a71a0fSBarry Smith 
259173a71a0fSBarry Smith   PetscFunctionBegin;
259208401ef6SPierre Jolivet   PetscCheck(x->assembled || x->preallocated, PetscObjectComm((PetscObject)x), PETSC_ERR_ARG_WRONGSTATE, "MatSetRandom on an unassembled and unpreallocated MATMPIAIJ is not allowed");
25939566063dSJacob Faibussowitsch   PetscCall(MatSetRandom(aij->A, rctx));
2594679944adSJunchao Zhang   if (x->assembled) {
25959566063dSJacob Faibussowitsch     PetscCall(MatSetRandom(aij->B, rctx));
2596679944adSJunchao Zhang   } else {
25979566063dSJacob Faibussowitsch     PetscCall(MatSetRandomSkipColumnRange_SeqAIJ_Private(aij->B, x->cmap->rstart, x->cmap->rend, rctx));
2598679944adSJunchao Zhang   }
25999566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(x, MAT_FINAL_ASSEMBLY));
26009566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(x, MAT_FINAL_ASSEMBLY));
26013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
260273a71a0fSBarry Smith }
2603bbead8a2SBarry Smith 
2604ba38deedSJacob Faibussowitsch static PetscErrorCode MatMPIAIJSetUseScalableIncreaseOverlap_MPIAIJ(Mat A, PetscBool sc)
2605d71ae5a4SJacob Faibussowitsch {
2606b1b1104fSBarry Smith   PetscFunctionBegin;
2607b1b1104fSBarry Smith   if (sc) A->ops->increaseoverlap = MatIncreaseOverlap_MPIAIJ_Scalable;
2608b1b1104fSBarry Smith   else A->ops->increaseoverlap = MatIncreaseOverlap_MPIAIJ;
26093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2610b1b1104fSBarry Smith }
2611b1b1104fSBarry Smith 
2612b1b1104fSBarry Smith /*@
2613f2afee66SBarry Smith   MatMPIAIJGetNumberNonzeros - gets the number of nonzeros in the matrix on this MPI rank
2614f2afee66SBarry Smith 
26152ef1f0ffSBarry Smith   Not Collective
2616f2afee66SBarry Smith 
2617f2afee66SBarry Smith   Input Parameter:
2618f2afee66SBarry Smith . A - the matrix
2619f2afee66SBarry Smith 
2620f2afee66SBarry Smith   Output Parameter:
2621f2afee66SBarry Smith . nz - the number of nonzeros
2622f2afee66SBarry Smith 
2623f2afee66SBarry Smith   Level: advanced
2624f2afee66SBarry Smith 
2625fe59aa6dSJacob Faibussowitsch .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`
2626f2afee66SBarry Smith @*/
2627d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJGetNumberNonzeros(Mat A, PetscCount *nz)
2628d71ae5a4SJacob Faibussowitsch {
2629f2afee66SBarry Smith   Mat_MPIAIJ *maij = (Mat_MPIAIJ *)A->data;
2630f2afee66SBarry Smith   Mat_SeqAIJ *aaij = (Mat_SeqAIJ *)maij->A->data, *baij = (Mat_SeqAIJ *)maij->B->data;
2631dfebb78cSStefano Zampini   PetscBool   isaij;
2632f2afee66SBarry Smith 
2633f2afee66SBarry Smith   PetscFunctionBegin;
2634dfebb78cSStefano Zampini   PetscCall(PetscObjectBaseTypeCompare((PetscObject)A, MATMPIAIJ, &isaij));
2635dfebb78cSStefano Zampini   PetscCheck(isaij, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "Not for type %s", ((PetscObject)A)->type_name);
2636f2afee66SBarry Smith   *nz = aaij->i[A->rmap->n] + baij->i[A->rmap->n];
26373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2638f2afee66SBarry Smith }
2639f2afee66SBarry Smith 
2640f2afee66SBarry Smith /*@
2641b1b1104fSBarry Smith   MatMPIAIJSetUseScalableIncreaseOverlap - Determine if the matrix uses a scalable algorithm to compute the overlap
2642b1b1104fSBarry Smith 
2643c3339decSBarry Smith   Collective
2644b1b1104fSBarry Smith 
2645b1b1104fSBarry Smith   Input Parameters:
2646b1b1104fSBarry Smith + A  - the matrix
264711a5261eSBarry Smith - sc - `PETSC_TRUE` indicates use the scalable algorithm (default is not to use the scalable algorithm)
2648b1b1104fSBarry Smith 
264996a0c994SBarry Smith   Level: advanced
265096a0c994SBarry Smith 
2651fe59aa6dSJacob Faibussowitsch .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`
2652b1b1104fSBarry Smith @*/
2653d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJSetUseScalableIncreaseOverlap(Mat A, PetscBool sc)
2654d71ae5a4SJacob Faibussowitsch {
2655b1b1104fSBarry Smith   PetscFunctionBegin;
2656cac4c232SBarry Smith   PetscTryMethod(A, "MatMPIAIJSetUseScalableIncreaseOverlap_C", (Mat, PetscBool), (A, sc));
26573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2658b1b1104fSBarry Smith }
2659b1b1104fSBarry Smith 
2660ce78bad3SBarry Smith PetscErrorCode MatSetFromOptions_MPIAIJ(Mat A, PetscOptionItems PetscOptionsObject)
2661d71ae5a4SJacob Faibussowitsch {
2662b1b1104fSBarry Smith   PetscBool sc = PETSC_FALSE, flg;
2663b1b1104fSBarry Smith 
2664b1b1104fSBarry Smith   PetscFunctionBegin;
2665d0609cedSBarry Smith   PetscOptionsHeadBegin(PetscOptionsObject, "MPIAIJ options");
2666b1b1104fSBarry Smith   if (A->ops->increaseoverlap == MatIncreaseOverlap_MPIAIJ_Scalable) sc = PETSC_TRUE;
26679566063dSJacob Faibussowitsch   PetscCall(PetscOptionsBool("-mat_increase_overlap_scalable", "Use a scalable algorithm to compute the overlap", "MatIncreaseOverlap", sc, &sc, &flg));
26681baa6e33SBarry Smith   if (flg) PetscCall(MatMPIAIJSetUseScalableIncreaseOverlap(A, sc));
2669d0609cedSBarry Smith   PetscOptionsHeadEnd();
26703ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2671b1b1104fSBarry Smith }
2672b1b1104fSBarry Smith 
2673ba38deedSJacob Faibussowitsch static PetscErrorCode MatShift_MPIAIJ(Mat Y, PetscScalar a)
2674d71ae5a4SJacob Faibussowitsch {
26757d68702bSBarry Smith   Mat_MPIAIJ *maij = (Mat_MPIAIJ *)Y->data;
2676c5e4d11fSDmitry Karpeev   Mat_SeqAIJ *aij  = (Mat_SeqAIJ *)maij->A->data;
26777d68702bSBarry Smith 
26787d68702bSBarry Smith   PetscFunctionBegin;
2679c5e4d11fSDmitry Karpeev   if (!Y->preallocated) {
26809566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(Y, 1, NULL, 0, NULL));
26815519a089SJose E. Roman   } else if (!aij->nz) { /* It does not matter if diagonals of Y only partially lie in maij->A. We just need an estimated preallocation. */
2682b83222d8SBarry Smith     PetscInt nonew = aij->nonew;
26839566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJSetPreallocation(maij->A, 1, NULL));
2684b83222d8SBarry Smith     aij->nonew = nonew;
26857d68702bSBarry Smith   }
26869566063dSJacob Faibussowitsch   PetscCall(MatShift_Basic(Y, a));
26873ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
26887d68702bSBarry Smith }
26897d68702bSBarry Smith 
2690ba38deedSJacob Faibussowitsch static PetscErrorCode MatMissingDiagonal_MPIAIJ(Mat A, PetscBool *missing, PetscInt *d)
2691d71ae5a4SJacob Faibussowitsch {
26923b49f96aSBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
26933b49f96aSBarry Smith 
26943b49f96aSBarry Smith   PetscFunctionBegin;
269508401ef6SPierre Jolivet   PetscCheck(A->rmap->n == A->cmap->n, PETSC_COMM_SELF, PETSC_ERR_SUP, "Only works for square matrices");
26969566063dSJacob Faibussowitsch   PetscCall(MatMissingDiagonal(a->A, missing, d));
26973b49f96aSBarry Smith   if (d) {
26983b49f96aSBarry Smith     PetscInt rstart;
26999566063dSJacob Faibussowitsch     PetscCall(MatGetOwnershipRange(A, &rstart, NULL));
27003b49f96aSBarry Smith     *d += rstart;
27013b49f96aSBarry Smith   }
27023ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
27033b49f96aSBarry Smith }
27043b49f96aSBarry Smith 
2705ba38deedSJacob Faibussowitsch static PetscErrorCode MatInvertVariableBlockDiagonal_MPIAIJ(Mat A, PetscInt nblocks, const PetscInt *bsizes, PetscScalar *diag)
2706d71ae5a4SJacob Faibussowitsch {
2707a8ee9fb5SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
2708a8ee9fb5SBarry Smith 
2709a8ee9fb5SBarry Smith   PetscFunctionBegin;
27109566063dSJacob Faibussowitsch   PetscCall(MatInvertVariableBlockDiagonal(a->A, nblocks, bsizes, diag));
27113ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2712a8ee9fb5SBarry Smith }
27133b49f96aSBarry Smith 
271458c11ad4SPierre Jolivet static PetscErrorCode MatEliminateZeros_MPIAIJ(Mat A, PetscBool keep)
2715dec0b466SHong Zhang {
2716dec0b466SHong Zhang   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
2717dec0b466SHong Zhang 
2718dec0b466SHong Zhang   PetscFunctionBegin;
271958c11ad4SPierre Jolivet   PetscCall(MatEliminateZeros_SeqAIJ(a->A, keep));        // possibly keep zero diagonal coefficients
272058c11ad4SPierre Jolivet   PetscCall(MatEliminateZeros_SeqAIJ(a->B, PETSC_FALSE)); // never keep zero diagonal coefficients
27213ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2722dec0b466SHong Zhang }
2723dec0b466SHong Zhang 
2724cda55fadSBarry Smith static struct _MatOps MatOps_Values = {MatSetValues_MPIAIJ,
2725cda55fadSBarry Smith                                        MatGetRow_MPIAIJ,
2726cda55fadSBarry Smith                                        MatRestoreRow_MPIAIJ,
2727cda55fadSBarry Smith                                        MatMult_MPIAIJ,
272897304618SKris Buschelman                                        /* 4*/ MatMultAdd_MPIAIJ,
27297c922b88SBarry Smith                                        MatMultTranspose_MPIAIJ,
27307c922b88SBarry Smith                                        MatMultTransposeAdd_MPIAIJ,
2731f4259b30SLisandro Dalcin                                        NULL,
2732f4259b30SLisandro Dalcin                                        NULL,
2733f4259b30SLisandro Dalcin                                        NULL,
2734f4259b30SLisandro Dalcin                                        /*10*/ NULL,
2735f4259b30SLisandro Dalcin                                        NULL,
2736f4259b30SLisandro Dalcin                                        NULL,
273741f059aeSBarry Smith                                        MatSOR_MPIAIJ,
2738b7c46309SBarry Smith                                        MatTranspose_MPIAIJ,
273997304618SKris Buschelman                                        /*15*/ MatGetInfo_MPIAIJ,
2740cda55fadSBarry Smith                                        MatEqual_MPIAIJ,
2741cda55fadSBarry Smith                                        MatGetDiagonal_MPIAIJ,
2742cda55fadSBarry Smith                                        MatDiagonalScale_MPIAIJ,
2743cda55fadSBarry Smith                                        MatNorm_MPIAIJ,
274497304618SKris Buschelman                                        /*20*/ MatAssemblyBegin_MPIAIJ,
2745cda55fadSBarry Smith                                        MatAssemblyEnd_MPIAIJ,
2746cda55fadSBarry Smith                                        MatSetOption_MPIAIJ,
2747cda55fadSBarry Smith                                        MatZeroEntries_MPIAIJ,
2748d519adbfSMatthew Knepley                                        /*24*/ MatZeroRows_MPIAIJ,
2749f4259b30SLisandro Dalcin                                        NULL,
2750f4259b30SLisandro Dalcin                                        NULL,
2751f4259b30SLisandro Dalcin                                        NULL,
2752f4259b30SLisandro Dalcin                                        NULL,
275326cec326SBarry Smith                                        /*29*/ MatSetUp_MPI_Hash,
2754f4259b30SLisandro Dalcin                                        NULL,
2755f4259b30SLisandro Dalcin                                        NULL,
2756a5b7ff6bSBarry Smith                                        MatGetDiagonalBlock_MPIAIJ,
2757f4259b30SLisandro Dalcin                                        NULL,
2758d519adbfSMatthew Knepley                                        /*34*/ MatDuplicate_MPIAIJ,
2759f4259b30SLisandro Dalcin                                        NULL,
2760f4259b30SLisandro Dalcin                                        NULL,
2761f4259b30SLisandro Dalcin                                        NULL,
2762f4259b30SLisandro Dalcin                                        NULL,
2763d519adbfSMatthew Knepley                                        /*39*/ MatAXPY_MPIAIJ,
27647dae84e0SHong Zhang                                        MatCreateSubMatrices_MPIAIJ,
2765cda55fadSBarry Smith                                        MatIncreaseOverlap_MPIAIJ,
2766cda55fadSBarry Smith                                        MatGetValues_MPIAIJ,
2767cb5b572fSBarry Smith                                        MatCopy_MPIAIJ,
2768d519adbfSMatthew Knepley                                        /*44*/ MatGetRowMax_MPIAIJ,
2769cda55fadSBarry Smith                                        MatScale_MPIAIJ,
27707d68702bSBarry Smith                                        MatShift_MPIAIJ,
277199e65526SBarry Smith                                        MatDiagonalSet_MPIAIJ,
2772564f14d6SBarry Smith                                        MatZeroRowsColumns_MPIAIJ,
277373a71a0fSBarry Smith                                        /*49*/ MatSetRandom_MPIAIJ,
27748a9c020eSBarry Smith                                        MatGetRowIJ_MPIAIJ,
27758a9c020eSBarry Smith                                        MatRestoreRowIJ_MPIAIJ,
2776f4259b30SLisandro Dalcin                                        NULL,
2777f4259b30SLisandro Dalcin                                        NULL,
277893dfae19SHong Zhang                                        /*54*/ MatFDColoringCreate_MPIXAIJ,
2779f4259b30SLisandro Dalcin                                        NULL,
2780cda55fadSBarry Smith                                        MatSetUnfactored_MPIAIJ,
278172e6a0cfSJed Brown                                        MatPermute_MPIAIJ,
2782f4259b30SLisandro Dalcin                                        NULL,
27837dae84e0SHong Zhang                                        /*59*/ MatCreateSubMatrix_MPIAIJ,
2784e03a110bSBarry Smith                                        MatDestroy_MPIAIJ,
2785e03a110bSBarry Smith                                        MatView_MPIAIJ,
2786f4259b30SLisandro Dalcin                                        NULL,
2787f4259b30SLisandro Dalcin                                        NULL,
2788f4259b30SLisandro Dalcin                                        /*64*/ NULL,
2789f996eeb8SHong Zhang                                        MatMatMatMultNumeric_MPIAIJ_MPIAIJ_MPIAIJ,
2790f4259b30SLisandro Dalcin                                        NULL,
2791f4259b30SLisandro Dalcin                                        NULL,
2792f4259b30SLisandro Dalcin                                        NULL,
2793d519adbfSMatthew Knepley                                        /*69*/ MatGetRowMaxAbs_MPIAIJ,
2794c87e5d42SMatthew Knepley                                        MatGetRowMinAbs_MPIAIJ,
2795f4259b30SLisandro Dalcin                                        NULL,
2796f4259b30SLisandro Dalcin                                        NULL,
2797f4259b30SLisandro Dalcin                                        NULL,
2798f4259b30SLisandro Dalcin                                        NULL,
27993acb8795SBarry Smith                                        /*75*/ MatFDColoringApply_AIJ,
2800b1b1104fSBarry Smith                                        MatSetFromOptions_MPIAIJ,
2801f4259b30SLisandro Dalcin                                        NULL,
2802f4259b30SLisandro Dalcin                                        NULL,
2803f1f41ecbSJed Brown                                        MatFindZeroDiagonals_MPIAIJ,
2804f4259b30SLisandro Dalcin                                        /*80*/ NULL,
2805f4259b30SLisandro Dalcin                                        NULL,
2806f4259b30SLisandro Dalcin                                        NULL,
28075bba2384SShri Abhyankar                                        /*83*/ MatLoad_MPIAIJ,
28086cff0a6bSPierre Jolivet                                        NULL,
2809f4259b30SLisandro Dalcin                                        NULL,
2810f4259b30SLisandro Dalcin                                        NULL,
2811f4259b30SLisandro Dalcin                                        NULL,
2812f4259b30SLisandro Dalcin                                        NULL,
2813f4259b30SLisandro Dalcin                                        /*89*/ NULL,
2814f4259b30SLisandro Dalcin                                        NULL,
281526be0446SHong Zhang                                        MatMatMultNumeric_MPIAIJ_MPIAIJ,
2816f4259b30SLisandro Dalcin                                        NULL,
2817f4259b30SLisandro Dalcin                                        NULL,
2818cf3ca8ceSHong Zhang                                        /*94*/ MatPtAPNumeric_MPIAIJ_MPIAIJ,
2819f4259b30SLisandro Dalcin                                        NULL,
2820f4259b30SLisandro Dalcin                                        NULL,
2821f4259b30SLisandro Dalcin                                        NULL,
2822b470e4b4SRichard Tran Mills                                        MatBindToCPU_MPIAIJ,
28234222ddf1SHong Zhang                                        /*99*/ MatProductSetFromOptions_MPIAIJ,
2824f4259b30SLisandro Dalcin                                        NULL,
2825f4259b30SLisandro Dalcin                                        NULL,
28262fd7e33dSBarry Smith                                        MatConjugate_MPIAIJ,
2827f4259b30SLisandro Dalcin                                        NULL,
2828d519adbfSMatthew Knepley                                        /*104*/ MatSetValuesRow_MPIAIJ,
282999cafbc1SBarry Smith                                        MatRealPart_MPIAIJ,
283069db28dcSHong Zhang                                        MatImaginaryPart_MPIAIJ,
2831f4259b30SLisandro Dalcin                                        NULL,
2832f4259b30SLisandro Dalcin                                        NULL,
2833f4259b30SLisandro Dalcin                                        /*109*/ NULL,
2834f4259b30SLisandro Dalcin                                        NULL,
28355494a064SHong Zhang                                        MatGetRowMin_MPIAIJ,
2836f4259b30SLisandro Dalcin                                        NULL,
28373b49f96aSBarry Smith                                        MatMissingDiagonal_MPIAIJ,
2838d1adec66SJed Brown                                        /*114*/ MatGetSeqNonzeroStructure_MPIAIJ,
2839f4259b30SLisandro Dalcin                                        NULL,
2840c5e4d11fSDmitry Karpeev                                        MatGetGhosts_MPIAIJ,
2841f4259b30SLisandro Dalcin                                        NULL,
2842f4259b30SLisandro Dalcin                                        NULL,
2843b215bc84SStefano Zampini                                        /*119*/ MatMultDiagonalBlock_MPIAIJ,
2844f4259b30SLisandro Dalcin                                        NULL,
2845f4259b30SLisandro Dalcin                                        NULL,
2846f4259b30SLisandro Dalcin                                        NULL,
2847b9614d88SDmitry Karpeev                                        MatGetMultiProcBlock_MPIAIJ,
2848f2c98031SJed Brown                                        /*124*/ MatFindNonzeroRows_MPIAIJ,
2849a873a8cdSSam Reynolds                                        MatGetColumnReductions_MPIAIJ,
2850bbead8a2SBarry Smith                                        MatInvertBlockDiagonal_MPIAIJ,
2851a8ee9fb5SBarry Smith                                        MatInvertVariableBlockDiagonal_MPIAIJ,
28527dae84e0SHong Zhang                                        MatCreateSubMatricesMPI_MPIAIJ,
2853f4259b30SLisandro Dalcin                                        /*129*/ NULL,
2854f4259b30SLisandro Dalcin                                        NULL,
2855f4259b30SLisandro Dalcin                                        NULL,
2856187b3c17SHong Zhang                                        MatTransposeMatMultNumeric_MPIAIJ_MPIAIJ,
2857f4259b30SLisandro Dalcin                                        NULL,
2858f4259b30SLisandro Dalcin                                        /*134*/ NULL,
2859f4259b30SLisandro Dalcin                                        NULL,
2860f4259b30SLisandro Dalcin                                        NULL,
2861f4259b30SLisandro Dalcin                                        NULL,
2862f4259b30SLisandro Dalcin                                        NULL,
286346533700Sstefano_zampini                                        /*139*/ MatSetBlockSizes_MPIAIJ,
2864f4259b30SLisandro Dalcin                                        NULL,
2865f4259b30SLisandro Dalcin                                        NULL,
28669c8f2541SHong Zhang                                        MatFDColoringSetUp_MPIXAIJ,
2867a0b6529bSBarry Smith                                        MatFindOffBlockDiagonalEntries_MPIAIJ,
28684222ddf1SHong Zhang                                        MatCreateMPIMatConcatenateSeqMat_MPIAIJ,
2869f4259b30SLisandro Dalcin                                        /*145*/ NULL,
2870f4259b30SLisandro Dalcin                                        NULL,
287172833a62Smarkadams4                                        NULL,
287272833a62Smarkadams4                                        MatCreateGraph_Simple_AIJ,
28732d776b49SBarry Smith                                        NULL,
2874dec0b466SHong Zhang                                        /*150*/ NULL,
2875eede4a3fSMark Adams                                        MatEliminateZeros_MPIAIJ,
28764cc2b5b5SPierre Jolivet                                        MatGetRowSumAbs_MPIAIJ,
287742ce410bSJunchao Zhang                                        NULL,
287842ce410bSJunchao Zhang                                        NULL,
2879fe1fc275SAlexander                                        /*155*/ NULL,
2880fe1fc275SAlexander                                        MatCopyHashToXAIJ_MPI_Hash};
288136ce4990SBarry Smith 
2882ba38deedSJacob Faibussowitsch static PetscErrorCode MatStoreValues_MPIAIJ(Mat mat)
2883d71ae5a4SJacob Faibussowitsch {
28842e8a6d31SBarry Smith   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
28852e8a6d31SBarry Smith 
28862e8a6d31SBarry Smith   PetscFunctionBegin;
28879566063dSJacob Faibussowitsch   PetscCall(MatStoreValues(aij->A));
28889566063dSJacob Faibussowitsch   PetscCall(MatStoreValues(aij->B));
28893ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
28902e8a6d31SBarry Smith }
28912e8a6d31SBarry Smith 
2892ba38deedSJacob Faibussowitsch static PetscErrorCode MatRetrieveValues_MPIAIJ(Mat mat)
2893d71ae5a4SJacob Faibussowitsch {
28942e8a6d31SBarry Smith   Mat_MPIAIJ *aij = (Mat_MPIAIJ *)mat->data;
28952e8a6d31SBarry Smith 
28962e8a6d31SBarry Smith   PetscFunctionBegin;
28979566063dSJacob Faibussowitsch   PetscCall(MatRetrieveValues(aij->A));
28989566063dSJacob Faibussowitsch   PetscCall(MatRetrieveValues(aij->B));
28993ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
29002e8a6d31SBarry Smith }
29018a729477SBarry Smith 
2902d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJSetPreallocation_MPIAIJ(Mat B, PetscInt d_nz, const PetscInt d_nnz[], PetscInt o_nz, const PetscInt o_nnz[])
2903d71ae5a4SJacob Faibussowitsch {
2904ad79cf63SBarry Smith   Mat_MPIAIJ *b = (Mat_MPIAIJ *)B->data;
29055d2a9ed1SStefano Zampini   PetscMPIInt size;
2906a23d5eceSKris Buschelman 
2907a23d5eceSKris Buschelman   PetscFunctionBegin;
2908ad79cf63SBarry Smith   if (B->hash_active) {
2909aea10558SJacob Faibussowitsch     B->ops[0]      = b->cops;
2910ad79cf63SBarry Smith     B->hash_active = PETSC_FALSE;
2911ad79cf63SBarry Smith   }
29129566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(B->rmap));
29139566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(B->cmap));
2914899cda47SBarry Smith 
2915cb7b82ddSBarry Smith #if defined(PETSC_USE_CTABLE)
2916eec179cfSJacob Faibussowitsch   PetscCall(PetscHMapIDestroy(&b->colmap));
2917cb7b82ddSBarry Smith #else
29189566063dSJacob Faibussowitsch   PetscCall(PetscFree(b->colmap));
2919cb7b82ddSBarry Smith #endif
29209566063dSJacob Faibussowitsch   PetscCall(PetscFree(b->garray));
29219566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&b->lvec));
29229566063dSJacob Faibussowitsch   PetscCall(VecScatterDestroy(&b->Mvctx));
2923cb7b82ddSBarry Smith 
29249566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(PetscObjectComm((PetscObject)B), &size));
2925c508b908SBarry Smith 
2926c508b908SBarry Smith   MatSeqXAIJGetOptions_Private(b->B);
29279566063dSJacob Faibussowitsch   PetscCall(MatDestroy(&b->B));
29289566063dSJacob Faibussowitsch   PetscCall(MatCreate(PETSC_COMM_SELF, &b->B));
29299566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(b->B, B->rmap->n, size > 1 ? B->cmap->N : 0, B->rmap->n, size > 1 ? B->cmap->N : 0));
29309566063dSJacob Faibussowitsch   PetscCall(MatSetBlockSizesFromMats(b->B, B, B));
29319566063dSJacob Faibussowitsch   PetscCall(MatSetType(b->B, MATSEQAIJ));
2932c508b908SBarry Smith   MatSeqXAIJRestoreOptions_Private(b->B);
2933cb7b82ddSBarry Smith 
2934c508b908SBarry Smith   MatSeqXAIJGetOptions_Private(b->A);
2935ad79cf63SBarry Smith   PetscCall(MatDestroy(&b->A));
29369566063dSJacob Faibussowitsch   PetscCall(MatCreate(PETSC_COMM_SELF, &b->A));
29379566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(b->A, B->rmap->n, B->cmap->n, B->rmap->n, B->cmap->n));
29389566063dSJacob Faibussowitsch   PetscCall(MatSetBlockSizesFromMats(b->A, B, B));
29399566063dSJacob Faibussowitsch   PetscCall(MatSetType(b->A, MATSEQAIJ));
2940c508b908SBarry Smith   MatSeqXAIJRestoreOptions_Private(b->A);
2941899cda47SBarry Smith 
29429566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJSetPreallocation(b->A, d_nz, d_nnz));
29439566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJSetPreallocation(b->B, o_nz, o_nnz));
2944526dfc15SBarry Smith   B->preallocated  = PETSC_TRUE;
2945cb7b82ddSBarry Smith   B->was_assembled = PETSC_FALSE;
294615001458SStefano Zampini   B->assembled     = PETSC_FALSE;
29473ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2948a23d5eceSKris Buschelman }
2949a23d5eceSKris Buschelman 
2950ba38deedSJacob Faibussowitsch static PetscErrorCode MatResetPreallocation_MPIAIJ(Mat B)
2951d71ae5a4SJacob Faibussowitsch {
2952ad79cf63SBarry Smith   Mat_MPIAIJ *b = (Mat_MPIAIJ *)B->data;
29534c51d546SAlexander   PetscBool   ondiagreset, offdiagreset, memoryreset;
2954846b4da1SFande Kong 
2955846b4da1SFande Kong   PetscFunctionBegin;
2956846b4da1SFande Kong   PetscValidHeaderSpecific(B, MAT_CLASSID, 1);
29574c51d546SAlexander   PetscCheck(B->insertmode == NOT_SET_VALUES, PETSC_COMM_SELF, PETSC_ERR_SUP, "Cannot reset preallocation after setting some values but not yet calling MatAssemblyBegin()/MatAssemblyEnd()");
29584c51d546SAlexander   if (B->num_ass == 0) PetscFunctionReturn(PETSC_SUCCESS);
29594c51d546SAlexander 
29604c51d546SAlexander   PetscCall(MatResetPreallocation_SeqAIJ_Private(b->A, &ondiagreset));
29614c51d546SAlexander   PetscCall(MatResetPreallocation_SeqAIJ_Private(b->B, &offdiagreset));
29624c51d546SAlexander   memoryreset = (PetscBool)(ondiagreset || offdiagreset);
29634c51d546SAlexander   PetscCallMPI(MPIU_Allreduce(MPI_IN_PLACE, &memoryreset, 1, MPIU_BOOL, MPI_LOR, PetscObjectComm((PetscObject)B)));
29644c51d546SAlexander   if (!memoryreset) PetscFunctionReturn(PETSC_SUCCESS);
29654c51d546SAlexander 
29669566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(B->rmap));
29679566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(B->cmap));
29684c51d546SAlexander   PetscCheck(B->assembled || B->was_assembled, PetscObjectComm((PetscObject)B), PETSC_ERR_ARG_WRONGSTATE, "Should not need to reset preallocation if the matrix was never assembled");
29694c51d546SAlexander   PetscCall(MatDisAssemble_MPIAIJ(B, PETSC_TRUE));
29709566063dSJacob Faibussowitsch   PetscCall(VecScatterDestroy(&b->Mvctx));
2971846b4da1SFande Kong 
2972846b4da1SFande Kong   B->preallocated  = PETSC_TRUE;
2973846b4da1SFande Kong   B->was_assembled = PETSC_FALSE;
2974846b4da1SFande Kong   B->assembled     = PETSC_FALSE;
2975b3a35320SAlex Lindsay   /* Log that the state of this object has changed; this will help guarantee that preconditioners get re-setup */
2976b3a35320SAlex Lindsay   PetscCall(PetscObjectStateIncrease((PetscObject)B));
29773ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2978846b4da1SFande Kong }
2979846b4da1SFande Kong 
2980d71ae5a4SJacob Faibussowitsch PetscErrorCode MatDuplicate_MPIAIJ(Mat matin, MatDuplicateOption cpvalues, Mat *newmat)
2981d71ae5a4SJacob Faibussowitsch {
2982d6dfbf8fSBarry Smith   Mat         mat;
2983416022c9SBarry Smith   Mat_MPIAIJ *a, *oldmat = (Mat_MPIAIJ *)matin->data;
2984d6dfbf8fSBarry Smith 
29853a40ed3dSBarry Smith   PetscFunctionBegin;
2986f4259b30SLisandro Dalcin   *newmat = NULL;
29879566063dSJacob Faibussowitsch   PetscCall(MatCreate(PetscObjectComm((PetscObject)matin), &mat));
29889566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(mat, matin->rmap->n, matin->cmap->n, matin->rmap->N, matin->cmap->N));
29899566063dSJacob Faibussowitsch   PetscCall(MatSetBlockSizesFromMats(mat, matin, matin));
29909566063dSJacob Faibussowitsch   PetscCall(MatSetType(mat, ((PetscObject)matin)->type_name));
2991273d9f13SBarry Smith   a = (Mat_MPIAIJ *)mat->data;
2992e1b6402fSHong Zhang 
2993d5f3da31SBarry Smith   mat->factortype = matin->factortype;
2994501880eeSStefano Zampini   mat->assembled  = matin->assembled;
2995e7641de0SSatish Balay   mat->insertmode = NOT_SET_VALUES;
2996d6dfbf8fSBarry Smith 
299717699dbbSLois Curfman McInnes   a->size         = oldmat->size;
299817699dbbSLois Curfman McInnes   a->rank         = oldmat->rank;
2999e7641de0SSatish Balay   a->donotstash   = oldmat->donotstash;
3000e7641de0SSatish Balay   a->roworiented  = oldmat->roworiented;
3001501880eeSStefano Zampini   a->rowindices   = NULL;
3002501880eeSStefano Zampini   a->rowvalues    = NULL;
3003bcd2baecSBarry Smith   a->getrowactive = PETSC_FALSE;
3004d6dfbf8fSBarry Smith 
30059566063dSJacob Faibussowitsch   PetscCall(PetscLayoutReference(matin->rmap, &mat->rmap));
30069566063dSJacob Faibussowitsch   PetscCall(PetscLayoutReference(matin->cmap, &mat->cmap));
3007420957c1SBarry Smith   if (matin->hash_active) {
3008420957c1SBarry Smith     PetscCall(MatSetUp(mat));
3009420957c1SBarry Smith   } else {
3010420957c1SBarry Smith     mat->preallocated = matin->preallocated;
30112ee70a88SLois Curfman McInnes     if (oldmat->colmap) {
3012aa482453SBarry Smith #if defined(PETSC_USE_CTABLE)
3013eec179cfSJacob Faibussowitsch       PetscCall(PetscHMapIDuplicate(oldmat->colmap, &a->colmap));
3014b1fc9764SSatish Balay #else
30159566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(mat->cmap->N, &a->colmap));
30169566063dSJacob Faibussowitsch       PetscCall(PetscArraycpy(a->colmap, oldmat->colmap, mat->cmap->N));
3017b1fc9764SSatish Balay #endif
3018501880eeSStefano Zampini     } else a->colmap = NULL;
30193f41c07dSBarry Smith     if (oldmat->garray) {
3020b1d57f15SBarry Smith       PetscInt len;
3021d0f46423SBarry Smith       len = oldmat->B->cmap->n;
30229566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(len + 1, &a->garray));
30239566063dSJacob Faibussowitsch       if (len) PetscCall(PetscArraycpy(a->garray, oldmat->garray, len));
3024501880eeSStefano Zampini     } else a->garray = NULL;
3025d6dfbf8fSBarry Smith 
30260de76c62SStefano Zampini     /* It may happen MatDuplicate is called with a non-assembled matrix
30270de76c62SStefano Zampini       In fact, MatDuplicate only requires the matrix to be preallocated
30280de76c62SStefano Zampini       This may happen inside a DMCreateMatrix_Shell */
3029aa624791SPierre Jolivet     if (oldmat->lvec) PetscCall(VecDuplicate(oldmat->lvec, &a->lvec));
3030cff58d65SJunchao Zhang     if (oldmat->Mvctx) {
3031cff58d65SJunchao Zhang       a->Mvctx = oldmat->Mvctx;
3032cff58d65SJunchao Zhang       PetscCall(PetscObjectReference((PetscObject)oldmat->Mvctx));
3033cff58d65SJunchao Zhang     }
30349566063dSJacob Faibussowitsch     PetscCall(MatDuplicate(oldmat->A, cpvalues, &a->A));
30359566063dSJacob Faibussowitsch     PetscCall(MatDuplicate(oldmat->B, cpvalues, &a->B));
3036420957c1SBarry Smith   }
30379566063dSJacob Faibussowitsch   PetscCall(PetscFunctionListDuplicate(((PetscObject)matin)->qlist, &((PetscObject)mat)->qlist));
30388a729477SBarry Smith   *newmat = mat;
30393ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
30408a729477SBarry Smith }
3041416022c9SBarry Smith 
3042d71ae5a4SJacob Faibussowitsch PetscErrorCode MatLoad_MPIAIJ(Mat newMat, PetscViewer viewer)
3043d71ae5a4SJacob Faibussowitsch {
304452f91c60SVaclav Hapla   PetscBool isbinary, ishdf5;
304552f91c60SVaclav Hapla 
304652f91c60SVaclav Hapla   PetscFunctionBegin;
304752f91c60SVaclav Hapla   PetscValidHeaderSpecific(newMat, MAT_CLASSID, 1);
304852f91c60SVaclav Hapla   PetscValidHeaderSpecific(viewer, PETSC_VIEWER_CLASSID, 2);
3049c27b3999SVaclav Hapla   /* force binary viewer to load .info file if it has not yet done so */
30509566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetUp(viewer));
30519566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERBINARY, &isbinary));
30529566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)viewer, PETSCVIEWERHDF5, &ishdf5));
305352f91c60SVaclav Hapla   if (isbinary) {
30549566063dSJacob Faibussowitsch     PetscCall(MatLoad_MPIAIJ_Binary(newMat, viewer));
305552f91c60SVaclav Hapla   } else if (ishdf5) {
305652f91c60SVaclav Hapla #if defined(PETSC_HAVE_HDF5)
30579566063dSJacob Faibussowitsch     PetscCall(MatLoad_AIJ_HDF5(newMat, viewer));
305852f91c60SVaclav Hapla #else
305952f91c60SVaclav Hapla     SETERRQ(PetscObjectComm((PetscObject)newMat), PETSC_ERR_SUP, "HDF5 not supported in this build.\nPlease reconfigure using --download-hdf5");
306052f91c60SVaclav Hapla #endif
306152f91c60SVaclav Hapla   } else {
306298921bdaSJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)newMat), PETSC_ERR_SUP, "Viewer type %s not yet supported for reading %s matrices", ((PetscObject)viewer)->type_name, ((PetscObject)newMat)->type_name);
306352f91c60SVaclav Hapla   }
30643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
306552f91c60SVaclav Hapla }
306652f91c60SVaclav Hapla 
3067d71ae5a4SJacob Faibussowitsch PetscErrorCode MatLoad_MPIAIJ_Binary(Mat mat, PetscViewer viewer)
3068d71ae5a4SJacob Faibussowitsch {
30693ea6fe3dSLisandro Dalcin   PetscInt     header[4], M, N, m, nz, rows, cols, sum, i;
30703ea6fe3dSLisandro Dalcin   PetscInt    *rowidxs, *colidxs;
30713ea6fe3dSLisandro Dalcin   PetscScalar *matvals;
30728fb81238SShri Abhyankar 
30738fb81238SShri Abhyankar   PetscFunctionBegin;
30749566063dSJacob Faibussowitsch   PetscCall(PetscViewerSetUp(viewer));
30758fb81238SShri Abhyankar 
30763ea6fe3dSLisandro Dalcin   /* read in matrix header */
30779566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryRead(viewer, header, 4, NULL, PETSC_INT));
307808401ef6SPierre Jolivet   PetscCheck(header[0] == MAT_FILE_CLASSID, PetscObjectComm((PetscObject)viewer), PETSC_ERR_FILE_UNEXPECTED, "Not a matrix object in file");
30799371c9d4SSatish Balay   M  = header[1];
30809371c9d4SSatish Balay   N  = header[2];
30819371c9d4SSatish Balay   nz = header[3];
308208401ef6SPierre Jolivet   PetscCheck(M >= 0, PetscObjectComm((PetscObject)viewer), PETSC_ERR_FILE_UNEXPECTED, "Matrix row size (%" PetscInt_FMT ") in file is negative", M);
308308401ef6SPierre Jolivet   PetscCheck(N >= 0, PetscObjectComm((PetscObject)viewer), PETSC_ERR_FILE_UNEXPECTED, "Matrix column size (%" PetscInt_FMT ") in file is negative", N);
308408401ef6SPierre Jolivet   PetscCheck(nz >= 0, PETSC_COMM_SELF, PETSC_ERR_FILE_UNEXPECTED, "Matrix stored in special format on disk, cannot load as MPIAIJ");
308508ea439dSMark F. Adams 
30863ea6fe3dSLisandro Dalcin   /* set block sizes from the viewer's .info file */
30879566063dSJacob Faibussowitsch   PetscCall(MatLoad_Binary_BlockSizes(mat, viewer));
30883ea6fe3dSLisandro Dalcin   /* set global sizes if not set already */
30893ea6fe3dSLisandro Dalcin   if (mat->rmap->N < 0) mat->rmap->N = M;
30903ea6fe3dSLisandro Dalcin   if (mat->cmap->N < 0) mat->cmap->N = N;
30919566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(mat->rmap));
30929566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(mat->cmap));
30938fb81238SShri Abhyankar 
30943ea6fe3dSLisandro Dalcin   /* check if the matrix sizes are correct */
30959566063dSJacob Faibussowitsch   PetscCall(MatGetSize(mat, &rows, &cols));
3096aed4548fSBarry Smith   PetscCheck(M == rows && N == cols, PETSC_COMM_SELF, PETSC_ERR_FILE_UNEXPECTED, "Matrix in file of different sizes (%" PetscInt_FMT ", %" PetscInt_FMT ") than the input matrix (%" PetscInt_FMT ", %" PetscInt_FMT ")", M, N, rows, cols);
30978fb81238SShri Abhyankar 
30983ea6fe3dSLisandro Dalcin   /* read in row lengths and build row indices */
30999566063dSJacob Faibussowitsch   PetscCall(MatGetLocalSize(mat, &m, NULL));
31009566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m + 1, &rowidxs));
31019566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryReadAll(viewer, rowidxs + 1, m, PETSC_DECIDE, M, PETSC_INT));
31029371c9d4SSatish Balay   rowidxs[0] = 0;
31039371c9d4SSatish Balay   for (i = 0; i < m; i++) rowidxs[i + 1] += rowidxs[i];
31041690c2aeSBarry Smith   if (nz != PETSC_INT_MAX) {
3105462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&rowidxs[m], &sum, 1, MPIU_INT, MPI_SUM, PetscObjectComm((PetscObject)viewer)));
310608401ef6SPierre Jolivet     PetscCheck(sum == nz, PetscObjectComm((PetscObject)viewer), PETSC_ERR_FILE_UNEXPECTED, "Inconsistent matrix data in file: nonzeros = %" PetscInt_FMT ", sum-row-lengths = %" PetscInt_FMT, nz, sum);
310738b83642SBarry Smith   }
310838b83642SBarry Smith 
31093ea6fe3dSLisandro Dalcin   /* read in column indices and matrix values */
31109566063dSJacob Faibussowitsch   PetscCall(PetscMalloc2(rowidxs[m], &colidxs, rowidxs[m], &matvals));
31119566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryReadAll(viewer, colidxs, rowidxs[m], PETSC_DETERMINE, PETSC_DETERMINE, PETSC_INT));
31129566063dSJacob Faibussowitsch   PetscCall(PetscViewerBinaryReadAll(viewer, matvals, rowidxs[m], PETSC_DETERMINE, PETSC_DETERMINE, PETSC_SCALAR));
31133ea6fe3dSLisandro Dalcin   /* store matrix indices and values */
31149566063dSJacob Faibussowitsch   PetscCall(MatMPIAIJSetPreallocationCSR(mat, rowidxs, colidxs, matvals));
31159566063dSJacob Faibussowitsch   PetscCall(PetscFree(rowidxs));
31169566063dSJacob Faibussowitsch   PetscCall(PetscFree2(colidxs, matvals));
31173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
31188fb81238SShri Abhyankar }
31198fb81238SShri Abhyankar 
31203782ecc7SHong Zhang /* Not scalable because of ISAllGather() unless getting all columns. */
3121ba38deedSJacob Faibussowitsch static PetscErrorCode ISGetSeqIS_Private(Mat mat, IS iscol, IS *isseq)
3122d71ae5a4SJacob Faibussowitsch {
31234aa3045dSJed Brown   IS          iscol_local;
3124c5e4d11fSDmitry Karpeev   PetscBool   isstride;
31259725ddffSPierre Jolivet   PetscMPIInt gisstride = 0;
31263782ecc7SHong Zhang 
31273782ecc7SHong Zhang   PetscFunctionBegin;
31283782ecc7SHong Zhang   /* check if we are grabbing all columns*/
31299566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)iscol, ISSTRIDE, &isstride));
31303782ecc7SHong Zhang 
3131c5e4d11fSDmitry Karpeev   if (isstride) {
3132c5e4d11fSDmitry Karpeev     PetscInt start, len, mstart, mlen;
31339566063dSJacob Faibussowitsch     PetscCall(ISStrideGetInfo(iscol, &start, NULL));
31349566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol, &len));
31359566063dSJacob Faibussowitsch     PetscCall(MatGetOwnershipRangeColumn(mat, &mstart, &mlen));
31369725ddffSPierre Jolivet     if (mstart == start && mlen - mstart == len) gisstride = 1;
3137c5e4d11fSDmitry Karpeev   }
31383782ecc7SHong Zhang 
31399725ddffSPierre Jolivet   PetscCallMPI(MPIU_Allreduce(MPI_IN_PLACE, &gisstride, 1, MPI_INT, MPI_MIN, PetscObjectComm((PetscObject)mat)));
3140c5e4d11fSDmitry Karpeev   if (gisstride) {
3141c5e4d11fSDmitry Karpeev     PetscInt N;
31429566063dSJacob Faibussowitsch     PetscCall(MatGetSize(mat, NULL, &N));
31439566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PETSC_COMM_SELF, N, 0, 1, &iscol_local));
31449566063dSJacob Faibussowitsch     PetscCall(ISSetIdentity(iscol_local));
31459566063dSJacob Faibussowitsch     PetscCall(PetscInfo(mat, "Optimizing for obtaining all columns of the matrix; skipping ISAllGather()\n"));
3146c5e4d11fSDmitry Karpeev   } else {
3147c5bfad50SMark F. Adams     PetscInt cbs;
31489566063dSJacob Faibussowitsch     PetscCall(ISGetBlockSize(iscol, &cbs));
31499566063dSJacob Faibussowitsch     PetscCall(ISAllGather(iscol, &iscol_local));
31509566063dSJacob Faibussowitsch     PetscCall(ISSetBlockSize(iscol_local, cbs));
3151b79d0421SJed Brown   }
31523782ecc7SHong Zhang 
31533782ecc7SHong Zhang   *isseq = iscol_local;
31543ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3155c5e4d11fSDmitry Karpeev }
31568d2139bdSHong Zhang 
3157ddfdf956SHong Zhang /*
31589c988bcaSHong Zhang  Used by MatCreateSubMatrix_MPIAIJ_SameRowColDist() to avoid ISAllGather() and global size of iscol_local
31599c988bcaSHong Zhang  (see MatCreateSubMatrix_MPIAIJ_nonscalable)
3160ddfdf956SHong Zhang 
3161ddfdf956SHong Zhang  Input Parameters:
316227430b45SBarry Smith +   mat - matrix
316327430b45SBarry Smith .   isrow - parallel row index set; its local indices are a subset of local columns of `mat`,
31649c988bcaSHong Zhang            i.e., mat->rstart <= isrow[i] < mat->rend
316527430b45SBarry Smith -   iscol - parallel column index set; its local indices are a subset of local columns of `mat`,
3166ddfdf956SHong Zhang            i.e., mat->cstart <= iscol[i] < mat->cend
316727430b45SBarry Smith 
316827430b45SBarry Smith  Output Parameters:
316927430b45SBarry Smith +   isrow_d - sequential row index set for retrieving mat->A
317027430b45SBarry Smith .   iscol_d - sequential  column index set for retrieving mat->A
317127430b45SBarry Smith .   iscol_o - sequential column index set for retrieving mat->B
317227430b45SBarry Smith -   garray - column map; garray[i] indicates global location of iscol_o[i] in `iscol`
3173ddfdf956SHong Zhang  */
3174835f2295SStefano Zampini static PetscErrorCode ISGetSeqIS_SameColDist_Private(Mat mat, IS isrow, IS iscol, IS *isrow_d, IS *iscol_d, IS *iscol_o, PetscInt *garray[])
3175d71ae5a4SJacob Faibussowitsch {
3176040216a4SHong Zhang   Vec             x, cmap;
3177040216a4SHong Zhang   const PetscInt *is_idx;
3178040216a4SHong Zhang   PetscScalar    *xarray, *cmaparray;
31799c988bcaSHong Zhang   PetscInt        ncols, isstart, *idx, m, rstart, *cmap1, count;
3180040216a4SHong Zhang   Mat_MPIAIJ     *a    = (Mat_MPIAIJ *)mat->data;
3181040216a4SHong Zhang   Mat             B    = a->B;
3182040216a4SHong Zhang   Vec             lvec = a->lvec, lcmap;
3183a31a438cSHong Zhang   PetscInt        i, cstart, cend, Bn = B->cmap->N;
31848b3fa1f7SHong Zhang   MPI_Comm        comm;
31853a8d973cSHong Zhang   VecScatter      Mvctx = a->Mvctx;
31863782ecc7SHong Zhang 
31873782ecc7SHong Zhang   PetscFunctionBegin;
31889566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)mat, &comm));
31899566063dSJacob Faibussowitsch   PetscCall(ISGetLocalSize(iscol, &ncols));
31908b3fa1f7SHong Zhang 
3191ddfdf956SHong Zhang   /* (1) iscol is a sub-column vector of mat, pad it with '-1.' to form a full vector x */
31929566063dSJacob Faibussowitsch   PetscCall(MatCreateVecs(mat, &x, NULL));
31939566063dSJacob Faibussowitsch   PetscCall(VecSet(x, -1.0));
31949566063dSJacob Faibussowitsch   PetscCall(VecDuplicate(x, &cmap));
31959566063dSJacob Faibussowitsch   PetscCall(VecSet(cmap, -1.0));
31960a351717SHong Zhang 
31979c988bcaSHong Zhang   /* Get start indices */
31989566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Scan(&ncols, &isstart, 1, MPIU_INT, MPI_SUM, comm));
3199ddfdf956SHong Zhang   isstart -= ncols;
32009566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRangeColumn(mat, &cstart, &cend));
3201040216a4SHong Zhang 
32029566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(iscol, &is_idx));
32039566063dSJacob Faibussowitsch   PetscCall(VecGetArray(x, &xarray));
32049566063dSJacob Faibussowitsch   PetscCall(VecGetArray(cmap, &cmaparray));
32059566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(ncols, &idx));
3206ddfdf956SHong Zhang   for (i = 0; i < ncols; i++) {
32078b3fa1f7SHong Zhang     xarray[is_idx[i] - cstart]    = (PetscScalar)is_idx[i];
3208ddfdf956SHong Zhang     cmaparray[is_idx[i] - cstart] = i + isstart;        /* global index of iscol[i] */
32099c988bcaSHong Zhang     idx[i]                        = is_idx[i] - cstart; /* local index of iscol[i]  */
32108b3fa1f7SHong Zhang   }
32119566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(x, &xarray));
32129566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(cmap, &cmaparray));
32139566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(iscol, &is_idx));
32148b3fa1f7SHong Zhang 
32159c988bcaSHong Zhang   /* Get iscol_d */
32169566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PETSC_COMM_SELF, ncols, idx, PETSC_OWN_POINTER, iscol_d));
32179566063dSJacob Faibussowitsch   PetscCall(ISGetBlockSize(iscol, &i));
32189566063dSJacob Faibussowitsch   PetscCall(ISSetBlockSize(*iscol_d, i));
3219feb78a15SHong Zhang 
32209c988bcaSHong Zhang   /* Get isrow_d */
32219566063dSJacob Faibussowitsch   PetscCall(ISGetLocalSize(isrow, &m));
3222feb78a15SHong Zhang   rstart = mat->rmap->rstart;
32239566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m, &idx));
32249566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(isrow, &is_idx));
32259c988bcaSHong Zhang   for (i = 0; i < m; i++) idx[i] = is_idx[i] - rstart;
32269566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(isrow, &is_idx));
3227feb78a15SHong Zhang 
32289566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PETSC_COMM_SELF, m, idx, PETSC_OWN_POINTER, isrow_d));
32299566063dSJacob Faibussowitsch   PetscCall(ISGetBlockSize(isrow, &i));
32309566063dSJacob Faibussowitsch   PetscCall(ISSetBlockSize(*isrow_d, i));
3231feb78a15SHong Zhang 
32329c988bcaSHong Zhang   /* (2) Scatter x and cmap using aij->Mvctx to get their off-process portions (see MatMult_MPIAIJ) */
32339566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(Mvctx, x, lvec, INSERT_VALUES, SCATTER_FORWARD));
32349566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(Mvctx, x, lvec, INSERT_VALUES, SCATTER_FORWARD));
3235ddfdf956SHong Zhang 
32369566063dSJacob Faibussowitsch   PetscCall(VecDuplicate(lvec, &lcmap));
323707250d77SHong Zhang 
32389566063dSJacob Faibussowitsch   PetscCall(VecScatterBegin(Mvctx, cmap, lcmap, INSERT_VALUES, SCATTER_FORWARD));
32399566063dSJacob Faibussowitsch   PetscCall(VecScatterEnd(Mvctx, cmap, lcmap, INSERT_VALUES, SCATTER_FORWARD));
324064efcef9SHong Zhang 
32419c988bcaSHong Zhang   /* (3) create sequential iscol_o (a subset of iscol) and isgarray */
3242ddfdf956SHong Zhang   /* off-process column indices */
32439c988bcaSHong Zhang   count = 0;
32449566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(Bn, &idx));
32459566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(Bn, &cmap1));
3246feb78a15SHong Zhang 
32479566063dSJacob Faibussowitsch   PetscCall(VecGetArray(lvec, &xarray));
32489566063dSJacob Faibussowitsch   PetscCall(VecGetArray(lcmap, &cmaparray));
32498b3fa1f7SHong Zhang   for (i = 0; i < Bn; i++) {
3250f73421bfSHong Zhang     if (PetscRealPart(xarray[i]) > -1.0) {
32519c988bcaSHong Zhang       idx[count]   = i;                                     /* local column index in off-diagonal part B */
32521c645242SHong Zhang       cmap1[count] = (PetscInt)PetscRealPart(cmaparray[i]); /* column index in submat */
32531c645242SHong Zhang       count++;
32548b3fa1f7SHong Zhang     }
32558b3fa1f7SHong Zhang   }
32569566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(lvec, &xarray));
32579566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(lcmap, &cmaparray));
325807250d77SHong Zhang 
32599566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PETSC_COMM_SELF, count, idx, PETSC_COPY_VALUES, iscol_o));
3260b6d9b4e0SHong Zhang   /* cannot ensure iscol_o has same blocksize as iscol! */
3261b6d9b4e0SHong Zhang 
32629566063dSJacob Faibussowitsch   PetscCall(PetscFree(idx));
32639c988bcaSHong Zhang   *garray = cmap1;
32649c988bcaSHong Zhang 
32659566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&x));
32669566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&cmap));
32679566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&lcmap));
32683ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3269040216a4SHong Zhang }
3270040216a4SHong Zhang 
3271b20e2604SHong Zhang /* isrow and iscol have same processor distribution as mat, output *submat is a submatrix of local mat */
3272d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateSubMatrix_MPIAIJ_SameRowColDist(Mat mat, IS isrow, IS iscol, MatReuse call, Mat *submat)
3273d71ae5a4SJacob Faibussowitsch {
3274b20e2604SHong Zhang   Mat_MPIAIJ *a = (Mat_MPIAIJ *)mat->data, *asub;
32751fd43edeSHong Zhang   Mat         M = NULL;
32763b00a383SHong Zhang   MPI_Comm    comm;
3277b20e2604SHong Zhang   IS          iscol_d, isrow_d, iscol_o;
32783b00a383SHong Zhang   Mat         Asub = NULL, Bsub = NULL;
3279c0c276a7Ssdargavi   PetscInt    n, count, M_size, N_size;
32803b00a383SHong Zhang 
32813b00a383SHong Zhang   PetscFunctionBegin;
32829566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)mat, &comm));
32833b00a383SHong Zhang 
32843b00a383SHong Zhang   if (call == MAT_REUSE_MATRIX) {
3285b20e2604SHong Zhang     /* Retrieve isrow_d, iscol_d and iscol_o from submat */
32869566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*submat, "isrow_d", (PetscObject *)&isrow_d));
328728b400f6SJacob Faibussowitsch     PetscCheck(isrow_d, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "isrow_d passed in was not used before, cannot reuse");
32883b00a383SHong Zhang 
32899566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*submat, "iscol_d", (PetscObject *)&iscol_d));
329028b400f6SJacob Faibussowitsch     PetscCheck(iscol_d, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "iscol_d passed in was not used before, cannot reuse");
32913b00a383SHong Zhang 
32929566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*submat, "iscol_o", (PetscObject *)&iscol_o));
329328b400f6SJacob Faibussowitsch     PetscCheck(iscol_o, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "iscol_o passed in was not used before, cannot reuse");
32943b00a383SHong Zhang 
3295b20e2604SHong Zhang     /* Update diagonal and off-diagonal portions of submat */
3296b20e2604SHong Zhang     asub = (Mat_MPIAIJ *)(*submat)->data;
32979566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrix_SeqAIJ(a->A, isrow_d, iscol_d, PETSC_DECIDE, MAT_REUSE_MATRIX, &asub->A));
32989566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol_o, &n));
329948a46eb9SPierre Jolivet     if (n) PetscCall(MatCreateSubMatrix_SeqAIJ(a->B, isrow_d, iscol_o, PETSC_DECIDE, MAT_REUSE_MATRIX, &asub->B));
33009566063dSJacob Faibussowitsch     PetscCall(MatAssemblyBegin(*submat, MAT_FINAL_ASSEMBLY));
33019566063dSJacob Faibussowitsch     PetscCall(MatAssemblyEnd(*submat, MAT_FINAL_ASSEMBLY));
33023b00a383SHong Zhang 
33033b00a383SHong Zhang   } else { /* call == MAT_INITIAL_MATRIX) */
3304c0c276a7Ssdargavi     PetscInt *garray, *garray_compact;
3305b20e2604SHong Zhang     PetscInt  BsubN;
33063b00a383SHong Zhang 
3307b20e2604SHong Zhang     /* Create isrow_d, iscol_d, iscol_o and isgarray (replace isgarray with array?) */
33089566063dSJacob Faibussowitsch     PetscCall(ISGetSeqIS_SameColDist_Private(mat, isrow, iscol, &isrow_d, &iscol_d, &iscol_o, &garray));
33093b00a383SHong Zhang 
3310b20e2604SHong Zhang     /* Create local submatrices Asub and Bsub */
33119566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrix_SeqAIJ(a->A, isrow_d, iscol_d, PETSC_DECIDE, MAT_INITIAL_MATRIX, &Asub));
33129566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrix_SeqAIJ(a->B, isrow_d, iscol_o, PETSC_DECIDE, MAT_INITIAL_MATRIX, &Bsub));
33133b00a383SHong Zhang 
3314c0c276a7Ssdargavi     // Compact garray so its not of size Bn
3315c0c276a7Ssdargavi     PetscCall(ISGetSize(iscol_o, &count));
3316c0c276a7Ssdargavi     PetscCall(PetscMalloc1(count, &garray_compact));
3317c0c276a7Ssdargavi     PetscCall(PetscArraycpy(garray_compact, garray, count));
3318c0c276a7Ssdargavi 
33199c988bcaSHong Zhang     /* Create submatrix M */
3320c0c276a7Ssdargavi     PetscCall(ISGetSize(isrow, &M_size));
3321c0c276a7Ssdargavi     PetscCall(ISGetSize(iscol, &N_size));
3322c0c276a7Ssdargavi     PetscCall(MatCreateMPIAIJWithSeqAIJ(comm, M_size, N_size, Asub, Bsub, garray_compact, &M));
33233b00a383SHong Zhang 
3324b20e2604SHong Zhang     /* If Bsub has empty columns, compress iscol_o such that it will retrieve condensed Bsub from a->B during reuse */
3325b20e2604SHong Zhang     asub = (Mat_MPIAIJ *)M->data;
33267cfce09cSHong Zhang 
33279566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol_o, &BsubN));
3328b20e2604SHong Zhang     n = asub->B->cmap->N;
3329b20e2604SHong Zhang     if (BsubN > n) {
3330c4762a1bSJed Brown       /* This case can be tested using ~petsc/src/tao/bound/tutorials/runplate2_3 */
33317cfce09cSHong Zhang       const PetscInt *idx;
33329c988bcaSHong Zhang       PetscInt        i, j, *idx_new, *subgarray = asub->garray;
33339566063dSJacob Faibussowitsch       PetscCall(PetscInfo(M, "submatrix Bn %" PetscInt_FMT " != BsubN %" PetscInt_FMT ", update iscol_o\n", n, BsubN));
33347cfce09cSHong Zhang 
33359566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(n, &idx_new));
33367cfce09cSHong Zhang       j = 0;
33379566063dSJacob Faibussowitsch       PetscCall(ISGetIndices(iscol_o, &idx));
3338b20e2604SHong Zhang       for (i = 0; i < n; i++) {
33397cfce09cSHong Zhang         if (j >= BsubN) break;
33409c988bcaSHong Zhang         while (subgarray[i] > garray[j]) j++;
33417cfce09cSHong Zhang 
33429c988bcaSHong Zhang         if (subgarray[i] == garray[j]) {
33437cfce09cSHong Zhang           idx_new[i] = idx[j++];
334498921bdaSJacob Faibussowitsch         } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "subgarray[%" PetscInt_FMT "]=%" PetscInt_FMT " cannot < garray[%" PetscInt_FMT "]=%" PetscInt_FMT, i, subgarray[i], j, garray[j]);
33457cfce09cSHong Zhang       }
33469566063dSJacob Faibussowitsch       PetscCall(ISRestoreIndices(iscol_o, &idx));
33477cfce09cSHong Zhang 
33489566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&iscol_o));
33499566063dSJacob Faibussowitsch       PetscCall(ISCreateGeneral(PETSC_COMM_SELF, n, idx_new, PETSC_OWN_POINTER, &iscol_o));
33507cfce09cSHong Zhang 
3351b20e2604SHong Zhang     } else if (BsubN < n) {
335298921bdaSJacob Faibussowitsch       SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Columns of Bsub (%" PetscInt_FMT ") cannot be smaller than B's (%" PetscInt_FMT ")", BsubN, asub->B->cmap->N);
3353b20e2604SHong Zhang     }
33547cfce09cSHong Zhang 
33559566063dSJacob Faibussowitsch     PetscCall(PetscFree(garray));
3356b20e2604SHong Zhang     *submat = M;
33573b00a383SHong Zhang 
3358e489de8fSHong Zhang     /* Save isrow_d, iscol_d and iscol_o used in processor for next request */
33599566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)M, "isrow_d", (PetscObject)isrow_d));
33609566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&isrow_d));
33613b00a383SHong Zhang 
33629566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)M, "iscol_d", (PetscObject)iscol_d));
33639566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscol_d));
33643b00a383SHong Zhang 
33659566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)M, "iscol_o", (PetscObject)iscol_o));
33669566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscol_o));
33673b00a383SHong Zhang   }
33683ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
33693b00a383SHong Zhang }
33703b00a383SHong Zhang 
3371d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateSubMatrix_MPIAIJ(Mat mat, IS isrow, IS iscol, MatReuse call, Mat *newmat)
3372d71ae5a4SJacob Faibussowitsch {
33731358a193SHong Zhang   IS        iscol_local = NULL, isrow_d;
33743782ecc7SHong Zhang   PetscInt  csize;
337518e627e3SHong Zhang   PetscInt  n, i, j, start, end;
33764a3daf6eSHong Zhang   PetscBool sameRowDist = PETSC_FALSE, sameDist[2], tsameDist[2];
33773782ecc7SHong Zhang   MPI_Comm  comm;
33783782ecc7SHong Zhang 
33793782ecc7SHong Zhang   PetscFunctionBegin;
3380bcae8d28SHong Zhang   /* If isrow has same processor distribution as mat,
3381a31a438cSHong Zhang      call MatCreateSubMatrix_MPIAIJ_SameRowDist() to avoid using a hash table with global size of iscol */
33828f69fa7bSHong Zhang   if (call == MAT_REUSE_MATRIX) {
33839566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*newmat, "isrow_d", (PetscObject *)&isrow_d));
3384d5761cdaSHong Zhang     if (isrow_d) {
3385d5761cdaSHong Zhang       sameRowDist  = PETSC_TRUE;
3386d5761cdaSHong Zhang       tsameDist[1] = PETSC_TRUE; /* sameColDist */
3387d5761cdaSHong Zhang     } else {
33889566063dSJacob Faibussowitsch       PetscCall(PetscObjectQuery((PetscObject)*newmat, "SubIScol", (PetscObject *)&iscol_local));
3389d5761cdaSHong Zhang       if (iscol_local) {
3390d5761cdaSHong Zhang         sameRowDist  = PETSC_TRUE;
3391d5761cdaSHong Zhang         tsameDist[1] = PETSC_FALSE; /* !sameColDist */
3392d5761cdaSHong Zhang       }
3393d5761cdaSHong Zhang     }
33948f69fa7bSHong Zhang   } else {
3395e489de8fSHong Zhang     /* Check if isrow has same processor distribution as mat */
339618e627e3SHong Zhang     sameDist[0] = PETSC_FALSE;
33979566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(isrow, &n));
33983782ecc7SHong Zhang     if (!n) {
339918e627e3SHong Zhang       sameDist[0] = PETSC_TRUE;
34003782ecc7SHong Zhang     } else {
34019566063dSJacob Faibussowitsch       PetscCall(ISGetMinMax(isrow, &i, &j));
34029566063dSJacob Faibussowitsch       PetscCall(MatGetOwnershipRange(mat, &start, &end));
3403ad540459SPierre Jolivet       if (i >= start && j < end) sameDist[0] = PETSC_TRUE;
34048f69fa7bSHong Zhang     }
34053782ecc7SHong Zhang 
3406e489de8fSHong Zhang     /* Check if iscol has same processor distribution as mat */
340718e627e3SHong Zhang     sameDist[1] = PETSC_FALSE;
34089566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol, &n));
340918e627e3SHong Zhang     if (!n) {
341018e627e3SHong Zhang       sameDist[1] = PETSC_TRUE;
341118e627e3SHong Zhang     } else {
34129566063dSJacob Faibussowitsch       PetscCall(ISGetMinMax(iscol, &i, &j));
34139566063dSJacob Faibussowitsch       PetscCall(MatGetOwnershipRangeColumn(mat, &start, &end));
341418e627e3SHong Zhang       if (i >= start && j < end) sameDist[1] = PETSC_TRUE;
341518e627e3SHong Zhang     }
341618e627e3SHong Zhang 
34179566063dSJacob Faibussowitsch     PetscCall(PetscObjectGetComm((PetscObject)mat, &comm));
3418462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&sameDist, &tsameDist, 2, MPIU_BOOL, MPI_LAND, comm));
341918e627e3SHong Zhang     sameRowDist = tsameDist[0];
342018e627e3SHong Zhang   }
342118e627e3SHong Zhang 
342218e627e3SHong Zhang   if (sameRowDist) {
3423b20e2604SHong Zhang     if (tsameDist[1]) { /* sameRowDist & sameColDist */
34243b00a383SHong Zhang       /* isrow and iscol have same processor distribution as mat */
34259566063dSJacob Faibussowitsch       PetscCall(MatCreateSubMatrix_MPIAIJ_SameRowColDist(mat, isrow, iscol, call, newmat));
34263ba16761SJacob Faibussowitsch       PetscFunctionReturn(PETSC_SUCCESS);
3427b20e2604SHong Zhang     } else { /* sameRowDist */
34283b00a383SHong Zhang       /* isrow has same processor distribution as mat */
34291358a193SHong Zhang       if (call == MAT_INITIAL_MATRIX) {
34301358a193SHong Zhang         PetscBool sorted;
34319566063dSJacob Faibussowitsch         PetscCall(ISGetSeqIS_Private(mat, iscol, &iscol_local));
34329566063dSJacob Faibussowitsch         PetscCall(ISGetLocalSize(iscol_local, &n)); /* local size of iscol_local = global columns of newmat */
34339566063dSJacob Faibussowitsch         PetscCall(ISGetSize(iscol, &i));
343408401ef6SPierre Jolivet         PetscCheck(n == i, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "n %" PetscInt_FMT " != size of iscol %" PetscInt_FMT, n, i);
34351358a193SHong Zhang 
34369566063dSJacob Faibussowitsch         PetscCall(ISSorted(iscol_local, &sorted));
34371358a193SHong Zhang         if (sorted) {
34381358a193SHong Zhang           /* MatCreateSubMatrix_MPIAIJ_SameRowDist() requires iscol_local be sorted; it can have duplicate indices */
34399566063dSJacob Faibussowitsch           PetscCall(MatCreateSubMatrix_MPIAIJ_SameRowDist(mat, isrow, iscol, iscol_local, MAT_INITIAL_MATRIX, newmat));
34403ba16761SJacob Faibussowitsch           PetscFunctionReturn(PETSC_SUCCESS);
34413782ecc7SHong Zhang         }
34421358a193SHong Zhang       } else { /* call == MAT_REUSE_MATRIX */
344348c0d076SHong Zhang         IS iscol_sub;
34449566063dSJacob Faibussowitsch         PetscCall(PetscObjectQuery((PetscObject)*newmat, "SubIScol", (PetscObject *)&iscol_sub));
344548c0d076SHong Zhang         if (iscol_sub) {
34469566063dSJacob Faibussowitsch           PetscCall(MatCreateSubMatrix_MPIAIJ_SameRowDist(mat, isrow, iscol, NULL, call, newmat));
34473ba16761SJacob Faibussowitsch           PetscFunctionReturn(PETSC_SUCCESS);
344848c0d076SHong Zhang         }
34491358a193SHong Zhang       }
34501358a193SHong Zhang     }
34511358a193SHong Zhang   }
34523782ecc7SHong Zhang 
3453bcae8d28SHong Zhang   /* General case: iscol -> iscol_local which has global size of iscol */
34543782ecc7SHong Zhang   if (call == MAT_REUSE_MATRIX) {
34559566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*newmat, "ISAllGather", (PetscObject *)&iscol_local));
345628b400f6SJacob Faibussowitsch     PetscCheck(iscol_local, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Submatrix passed in was not used before, cannot reuse");
34573782ecc7SHong Zhang   } else {
345848a46eb9SPierre Jolivet     if (!iscol_local) PetscCall(ISGetSeqIS_Private(mat, iscol, &iscol_local));
34591358a193SHong Zhang   }
34603782ecc7SHong Zhang 
34619566063dSJacob Faibussowitsch   PetscCall(ISGetLocalSize(iscol, &csize));
34629566063dSJacob Faibussowitsch   PetscCall(MatCreateSubMatrix_MPIAIJ_nonscalable(mat, isrow, iscol_local, csize, call, newmat));
34638f69fa7bSHong Zhang 
3464b79d0421SJed Brown   if (call == MAT_INITIAL_MATRIX) {
34659566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)*newmat, "ISAllGather", (PetscObject)iscol_local));
34669566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscol_local));
3467b79d0421SJed Brown   }
34683ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
34694aa3045dSJed Brown }
34704aa3045dSJed Brown 
3471feb78a15SHong Zhang /*@C
347211a5261eSBarry Smith   MatCreateMPIAIJWithSeqAIJ - creates a `MATMPIAIJ` matrix using `MATSEQAIJ` matrices that contain the "diagonal"
3473feb78a15SHong Zhang   and "off-diagonal" part of the matrix in CSR format.
3474feb78a15SHong Zhang 
3475d083f849SBarry Smith   Collective
3476feb78a15SHong Zhang 
3477feb78a15SHong Zhang   Input Parameters:
3478feb78a15SHong Zhang + comm   - MPI communicator
3479c0c276a7Ssdargavi . M      - the global row size
3480c0c276a7Ssdargavi . N      - the global column size
3481feb78a15SHong Zhang . A      - "diagonal" portion of matrix
3482c0c276a7Ssdargavi . B      - if garray is `NULL`, B should be the offdiag matrix using global col ids and of size N - if garray is not `NULL`, B should be the offdiag matrix using local col ids and of size garray
3483*a3156c1cSJunchao Zhang - garray - either `NULL` or the global index of `B` columns. If not `NULL`, it should be allocated by `PetscMalloc1()` and will be owned by `mat` thereafter.
3484feb78a15SHong Zhang 
3485feb78a15SHong Zhang   Output Parameter:
34862ef1f0ffSBarry Smith . mat - the matrix, with input `A` as its local diagonal matrix
348727430b45SBarry Smith 
3488feb78a15SHong Zhang   Level: advanced
3489feb78a15SHong Zhang 
3490feb78a15SHong Zhang   Notes:
349111a5261eSBarry Smith   See `MatCreateAIJ()` for the definition of "diagonal" and "off-diagonal" portion of the matrix.
349211a5261eSBarry Smith 
3493c0c276a7Ssdargavi   `A` and `B` becomes part of output mat. The user cannot use `A` and `B` anymore.
3494feb78a15SHong Zhang 
3495*a3156c1cSJunchao Zhang   If `garray` is `NULL`, `B` will be compacted to use local indices. In this sense, `B`'s sparsity pattern (nonzerostate) will be changed. If `B` is a device matrix, we need to somehow also update
3496*a3156c1cSJunchao Zhang   `B`'s copy on device.  We do so by increasing `B`'s nonzerostate. In use of `B` on device, device matrix types should detect this change (ref. internal routines `MatSeqAIJCUSPARSECopyToGPU()` or
3497*a3156c1cSJunchao Zhang   `MatAssemblyEnd_SeqAIJKokkos()`) and will just destroy and then recreate the device copy of `B`. It is not optimal, but is easy to implement and less hacky. To avoid this overhead, try to compute `garray`
3498*a3156c1cSJunchao Zhang   yourself, see algorithms in the private function `MatSetUpMultiply_MPIAIJ()`.
3499*a3156c1cSJunchao Zhang 
35001cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MATSEQAIJ`, `MatCreateMPIAIJWithSplitArrays()`
3501feb78a15SHong Zhang @*/
3502c0c276a7Ssdargavi PetscErrorCode MatCreateMPIAIJWithSeqAIJ(MPI_Comm comm, PetscInt M, PetscInt N, Mat A, Mat B, PetscInt *garray, Mat *mat)
3503d71ae5a4SJacob Faibussowitsch {
3504c0c276a7Ssdargavi   PetscInt m, n;
35054ab4d6f4SRichard Tran Mills   MatType  mpi_mat_type;
3506feb78a15SHong Zhang 
3507feb78a15SHong Zhang   PetscFunctionBegin;
35089566063dSJacob Faibussowitsch   PetscCall(MatCreate(comm, mat));
35099566063dSJacob Faibussowitsch   PetscCall(MatGetSize(A, &m, &n));
351008401ef6SPierre Jolivet   PetscCheck(m == B->rmap->N, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Am %" PetscInt_FMT " != Bm %" PetscInt_FMT, m, B->rmap->N);
351158b7e2c1SStefano Zampini   PetscCheck(A->rmap->bs == B->rmap->bs, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "A row bs %" PetscInt_FMT " != B row bs %" PetscInt_FMT, A->rmap->bs, B->rmap->bs);
3512feb78a15SHong Zhang 
3513c0c276a7Ssdargavi   PetscCall(MatSetSizes(*mat, m, n, M, N));
35144ab4d6f4SRichard Tran Mills   /* Determine the type of MPI matrix that should be created from the type of matrix A, which holds the "diagonal" portion. */
35154ab4d6f4SRichard Tran Mills   PetscCall(MatGetMPIMatType_Private(A, &mpi_mat_type));
35164ab4d6f4SRichard Tran Mills   PetscCall(MatSetType(*mat, mpi_mat_type));
35174ab4d6f4SRichard Tran Mills 
351858b7e2c1SStefano Zampini   PetscCall(MatSetBlockSizes(*mat, A->rmap->bs, A->cmap->bs));
3519feb78a15SHong Zhang 
35209566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp((*mat)->rmap));
35219566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp((*mat)->cmap));
3522*a3156c1cSJunchao Zhang   if (!garray) {
3523*a3156c1cSJunchao Zhang     const PetscScalar *ba;
3524*a3156c1cSJunchao Zhang 
3525*a3156c1cSJunchao Zhang     B->nonzerostate++;
3526*a3156c1cSJunchao Zhang     PetscCall(MatSeqAIJGetArrayRead(B, &ba)); /* Since we will destroy B's device copy, we need to make sure the host copy is up to date */
3527*a3156c1cSJunchao Zhang     PetscCall(MatSeqAIJRestoreArrayRead(B, &ba));
3528*a3156c1cSJunchao Zhang   }
3529c0c276a7Ssdargavi   PetscCall(MatSetMPIAIJWithSplitSeqAIJ(*mat, A, B, garray));
3530c0c276a7Ssdargavi   PetscFunctionReturn(PETSC_SUCCESS);
3531feb78a15SHong Zhang }
3532feb78a15SHong Zhang 
3533c0c276a7Ssdargavi /*
3534c0c276a7Ssdargavi   MatSetMPIAIJWithSplitSeqAIJ - Set the diag and offdiag matrices of a `MATMPIAIJ` matrix.
3535c0c276a7Ssdargavi    It is similar to `MatCreateMPIAIJWithSplitArrays()`. This routine allows passing in
3536c0c276a7Ssdargavi    B with local indices and the correct size, along with the accompanying
3537c0c276a7Ssdargavi    garray, hence skipping compactification
3538d5761cdaSHong Zhang 
3539c0c276a7Ssdargavi   Collective
3540d5761cdaSHong Zhang 
3541c0c276a7Ssdargavi   Input Parameters:
3542c0c276a7Ssdargavi +  mat    - the MATMPIAIJ matrix, which should have its type and layout set, but should not have its diag, offdiag matrices set
3543c0c276a7Ssdargavi .  A      - the diag matrix using local col ids
3544c0c276a7Ssdargavi .  B      - if garray is `NULL`, B should be the offdiag matrix using global col ids and of size N - if garray is not `NULL`, B should be the offdiag matrix using local col ids and of size garray
3545c0c276a7Ssdargavi -  garray - either `NULL` or the global index of `B` columns
3546d5761cdaSHong Zhang 
3547c0c276a7Ssdargavi   Output Parameter:
3548c0c276a7Ssdargavi .  mat   - the updated `MATMPIAIJ` matrix
3549feb78a15SHong Zhang 
3550c0c276a7Ssdargavi   Level: advanced
3551c0c276a7Ssdargavi 
3552c0c276a7Ssdargavi   Notes:
3553c0c276a7Ssdargavi   See `MatCreateAIJ()` for the definition of "diagonal" and "off-diagonal" portion of the matrix.
3554c0c276a7Ssdargavi 
3555c0c276a7Ssdargavi   `A` and `B` become part of output mat. The user cannot use `A` and `B` anymore.
3556c0c276a7Ssdargavi 
3557c0c276a7Ssdargavi .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MATSEQAIJ`, `MatCreateMPIAIJWithSplitArrays()`
3558c0c276a7Ssdargavi */
3559c0c276a7Ssdargavi PETSC_INTERN PetscErrorCode MatSetMPIAIJWithSplitSeqAIJ(Mat mat, Mat A, Mat B, PetscInt *garray)
3560c0c276a7Ssdargavi {
3561c0c276a7Ssdargavi   PetscFunctionBegin;
3562c0c276a7Ssdargavi   Mat_MPIAIJ *mpiaij = (Mat_MPIAIJ *)mat->data;
3563c0c276a7Ssdargavi   PetscInt    m, n, M, N, Am, An, Bm, Bn;
3564c0c276a7Ssdargavi 
3565c0c276a7Ssdargavi   PetscCall(MatGetSize(mat, &M, &N));
3566c0c276a7Ssdargavi   PetscCall(MatGetLocalSize(mat, &m, &n));
3567c0c276a7Ssdargavi   PetscCall(MatGetLocalSize(A, &Am, &An));
3568c0c276a7Ssdargavi   PetscCall(MatGetLocalSize(B, &Bm, &Bn));
3569c0c276a7Ssdargavi 
3570c0c276a7Ssdargavi   PetscCheck(m == Am && m == Bm, PETSC_COMM_SELF, PETSC_ERR_PLIB, "local number of rows do not match");
3571c0c276a7Ssdargavi   PetscCheck(n == An, PETSC_COMM_SELF, PETSC_ERR_PLIB, "local number of columns do not match");
3572c0c276a7Ssdargavi   PetscCheck(!mpiaij->A && !mpiaij->B, PETSC_COMM_SELF, PETSC_ERR_PLIB, "A, B of the MPIAIJ matrix are not empty");
3573c0c276a7Ssdargavi   mpiaij->A      = A;
3574c0c276a7Ssdargavi   mpiaij->B      = B;
3575c0c276a7Ssdargavi   mpiaij->garray = garray;
3576c0c276a7Ssdargavi 
3577c0c276a7Ssdargavi   mat->preallocated     = PETSC_TRUE;
3578c0c276a7Ssdargavi   mat->nooffprocentries = PETSC_TRUE; /* See MatAssemblyBegin_MPIAIJ. In effect, making MatAssemblyBegin a nop */
3579c0c276a7Ssdargavi 
3580c0c276a7Ssdargavi   PetscCall(MatSetOption(mat, MAT_NO_OFF_PROC_ENTRIES, PETSC_TRUE));
3581c0c276a7Ssdargavi   PetscCall(MatAssemblyBegin(mat, MAT_FINAL_ASSEMBLY));
3582c0c276a7Ssdargavi   /* MatAssemblyEnd is critical here. It sets mat->offloadmask according to A and B's, and
3583c0c276a7Ssdargavi    also gets mpiaij->B compacted (if garray is NULL), with its col ids and size reduced
3584c0c276a7Ssdargavi    */
3585c0c276a7Ssdargavi   PetscCall(MatAssemblyEnd(mat, MAT_FINAL_ASSEMBLY));
3586c0c276a7Ssdargavi   PetscCall(MatSetOption(mat, MAT_NO_OFF_PROC_ENTRIES, PETSC_FALSE));
3587c0c276a7Ssdargavi   PetscCall(MatSetOption(mat, MAT_NEW_NONZERO_LOCATION_ERR, PETSC_TRUE));
35883ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3589feb78a15SHong Zhang }
3590feb78a15SHong Zhang 
3591ef514586SHong Zhang extern PetscErrorCode MatCreateSubMatrices_MPIAIJ_SingleIS_Local(Mat, PetscInt, const IS[], const IS[], MatReuse, PetscBool, Mat *);
35924aa3045dSJed Brown 
3593d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateSubMatrix_MPIAIJ_SameRowDist(Mat mat, IS isrow, IS iscol, IS iscol_local, MatReuse call, Mat *newmat)
3594d71ae5a4SJacob Faibussowitsch {
359598b658c4SHong Zhang   PetscInt        i, m, n, rstart, row, rend, nz, j, bs, cbs;
359685f27616SHong Zhang   PetscInt       *ii, *jj, nlocal, *dlens, *olens, dlen, olen, jend, mglobal;
359798b658c4SHong Zhang   Mat_MPIAIJ     *a = (Mat_MPIAIJ *)mat->data;
35981fd43edeSHong Zhang   Mat             M, Msub, B = a->B;
359998b658c4SHong Zhang   MatScalar      *aa;
360000e6dbe6SBarry Smith   Mat_SeqAIJ     *aij;
3601a31a438cSHong Zhang   PetscInt       *garray = a->garray, *colsub, Ncols;
360298b658c4SHong Zhang   PetscInt        count, Bn = B->cmap->N, cstart = mat->cmap->rstart, cend = mat->cmap->rend;
360398b658c4SHong Zhang   IS              iscol_sub, iscmap;
360498b658c4SHong Zhang   const PetscInt *is_idx, *cmap;
360518e627e3SHong Zhang   PetscBool       allcolumns = PETSC_FALSE;
3606a31a438cSHong Zhang   MPI_Comm        comm;
36077e2c5f70SBarry Smith 
3608a0ff6018SBarry Smith   PetscFunctionBegin;
36099566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)mat, &comm));
3610d5761cdaSHong Zhang   if (call == MAT_REUSE_MATRIX) {
36119566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*newmat, "SubIScol", (PetscObject *)&iscol_sub));
361228b400f6SJacob Faibussowitsch     PetscCheck(iscol_sub, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "SubIScol passed in was not used before, cannot reuse");
36139566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol_sub, &count));
3614d5761cdaSHong Zhang 
36159566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*newmat, "Subcmap", (PetscObject *)&iscmap));
361628b400f6SJacob Faibussowitsch     PetscCheck(iscmap, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Subcmap passed in was not used before, cannot reuse");
3617d5761cdaSHong Zhang 
36189566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*newmat, "SubMatrix", (PetscObject *)&Msub));
361928b400f6SJacob Faibussowitsch     PetscCheck(Msub, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Submatrix passed in was not used before, cannot reuse");
3620d5761cdaSHong Zhang 
36219566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrices_MPIAIJ_SingleIS_Local(mat, 1, &isrow, &iscol_sub, MAT_REUSE_MATRIX, PETSC_FALSE, &Msub));
3622d5761cdaSHong Zhang 
3623d5761cdaSHong Zhang   } else { /* call == MAT_INITIAL_MATRIX) */
36243b00a383SHong Zhang     PetscBool flg;
36253b00a383SHong Zhang 
36269566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol, &n));
36279566063dSJacob Faibussowitsch     PetscCall(ISGetSize(iscol, &Ncols));
3628bcae8d28SHong Zhang 
36293b00a383SHong Zhang     /* (1) iscol -> nonscalable iscol_local */
3630366a327dSHong Zhang     /* Check for special case: each processor gets entire matrix columns */
36319566063dSJacob Faibussowitsch     PetscCall(ISIdentity(iscol_local, &flg));
3632366a327dSHong Zhang     if (flg && n == mat->cmap->N) allcolumns = PETSC_TRUE;
3633462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(MPI_IN_PLACE, &allcolumns, 1, MPIU_BOOL, MPI_LAND, PetscObjectComm((PetscObject)mat)));
3634366a327dSHong Zhang     if (allcolumns) {
3635366a327dSHong Zhang       iscol_sub = iscol_local;
36369566063dSJacob Faibussowitsch       PetscCall(PetscObjectReference((PetscObject)iscol_local));
36379566063dSJacob Faibussowitsch       PetscCall(ISCreateStride(PETSC_COMM_SELF, n, 0, 1, &iscmap));
3638366a327dSHong Zhang 
36393b00a383SHong Zhang     } else {
36401358a193SHong Zhang       /* (2) iscol_local -> iscol_sub and iscmap. Implementation below requires iscol_local be sorted, it can have duplicate indices */
3641244c7f15SHong Zhang       PetscInt *idx, *cmap1, k;
36429566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncols, &idx));
36439566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(Ncols, &cmap1));
36449566063dSJacob Faibussowitsch       PetscCall(ISGetIndices(iscol_local, &is_idx));
36458d2139bdSHong Zhang       count = 0;
3646a31a438cSHong Zhang       k     = 0;
3647a31a438cSHong Zhang       for (i = 0; i < Ncols; i++) {
3648a31a438cSHong Zhang         j = is_idx[i];
3649a31a438cSHong Zhang         if (j >= cstart && j < cend) {
3650a31a438cSHong Zhang           /* diagonal part of mat */
36518d2139bdSHong Zhang           idx[count]     = j;
3652366a327dSHong Zhang           cmap1[count++] = i; /* column index in submat */
36534a3daf6eSHong Zhang         } else if (Bn) {
3654a31a438cSHong Zhang           /* off-diagonal part of mat */
3655a31a438cSHong Zhang           if (j == garray[k]) {
36568d2139bdSHong Zhang             idx[count]     = j;
3657a31a438cSHong Zhang             cmap1[count++] = i; /* column index in submat */
3658a31a438cSHong Zhang           } else if (j > garray[k]) {
3659a31a438cSHong Zhang             while (j > garray[k] && k < Bn - 1) k++;
3660a31a438cSHong Zhang             if (j == garray[k]) {
3661a31a438cSHong Zhang               idx[count]     = j;
3662a31a438cSHong Zhang               cmap1[count++] = i; /* column index in submat */
36638d2139bdSHong Zhang             }
36648d2139bdSHong Zhang           }
36658d2139bdSHong Zhang         }
36668d2139bdSHong Zhang       }
36679566063dSJacob Faibussowitsch       PetscCall(ISRestoreIndices(iscol_local, &is_idx));
36688d2139bdSHong Zhang 
36699566063dSJacob Faibussowitsch       PetscCall(ISCreateGeneral(PETSC_COMM_SELF, count, idx, PETSC_OWN_POINTER, &iscol_sub));
36709566063dSJacob Faibussowitsch       PetscCall(ISGetBlockSize(iscol, &cbs));
36719566063dSJacob Faibussowitsch       PetscCall(ISSetBlockSize(iscol_sub, cbs));
3672b6d9b4e0SHong Zhang 
36739566063dSJacob Faibussowitsch       PetscCall(ISCreateGeneral(PetscObjectComm((PetscObject)iscol_local), count, cmap1, PETSC_OWN_POINTER, &iscmap));
3674a31a438cSHong Zhang     }
36758b3fa1f7SHong Zhang 
36763b00a383SHong Zhang     /* (3) Create sequential Msub */
36779566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrices_MPIAIJ_SingleIS_Local(mat, 1, &isrow, &iscol_sub, MAT_INITIAL_MATRIX, allcolumns, &Msub));
3678d5761cdaSHong Zhang   }
36798d2139bdSHong Zhang 
36809566063dSJacob Faibussowitsch   PetscCall(ISGetLocalSize(iscol_sub, &count));
368157508eceSPierre Jolivet   aij = (Mat_SeqAIJ *)Msub->data;
368298b658c4SHong Zhang   ii  = aij->i;
36839566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(iscmap, &cmap));
3684a0ff6018SBarry Smith 
3685a0ff6018SBarry Smith   /*
3686a0ff6018SBarry Smith       m - number of local rows
3687a31a438cSHong Zhang       Ncols - number of columns (same on all processors)
3688a0ff6018SBarry Smith       rstart - first row in new global matrix generated
3689a0ff6018SBarry Smith   */
36909566063dSJacob Faibussowitsch   PetscCall(MatGetSize(Msub, &m, NULL));
369198b658c4SHong Zhang 
36923b00a383SHong Zhang   if (call == MAT_INITIAL_MATRIX) {
36933b00a383SHong Zhang     /* (4) Create parallel newmat */
369498b658c4SHong Zhang     PetscMPIInt rank, size;
3695bcae8d28SHong Zhang     PetscInt    csize;
369698b658c4SHong Zhang 
36979566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Comm_size(comm, &size));
36989566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Comm_rank(comm, &rank));
369900e6dbe6SBarry Smith 
3700a0ff6018SBarry Smith     /*
370100e6dbe6SBarry Smith         Determine the number of non-zeros in the diagonal and off-diagonal
370200e6dbe6SBarry Smith         portions of the matrix in order to do correct preallocation
3703a0ff6018SBarry Smith     */
370400e6dbe6SBarry Smith 
370500e6dbe6SBarry Smith     /* first get start and end of "diagonal" columns */
37069566063dSJacob Faibussowitsch     PetscCall(ISGetLocalSize(iscol, &csize));
37076a6a5d1dSBarry Smith     if (csize == PETSC_DECIDE) {
37089566063dSJacob Faibussowitsch       PetscCall(ISGetSize(isrow, &mglobal));
3709a31a438cSHong Zhang       if (mglobal == Ncols) { /* square matrix */
3710e2c4fddaSBarry Smith         nlocal = m;
37116a6a5d1dSBarry Smith       } else {
3712a31a438cSHong Zhang         nlocal = Ncols / size + ((Ncols % size) > rank);
3713ab50ec6bSBarry Smith       }
3714ab50ec6bSBarry Smith     } else {
37156a6a5d1dSBarry Smith       nlocal = csize;
37166a6a5d1dSBarry Smith     }
37179566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Scan(&nlocal, &rend, 1, MPIU_INT, MPI_SUM, comm));
371800e6dbe6SBarry Smith     rstart = rend - nlocal;
3719aed4548fSBarry Smith     PetscCheck(rank != size - 1 || rend == Ncols, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Local column sizes %" PetscInt_FMT " do not add up to total number of columns %" PetscInt_FMT, rend, Ncols);
372000e6dbe6SBarry Smith 
372100e6dbe6SBarry Smith     /* next, compute all the lengths */
372298b658c4SHong Zhang     jj = aij->j;
37239566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(2 * m + 1, &dlens));
372400e6dbe6SBarry Smith     olens = dlens + m;
372500e6dbe6SBarry Smith     for (i = 0; i < m; i++) {
372600e6dbe6SBarry Smith       jend = ii[i + 1] - ii[i];
372700e6dbe6SBarry Smith       olen = 0;
372800e6dbe6SBarry Smith       dlen = 0;
372900e6dbe6SBarry Smith       for (j = 0; j < jend; j++) {
373015b2185cSHong Zhang         if (cmap[*jj] < rstart || cmap[*jj] >= rend) olen++;
373100e6dbe6SBarry Smith         else dlen++;
373200e6dbe6SBarry Smith         jj++;
373300e6dbe6SBarry Smith       }
373400e6dbe6SBarry Smith       olens[i] = olen;
373500e6dbe6SBarry Smith       dlens[i] = dlen;
373600e6dbe6SBarry Smith     }
3737b6d9b4e0SHong Zhang 
37389566063dSJacob Faibussowitsch     PetscCall(ISGetBlockSize(isrow, &bs));
37399566063dSJacob Faibussowitsch     PetscCall(ISGetBlockSize(iscol, &cbs));
374098b658c4SHong Zhang 
37419566063dSJacob Faibussowitsch     PetscCall(MatCreate(comm, &M));
37429566063dSJacob Faibussowitsch     PetscCall(MatSetSizes(M, m, nlocal, PETSC_DECIDE, Ncols));
37439566063dSJacob Faibussowitsch     PetscCall(MatSetBlockSizes(M, bs, cbs));
37449566063dSJacob Faibussowitsch     PetscCall(MatSetType(M, ((PetscObject)mat)->type_name));
37459566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(M, 0, dlens, 0, olens));
37469566063dSJacob Faibussowitsch     PetscCall(PetscFree(dlens));
3747d5761cdaSHong Zhang 
3748d5761cdaSHong Zhang   } else { /* call == MAT_REUSE_MATRIX */
3749a0ff6018SBarry Smith     M = *newmat;
37509566063dSJacob Faibussowitsch     PetscCall(MatGetLocalSize(M, &i, NULL));
375108401ef6SPierre Jolivet     PetscCheck(i == m, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Previous matrix must be same size/layout as request");
37529566063dSJacob Faibussowitsch     PetscCall(MatZeroEntries(M));
3753c48de900SBarry Smith     /*
3754c48de900SBarry Smith          The next two lines are needed so we may call MatSetValues_MPIAIJ() below directly,
3755c48de900SBarry Smith        rather than the slower MatSetValues().
3756c48de900SBarry Smith     */
3757c48de900SBarry Smith     M->was_assembled = PETSC_TRUE;
3758c48de900SBarry Smith     M->assembled     = PETSC_FALSE;
3759a0ff6018SBarry Smith   }
3760548ecf4dSHong Zhang 
37613b00a383SHong Zhang   /* (5) Set values of Msub to *newmat */
37629566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(count, &colsub));
37639566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(M, &rstart, NULL));
376498b658c4SHong Zhang 
376598b658c4SHong Zhang   jj = aij->j;
37669566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(Msub, (const PetscScalar **)&aa));
3767a0ff6018SBarry Smith   for (i = 0; i < m; i++) {
3768a0ff6018SBarry Smith     row = rstart + i;
376900e6dbe6SBarry Smith     nz  = ii[i + 1] - ii[i];
377015b2185cSHong Zhang     for (j = 0; j < nz; j++) colsub[j] = cmap[jj[j]];
37719566063dSJacob Faibussowitsch     PetscCall(MatSetValues_MPIAIJ(M, 1, &row, nz, colsub, aa, INSERT_VALUES));
37729371c9d4SSatish Balay     jj += nz;
37739371c9d4SSatish Balay     aa += nz;
3774a0ff6018SBarry Smith   }
37759566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(Msub, (const PetscScalar **)&aa));
37769566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(iscmap, &cmap));
3777a0ff6018SBarry Smith 
37789566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(M, MAT_FINAL_ASSEMBLY));
37799566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(M, MAT_FINAL_ASSEMBLY));
3780fee21e36SBarry Smith 
37819566063dSJacob Faibussowitsch   PetscCall(PetscFree(colsub));
378298b658c4SHong Zhang 
378398b658c4SHong Zhang   /* save Msub, iscol_sub and iscmap used in processor for next request */
3784fee21e36SBarry Smith   if (call == MAT_INITIAL_MATRIX) {
37853b00a383SHong Zhang     *newmat = M;
3786f4f49eeaSPierre Jolivet     PetscCall(PetscObjectCompose((PetscObject)*newmat, "SubMatrix", (PetscObject)Msub));
37879566063dSJacob Faibussowitsch     PetscCall(MatDestroy(&Msub));
378898b658c4SHong Zhang 
3789f4f49eeaSPierre Jolivet     PetscCall(PetscObjectCompose((PetscObject)*newmat, "SubIScol", (PetscObject)iscol_sub));
37909566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscol_sub));
379198b658c4SHong Zhang 
3792f4f49eeaSPierre Jolivet     PetscCall(PetscObjectCompose((PetscObject)*newmat, "Subcmap", (PetscObject)iscmap));
37939566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscmap));
3794bcae8d28SHong Zhang 
3795bcae8d28SHong Zhang     if (iscol_local) {
3796f4f49eeaSPierre Jolivet       PetscCall(PetscObjectCompose((PetscObject)*newmat, "ISAllGather", (PetscObject)iscol_local));
37979566063dSJacob Faibussowitsch       PetscCall(ISDestroy(&iscol_local));
3798bcae8d28SHong Zhang     }
379998b658c4SHong Zhang   }
38003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3801a0ff6018SBarry Smith }
3802273d9f13SBarry Smith 
3803df40acb1SHong Zhang /*
3804df40acb1SHong Zhang     Not great since it makes two copies of the submatrix, first an SeqAIJ
3805df40acb1SHong Zhang   in local and then by concatenating the local matrices the end result.
3806df40acb1SHong Zhang   Writing it directly would be much like MatCreateSubMatrices_MPIAIJ()
3807df40acb1SHong Zhang 
380811a5261eSBarry Smith   This requires a sequential iscol with all indices.
3809df40acb1SHong Zhang */
3810d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateSubMatrix_MPIAIJ_nonscalable(Mat mat, IS isrow, IS iscol, PetscInt csize, MatReuse call, Mat *newmat)
3811d71ae5a4SJacob Faibussowitsch {
3812df40acb1SHong Zhang   PetscMPIInt rank, size;
3813df40acb1SHong Zhang   PetscInt    i, m, n, rstart, row, rend, nz, *cwork, j, bs, cbs;
3814df40acb1SHong Zhang   PetscInt   *ii, *jj, nlocal, *dlens, *olens, dlen, olen, jend, mglobal;
3815df40acb1SHong Zhang   Mat         M, Mreuse;
381698b658c4SHong Zhang   MatScalar  *aa, *vwork;
3817df40acb1SHong Zhang   MPI_Comm    comm;
3818df40acb1SHong Zhang   Mat_SeqAIJ *aij;
38190b27a90eSHong Zhang   PetscBool   colflag, allcolumns = PETSC_FALSE;
3820df40acb1SHong Zhang 
3821df40acb1SHong Zhang   PetscFunctionBegin;
38229566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)mat, &comm));
38239566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
38249566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
3825df40acb1SHong Zhang 
38260b27a90eSHong Zhang   /* Check for special case: each processor gets entire matrix columns */
38279566063dSJacob Faibussowitsch   PetscCall(ISIdentity(iscol, &colflag));
38289566063dSJacob Faibussowitsch   PetscCall(ISGetLocalSize(iscol, &n));
38290b27a90eSHong Zhang   if (colflag && n == mat->cmap->N) allcolumns = PETSC_TRUE;
3830462c564dSBarry Smith   PetscCallMPI(MPIU_Allreduce(MPI_IN_PLACE, &allcolumns, 1, MPIU_BOOL, MPI_LAND, PetscObjectComm((PetscObject)mat)));
38310b27a90eSHong Zhang 
3832df40acb1SHong Zhang   if (call == MAT_REUSE_MATRIX) {
38339566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*newmat, "SubMatrix", (PetscObject *)&Mreuse));
383428b400f6SJacob Faibussowitsch     PetscCheck(Mreuse, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Submatrix passed in was not used before, cannot reuse");
38359566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrices_MPIAIJ_SingleIS_Local(mat, 1, &isrow, &iscol, MAT_REUSE_MATRIX, allcolumns, &Mreuse));
3836df40acb1SHong Zhang   } else {
38379566063dSJacob Faibussowitsch     PetscCall(MatCreateSubMatrices_MPIAIJ_SingleIS_Local(mat, 1, &isrow, &iscol, MAT_INITIAL_MATRIX, allcolumns, &Mreuse));
3838df40acb1SHong Zhang   }
3839df40acb1SHong Zhang 
3840df40acb1SHong Zhang   /*
3841df40acb1SHong Zhang       m - number of local rows
3842df40acb1SHong Zhang       n - number of columns (same on all processors)
3843df40acb1SHong Zhang       rstart - first row in new global matrix generated
3844df40acb1SHong Zhang   */
38459566063dSJacob Faibussowitsch   PetscCall(MatGetSize(Mreuse, &m, &n));
38469566063dSJacob Faibussowitsch   PetscCall(MatGetBlockSizes(Mreuse, &bs, &cbs));
3847df40acb1SHong Zhang   if (call == MAT_INITIAL_MATRIX) {
384857508eceSPierre Jolivet     aij = (Mat_SeqAIJ *)Mreuse->data;
3849df40acb1SHong Zhang     ii  = aij->i;
3850df40acb1SHong Zhang     jj  = aij->j;
3851df40acb1SHong Zhang 
3852df40acb1SHong Zhang     /*
3853df40acb1SHong Zhang         Determine the number of non-zeros in the diagonal and off-diagonal
3854df40acb1SHong Zhang         portions of the matrix in order to do correct preallocation
3855df40acb1SHong Zhang     */
3856df40acb1SHong Zhang 
3857df40acb1SHong Zhang     /* first get start and end of "diagonal" columns */
3858df40acb1SHong Zhang     if (csize == PETSC_DECIDE) {
38599566063dSJacob Faibussowitsch       PetscCall(ISGetSize(isrow, &mglobal));
3860df40acb1SHong Zhang       if (mglobal == n) { /* square matrix */
3861df40acb1SHong Zhang         nlocal = m;
3862df40acb1SHong Zhang       } else {
3863df40acb1SHong Zhang         nlocal = n / size + ((n % size) > rank);
3864df40acb1SHong Zhang       }
3865df40acb1SHong Zhang     } else {
3866df40acb1SHong Zhang       nlocal = csize;
3867df40acb1SHong Zhang     }
38689566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Scan(&nlocal, &rend, 1, MPIU_INT, MPI_SUM, comm));
3869df40acb1SHong Zhang     rstart = rend - nlocal;
3870aed4548fSBarry Smith     PetscCheck(rank != size - 1 || rend == n, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Local column sizes %" PetscInt_FMT " do not add up to total number of columns %" PetscInt_FMT, rend, n);
3871df40acb1SHong Zhang 
3872df40acb1SHong Zhang     /* next, compute all the lengths */
38739566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(2 * m + 1, &dlens));
3874df40acb1SHong Zhang     olens = dlens + m;
3875df40acb1SHong Zhang     for (i = 0; i < m; i++) {
3876df40acb1SHong Zhang       jend = ii[i + 1] - ii[i];
3877df40acb1SHong Zhang       olen = 0;
3878df40acb1SHong Zhang       dlen = 0;
3879df40acb1SHong Zhang       for (j = 0; j < jend; j++) {
3880df40acb1SHong Zhang         if (*jj < rstart || *jj >= rend) olen++;
3881df40acb1SHong Zhang         else dlen++;
3882df40acb1SHong Zhang         jj++;
3883df40acb1SHong Zhang       }
3884df40acb1SHong Zhang       olens[i] = olen;
3885df40acb1SHong Zhang       dlens[i] = dlen;
3886df40acb1SHong Zhang     }
38879566063dSJacob Faibussowitsch     PetscCall(MatCreate(comm, &M));
38889566063dSJacob Faibussowitsch     PetscCall(MatSetSizes(M, m, nlocal, PETSC_DECIDE, n));
38899566063dSJacob Faibussowitsch     PetscCall(MatSetBlockSizes(M, bs, cbs));
38909566063dSJacob Faibussowitsch     PetscCall(MatSetType(M, ((PetscObject)mat)->type_name));
38919566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(M, 0, dlens, 0, olens));
38929566063dSJacob Faibussowitsch     PetscCall(PetscFree(dlens));
3893df40acb1SHong Zhang   } else {
3894df40acb1SHong Zhang     PetscInt ml, nl;
3895df40acb1SHong Zhang 
3896df40acb1SHong Zhang     M = *newmat;
38979566063dSJacob Faibussowitsch     PetscCall(MatGetLocalSize(M, &ml, &nl));
389808401ef6SPierre Jolivet     PetscCheck(ml == m, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Previous matrix must be same size/layout as request");
38999566063dSJacob Faibussowitsch     PetscCall(MatZeroEntries(M));
3900df40acb1SHong Zhang     /*
3901df40acb1SHong Zhang          The next two lines are needed so we may call MatSetValues_MPIAIJ() below directly,
3902df40acb1SHong Zhang        rather than the slower MatSetValues().
3903df40acb1SHong Zhang     */
3904df40acb1SHong Zhang     M->was_assembled = PETSC_TRUE;
3905df40acb1SHong Zhang     M->assembled     = PETSC_FALSE;
3906df40acb1SHong Zhang   }
39079566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(M, &rstart, &rend));
390857508eceSPierre Jolivet   aij = (Mat_SeqAIJ *)Mreuse->data;
3909df40acb1SHong Zhang   ii  = aij->i;
3910df40acb1SHong Zhang   jj  = aij->j;
39112e5835c6SStefano Zampini 
39122e5835c6SStefano Zampini   /* trigger copy to CPU if needed */
39139566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(Mreuse, (const PetscScalar **)&aa));
3914df40acb1SHong Zhang   for (i = 0; i < m; i++) {
3915df40acb1SHong Zhang     row   = rstart + i;
3916df40acb1SHong Zhang     nz    = ii[i + 1] - ii[i];
39179371c9d4SSatish Balay     cwork = jj;
39188e3a54c0SPierre Jolivet     jj    = PetscSafePointerPlusOffset(jj, nz);
39199371c9d4SSatish Balay     vwork = aa;
39208e3a54c0SPierre Jolivet     aa    = PetscSafePointerPlusOffset(aa, nz);
39219566063dSJacob Faibussowitsch     PetscCall(MatSetValues_MPIAIJ(M, 1, &row, nz, cwork, vwork, INSERT_VALUES));
3922df40acb1SHong Zhang   }
39239566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(Mreuse, (const PetscScalar **)&aa));
3924df40acb1SHong Zhang 
39259566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(M, MAT_FINAL_ASSEMBLY));
39269566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(M, MAT_FINAL_ASSEMBLY));
3927df40acb1SHong Zhang   *newmat = M;
3928df40acb1SHong Zhang 
3929df40acb1SHong Zhang   /* save submatrix used in processor for next request */
3930df40acb1SHong Zhang   if (call == MAT_INITIAL_MATRIX) {
39319566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)M, "SubMatrix", (PetscObject)Mreuse));
39329566063dSJacob Faibussowitsch     PetscCall(MatDestroy(&Mreuse));
3933df40acb1SHong Zhang   }
39343ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3935df40acb1SHong Zhang }
3936df40acb1SHong Zhang 
3937ba38deedSJacob Faibussowitsch static PetscErrorCode MatMPIAIJSetPreallocationCSR_MPIAIJ(Mat B, const PetscInt Ii[], const PetscInt J[], const PetscScalar v[])
3938d71ae5a4SJacob Faibussowitsch {
39396a3d2595SBarry Smith   PetscInt        m, cstart, cend, j, nnz, i, d, *ld;
39409f0612e4SBarry Smith   PetscInt       *d_nnz, *o_nnz, nnz_max = 0, rstart, ii, irstart;
3941ccd8e176SBarry Smith   const PetscInt *JJ;
3942eeb24464SBarry Smith   PetscBool       nooffprocentries;
39436a3d2595SBarry Smith   Mat_MPIAIJ     *Aij = (Mat_MPIAIJ *)B->data;
3944ccd8e176SBarry Smith 
3945ccd8e176SBarry Smith   PetscFunctionBegin;
39469566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(B->rmap));
39479566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(B->cmap));
3948d0f46423SBarry Smith   m       = B->rmap->n;
3949d0f46423SBarry Smith   cstart  = B->cmap->rstart;
3950d0f46423SBarry Smith   cend    = B->cmap->rend;
3951d0f46423SBarry Smith   rstart  = B->rmap->rstart;
39529f0612e4SBarry Smith   irstart = Ii[0];
3953899cda47SBarry Smith 
39549566063dSJacob Faibussowitsch   PetscCall(PetscCalloc2(m, &d_nnz, m, &o_nnz));
3955ccd8e176SBarry Smith 
395676bd3646SJed Brown   if (PetscDefined(USE_DEBUG)) {
39578f8f2f0dSBarry Smith     for (i = 0; i < m; i++) {
3958ecc77c7aSBarry Smith       nnz = Ii[i + 1] - Ii[i];
39599f0612e4SBarry Smith       JJ  = PetscSafePointerPlusOffset(J, Ii[i] - irstart);
396008401ef6SPierre Jolivet       PetscCheck(nnz >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Local row %" PetscInt_FMT " has a negative %" PetscInt_FMT " number of columns", i, nnz);
396108401ef6SPierre Jolivet       PetscCheck(!nnz || !(JJ[0] < 0), PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Row %" PetscInt_FMT " starts with negative column index %" PetscInt_FMT, i, JJ[0]);
396208401ef6SPierre Jolivet       PetscCheck(!nnz || !(JJ[nnz - 1] >= B->cmap->N), PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Row %" PetscInt_FMT " ends with too large a column index %" PetscInt_FMT " (max allowed %" PetscInt_FMT ")", i, JJ[nnz - 1], B->cmap->N);
3963ecc77c7aSBarry Smith     }
396476bd3646SJed Brown   }
3965ecc77c7aSBarry Smith 
39668f8f2f0dSBarry Smith   for (i = 0; i < m; i++) {
3967b7940d39SSatish Balay     nnz     = Ii[i + 1] - Ii[i];
39689f0612e4SBarry Smith     JJ      = PetscSafePointerPlusOffset(J, Ii[i] - irstart);
3969ccd8e176SBarry Smith     nnz_max = PetscMax(nnz_max, nnz);
3970ccd8e176SBarry Smith     d       = 0;
39710daa03b5SJed Brown     for (j = 0; j < nnz; j++) {
39720daa03b5SJed Brown       if (cstart <= JJ[j] && JJ[j] < cend) d++;
3973ccd8e176SBarry Smith     }
3974ccd8e176SBarry Smith     d_nnz[i] = d;
3975ccd8e176SBarry Smith     o_nnz[i] = nnz - d;
3976ccd8e176SBarry Smith   }
39779566063dSJacob Faibussowitsch   PetscCall(MatMPIAIJSetPreallocation(B, 0, d_nnz, 0, o_nnz));
39789566063dSJacob Faibussowitsch   PetscCall(PetscFree2(d_nnz, o_nnz));
3979ccd8e176SBarry Smith 
39808f8f2f0dSBarry Smith   for (i = 0; i < m; i++) {
3981ccd8e176SBarry Smith     ii = i + rstart;
39829f0612e4SBarry Smith     PetscCall(MatSetValues_MPIAIJ(B, 1, &ii, Ii[i + 1] - Ii[i], PetscSafePointerPlusOffset(J, Ii[i] - irstart), PetscSafePointerPlusOffset(v, Ii[i] - irstart), INSERT_VALUES));
3983ccd8e176SBarry Smith   }
3984eeb24464SBarry Smith   nooffprocentries    = B->nooffprocentries;
3985eeb24464SBarry Smith   B->nooffprocentries = PETSC_TRUE;
39869566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(B, MAT_FINAL_ASSEMBLY));
39879566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(B, MAT_FINAL_ASSEMBLY));
3988eeb24464SBarry Smith   B->nooffprocentries = nooffprocentries;
3989ccd8e176SBarry Smith 
39906a3d2595SBarry Smith   /* count number of entries below block diagonal */
39916a3d2595SBarry Smith   PetscCall(PetscFree(Aij->ld));
39926a3d2595SBarry Smith   PetscCall(PetscCalloc1(m, &ld));
39936a3d2595SBarry Smith   Aij->ld = ld;
39946a3d2595SBarry Smith   for (i = 0; i < m; i++) {
39956a3d2595SBarry Smith     nnz = Ii[i + 1] - Ii[i];
39966a3d2595SBarry Smith     j   = 0;
3997ad540459SPierre Jolivet     while (j < nnz && J[j] < cstart) j++;
39986a3d2595SBarry Smith     ld[i] = j;
3999720a2405SPierre Jolivet     if (J) J += nnz;
40006a3d2595SBarry Smith   }
40016a3d2595SBarry Smith 
40029566063dSJacob Faibussowitsch   PetscCall(MatSetOption(B, MAT_NEW_NONZERO_LOCATION_ERR, PETSC_TRUE));
40033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4004ccd8e176SBarry Smith }
4005ccd8e176SBarry Smith 
40061eea217eSSatish Balay /*@
400711a5261eSBarry Smith   MatMPIAIJSetPreallocationCSR - Allocates memory for a sparse parallel matrix in `MATAIJ` format
4008ccd8e176SBarry Smith   (the default parallel PETSc format).
4009ccd8e176SBarry Smith 
4010d083f849SBarry Smith   Collective
4011ccd8e176SBarry Smith 
4012ccd8e176SBarry Smith   Input Parameters:
4013a1661176SMatthew Knepley + B - the matrix
4014d8a51d2aSBarry Smith . i - the indices into `j` for the start of each local row (indices start with zero)
4015d8a51d2aSBarry Smith . j - the column indices for each local row (indices start with zero)
4016ccd8e176SBarry Smith - v - optional values in the matrix
4017ccd8e176SBarry Smith 
4018ccd8e176SBarry Smith   Level: developer
4019ccd8e176SBarry Smith 
402012251496SSatish Balay   Notes:
40212ef1f0ffSBarry Smith   The `i`, `j`, and `v` arrays ARE copied by this routine into the internal format used by PETSc;
40222ef1f0ffSBarry Smith   thus you CANNOT change the matrix entries by changing the values of `v` after you have
402311a5261eSBarry Smith   called this routine. Use `MatCreateMPIAIJWithSplitArrays()` to avoid needing to copy the arrays.
402412251496SSatish Balay 
40252ef1f0ffSBarry Smith   The `i` and `j` indices are 0 based, and `i` indices are indices corresponding to the local `j` array.
402612251496SSatish Balay 
4027a4bd8bc0SBarry Smith   A convenience routine for this functionality is `MatCreateMPIAIJWithArrays()`.
4028a4bd8bc0SBarry Smith 
4029a4bd8bc0SBarry Smith   You can update the matrix with new numerical values using `MatUpdateMPIAIJWithArrays()` after this call if the column indices in `j` are sorted.
4030a4bd8bc0SBarry Smith 
4031a4bd8bc0SBarry Smith   If you do **not** use `MatUpdateMPIAIJWithArrays()`, the column indices in `j` do not need to be sorted. If you will use
4032a4bd8bc0SBarry Smith   `MatUpdateMPIAIJWithArrays()`, the column indices **must** be sorted.
4033a4bd8bc0SBarry Smith 
403412251496SSatish Balay   The format which is used for the sparse matrix input, is equivalent to a
403512251496SSatish Balay   row-major ordering.. i.e for the following matrix, the input data expected is
4036c5e4d11fSDmitry Karpeev   as shown
403727430b45SBarry Smith .vb
403827430b45SBarry Smith         1 0 0
403927430b45SBarry Smith         2 0 3     P0
404027430b45SBarry Smith        -------
404127430b45SBarry Smith         4 5 6     P1
404227430b45SBarry Smith 
404327430b45SBarry Smith      Process0 [P0] rows_owned=[0,1]
404427430b45SBarry Smith         i =  {0,1,3}  [size = nrow+1  = 2+1]
404527430b45SBarry Smith         j =  {0,0,2}  [size = 3]
404627430b45SBarry Smith         v =  {1,2,3}  [size = 3]
404727430b45SBarry Smith 
404827430b45SBarry Smith      Process1 [P1] rows_owned=[2]
404927430b45SBarry Smith         i =  {0,3}    [size = nrow+1  = 1+1]
405027430b45SBarry Smith         j =  {0,1,2}  [size = 3]
405127430b45SBarry Smith         v =  {4,5,6}  [size = 3]
405227430b45SBarry Smith .ve
405312251496SSatish Balay 
4054fe59aa6dSJacob Faibussowitsch .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatMPIAIJSetPreallocation()`, `MatCreateAIJ()`,
4055a4bd8bc0SBarry Smith           `MatCreateSeqAIJWithArrays()`, `MatCreateMPIAIJWithSplitArrays()`, `MatCreateMPIAIJWithArrays()`, `MatSetPreallocationCOO()`, `MatSetValuesCOO()`
4056ccd8e176SBarry Smith @*/
4057d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJSetPreallocationCSR(Mat B, const PetscInt i[], const PetscInt j[], const PetscScalar v[])
4058d71ae5a4SJacob Faibussowitsch {
4059ccd8e176SBarry Smith   PetscFunctionBegin;
4060cac4c232SBarry Smith   PetscTryMethod(B, "MatMPIAIJSetPreallocationCSR_C", (Mat, const PetscInt[], const PetscInt[], const PetscScalar[]), (B, i, j, v));
40613ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4062ccd8e176SBarry Smith }
4063ccd8e176SBarry Smith 
40645d83a8b1SBarry Smith /*@
406511a5261eSBarry Smith   MatMPIAIJSetPreallocation - Preallocates memory for a sparse parallel matrix in `MATMPIAIJ` format
4066273d9f13SBarry Smith   (the default parallel PETSc format).  For good matrix assembly performance
4067273d9f13SBarry Smith   the user should preallocate the matrix storage by setting the parameters
406820f4b53cSBarry Smith   `d_nz` (or `d_nnz`) and `o_nz` (or `o_nnz`).
4069273d9f13SBarry Smith 
4070d083f849SBarry Smith   Collective
4071273d9f13SBarry Smith 
4072273d9f13SBarry Smith   Input Parameters:
40731c4f3114SJed Brown + B     - the matrix
4074273d9f13SBarry Smith . d_nz  - number of nonzeros per row in DIAGONAL portion of local submatrix
4075273d9f13SBarry Smith            (same value is used for all local rows)
4076273d9f13SBarry Smith . d_nnz - array containing the number of nonzeros in the various rows of the
4077273d9f13SBarry Smith            DIAGONAL portion of the local submatrix (possibly different for each row)
40782ef1f0ffSBarry Smith            or `NULL` (`PETSC_NULL_INTEGER` in Fortran), if `d_nz` is used to specify the nonzero structure.
4079273d9f13SBarry Smith            The size of this array is equal to the number of local rows, i.e 'm'.
40803287b5eaSJed Brown            For matrices that will be factored, you must leave room for (and set)
40813287b5eaSJed Brown            the diagonal entry even if it is zero.
4082273d9f13SBarry Smith . o_nz  - number of nonzeros per row in the OFF-DIAGONAL portion of local
4083273d9f13SBarry Smith            submatrix (same value is used for all local rows).
4084273d9f13SBarry Smith - o_nnz - array containing the number of nonzeros in the various rows of the
4085273d9f13SBarry Smith            OFF-DIAGONAL portion of the local submatrix (possibly different for
40862ef1f0ffSBarry Smith            each row) or `NULL` (`PETSC_NULL_INTEGER` in Fortran), if `o_nz` is used to specify the nonzero
4087273d9f13SBarry Smith            structure. The size of this array is equal to the number
4088273d9f13SBarry Smith            of local rows, i.e 'm'.
4089273d9f13SBarry Smith 
40902920cce0SJacob Faibussowitsch   Example Usage:
409127430b45SBarry Smith   Consider the following 8x8 matrix with 34 non-zero values, that is
409227430b45SBarry Smith   assembled across 3 processors. Lets assume that proc0 owns 3 rows,
409327430b45SBarry Smith   proc1 owns 3 rows, proc2 owns 2 rows. This division can be shown
409427430b45SBarry Smith   as follows
409527430b45SBarry Smith 
409627430b45SBarry Smith .vb
409727430b45SBarry Smith             1  2  0  |  0  3  0  |  0  4
409827430b45SBarry Smith     Proc0   0  5  6  |  7  0  0  |  8  0
409927430b45SBarry Smith             9  0 10  | 11  0  0  | 12  0
410027430b45SBarry Smith     -------------------------------------
410127430b45SBarry Smith            13  0 14  | 15 16 17  |  0  0
410227430b45SBarry Smith     Proc1   0 18  0  | 19 20 21  |  0  0
410327430b45SBarry Smith             0  0  0  | 22 23  0  | 24  0
410427430b45SBarry Smith     -------------------------------------
410527430b45SBarry Smith     Proc2  25 26 27  |  0  0 28  | 29  0
410627430b45SBarry Smith            30  0  0  | 31 32 33  |  0 34
410727430b45SBarry Smith .ve
410827430b45SBarry Smith 
410927430b45SBarry Smith   This can be represented as a collection of submatrices as
411027430b45SBarry Smith .vb
411127430b45SBarry Smith       A B C
411227430b45SBarry Smith       D E F
411327430b45SBarry Smith       G H I
411427430b45SBarry Smith .ve
411527430b45SBarry Smith 
411627430b45SBarry Smith   Where the submatrices A,B,C are owned by proc0, D,E,F are
411727430b45SBarry Smith   owned by proc1, G,H,I are owned by proc2.
411827430b45SBarry Smith 
411927430b45SBarry Smith   The 'm' parameters for proc0,proc1,proc2 are 3,3,2 respectively.
412027430b45SBarry Smith   The 'n' parameters for proc0,proc1,proc2 are 3,3,2 respectively.
412127430b45SBarry Smith   The 'M','N' parameters are 8,8, and have the same values on all procs.
412227430b45SBarry Smith 
412327430b45SBarry Smith   The DIAGONAL submatrices corresponding to proc0,proc1,proc2 are
412427430b45SBarry Smith   submatrices [A], [E], [I] respectively. The OFF-DIAGONAL submatrices
412527430b45SBarry Smith   corresponding to proc0,proc1,proc2 are [BC], [DF], [GH] respectively.
412627430b45SBarry Smith   Internally, each processor stores the DIAGONAL part, and the OFF-DIAGONAL
412727430b45SBarry Smith   part as `MATSEQAIJ` matrices. For example, proc1 will store [E] as a `MATSEQAIJ`
41285163b989SNuno Nobre   matrix, and [DF] as another `MATSEQAIJ` matrix.
412927430b45SBarry Smith 
413020f4b53cSBarry Smith   When `d_nz`, `o_nz` parameters are specified, `d_nz` storage elements are
41315163b989SNuno Nobre   allocated for every row of the local DIAGONAL submatrix, and `o_nz`
41325163b989SNuno Nobre   storage locations are allocated for every row of the OFF-DIAGONAL submatrix.
41335163b989SNuno Nobre   One way to choose `d_nz` and `o_nz` is to use the maximum number of nonzeros over
41345163b989SNuno Nobre   the local rows for each of the local DIAGONAL, and the OFF-DIAGONAL submatrices.
413520f4b53cSBarry Smith   In this case, the values of `d_nz`, `o_nz` are
413627430b45SBarry Smith .vb
413727430b45SBarry Smith      proc0  dnz = 2, o_nz = 2
413827430b45SBarry Smith      proc1  dnz = 3, o_nz = 2
413927430b45SBarry Smith      proc2  dnz = 1, o_nz = 4
414027430b45SBarry Smith .ve
414120f4b53cSBarry Smith   We are allocating `m`*(`d_nz`+`o_nz`) storage locations for every proc. This
414227430b45SBarry Smith   translates to 3*(2+2)=12 for proc0, 3*(3+2)=15 for proc1, 2*(1+4)=10
414327430b45SBarry Smith   for proc3. i.e we are using 12+15+10=37 storage locations to store
414427430b45SBarry Smith   34 values.
414527430b45SBarry Smith 
414620f4b53cSBarry Smith   When `d_nnz`, `o_nnz` parameters are specified, the storage is specified
414727430b45SBarry Smith   for every row, corresponding to both DIAGONAL and OFF-DIAGONAL submatrices.
414820f4b53cSBarry Smith   In the above case the values for `d_nnz`, `o_nnz` are
414927430b45SBarry Smith .vb
415027430b45SBarry Smith      proc0 d_nnz = [2,2,2] and o_nnz = [2,2,2]
415127430b45SBarry Smith      proc1 d_nnz = [3,3,2] and o_nnz = [2,1,1]
415227430b45SBarry Smith      proc2 d_nnz = [1,1]   and o_nnz = [4,4]
415327430b45SBarry Smith .ve
415427430b45SBarry Smith   Here the space allocated is sum of all the above values i.e 34, and
415527430b45SBarry Smith   hence pre-allocation is perfect.
415627430b45SBarry Smith 
415727430b45SBarry Smith   Level: intermediate
415827430b45SBarry Smith 
415927430b45SBarry Smith   Notes:
416049a6f317SBarry Smith   If the *_nnz parameter is given then the *_nz parameter is ignored
416149a6f317SBarry Smith 
416227430b45SBarry Smith   The `MATAIJ` format, also called compressed row storage (CSR), is compatible with standard Fortran
41630598bfebSBarry Smith   storage.  The stored row and column indices begin with zero.
4164651615e1SBarry Smith   See [Sparse Matrices](sec_matsparse) for details.
4165273d9f13SBarry Smith 
4166273d9f13SBarry Smith   The parallel matrix is partitioned such that the first m0 rows belong to
4167273d9f13SBarry Smith   process 0, the next m1 rows belong to process 1, the next m2 rows belong
4168273d9f13SBarry Smith   to process 2 etc.. where m0,m1,m2... are the input parameter 'm'.
4169273d9f13SBarry Smith 
4170273d9f13SBarry Smith   The DIAGONAL portion of the local submatrix of a processor can be defined
4171a05b864aSJed Brown   as the submatrix which is obtained by extraction the part corresponding to
4172a05b864aSJed Brown   the rows r1-r2 and columns c1-c2 of the global matrix, where r1 is the
4173a05b864aSJed Brown   first row that belongs to the processor, r2 is the last row belonging to
4174a05b864aSJed Brown   the this processor, and c1-c2 is range of indices of the local part of a
4175a05b864aSJed Brown   vector suitable for applying the matrix to.  This is an mxn matrix.  In the
4176a05b864aSJed Brown   common case of a square matrix, the row and column ranges are the same and
4177a05b864aSJed Brown   the DIAGONAL part is also square. The remaining portion of the local
4178a05b864aSJed Brown   submatrix (mxN) constitute the OFF-DIAGONAL portion.
4179273d9f13SBarry Smith 
41802ef1f0ffSBarry Smith   If `o_nnz` and `d_nnz` are specified, then `o_nz` and `d_nz` are ignored.
4181273d9f13SBarry Smith 
418227430b45SBarry Smith   You can call `MatGetInfo()` to get information on how effective the preallocation was;
4183aa95bbe8SBarry Smith   for example the fields mallocs,nz_allocated,nz_used,nz_unneeded;
418427430b45SBarry Smith   You can also run with the option `-info` and look for messages with the string
4185aa95bbe8SBarry Smith   malloc in them to see if additional memory allocation was needed.
4186aa95bbe8SBarry Smith 
41871cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, [Sparse Matrices](sec_matsparse), `MATMPIAIJ`, `MATAIJ`, `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatCreateAIJ()`, `MatMPIAIJSetPreallocationCSR()`,
4188a4bd8bc0SBarry Smith           `MatGetInfo()`, `PetscSplitOwnership()`, `MatSetPreallocationCOO()`, `MatSetValuesCOO()`
4189273d9f13SBarry Smith @*/
4190d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJSetPreallocation(Mat B, PetscInt d_nz, const PetscInt d_nnz[], PetscInt o_nz, const PetscInt o_nnz[])
4191d71ae5a4SJacob Faibussowitsch {
4192273d9f13SBarry Smith   PetscFunctionBegin;
41936ba663aaSJed Brown   PetscValidHeaderSpecific(B, MAT_CLASSID, 1);
41946ba663aaSJed Brown   PetscValidType(B, 1);
4195cac4c232SBarry Smith   PetscTryMethod(B, "MatMPIAIJSetPreallocation_C", (Mat, PetscInt, const PetscInt[], PetscInt, const PetscInt[]), (B, d_nz, d_nnz, o_nz, o_nnz));
41963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4197273d9f13SBarry Smith }
4198273d9f13SBarry Smith 
419958d36128SBarry Smith /*@
420011a5261eSBarry Smith   MatCreateMPIAIJWithArrays - creates a `MATMPIAIJ` matrix using arrays that contain in standard
42018f8f2f0dSBarry Smith   CSR format for the local rows.
42022fb0ec9aSBarry Smith 
4203d083f849SBarry Smith   Collective
42042fb0ec9aSBarry Smith 
42052fb0ec9aSBarry Smith   Input Parameters:
42062fb0ec9aSBarry Smith + comm - MPI communicator
420711a5261eSBarry Smith . m    - number of local rows (Cannot be `PETSC_DECIDE`)
42082fb0ec9aSBarry Smith . n    - This value should be the same as the local size used in creating the
4209d8a51d2aSBarry Smith          x vector for the matrix-vector product $ y = Ax$. (or `PETSC_DECIDE` to have
4210d8a51d2aSBarry Smith          calculated if `N` is given) For square matrices n is almost always `m`.
4211d8a51d2aSBarry Smith . M    - number of global rows (or `PETSC_DETERMINE` to have calculated if `m` is given)
4212d8a51d2aSBarry Smith . N    - number of global columns (or `PETSC_DETERMINE` to have calculated if `n` is given)
42135693b835SJunchao Zhang . i    - row indices (of length m+1); that is i[0] = 0, i[row] = i[row-1] + number of elements in that row of the matrix
42145693b835SJunchao Zhang . j    - global column indices
4215f1f2ae84SBarry Smith - a    - optional matrix values
42162fb0ec9aSBarry Smith 
42172fb0ec9aSBarry Smith   Output Parameter:
42182fb0ec9aSBarry Smith . mat - the matrix
421903bfb495SBarry Smith 
42202fb0ec9aSBarry Smith   Level: intermediate
42212fb0ec9aSBarry Smith 
42222fb0ec9aSBarry Smith   Notes:
42232ef1f0ffSBarry Smith   The `i`, `j`, and `a` arrays ARE copied by this routine into the internal format used by PETSc;
4224d4c8cc39SPierre Jolivet   thus you CANNOT change the matrix entries by changing the values of `a[]` after you have
4225d4c8cc39SPierre Jolivet   called this routine. Use `MatCreateMPIAIJWithSplitArrays()` to avoid needing to copy the arrays.
42262fb0ec9aSBarry Smith 
42272ef1f0ffSBarry Smith   The `i` and `j` indices are 0 based, and `i` indices are indices corresponding to the local `j` array.
422812251496SSatish Balay 
42295693b835SJunchao Zhang   Once you have created the matrix you can update it with new numerical values using `MatUpdateMPIAIJWithArray()`
4230a4bd8bc0SBarry Smith 
42315693b835SJunchao Zhang   If you do **not** use `MatUpdateMPIAIJWithArray()`, the column indices in `j` do not need to be sorted. If you will use
4232a4bd8bc0SBarry Smith   `MatUpdateMPIAIJWithArrays()`, the column indices **must** be sorted.
4233a4bd8bc0SBarry Smith 
423412251496SSatish Balay   The format which is used for the sparse matrix input, is equivalent to a
4235d4c8cc39SPierre Jolivet   row-major ordering, i.e., for the following matrix, the input data expected is
4236c5e4d11fSDmitry Karpeev   as shown
42372ef1f0ffSBarry Smith .vb
42382ef1f0ffSBarry Smith         1 0 0
42392ef1f0ffSBarry Smith         2 0 3     P0
42402ef1f0ffSBarry Smith        -------
42412ef1f0ffSBarry Smith         4 5 6     P1
42428f8f2f0dSBarry Smith 
42432ef1f0ffSBarry Smith      Process0 [P0] rows_owned=[0,1]
42442ef1f0ffSBarry Smith         i =  {0,1,3}  [size = nrow+1  = 2+1]
42452ef1f0ffSBarry Smith         j =  {0,0,2}  [size = 3]
42462ef1f0ffSBarry Smith         v =  {1,2,3}  [size = 3]
42472fb0ec9aSBarry Smith 
42482ef1f0ffSBarry Smith      Process1 [P1] rows_owned=[2]
42492ef1f0ffSBarry Smith         i =  {0,3}    [size = nrow+1  = 1+1]
42502ef1f0ffSBarry Smith         j =  {0,1,2}  [size = 3]
42512ef1f0ffSBarry Smith         v =  {4,5,6}  [size = 3]
42522ef1f0ffSBarry Smith .ve
42532ef1f0ffSBarry Smith 
4254d4c8cc39SPierre Jolivet .seealso: [](ch_matrices), `Mat`, `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatMPIAIJSetPreallocation()`, `MatMPIAIJSetPreallocationCSR()`,
42555693b835SJunchao Zhang           `MATMPIAIJ`, `MatCreateAIJ()`, `MatCreateMPIAIJWithSplitArrays()`, `MatUpdateMPIAIJWithArray()`, `MatSetPreallocationCOO()`, `MatSetValuesCOO()`
42562fb0ec9aSBarry Smith @*/
4257d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateMPIAIJWithArrays(MPI_Comm comm, PetscInt m, PetscInt n, PetscInt M, PetscInt N, const PetscInt i[], const PetscInt j[], const PetscScalar a[], Mat *mat)
4258d71ae5a4SJacob Faibussowitsch {
42592fb0ec9aSBarry Smith   PetscFunctionBegin;
426008401ef6SPierre Jolivet   PetscCheck(!i || !i[0], PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "i (row indices) must start with 0");
426108401ef6SPierre Jolivet   PetscCheck(m >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "local number of rows (m) cannot be PETSC_DECIDE, or negative");
42629566063dSJacob Faibussowitsch   PetscCall(MatCreate(comm, mat));
42639566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(*mat, m, n, M, N));
42649566063dSJacob Faibussowitsch   /* PetscCall(MatSetBlockSizes(M,bs,cbs)); */
42659566063dSJacob Faibussowitsch   PetscCall(MatSetType(*mat, MATMPIAIJ));
42669566063dSJacob Faibussowitsch   PetscCall(MatMPIAIJSetPreallocationCSR(*mat, i, j, a));
42673ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
42682fb0ec9aSBarry Smith }
42692fb0ec9aSBarry Smith 
42708f8f2f0dSBarry Smith /*@
427111a5261eSBarry Smith   MatUpdateMPIAIJWithArrays - updates a `MATMPIAIJ` matrix using arrays that contain in standard
42722ef1f0ffSBarry Smith   CSR format for the local rows. Only the numerical values are updated the other arrays must be identical to what was passed
42732ef1f0ffSBarry Smith   from `MatCreateMPIAIJWithArrays()`
42746a3d2595SBarry Smith 
42756a3d2595SBarry Smith   Deprecated: Use `MatUpdateMPIAIJWithArray()`
42768f8f2f0dSBarry Smith 
42778f8f2f0dSBarry Smith   Collective
42788f8f2f0dSBarry Smith 
42798f8f2f0dSBarry Smith   Input Parameters:
42808f8f2f0dSBarry Smith + mat - the matrix
428111a5261eSBarry Smith . m   - number of local rows (Cannot be `PETSC_DECIDE`)
42828f8f2f0dSBarry Smith . n   - This value should be the same as the local size used in creating the
428311a5261eSBarry Smith        x vector for the matrix-vector product y = Ax. (or `PETSC_DECIDE` to have
42848f8f2f0dSBarry Smith        calculated if N is given) For square matrices n is almost always m.
428511a5261eSBarry Smith . M   - number of global rows (or `PETSC_DETERMINE` to have calculated if m is given)
428611a5261eSBarry Smith . N   - number of global columns (or `PETSC_DETERMINE` to have calculated if n is given)
42878f8f2f0dSBarry Smith . Ii  - row indices; that is Ii[0] = 0, Ii[row] = Ii[row-1] + number of elements in that row of the matrix
42888f8f2f0dSBarry Smith . J   - column indices
42898f8f2f0dSBarry Smith - v   - matrix values
42908f8f2f0dSBarry Smith 
42912ef1f0ffSBarry Smith   Level: deprecated
42928f8f2f0dSBarry Smith 
42931cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatMPIAIJSetPreallocation()`, `MatMPIAIJSetPreallocationCSR()`,
4294a4bd8bc0SBarry Smith           `MatCreateAIJ()`, `MatCreateMPIAIJWithSplitArrays()`, `MatUpdateMPIAIJWithArray()`, `MatSetPreallocationCOO()`, `MatSetValuesCOO()`
42958f8f2f0dSBarry Smith @*/
4296d71ae5a4SJacob Faibussowitsch PetscErrorCode MatUpdateMPIAIJWithArrays(Mat mat, PetscInt m, PetscInt n, PetscInt M, PetscInt N, const PetscInt Ii[], const PetscInt J[], const PetscScalar v[])
4297d71ae5a4SJacob Faibussowitsch {
42986a3d2595SBarry Smith   PetscInt        nnz, i;
42998f8f2f0dSBarry Smith   PetscBool       nooffprocentries;
43008f8f2f0dSBarry Smith   Mat_MPIAIJ     *Aij = (Mat_MPIAIJ *)mat->data;
4301fff043a9SJunchao Zhang   Mat_SeqAIJ     *Ad  = (Mat_SeqAIJ *)Aij->A->data;
4302fff043a9SJunchao Zhang   PetscScalar    *ad, *ao;
43038f8f2f0dSBarry Smith   PetscInt        ldi, Iii, md;
43046a3d2595SBarry Smith   const PetscInt *Adi = Ad->i;
43056a3d2595SBarry Smith   PetscInt       *ld  = Aij->ld;
43068f8f2f0dSBarry Smith 
43078f8f2f0dSBarry Smith   PetscFunctionBegin;
4308aed4548fSBarry Smith   PetscCheck(Ii[0] == 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "i (row indices) must start with 0");
430908401ef6SPierre Jolivet   PetscCheck(m >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "local number of rows (m) cannot be PETSC_DECIDE, or negative");
431008401ef6SPierre Jolivet   PetscCheck(m == mat->rmap->n, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Local number of rows cannot change from call to MatUpdateMPIAIJWithArrays()");
431108401ef6SPierre Jolivet   PetscCheck(n == mat->cmap->n, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Local number of columns cannot change from call to MatUpdateMPIAIJWithArrays()");
43128f8f2f0dSBarry Smith 
43139566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayWrite(Aij->A, &ad));
43149566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayWrite(Aij->B, &ao));
43158f8f2f0dSBarry Smith 
43168f8f2f0dSBarry Smith   for (i = 0; i < m; i++) {
43174c17f1ccSBarry Smith     if (PetscDefined(USE_DEBUG)) {
43184c17f1ccSBarry Smith       for (PetscInt j = Ii[i] + 1; j < Ii[i + 1]; ++j) {
43194c17f1ccSBarry Smith         PetscCheck(J[j] >= J[j - 1], PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Column entry number %" PetscInt_FMT " (actual column %" PetscInt_FMT ") in row %" PetscInt_FMT " is not sorted", j - Ii[i], J[j], i);
43204c17f1ccSBarry Smith         PetscCheck(J[j] != J[j - 1], PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Column entry number %" PetscInt_FMT " (actual column %" PetscInt_FMT ") in row %" PetscInt_FMT " is identical to previous entry", j - Ii[i], J[j], i);
43214c17f1ccSBarry Smith       }
43224c17f1ccSBarry Smith     }
43238f8f2f0dSBarry Smith     nnz = Ii[i + 1] - Ii[i];
43248f8f2f0dSBarry Smith     Iii = Ii[i];
43258f8f2f0dSBarry Smith     ldi = ld[i];
43268f8f2f0dSBarry Smith     md  = Adi[i + 1] - Adi[i];
43279566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(ao, v + Iii, ldi));
43289566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(ad, v + Iii + ldi, md));
43299566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(ao + ldi, v + Iii + ldi + md, nnz - ldi - md));
43308f8f2f0dSBarry Smith     ad += md;
43318f8f2f0dSBarry Smith     ao += nnz - md;
43328f8f2f0dSBarry Smith   }
43338f8f2f0dSBarry Smith   nooffprocentries      = mat->nooffprocentries;
43348f8f2f0dSBarry Smith   mat->nooffprocentries = PETSC_TRUE;
43359566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayWrite(Aij->A, &ad));
43369566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayWrite(Aij->B, &ao));
43379566063dSJacob Faibussowitsch   PetscCall(PetscObjectStateIncrease((PetscObject)Aij->A));
43389566063dSJacob Faibussowitsch   PetscCall(PetscObjectStateIncrease((PetscObject)Aij->B));
43399566063dSJacob Faibussowitsch   PetscCall(PetscObjectStateIncrease((PetscObject)mat));
43409566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(mat, MAT_FINAL_ASSEMBLY));
43419566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(mat, MAT_FINAL_ASSEMBLY));
43428f8f2f0dSBarry Smith   mat->nooffprocentries = nooffprocentries;
43433ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
43448f8f2f0dSBarry Smith }
43458f8f2f0dSBarry Smith 
43466a3d2595SBarry Smith /*@
434711a5261eSBarry Smith   MatUpdateMPIAIJWithArray - updates an `MATMPIAIJ` matrix using an array that contains the nonzero values
43486a3d2595SBarry Smith 
43496a3d2595SBarry Smith   Collective
43506a3d2595SBarry Smith 
43516a3d2595SBarry Smith   Input Parameters:
43526a3d2595SBarry Smith + mat - the matrix
43536a3d2595SBarry Smith - v   - matrix values, stored by row
43546a3d2595SBarry Smith 
43556a3d2595SBarry Smith   Level: intermediate
43566a3d2595SBarry Smith 
4357a4bd8bc0SBarry Smith   Notes:
43586a3d2595SBarry Smith   The matrix must have been obtained with `MatCreateMPIAIJWithArrays()` or `MatMPIAIJSetPreallocationCSR()`
43596a3d2595SBarry Smith 
4360a4bd8bc0SBarry Smith   The column indices in the call to `MatCreateMPIAIJWithArrays()` or `MatMPIAIJSetPreallocationCSR()` must have been sorted for this call to work correctly
4361a4bd8bc0SBarry Smith 
43621cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatMPIAIJSetPreallocation()`, `MatMPIAIJSetPreallocationCSR()`,
4363a4bd8bc0SBarry Smith           `MATMPIAIJ`, `MatCreateAIJ()`, `MatCreateMPIAIJWithSplitArrays()`, `MatUpdateMPIAIJWithArrays()`, `MatSetPreallocationCOO()`, `MatSetValuesCOO()`
43646a3d2595SBarry Smith @*/
4365d71ae5a4SJacob Faibussowitsch PetscErrorCode MatUpdateMPIAIJWithArray(Mat mat, const PetscScalar v[])
4366d71ae5a4SJacob Faibussowitsch {
43676a3d2595SBarry Smith   PetscInt        nnz, i, m;
43686a3d2595SBarry Smith   PetscBool       nooffprocentries;
43696a3d2595SBarry Smith   Mat_MPIAIJ     *Aij = (Mat_MPIAIJ *)mat->data;
43706a3d2595SBarry Smith   Mat_SeqAIJ     *Ad  = (Mat_SeqAIJ *)Aij->A->data;
43716a3d2595SBarry Smith   Mat_SeqAIJ     *Ao  = (Mat_SeqAIJ *)Aij->B->data;
43726a3d2595SBarry Smith   PetscScalar    *ad, *ao;
43736a3d2595SBarry Smith   const PetscInt *Adi = Ad->i, *Adj = Ao->i;
43746a3d2595SBarry Smith   PetscInt        ldi, Iii, md;
43756a3d2595SBarry Smith   PetscInt       *ld = Aij->ld;
43766a3d2595SBarry Smith 
43776a3d2595SBarry Smith   PetscFunctionBegin;
43786a3d2595SBarry Smith   m = mat->rmap->n;
43796a3d2595SBarry Smith 
43806a3d2595SBarry Smith   PetscCall(MatSeqAIJGetArrayWrite(Aij->A, &ad));
43816a3d2595SBarry Smith   PetscCall(MatSeqAIJGetArrayWrite(Aij->B, &ao));
43826a3d2595SBarry Smith   Iii = 0;
43836a3d2595SBarry Smith   for (i = 0; i < m; i++) {
43846a3d2595SBarry Smith     nnz = Adi[i + 1] - Adi[i] + Adj[i + 1] - Adj[i];
43856a3d2595SBarry Smith     ldi = ld[i];
43866a3d2595SBarry Smith     md  = Adi[i + 1] - Adi[i];
43876a3d2595SBarry Smith     PetscCall(PetscArraycpy(ad, v + Iii + ldi, md));
43886a3d2595SBarry Smith     ad += md;
4389810441c8SPierre Jolivet     if (ao) {
4390810441c8SPierre Jolivet       PetscCall(PetscArraycpy(ao, v + Iii, ldi));
4391810441c8SPierre Jolivet       PetscCall(PetscArraycpy(ao + ldi, v + Iii + ldi + md, nnz - ldi - md));
43926a3d2595SBarry Smith       ao += nnz - md;
4393810441c8SPierre Jolivet     }
43946a3d2595SBarry Smith     Iii += nnz;
43956a3d2595SBarry Smith   }
43966a3d2595SBarry Smith   nooffprocentries      = mat->nooffprocentries;
43976a3d2595SBarry Smith   mat->nooffprocentries = PETSC_TRUE;
43986a3d2595SBarry Smith   PetscCall(MatSeqAIJRestoreArrayWrite(Aij->A, &ad));
43996a3d2595SBarry Smith   PetscCall(MatSeqAIJRestoreArrayWrite(Aij->B, &ao));
44006a3d2595SBarry Smith   PetscCall(PetscObjectStateIncrease((PetscObject)Aij->A));
44016a3d2595SBarry Smith   PetscCall(PetscObjectStateIncrease((PetscObject)Aij->B));
44026a3d2595SBarry Smith   PetscCall(PetscObjectStateIncrease((PetscObject)mat));
44036a3d2595SBarry Smith   PetscCall(MatAssemblyBegin(mat, MAT_FINAL_ASSEMBLY));
44046a3d2595SBarry Smith   PetscCall(MatAssemblyEnd(mat, MAT_FINAL_ASSEMBLY));
44056a3d2595SBarry Smith   mat->nooffprocentries = nooffprocentries;
44063ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
44076a3d2595SBarry Smith }
44086a3d2595SBarry Smith 
44095d83a8b1SBarry Smith /*@
441011a5261eSBarry Smith   MatCreateAIJ - Creates a sparse parallel matrix in `MATAIJ` format
4411273d9f13SBarry Smith   (the default parallel PETSc format).  For good matrix assembly performance
4412273d9f13SBarry Smith   the user should preallocate the matrix storage by setting the parameters
44132ef1f0ffSBarry Smith   `d_nz` (or `d_nnz`) and `o_nz` (or `o_nnz`).
4414273d9f13SBarry Smith 
4415d083f849SBarry Smith   Collective
4416273d9f13SBarry Smith 
4417273d9f13SBarry Smith   Input Parameters:
4418273d9f13SBarry Smith + comm  - MPI communicator
441911a5261eSBarry Smith . m     - number of local rows (or `PETSC_DECIDE` to have calculated if M is given)
4420273d9f13SBarry Smith           This value should be the same as the local size used in creating the
4421273d9f13SBarry Smith           y vector for the matrix-vector product y = Ax.
4422273d9f13SBarry Smith . n     - This value should be the same as the local size used in creating the
442345f401ebSJose E. Roman           x vector for the matrix-vector product y = Ax. (or `PETSC_DECIDE` to have
4424273d9f13SBarry Smith           calculated if N is given) For square matrices n is almost always m.
442511a5261eSBarry Smith . M     - number of global rows (or `PETSC_DETERMINE` to have calculated if m is given)
442611a5261eSBarry Smith . N     - number of global columns (or `PETSC_DETERMINE` to have calculated if n is given)
4427273d9f13SBarry Smith . d_nz  - number of nonzeros per row in DIAGONAL portion of local submatrix
4428273d9f13SBarry Smith           (same value is used for all local rows)
4429273d9f13SBarry Smith . d_nnz - array containing the number of nonzeros in the various rows of the
4430273d9f13SBarry Smith           DIAGONAL portion of the local submatrix (possibly different for each row)
44312ef1f0ffSBarry Smith           or `NULL`, if `d_nz` is used to specify the nonzero structure.
4432273d9f13SBarry Smith           The size of this array is equal to the number of local rows, i.e 'm'.
4433273d9f13SBarry Smith . o_nz  - number of nonzeros per row in the OFF-DIAGONAL portion of local
4434273d9f13SBarry Smith           submatrix (same value is used for all local rows).
4435273d9f13SBarry Smith - o_nnz - array containing the number of nonzeros in the various rows of the
4436273d9f13SBarry Smith           OFF-DIAGONAL portion of the local submatrix (possibly different for
44372ef1f0ffSBarry Smith           each row) or `NULL`, if `o_nz` is used to specify the nonzero
4438273d9f13SBarry Smith           structure. The size of this array is equal to the number
4439273d9f13SBarry Smith           of local rows, i.e 'm'.
4440273d9f13SBarry Smith 
4441273d9f13SBarry Smith   Output Parameter:
4442273d9f13SBarry Smith . A - the matrix
4443273d9f13SBarry Smith 
444427430b45SBarry Smith   Options Database Keys:
444527430b45SBarry Smith + -mat_no_inode                     - Do not use inodes
444627430b45SBarry Smith . -mat_inode_limit <limit>          - Sets inode limit (max limit=5)
444727430b45SBarry Smith - -matmult_vecscatter_view <viewer> - View the vecscatter (i.e., communication pattern) used in `MatMult()` of sparse parallel matrices.
4448727bdf9bSBarry Smith                                       See viewer types in manual of `MatView()`. Of them, ascii_matlab, draw or binary cause the `VecScatter`
4449727bdf9bSBarry Smith                                       to be viewed as a matrix. Entry (i,j) is the size of message (in bytes) rank i sends to rank j in one `MatMult()` call.
445027430b45SBarry Smith 
44512ef1f0ffSBarry Smith   Level: intermediate
44522ef1f0ffSBarry Smith 
445327430b45SBarry Smith   Notes:
445477433607SBarry Smith   It is recommended that one use `MatCreateFromOptions()` or the `MatCreate()`, `MatSetType()` and/or `MatSetFromOptions()`,
4455f6f02116SRichard Tran Mills   MatXXXXSetPreallocation() paradigm instead of this routine directly.
445611a5261eSBarry Smith   [MatXXXXSetPreallocation() is, for example, `MatSeqAIJSetPreallocation()`]
4457175b88e8SBarry Smith 
445849a6f317SBarry Smith   If the *_nnz parameter is given then the *_nz parameter is ignored
445949a6f317SBarry Smith 
44602ef1f0ffSBarry Smith   The `m`,`n`,`M`,`N` parameters specify the size of the matrix, and its partitioning across
44612ef1f0ffSBarry Smith   processors, while `d_nz`,`d_nnz`,`o_nz`,`o_nnz` parameters specify the approximate
4462273d9f13SBarry Smith   storage requirements for this matrix.
4463273d9f13SBarry Smith 
446411a5261eSBarry Smith   If `PETSC_DECIDE` or  `PETSC_DETERMINE` is used for a particular argument on one
4465273d9f13SBarry Smith   processor than it must be used on all processors that share the object for
4466273d9f13SBarry Smith   that argument.
4467273d9f13SBarry Smith 
4468727bdf9bSBarry Smith   If `m` and `n` are not `PETSC_DECIDE`, then the values determine the `PetscLayout` of the matrix and the ranges returned by
4469727bdf9bSBarry Smith   `MatGetOwnershipRange()`, `MatGetOwnershipRanges()`, `MatGetOwnershipRangeColumn()`, and `MatGetOwnershipRangesColumn()`.
4470727bdf9bSBarry Smith 
4471273d9f13SBarry Smith   The user MUST specify either the local or global matrix dimensions
4472273d9f13SBarry Smith   (possibly both).
4473273d9f13SBarry Smith 
447433a7c187SSatish Balay   The parallel matrix is partitioned across processors such that the
4475727bdf9bSBarry Smith   first `m0` rows belong to process 0, the next `m1` rows belong to
4476727bdf9bSBarry Smith   process 1, the next `m2` rows belong to process 2, etc., where
4477727bdf9bSBarry Smith   `m0`, `m1`, `m2`... are the input parameter `m` on each MPI process. I.e., each MPI process stores
447833a7c187SSatish Balay   values corresponding to [m x N] submatrix.
4479273d9f13SBarry Smith 
448033a7c187SSatish Balay   The columns are logically partitioned with the n0 columns belonging
448133a7c187SSatish Balay   to 0th partition, the next n1 columns belonging to the next
4482df3898eeSBarry Smith   partition etc.. where n0,n1,n2... are the input parameter 'n'.
448333a7c187SSatish Balay 
448433a7c187SSatish Balay   The DIAGONAL portion of the local submatrix on any given processor
448533a7c187SSatish Balay   is the submatrix corresponding to the rows and columns m,n
448633a7c187SSatish Balay   corresponding to the given processor. i.e diagonal matrix on
448733a7c187SSatish Balay   process 0 is [m0 x n0], diagonal matrix on process 1 is [m1 x n1]
448833a7c187SSatish Balay   etc. The remaining portion of the local submatrix [m x (N-n)]
448933a7c187SSatish Balay   constitute the OFF-DIAGONAL portion. The example below better
44900b4b7b1cSBarry Smith   illustrates this concept. The two matrices, the DIAGONAL portion and
44910b4b7b1cSBarry Smith   the OFF-DIAGONAL portion are each stored as `MATSEQAIJ` matrices.
449233a7c187SSatish Balay 
449333a7c187SSatish Balay   For a square global matrix we define each processor's diagonal portion
449433a7c187SSatish Balay   to be its local rows and the corresponding columns (a square submatrix);
449533a7c187SSatish Balay   each processor's off-diagonal portion encompasses the remainder of the
449633a7c187SSatish Balay   local matrix (a rectangular submatrix).
4497273d9f13SBarry Smith 
44982ef1f0ffSBarry Smith   If `o_nnz`, `d_nnz` are specified, then `o_nz`, and `d_nz` are ignored.
4499273d9f13SBarry Smith 
450097d05335SKris Buschelman   When calling this routine with a single process communicator, a matrix of
45012ef1f0ffSBarry Smith   type `MATSEQAIJ` is returned.  If a matrix of type `MATMPIAIJ` is desired for this
4502da57b5cdSKarl Rupp   type of communicator, use the construction mechanism
4503da57b5cdSKarl Rupp .vb
45042ef1f0ffSBarry Smith   MatCreate(..., &A);
45052ef1f0ffSBarry Smith   MatSetType(A, MATMPIAIJ);
45062ef1f0ffSBarry Smith   MatSetSizes(A, m, n, M, N);
45072ef1f0ffSBarry Smith   MatMPIAIJSetPreallocation(A, ...);
4508da57b5cdSKarl Rupp .ve
450997d05335SKris Buschelman 
4510273d9f13SBarry Smith   By default, this format uses inodes (identical nodes) when possible.
4511273d9f13SBarry Smith   We search for consecutive rows with the same nonzero structure, thereby
4512273d9f13SBarry Smith   reusing matrix information to achieve increased efficiency.
4513273d9f13SBarry Smith 
45142920cce0SJacob Faibussowitsch   Example Usage:
4515273d9f13SBarry Smith   Consider the following 8x8 matrix with 34 non-zero values, that is
4516273d9f13SBarry Smith   assembled across 3 processors. Lets assume that proc0 owns 3 rows,
4517273d9f13SBarry Smith   proc1 owns 3 rows, proc2 owns 2 rows. This division can be shown
4518efc377ccSKarl Rupp   as follows
4519273d9f13SBarry Smith 
4520273d9f13SBarry Smith .vb
4521273d9f13SBarry Smith             1  2  0  |  0  3  0  |  0  4
4522273d9f13SBarry Smith     Proc0   0  5  6  |  7  0  0  |  8  0
4523273d9f13SBarry Smith             9  0 10  | 11  0  0  | 12  0
4524273d9f13SBarry Smith     -------------------------------------
4525273d9f13SBarry Smith            13  0 14  | 15 16 17  |  0  0
4526273d9f13SBarry Smith     Proc1   0 18  0  | 19 20 21  |  0  0
4527273d9f13SBarry Smith             0  0  0  | 22 23  0  | 24  0
4528273d9f13SBarry Smith     -------------------------------------
4529273d9f13SBarry Smith     Proc2  25 26 27  |  0  0 28  | 29  0
4530273d9f13SBarry Smith            30  0  0  | 31 32 33  |  0 34
4531273d9f13SBarry Smith .ve
4532273d9f13SBarry Smith 
4533da57b5cdSKarl Rupp   This can be represented as a collection of submatrices as
4534273d9f13SBarry Smith 
4535273d9f13SBarry Smith .vb
4536273d9f13SBarry Smith       A B C
4537273d9f13SBarry Smith       D E F
4538273d9f13SBarry Smith       G H I
4539273d9f13SBarry Smith .ve
4540273d9f13SBarry Smith 
4541273d9f13SBarry Smith   Where the submatrices A,B,C are owned by proc0, D,E,F are
4542273d9f13SBarry Smith   owned by proc1, G,H,I are owned by proc2.
4543273d9f13SBarry Smith 
4544273d9f13SBarry Smith   The 'm' parameters for proc0,proc1,proc2 are 3,3,2 respectively.
4545273d9f13SBarry Smith   The 'n' parameters for proc0,proc1,proc2 are 3,3,2 respectively.
4546273d9f13SBarry Smith   The 'M','N' parameters are 8,8, and have the same values on all procs.
4547273d9f13SBarry Smith 
4548273d9f13SBarry Smith   The DIAGONAL submatrices corresponding to proc0,proc1,proc2 are
4549273d9f13SBarry Smith   submatrices [A], [E], [I] respectively. The OFF-DIAGONAL submatrices
4550273d9f13SBarry Smith   corresponding to proc0,proc1,proc2 are [BC], [DF], [GH] respectively.
4551273d9f13SBarry Smith   Internally, each processor stores the DIAGONAL part, and the OFF-DIAGONAL
455227430b45SBarry Smith   part as `MATSEQAIJ` matrices. For example, proc1 will store [E] as a `MATSEQAIJ`
45535163b989SNuno Nobre   matrix, and [DF] as another SeqAIJ matrix.
4554273d9f13SBarry Smith 
45552ef1f0ffSBarry Smith   When `d_nz`, `o_nz` parameters are specified, `d_nz` storage elements are
45565163b989SNuno Nobre   allocated for every row of the local DIAGONAL submatrix, and `o_nz`
45575163b989SNuno Nobre   storage locations are allocated for every row of the OFF-DIAGONAL submatrix.
45585163b989SNuno Nobre   One way to choose `d_nz` and `o_nz` is to use the maximum number of nonzeros over
45595163b989SNuno Nobre   the local rows for each of the local DIAGONAL, and the OFF-DIAGONAL submatrices.
45602ef1f0ffSBarry Smith   In this case, the values of `d_nz`,`o_nz` are
4561273d9f13SBarry Smith .vb
456227430b45SBarry Smith      proc0  dnz = 2, o_nz = 2
456327430b45SBarry Smith      proc1  dnz = 3, o_nz = 2
456427430b45SBarry Smith      proc2  dnz = 1, o_nz = 4
4565273d9f13SBarry Smith .ve
45662ef1f0ffSBarry Smith   We are allocating m*(`d_nz`+`o_nz`) storage locations for every proc. This
4567273d9f13SBarry Smith   translates to 3*(2+2)=12 for proc0, 3*(3+2)=15 for proc1, 2*(1+4)=10
4568273d9f13SBarry Smith   for proc3. i.e we are using 12+15+10=37 storage locations to store
4569273d9f13SBarry Smith   34 values.
4570273d9f13SBarry Smith 
45712ef1f0ffSBarry Smith   When `d_nnz`, `o_nnz` parameters are specified, the storage is specified
4572a5b23f4aSJose E. Roman   for every row, corresponding to both DIAGONAL and OFF-DIAGONAL submatrices.
4573da57b5cdSKarl Rupp   In the above case the values for d_nnz,o_nnz are
4574273d9f13SBarry Smith .vb
457527430b45SBarry Smith      proc0 d_nnz = [2,2,2] and o_nnz = [2,2,2]
457627430b45SBarry Smith      proc1 d_nnz = [3,3,2] and o_nnz = [2,1,1]
457727430b45SBarry Smith      proc2 d_nnz = [1,1]   and o_nnz = [4,4]
4578273d9f13SBarry Smith .ve
4579273d9f13SBarry Smith   Here the space allocated is sum of all the above values i.e 34, and
4580273d9f13SBarry Smith   hence pre-allocation is perfect.
4581273d9f13SBarry Smith 
45821cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, [Sparse Matrix Creation](sec_matsparse), `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatMPIAIJSetPreallocation()`, `MatMPIAIJSetPreallocationCSR()`,
4583727bdf9bSBarry Smith           `MATMPIAIJ`, `MatCreateMPIAIJWithArrays()`, `MatGetOwnershipRange()`, `MatGetOwnershipRanges()`, `MatGetOwnershipRangeColumn()`,
4584727bdf9bSBarry Smith           `MatGetOwnershipRangesColumn()`, `PetscLayout`
4585273d9f13SBarry Smith @*/
4586d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateAIJ(MPI_Comm comm, PetscInt m, PetscInt n, PetscInt M, PetscInt N, PetscInt d_nz, const PetscInt d_nnz[], PetscInt o_nz, const PetscInt o_nnz[], Mat *A)
4587d71ae5a4SJacob Faibussowitsch {
4588b1d57f15SBarry Smith   PetscMPIInt size;
4589273d9f13SBarry Smith 
4590273d9f13SBarry Smith   PetscFunctionBegin;
45919566063dSJacob Faibussowitsch   PetscCall(MatCreate(comm, A));
45929566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(*A, m, n, M, N));
45939566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
4594273d9f13SBarry Smith   if (size > 1) {
45959566063dSJacob Faibussowitsch     PetscCall(MatSetType(*A, MATMPIAIJ));
45969566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(*A, d_nz, d_nnz, o_nz, o_nnz));
4597273d9f13SBarry Smith   } else {
45989566063dSJacob Faibussowitsch     PetscCall(MatSetType(*A, MATSEQAIJ));
45999566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJSetPreallocation(*A, d_nz, d_nnz));
4600273d9f13SBarry Smith   }
46013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4602273d9f13SBarry Smith }
4603195d93cdSBarry Smith 
4604127ca0efSMatthew Knepley /*@C
46050ab4885dSBarry Smith   MatMPIAIJGetSeqAIJ - Returns the local pieces of this distributed matrix
4606127ca0efSMatthew Knepley 
46072ef1f0ffSBarry Smith   Not Collective
4608127ca0efSMatthew Knepley 
4609127ca0efSMatthew Knepley   Input Parameter:
461011a5261eSBarry Smith . A - The `MATMPIAIJ` matrix
4611127ca0efSMatthew Knepley 
4612127ca0efSMatthew Knepley   Output Parameters:
461311a5261eSBarry Smith + Ad     - The local diagonal block as a `MATSEQAIJ` matrix
461411a5261eSBarry Smith . Ao     - The local off-diagonal block as a `MATSEQAIJ` matrix
46152ef1f0ffSBarry Smith - colmap - An array mapping local column numbers of `Ao` to global column numbers of the parallel matrix
4616127ca0efSMatthew Knepley 
46170ab4885dSBarry Smith   Level: intermediate
46180ab4885dSBarry Smith 
461911a5261eSBarry Smith   Note:
46202ef1f0ffSBarry Smith   The rows in `Ad` and `Ao` are in [0, Nr), where Nr is the number of local rows on this process. The columns
46212ef1f0ffSBarry Smith   in `Ad` are in [0, Nc) where Nc is the number of local columns. The columns are `Ao` are in [0, Nco), where Nco is
46222ef1f0ffSBarry Smith   the number of nonzero columns in the local off-diagonal piece of the matrix `A`. The array colmap maps these
4623127ca0efSMatthew Knepley   local column numbers to global column numbers in the original matrix.
4624127ca0efSMatthew Knepley 
4625ce78bad3SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MatMPIAIJGetLocalMat()`, `MatMPIAIJGetLocalMatCondensed()`, `MatCreateAIJ()`, `MATSEQAIJ`
4626127ca0efSMatthew Knepley @*/
4627d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJGetSeqAIJ(Mat A, Mat *Ad, Mat *Ao, const PetscInt *colmap[])
4628d71ae5a4SJacob Faibussowitsch {
4629195d93cdSBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
463004cf37c7SBarry Smith   PetscBool   flg;
4631b1d57f15SBarry Smith 
4632195d93cdSBarry Smith   PetscFunctionBegin;
46339566063dSJacob Faibussowitsch   PetscCall(PetscStrbeginswith(((PetscObject)A)->type_name, MATMPIAIJ, &flg));
463428b400f6SJacob Faibussowitsch   PetscCheck(flg, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "This function requires a MATMPIAIJ matrix as input");
463521e72a00SBarry Smith   if (Ad) *Ad = a->A;
463621e72a00SBarry Smith   if (Ao) *Ao = a->B;
463721e72a00SBarry Smith   if (colmap) *colmap = a->garray;
46383ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4639195d93cdSBarry Smith }
4640a2243be0SBarry Smith 
4641d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateMPIMatConcatenateSeqMat_MPIAIJ(MPI_Comm comm, Mat inmat, PetscInt n, MatReuse scall, Mat *outmat)
4642d71ae5a4SJacob Faibussowitsch {
4643110bb6e1SHong Zhang   PetscInt     m, N, i, rstart, nnz, Ii;
46449b8102ccSHong Zhang   PetscInt    *indx;
4645110bb6e1SHong Zhang   PetscScalar *values;
4646421ddf4dSJunchao Zhang   MatType      rootType;
46479b8102ccSHong Zhang 
46489b8102ccSHong Zhang   PetscFunctionBegin;
46499566063dSJacob Faibussowitsch   PetscCall(MatGetSize(inmat, &m, &N));
4650110bb6e1SHong Zhang   if (scall == MAT_INITIAL_MATRIX) { /* symbolic phase */
4651110bb6e1SHong Zhang     PetscInt *dnz, *onz, sum, bs, cbs;
4652110bb6e1SHong Zhang 
465348a46eb9SPierre Jolivet     if (n == PETSC_DECIDE) PetscCall(PetscSplitOwnership(comm, &n, &N));
4654a22543b6SHong Zhang     /* Check sum(n) = N */
4655462c564dSBarry Smith     PetscCallMPI(MPIU_Allreduce(&n, &sum, 1, MPIU_INT, MPI_SUM, comm));
465608401ef6SPierre Jolivet     PetscCheck(sum == N, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Sum of local columns %" PetscInt_FMT " != global columns %" PetscInt_FMT, sum, N);
4657a22543b6SHong Zhang 
46589566063dSJacob Faibussowitsch     PetscCallMPI(MPI_Scan(&m, &rstart, 1, MPIU_INT, MPI_SUM, comm));
46599b8102ccSHong Zhang     rstart -= m;
46609b8102ccSHong Zhang 
4661d0609cedSBarry Smith     MatPreallocateBegin(comm, m, n, dnz, onz);
46629b8102ccSHong Zhang     for (i = 0; i < m; i++) {
46639566063dSJacob Faibussowitsch       PetscCall(MatGetRow_SeqAIJ(inmat, i, &nnz, &indx, NULL));
46649566063dSJacob Faibussowitsch       PetscCall(MatPreallocateSet(i + rstart, nnz, indx, dnz, onz));
46659566063dSJacob Faibussowitsch       PetscCall(MatRestoreRow_SeqAIJ(inmat, i, &nnz, &indx, NULL));
46669b8102ccSHong Zhang     }
46679b8102ccSHong Zhang 
46689566063dSJacob Faibussowitsch     PetscCall(MatCreate(comm, outmat));
46699566063dSJacob Faibussowitsch     PetscCall(MatSetSizes(*outmat, m, n, PETSC_DETERMINE, PETSC_DETERMINE));
46709566063dSJacob Faibussowitsch     PetscCall(MatGetBlockSizes(inmat, &bs, &cbs));
46719566063dSJacob Faibussowitsch     PetscCall(MatSetBlockSizes(*outmat, bs, cbs));
46729566063dSJacob Faibussowitsch     PetscCall(MatGetRootType_Private(inmat, &rootType));
46739566063dSJacob Faibussowitsch     PetscCall(MatSetType(*outmat, rootType));
46749566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJSetPreallocation(*outmat, 0, dnz));
46759566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJSetPreallocation(*outmat, 0, dnz, 0, onz));
4676d0609cedSBarry Smith     MatPreallocateEnd(dnz, onz);
46779566063dSJacob Faibussowitsch     PetscCall(MatSetOption(*outmat, MAT_NO_OFF_PROC_ENTRIES, PETSC_TRUE));
46789b8102ccSHong Zhang   }
46799b8102ccSHong Zhang 
4680110bb6e1SHong Zhang   /* numeric phase */
46819566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRange(*outmat, &rstart, NULL));
46829b8102ccSHong Zhang   for (i = 0; i < m; i++) {
46839566063dSJacob Faibussowitsch     PetscCall(MatGetRow_SeqAIJ(inmat, i, &nnz, &indx, &values));
46849b8102ccSHong Zhang     Ii = i + rstart;
46859566063dSJacob Faibussowitsch     PetscCall(MatSetValues(*outmat, 1, &Ii, nnz, indx, values, INSERT_VALUES));
46869566063dSJacob Faibussowitsch     PetscCall(MatRestoreRow_SeqAIJ(inmat, i, &nnz, &indx, &values));
46879b8102ccSHong Zhang   }
46889566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(*outmat, MAT_FINAL_ASSEMBLY));
46899566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(*outmat, MAT_FINAL_ASSEMBLY));
46903ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
4691c5d6d63eSBarry Smith }
4692c5d6d63eSBarry Smith 
469349abdd8aSBarry Smith static PetscErrorCode MatDestroy_MPIAIJ_SeqsToMPI(void **data)
4694d71ae5a4SJacob Faibussowitsch {
469549abdd8aSBarry Smith   Mat_Merge_SeqsToMPI *merge = (Mat_Merge_SeqsToMPI *)*data;
469651a7d1a8SHong Zhang 
469751a7d1a8SHong Zhang   PetscFunctionBegin;
46983ba16761SJacob Faibussowitsch   if (!merge) PetscFunctionReturn(PETSC_SUCCESS);
46999566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->id_r));
47009566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->len_s));
47019566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->len_r));
47029566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->bi));
47039566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->bj));
47049566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->buf_ri[0]));
47059566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->buf_ri));
47069566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->buf_rj[0]));
47079566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->buf_rj));
47089566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->coi));
47099566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->coj));
47109566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge->owners_co));
47119566063dSJacob Faibussowitsch   PetscCall(PetscLayoutDestroy(&merge->rowmap));
47129566063dSJacob Faibussowitsch   PetscCall(PetscFree(merge));
47133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
471451a7d1a8SHong Zhang }
471551a7d1a8SHong Zhang 
4716c6db04a5SJed Brown #include <../src/mat/utils/freespace.h>
4717c6db04a5SJed Brown #include <petscbt.h>
47184ebed01fSBarry Smith 
4719d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateMPIAIJSumSeqAIJNumeric(Mat seqmat, Mat mpimat)
4720d71ae5a4SJacob Faibussowitsch {
4721ce94432eSBarry Smith   MPI_Comm             comm;
472255d1abb9SHong Zhang   Mat_SeqAIJ          *a = (Mat_SeqAIJ *)seqmat->data;
4723b1d57f15SBarry Smith   PetscMPIInt          size, rank, taga, *len_s;
47246497c311SBarry Smith   PetscInt             N = mpimat->cmap->N, i, j, *owners, *ai = a->i, *aj, m;
47256497c311SBarry Smith   PetscMPIInt          proc, k;
4726b1d57f15SBarry Smith   PetscInt           **buf_ri, **buf_rj;
47276497c311SBarry Smith   PetscInt             anzi, *bj_i, *bi, *bj, arow, bnzi, nextaj;
4728b1d57f15SBarry Smith   PetscInt             nrows, **buf_ri_k, **nextrow, **nextai;
472955d1abb9SHong Zhang   MPI_Request         *s_waits, *r_waits;
473055d1abb9SHong Zhang   MPI_Status          *status;
4731fff043a9SJunchao Zhang   const MatScalar     *aa, *a_a;
4732dd6ea824SBarry Smith   MatScalar          **abuf_r, *ba_i;
473355d1abb9SHong Zhang   Mat_Merge_SeqsToMPI *merge;
4734776b82aeSLisandro Dalcin   PetscContainer       container;
473555d1abb9SHong Zhang 
473655d1abb9SHong Zhang   PetscFunctionBegin;
47379566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)mpimat, &comm));
47389566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_Seqstompinum, seqmat, 0, 0, 0));
47393c2c1871SHong Zhang 
47409566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
47419566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
474255d1abb9SHong Zhang 
47439566063dSJacob Faibussowitsch   PetscCall(PetscObjectQuery((PetscObject)mpimat, "MatMergeSeqsToMPI", (PetscObject *)&container));
474428b400f6SJacob Faibussowitsch   PetscCheck(container, PetscObjectComm((PetscObject)mpimat), PETSC_ERR_PLIB, "Mat not created from MatCreateMPIAIJSumSeqAIJSymbolic");
47459566063dSJacob Faibussowitsch   PetscCall(PetscContainerGetPointer(container, (void **)&merge));
47469566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(seqmat, &a_a));
4747fff043a9SJunchao Zhang   aa = a_a;
4748bf0cc555SLisandro Dalcin 
474955d1abb9SHong Zhang   bi     = merge->bi;
475055d1abb9SHong Zhang   bj     = merge->bj;
475155d1abb9SHong Zhang   buf_ri = merge->buf_ri;
475255d1abb9SHong Zhang   buf_rj = merge->buf_rj;
475355d1abb9SHong Zhang 
47549566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(size, &status));
47557a2fc3feSBarry Smith   owners = merge->rowmap->range;
475655d1abb9SHong Zhang   len_s  = merge->len_s;
475755d1abb9SHong Zhang 
475855d1abb9SHong Zhang   /* send and recv matrix values */
47599566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetNewTag((PetscObject)mpimat, &taga));
47609566063dSJacob Faibussowitsch   PetscCall(PetscPostIrecvScalar(comm, taga, merge->nrecv, merge->id_r, merge->len_r, &abuf_r, &r_waits));
476155d1abb9SHong Zhang 
47629566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(merge->nsend + 1, &s_waits));
476355d1abb9SHong Zhang   for (proc = 0, k = 0; proc < size; proc++) {
476455d1abb9SHong Zhang     if (!len_s[proc]) continue;
476555d1abb9SHong Zhang     i = owners[proc];
47666497c311SBarry Smith     PetscCallMPI(MPIU_Isend(aa + ai[i], len_s[proc], MPIU_MATSCALAR, proc, taga, comm, s_waits + k));
476755d1abb9SHong Zhang     k++;
476855d1abb9SHong Zhang   }
476955d1abb9SHong Zhang 
47709566063dSJacob Faibussowitsch   if (merge->nrecv) PetscCallMPI(MPI_Waitall(merge->nrecv, r_waits, status));
47719566063dSJacob Faibussowitsch   if (merge->nsend) PetscCallMPI(MPI_Waitall(merge->nsend, s_waits, status));
47729566063dSJacob Faibussowitsch   PetscCall(PetscFree(status));
477355d1abb9SHong Zhang 
47749566063dSJacob Faibussowitsch   PetscCall(PetscFree(s_waits));
47759566063dSJacob Faibussowitsch   PetscCall(PetscFree(r_waits));
477655d1abb9SHong Zhang 
477755d1abb9SHong Zhang   /* insert mat values of mpimat */
47789566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(N, &ba_i));
47799566063dSJacob Faibussowitsch   PetscCall(PetscMalloc3(merge->nrecv, &buf_ri_k, merge->nrecv, &nextrow, merge->nrecv, &nextai));
478055d1abb9SHong Zhang 
478155d1abb9SHong Zhang   for (k = 0; k < merge->nrecv; k++) {
478255d1abb9SHong Zhang     buf_ri_k[k] = buf_ri[k]; /* beginning of k-th recved i-structure */
4783f4f49eeaSPierre Jolivet     nrows       = *buf_ri_k[k];
478455d1abb9SHong Zhang     nextrow[k]  = buf_ri_k[k] + 1;           /* next row number of k-th recved i-structure */
4785a5b23f4aSJose E. Roman     nextai[k]   = buf_ri_k[k] + (nrows + 1); /* points to the next i-structure of k-th recved i-structure  */
478655d1abb9SHong Zhang   }
478755d1abb9SHong Zhang 
478855d1abb9SHong Zhang   /* set values of ba */
47897a2fc3feSBarry Smith   m = merge->rowmap->n;
479055d1abb9SHong Zhang   for (i = 0; i < m; i++) {
479155d1abb9SHong Zhang     arow = owners[rank] + i;
479255d1abb9SHong Zhang     bj_i = bj + bi[i]; /* col indices of the i-th row of mpimat */
479355d1abb9SHong Zhang     bnzi = bi[i + 1] - bi[i];
47949566063dSJacob Faibussowitsch     PetscCall(PetscArrayzero(ba_i, bnzi));
479555d1abb9SHong Zhang 
479655d1abb9SHong Zhang     /* add local non-zero vals of this proc's seqmat into ba */
479755d1abb9SHong Zhang     anzi   = ai[arow + 1] - ai[arow];
479855d1abb9SHong Zhang     aj     = a->j + ai[arow];
4799fff043a9SJunchao Zhang     aa     = a_a + ai[arow];
480055d1abb9SHong Zhang     nextaj = 0;
480155d1abb9SHong Zhang     for (j = 0; nextaj < anzi; j++) {
480255d1abb9SHong Zhang       if (*(bj_i + j) == aj[nextaj]) { /* bcol == acol */
480355d1abb9SHong Zhang         ba_i[j] += aa[nextaj++];
480455d1abb9SHong Zhang       }
480555d1abb9SHong Zhang     }
480655d1abb9SHong Zhang 
480755d1abb9SHong Zhang     /* add received vals into ba */
480855d1abb9SHong Zhang     for (k = 0; k < merge->nrecv; k++) { /* k-th received message */
480955d1abb9SHong Zhang       /* i-th row */
481055d1abb9SHong Zhang       if (i == *nextrow[k]) {
481155d1abb9SHong Zhang         anzi   = *(nextai[k] + 1) - *nextai[k];
4812f4f49eeaSPierre Jolivet         aj     = buf_rj[k] + *nextai[k];
4813f4f49eeaSPierre Jolivet         aa     = abuf_r[k] + *nextai[k];
481455d1abb9SHong Zhang         nextaj = 0;
481555d1abb9SHong Zhang         for (j = 0; nextaj < anzi; j++) {
481655d1abb9SHong Zhang           if (*(bj_i + j) == aj[nextaj]) { /* bcol == acol */
481755d1abb9SHong Zhang             ba_i[j] += aa[nextaj++];
481855d1abb9SHong Zhang           }
481955d1abb9SHong Zhang         }
48209371c9d4SSatish Balay         nextrow[k]++;
48219371c9d4SSatish Balay         nextai[k]++;
482255d1abb9SHong Zhang       }
482355d1abb9SHong Zhang     }
48249566063dSJacob Faibussowitsch     PetscCall(MatSetValues(mpimat, 1, &arow, bnzi, bj_i, ba_i, INSERT_VALUES));
482555d1abb9SHong Zhang   }
48269566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(seqmat, &a_a));
48279566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(mpimat, MAT_FINAL_ASSEMBLY));
48289566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(mpimat, MAT_FINAL_ASSEMBLY));
482955d1abb9SHong Zhang 
48309566063dSJacob Faibussowitsch   PetscCall(PetscFree(abuf_r[0]));
48319566063dSJacob Faibussowitsch   PetscCall(PetscFree(abuf_r));
48329566063dSJacob Faibussowitsch   PetscCall(PetscFree(ba_i));
48339566063dSJacob Faibussowitsch   PetscCall(PetscFree3(buf_ri_k, nextrow, nextai));
48349566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_Seqstompinum, seqmat, 0, 0, 0));
48353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
483655d1abb9SHong Zhang }
483738f152feSBarry Smith 
4838d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateMPIAIJSumSeqAIJSymbolic(MPI_Comm comm, Mat seqmat, PetscInt m, PetscInt n, Mat *mpimat)
4839d71ae5a4SJacob Faibussowitsch {
484055a3bba9SHong Zhang   Mat                  B_mpi;
4841c2234fe3SHong Zhang   Mat_SeqAIJ          *a = (Mat_SeqAIJ *)seqmat->data;
4842b1d57f15SBarry Smith   PetscMPIInt          size, rank, tagi, tagj, *len_s, *len_si, *len_ri;
4843b1d57f15SBarry Smith   PetscInt           **buf_rj, **buf_ri, **buf_ri_k;
4844d0f46423SBarry Smith   PetscInt             M = seqmat->rmap->n, N = seqmat->cmap->n, i, *owners, *ai = a->i, *aj = a->j;
48456497c311SBarry Smith   PetscInt             len, *dnz, *onz, bs, cbs;
4846c599c493SJunchao Zhang   PetscInt             k, anzi, *bi, *bj, *lnk, nlnk, arow, bnzi;
4847b1d57f15SBarry Smith   PetscInt             nrows, *buf_s, *buf_si, *buf_si_i, **nextrow, **nextai;
484855d1abb9SHong Zhang   MPI_Request         *si_waits, *sj_waits, *ri_waits, *rj_waits;
484958cb9c82SHong Zhang   MPI_Status          *status;
48500298fd71SBarry Smith   PetscFreeSpaceList   free_space = NULL, current_space = NULL;
4851be0fcf8dSHong Zhang   PetscBT              lnkbt;
485251a7d1a8SHong Zhang   Mat_Merge_SeqsToMPI *merge;
4853776b82aeSLisandro Dalcin   PetscContainer       container;
485402c68681SHong Zhang 
4855e5f2cdd8SHong Zhang   PetscFunctionBegin;
48569566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_Seqstompisym, seqmat, 0, 0, 0));
48573c2c1871SHong Zhang 
485838f152feSBarry Smith   /* make sure it is a PETSc comm */
48599566063dSJacob Faibussowitsch   PetscCall(PetscCommDuplicate(comm, &comm, NULL));
48609566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
48619566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
486255d1abb9SHong Zhang 
48639566063dSJacob Faibussowitsch   PetscCall(PetscNew(&merge));
48649566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(size, &status));
4865e5f2cdd8SHong Zhang 
48666abd8857SHong Zhang   /* determine row ownership */
48679566063dSJacob Faibussowitsch   PetscCall(PetscLayoutCreate(comm, &merge->rowmap));
48689566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetLocalSize(merge->rowmap, m));
48699566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetSize(merge->rowmap, M));
48709566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetBlockSize(merge->rowmap, 1));
48719566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(merge->rowmap));
48729566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(size, &len_si));
48739566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(size, &merge->len_s));
487455d1abb9SHong Zhang 
48757a2fc3feSBarry Smith   m      = merge->rowmap->n;
48767a2fc3feSBarry Smith   owners = merge->rowmap->range;
48776abd8857SHong Zhang 
48786abd8857SHong Zhang   /* determine the number of messages to send, their lengths */
48793e06a4e6SHong Zhang   len_s = merge->len_s;
488051a7d1a8SHong Zhang 
48812257cef7SHong Zhang   len          = 0; /* length of buf_si[] */
4882c2234fe3SHong Zhang   merge->nsend = 0;
48836497c311SBarry Smith   for (PetscMPIInt proc = 0; proc < size; proc++) {
48842257cef7SHong Zhang     len_si[proc] = 0;
48853e06a4e6SHong Zhang     if (proc == rank) {
48866abd8857SHong Zhang       len_s[proc] = 0;
48873e06a4e6SHong Zhang     } else {
48886497c311SBarry Smith       PetscCall(PetscMPIIntCast(owners[proc + 1] - owners[proc] + 1, &len_si[proc]));
48896497c311SBarry Smith       PetscCall(PetscMPIIntCast(ai[owners[proc + 1]] - ai[owners[proc]], &len_s[proc])); /* num of rows to be sent to [proc] */
48903e06a4e6SHong Zhang     }
48913e06a4e6SHong Zhang     if (len_s[proc]) {
4892c2234fe3SHong Zhang       merge->nsend++;
48932257cef7SHong Zhang       nrows = 0;
48942257cef7SHong Zhang       for (i = owners[proc]; i < owners[proc + 1]; i++) {
48952257cef7SHong Zhang         if (ai[i + 1] > ai[i]) nrows++;
48962257cef7SHong Zhang       }
48976497c311SBarry Smith       PetscCall(PetscMPIIntCast(2 * (nrows + 1), &len_si[proc]));
48982257cef7SHong Zhang       len += len_si[proc];
4899409913e3SHong Zhang     }
490058cb9c82SHong Zhang   }
4901409913e3SHong Zhang 
49022257cef7SHong Zhang   /* determine the number and length of messages to receive for ij-structure */
49039566063dSJacob Faibussowitsch   PetscCall(PetscGatherNumberOfMessages(comm, NULL, len_s, &merge->nrecv));
49049566063dSJacob Faibussowitsch   PetscCall(PetscGatherMessageLengths2(comm, merge->nsend, merge->nrecv, len_s, len_si, &merge->id_r, &merge->len_r, &len_ri));
4905671beff6SHong Zhang 
49063e06a4e6SHong Zhang   /* post the Irecv of j-structure */
49079566063dSJacob Faibussowitsch   PetscCall(PetscCommGetNewTag(comm, &tagj));
49089566063dSJacob Faibussowitsch   PetscCall(PetscPostIrecvInt(comm, tagj, merge->nrecv, merge->id_r, merge->len_r, &buf_rj, &rj_waits));
490902c68681SHong Zhang 
49103e06a4e6SHong Zhang   /* post the Isend of j-structure */
49119566063dSJacob Faibussowitsch   PetscCall(PetscMalloc2(merge->nsend, &si_waits, merge->nsend, &sj_waits));
49123e06a4e6SHong Zhang 
49136497c311SBarry Smith   for (PetscMPIInt proc = 0, k = 0; proc < size; proc++) {
4914409913e3SHong Zhang     if (!len_s[proc]) continue;
491502c68681SHong Zhang     i = owners[proc];
49166497c311SBarry Smith     PetscCallMPI(MPIU_Isend(aj + ai[i], len_s[proc], MPIU_INT, proc, tagj, comm, sj_waits + k));
491751a7d1a8SHong Zhang     k++;
491851a7d1a8SHong Zhang   }
491951a7d1a8SHong Zhang 
49203e06a4e6SHong Zhang   /* receives and sends of j-structure are complete */
49219566063dSJacob Faibussowitsch   if (merge->nrecv) PetscCallMPI(MPI_Waitall(merge->nrecv, rj_waits, status));
49229566063dSJacob Faibussowitsch   if (merge->nsend) PetscCallMPI(MPI_Waitall(merge->nsend, sj_waits, status));
492302c68681SHong Zhang 
492402c68681SHong Zhang   /* send and recv i-structure */
49259566063dSJacob Faibussowitsch   PetscCall(PetscCommGetNewTag(comm, &tagi));
49269566063dSJacob Faibussowitsch   PetscCall(PetscPostIrecvInt(comm, tagi, merge->nrecv, merge->id_r, len_ri, &buf_ri, &ri_waits));
492702c68681SHong Zhang 
49289566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(len + 1, &buf_s));
49293e06a4e6SHong Zhang   buf_si = buf_s; /* points to the beginning of k-th msg to be sent */
49306497c311SBarry Smith   for (PetscMPIInt proc = 0, k = 0; proc < size; proc++) {
493102c68681SHong Zhang     if (!len_s[proc]) continue;
49323e06a4e6SHong Zhang     /* form outgoing message for i-structure:
49333e06a4e6SHong Zhang          buf_si[0]:                 nrows to be sent
49343e06a4e6SHong Zhang                [1:nrows]:           row index (global)
49353e06a4e6SHong Zhang                [nrows+1:2*nrows+1]: i-structure index
49363e06a4e6SHong Zhang     */
49372257cef7SHong Zhang     nrows       = len_si[proc] / 2 - 1;
49383e06a4e6SHong Zhang     buf_si_i    = buf_si + nrows + 1;
49393e06a4e6SHong Zhang     buf_si[0]   = nrows;
49403e06a4e6SHong Zhang     buf_si_i[0] = 0;
49413e06a4e6SHong Zhang     nrows       = 0;
49423e06a4e6SHong Zhang     for (i = owners[proc]; i < owners[proc + 1]; i++) {
49433e06a4e6SHong Zhang       anzi = ai[i + 1] - ai[i];
49443e06a4e6SHong Zhang       if (anzi) {
49453e06a4e6SHong Zhang         buf_si_i[nrows + 1] = buf_si_i[nrows] + anzi; /* i-structure */
49463e06a4e6SHong Zhang         buf_si[nrows + 1]   = i - owners[proc];       /* local row index */
49473e06a4e6SHong Zhang         nrows++;
49483e06a4e6SHong Zhang       }
49493e06a4e6SHong Zhang     }
49506497c311SBarry Smith     PetscCallMPI(MPIU_Isend(buf_si, len_si[proc], MPIU_INT, proc, tagi, comm, si_waits + k));
495102c68681SHong Zhang     k++;
49522257cef7SHong Zhang     buf_si += len_si[proc];
495302c68681SHong Zhang   }
49542257cef7SHong Zhang 
49559566063dSJacob Faibussowitsch   if (merge->nrecv) PetscCallMPI(MPI_Waitall(merge->nrecv, ri_waits, status));
49569566063dSJacob Faibussowitsch   if (merge->nsend) PetscCallMPI(MPI_Waitall(merge->nsend, si_waits, status));
495702c68681SHong Zhang 
49589566063dSJacob Faibussowitsch   PetscCall(PetscInfo(seqmat, "nsend: %d, nrecv: %d\n", merge->nsend, merge->nrecv));
495948a46eb9SPierre Jolivet   for (i = 0; i < merge->nrecv; i++) PetscCall(PetscInfo(seqmat, "recv len_ri=%d, len_rj=%d from [%d]\n", len_ri[i], merge->len_r[i], merge->id_r[i]));
49603e06a4e6SHong Zhang 
49619566063dSJacob Faibussowitsch   PetscCall(PetscFree(len_si));
49629566063dSJacob Faibussowitsch   PetscCall(PetscFree(len_ri));
49639566063dSJacob Faibussowitsch   PetscCall(PetscFree(rj_waits));
49649566063dSJacob Faibussowitsch   PetscCall(PetscFree2(si_waits, sj_waits));
49659566063dSJacob Faibussowitsch   PetscCall(PetscFree(ri_waits));
49669566063dSJacob Faibussowitsch   PetscCall(PetscFree(buf_s));
49679566063dSJacob Faibussowitsch   PetscCall(PetscFree(status));
496858cb9c82SHong Zhang 
4969bcc1bcd5SHong Zhang   /* compute a local seq matrix in each processor */
497058cb9c82SHong Zhang   /* allocate bi array and free space for accumulating nonzero column info */
49719566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m + 1, &bi));
497258cb9c82SHong Zhang   bi[0] = 0;
497358cb9c82SHong Zhang 
4974be0fcf8dSHong Zhang   /* create and initialize a linked list */
4975be0fcf8dSHong Zhang   nlnk = N + 1;
49769566063dSJacob Faibussowitsch   PetscCall(PetscLLCreate(N, N, nlnk, lnk, lnkbt));
497758cb9c82SHong Zhang 
4978bcc1bcd5SHong Zhang   /* initial FreeSpace size is 2*(num of local nnz(seqmat)) */
4979bcc1bcd5SHong Zhang   len = ai[owners[rank + 1]] - ai[owners[rank]];
49809566063dSJacob Faibussowitsch   PetscCall(PetscFreeSpaceGet(PetscIntMultTruncate(2, len) + 1, &free_space));
49812205254eSKarl Rupp 
498258cb9c82SHong Zhang   current_space = free_space;
498358cb9c82SHong Zhang 
4984bcc1bcd5SHong Zhang   /* determine symbolic info for each local row */
49859566063dSJacob Faibussowitsch   PetscCall(PetscMalloc3(merge->nrecv, &buf_ri_k, merge->nrecv, &nextrow, merge->nrecv, &nextai));
49861d79065fSBarry Smith 
49873e06a4e6SHong Zhang   for (k = 0; k < merge->nrecv; k++) {
49882257cef7SHong Zhang     buf_ri_k[k] = buf_ri[k]; /* beginning of k-th recved i-structure */
49893e06a4e6SHong Zhang     nrows       = *buf_ri_k[k];
49903e06a4e6SHong Zhang     nextrow[k]  = buf_ri_k[k] + 1;           /* next row number of k-th recved i-structure */
4991a5b23f4aSJose E. Roman     nextai[k]   = buf_ri_k[k] + (nrows + 1); /* points to the next i-structure of k-th recved i-structure  */
49923e06a4e6SHong Zhang   }
49932257cef7SHong Zhang 
4994d0609cedSBarry Smith   MatPreallocateBegin(comm, m, n, dnz, onz);
4995bcc1bcd5SHong Zhang   len = 0;
499658cb9c82SHong Zhang   for (i = 0; i < m; i++) {
499758cb9c82SHong Zhang     bnzi = 0;
499858cb9c82SHong Zhang     /* add local non-zero cols of this proc's seqmat into lnk */
499958cb9c82SHong Zhang     arow = owners[rank] + i;
500058cb9c82SHong Zhang     anzi = ai[arow + 1] - ai[arow];
500158cb9c82SHong Zhang     aj   = a->j + ai[arow];
50029566063dSJacob Faibussowitsch     PetscCall(PetscLLAddSorted(anzi, aj, N, &nlnk, lnk, lnkbt));
500358cb9c82SHong Zhang     bnzi += nlnk;
500458cb9c82SHong Zhang     /* add received col data into lnk */
500551a7d1a8SHong Zhang     for (k = 0; k < merge->nrecv; k++) { /* k-th received message */
500655d1abb9SHong Zhang       if (i == *nextrow[k]) {            /* i-th row */
50073e06a4e6SHong Zhang         anzi = *(nextai[k] + 1) - *nextai[k];
50083e06a4e6SHong Zhang         aj   = buf_rj[k] + *nextai[k];
50099566063dSJacob Faibussowitsch         PetscCall(PetscLLAddSorted(anzi, aj, N, &nlnk, lnk, lnkbt));
50103e06a4e6SHong Zhang         bnzi += nlnk;
50119371c9d4SSatish Balay         nextrow[k]++;
50129371c9d4SSatish Balay         nextai[k]++;
50133e06a4e6SHong Zhang       }
501458cb9c82SHong Zhang     }
5015bcc1bcd5SHong Zhang     if (len < bnzi) len = bnzi; /* =max(bnzi) */
501658cb9c82SHong Zhang 
501758cb9c82SHong Zhang     /* if free space is not available, make more free space */
501848a46eb9SPierre Jolivet     if (current_space->local_remaining < bnzi) PetscCall(PetscFreeSpaceGet(PetscIntSumTruncate(bnzi, current_space->total_array_size), &current_space));
501958cb9c82SHong Zhang     /* copy data into free space, then initialize lnk */
50209566063dSJacob Faibussowitsch     PetscCall(PetscLLClean(N, N, bnzi, lnk, current_space->array, lnkbt));
50219566063dSJacob Faibussowitsch     PetscCall(MatPreallocateSet(i + owners[rank], bnzi, current_space->array, dnz, onz));
5022bcc1bcd5SHong Zhang 
502358cb9c82SHong Zhang     current_space->array += bnzi;
502458cb9c82SHong Zhang     current_space->local_used += bnzi;
502558cb9c82SHong Zhang     current_space->local_remaining -= bnzi;
502658cb9c82SHong Zhang 
502758cb9c82SHong Zhang     bi[i + 1] = bi[i] + bnzi;
502858cb9c82SHong Zhang   }
5029bcc1bcd5SHong Zhang 
50309566063dSJacob Faibussowitsch   PetscCall(PetscFree3(buf_ri_k, nextrow, nextai));
5031bcc1bcd5SHong Zhang 
50329566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(bi[m] + 1, &bj));
50339566063dSJacob Faibussowitsch   PetscCall(PetscFreeSpaceContiguous(&free_space, bj));
50349566063dSJacob Faibussowitsch   PetscCall(PetscLLDestroy(lnk, lnkbt));
5035409913e3SHong Zhang 
5036bcc1bcd5SHong Zhang   /* create symbolic parallel matrix B_mpi */
50379566063dSJacob Faibussowitsch   PetscCall(MatGetBlockSizes(seqmat, &bs, &cbs));
50389566063dSJacob Faibussowitsch   PetscCall(MatCreate(comm, &B_mpi));
503954b84b50SHong Zhang   if (n == PETSC_DECIDE) {
50409566063dSJacob Faibussowitsch     PetscCall(MatSetSizes(B_mpi, m, n, PETSC_DETERMINE, N));
504154b84b50SHong Zhang   } else {
50429566063dSJacob Faibussowitsch     PetscCall(MatSetSizes(B_mpi, m, n, PETSC_DETERMINE, PETSC_DETERMINE));
504354b84b50SHong Zhang   }
50449566063dSJacob Faibussowitsch   PetscCall(MatSetBlockSizes(B_mpi, bs, cbs));
50459566063dSJacob Faibussowitsch   PetscCall(MatSetType(B_mpi, MATMPIAIJ));
50469566063dSJacob Faibussowitsch   PetscCall(MatMPIAIJSetPreallocation(B_mpi, 0, dnz, 0, onz));
5047d0609cedSBarry Smith   MatPreallocateEnd(dnz, onz);
50489566063dSJacob Faibussowitsch   PetscCall(MatSetOption(B_mpi, MAT_NEW_NONZERO_ALLOCATION_ERR, PETSC_FALSE));
504958cb9c82SHong Zhang 
505090431a8fSHong Zhang   /* B_mpi is not ready for use - assembly will be done by MatCreateMPIAIJSumSeqAIJNumeric() */
50516abd8857SHong Zhang   B_mpi->assembled = PETSC_FALSE;
5052affca5deSHong Zhang   merge->bi        = bi;
5053affca5deSHong Zhang   merge->bj        = bj;
505402c68681SHong Zhang   merge->buf_ri    = buf_ri;
505502c68681SHong Zhang   merge->buf_rj    = buf_rj;
50560298fd71SBarry Smith   merge->coi       = NULL;
50570298fd71SBarry Smith   merge->coj       = NULL;
50580298fd71SBarry Smith   merge->owners_co = NULL;
5059affca5deSHong Zhang 
50609566063dSJacob Faibussowitsch   PetscCall(PetscCommDestroy(&comm));
5061bf0cc555SLisandro Dalcin 
5062affca5deSHong Zhang   /* attach the supporting struct to B_mpi for reuse */
50639566063dSJacob Faibussowitsch   PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &container));
50649566063dSJacob Faibussowitsch   PetscCall(PetscContainerSetPointer(container, merge));
506549abdd8aSBarry Smith   PetscCall(PetscContainerSetCtxDestroy(container, MatDestroy_MPIAIJ_SeqsToMPI));
50669566063dSJacob Faibussowitsch   PetscCall(PetscObjectCompose((PetscObject)B_mpi, "MatMergeSeqsToMPI", (PetscObject)container));
50679566063dSJacob Faibussowitsch   PetscCall(PetscContainerDestroy(&container));
5068affca5deSHong Zhang   *mpimat = B_mpi;
506938f152feSBarry Smith 
50709566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_Seqstompisym, seqmat, 0, 0, 0));
50713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5072e5f2cdd8SHong Zhang }
507325616d81SHong Zhang 
5074cc4c1da9SBarry Smith /*@
507511a5261eSBarry Smith   MatCreateMPIAIJSumSeqAIJ - Creates a `MATMPIAIJ` matrix by adding sequential
5076d4036a1aSHong Zhang   matrices from each processor
5077d4036a1aSHong Zhang 
5078d083f849SBarry Smith   Collective
5079d4036a1aSHong Zhang 
5080d4036a1aSHong Zhang   Input Parameters:
5081d4036a1aSHong Zhang + comm   - the communicators the parallel matrix will live on
5082d4036a1aSHong Zhang . seqmat - the input sequential matrices
508311a5261eSBarry Smith . m      - number of local rows (or `PETSC_DECIDE`)
508411a5261eSBarry Smith . n      - number of local columns (or `PETSC_DECIDE`)
508511a5261eSBarry Smith - scall  - either `MAT_INITIAL_MATRIX` or `MAT_REUSE_MATRIX`
5086d4036a1aSHong Zhang 
5087d4036a1aSHong Zhang   Output Parameter:
5088d4036a1aSHong Zhang . mpimat - the parallel matrix generated
5089d4036a1aSHong Zhang 
5090d4036a1aSHong Zhang   Level: advanced
5091d4036a1aSHong Zhang 
509211a5261eSBarry Smith   Note:
5093d4036a1aSHong Zhang   The dimensions of the sequential matrix in each processor MUST be the same.
5094d4036a1aSHong Zhang   The input seqmat is included into the container "Mat_Merge_SeqsToMPI", and will be
5095b6971eaeSBarry Smith   destroyed when `mpimat` is destroyed. Call `PetscObjectQuery()` to access `seqmat`.
50962ef1f0ffSBarry Smith 
50971cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MatCreateAIJ()`
5098d4036a1aSHong Zhang @*/
5099d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateMPIAIJSumSeqAIJ(MPI_Comm comm, Mat seqmat, PetscInt m, PetscInt n, MatReuse scall, Mat *mpimat)
5100d71ae5a4SJacob Faibussowitsch {
51017e63b356SHong Zhang   PetscMPIInt size;
510255d1abb9SHong Zhang 
510355d1abb9SHong Zhang   PetscFunctionBegin;
51049566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
51057e63b356SHong Zhang   if (size == 1) {
51069566063dSJacob Faibussowitsch     PetscCall(PetscLogEventBegin(MAT_Seqstompi, seqmat, 0, 0, 0));
51077e63b356SHong Zhang     if (scall == MAT_INITIAL_MATRIX) {
51089566063dSJacob Faibussowitsch       PetscCall(MatDuplicate(seqmat, MAT_COPY_VALUES, mpimat));
51097e63b356SHong Zhang     } else {
51109566063dSJacob Faibussowitsch       PetscCall(MatCopy(seqmat, *mpimat, SAME_NONZERO_PATTERN));
51117e63b356SHong Zhang     }
51129566063dSJacob Faibussowitsch     PetscCall(PetscLogEventEnd(MAT_Seqstompi, seqmat, 0, 0, 0));
51133ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
51147e63b356SHong Zhang   }
51159566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_Seqstompi, seqmat, 0, 0, 0));
511648a46eb9SPierre Jolivet   if (scall == MAT_INITIAL_MATRIX) PetscCall(MatCreateMPIAIJSumSeqAIJSymbolic(comm, seqmat, m, n, mpimat));
51179566063dSJacob Faibussowitsch   PetscCall(MatCreateMPIAIJSumSeqAIJNumeric(seqmat, *mpimat));
51189566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_Seqstompi, seqmat, 0, 0, 0));
51193ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
512055d1abb9SHong Zhang }
51214ebed01fSBarry Smith 
5122bc08b0f1SBarry Smith /*@
51232920cce0SJacob Faibussowitsch   MatAIJGetLocalMat - Creates a `MATSEQAIJ` from a `MATAIJ` matrix.
51248a9c020eSBarry Smith 
51258a9c020eSBarry Smith   Not Collective
51268a9c020eSBarry Smith 
51272fe279fdSBarry Smith   Input Parameter:
512820f4b53cSBarry Smith . A - the matrix
51298a9c020eSBarry Smith 
51308a9c020eSBarry Smith   Output Parameter:
51318a9c020eSBarry Smith . A_loc - the local sequential matrix generated
51328a9c020eSBarry Smith 
51338a9c020eSBarry Smith   Level: developer
51348a9c020eSBarry Smith 
51358a9c020eSBarry Smith   Notes:
51362920cce0SJacob Faibussowitsch   The matrix is created by taking `A`'s local rows and putting them into a sequential matrix
51372920cce0SJacob Faibussowitsch   with `mlocal` rows and `n` columns. Where `mlocal` is obtained with `MatGetLocalSize()` and
51382920cce0SJacob Faibussowitsch   `n` is the global column count obtained with `MatGetSize()`
51392920cce0SJacob Faibussowitsch 
514011a5261eSBarry Smith   In other words combines the two parts of a parallel `MATMPIAIJ` matrix on each process to a single matrix.
51418a9c020eSBarry Smith 
51422920cce0SJacob Faibussowitsch   For parallel matrices this creates an entirely new matrix. If the matrix is sequential it merely increases the reference count.
51432920cce0SJacob Faibussowitsch 
514411a5261eSBarry Smith   Destroy the matrix with `MatDestroy()`
51458a9c020eSBarry Smith 
51461cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MatMPIAIJGetLocalMat()`
51478a9c020eSBarry Smith @*/
5148d71ae5a4SJacob Faibussowitsch PetscErrorCode MatAIJGetLocalMat(Mat A, Mat *A_loc)
5149d71ae5a4SJacob Faibussowitsch {
51508a9c020eSBarry Smith   PetscBool mpi;
51518a9c020eSBarry Smith 
51528a9c020eSBarry Smith   PetscFunctionBegin;
51538a9c020eSBarry Smith   PetscCall(PetscObjectTypeCompare((PetscObject)A, MATMPIAIJ, &mpi));
51548a9c020eSBarry Smith   if (mpi) {
51558a9c020eSBarry Smith     PetscCall(MatMPIAIJGetLocalMat(A, MAT_INITIAL_MATRIX, A_loc));
51568a9c020eSBarry Smith   } else {
51578a9c020eSBarry Smith     *A_loc = A;
51588a9c020eSBarry Smith     PetscCall(PetscObjectReference((PetscObject)*A_loc));
51598a9c020eSBarry Smith   }
51603ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
51618a9c020eSBarry Smith }
51628a9c020eSBarry Smith 
51638a9c020eSBarry Smith /*@
51642920cce0SJacob Faibussowitsch   MatMPIAIJGetLocalMat - Creates a `MATSEQAIJ` from a `MATMPIAIJ` matrix.
516525616d81SHong Zhang 
516632fba14fSHong Zhang   Not Collective
516725616d81SHong Zhang 
516825616d81SHong Zhang   Input Parameters:
516925616d81SHong Zhang + A     - the matrix
517011a5261eSBarry Smith - scall - either `MAT_INITIAL_MATRIX` or `MAT_REUSE_MATRIX`
517125616d81SHong Zhang 
517225616d81SHong Zhang   Output Parameter:
517325616d81SHong Zhang . A_loc - the local sequential matrix generated
517425616d81SHong Zhang 
517525616d81SHong Zhang   Level: developer
517625616d81SHong Zhang 
517777c65a98SStefano Zampini   Notes:
51782920cce0SJacob Faibussowitsch   The matrix is created by taking all `A`'s local rows and putting them into a sequential
51792920cce0SJacob Faibussowitsch   matrix with `mlocal` rows and `n` columns.`mlocal` is the row count obtained with
51802920cce0SJacob Faibussowitsch   `MatGetLocalSize()` and `n` is the global column count obtained with `MatGetSize()`.
51812920cce0SJacob Faibussowitsch 
518211a5261eSBarry Smith   In other words combines the two parts of a parallel `MATMPIAIJ` matrix on each process to a single matrix.
51838a9c020eSBarry Smith 
51842920cce0SJacob Faibussowitsch   When `A` is sequential and `MAT_INITIAL_MATRIX` is requested, the matrix returned is the diagonal part of `A` (which contains the entire matrix),
51852920cce0SJacob Faibussowitsch   with its reference count increased by one. Hence changing values of `A_loc` changes `A`. If `MAT_REUSE_MATRIX` is requested on a sequential matrix
51862920cce0SJacob Faibussowitsch   then `MatCopy`(Adiag,*`A_loc`,`SAME_NONZERO_PATTERN`) is called to fill `A_loc`. Thus one can preallocate the appropriate sequential matrix `A_loc`
51872920cce0SJacob Faibussowitsch   and then call this routine with `MAT_REUSE_MATRIX`. In this case, one can modify the values of `A_loc` without affecting the original sequential matrix.
518877c65a98SStefano Zampini 
51891cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MatGetOwnershipRange()`, `MatMPIAIJGetLocalMatCondensed()`, `MatMPIAIJGetLocalMatMerge()`
519025616d81SHong Zhang @*/
5191d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJGetLocalMat(Mat A, MatReuse scall, Mat *A_loc)
5192d71ae5a4SJacob Faibussowitsch {
519301b7ae99SHong Zhang   Mat_MPIAIJ        *mpimat = (Mat_MPIAIJ *)A->data;
5194b78526a6SJose E. Roman   Mat_SeqAIJ        *mat, *a, *b;
5195b78526a6SJose E. Roman   PetscInt          *ai, *aj, *bi, *bj, *cmap = mpimat->garray;
5196ce496241SStefano Zampini   const PetscScalar *aa, *ba, *aav, *bav;
5197ce496241SStefano Zampini   PetscScalar       *ca, *cam;
519877c65a98SStefano Zampini   PetscMPIInt        size;
5199d0f46423SBarry Smith   PetscInt           am = A->rmap->n, i, j, k, cstart = A->cmap->rstart;
52005a7d977cSHong Zhang   PetscInt          *ci, *cj, col, ncols_d, ncols_o, jo;
52018661ff28SBarry Smith   PetscBool          match;
520225616d81SHong Zhang 
520325616d81SHong Zhang   PetscFunctionBegin;
52049566063dSJacob Faibussowitsch   PetscCall(PetscStrbeginswith(((PetscObject)A)->type_name, MATMPIAIJ, &match));
520528b400f6SJacob Faibussowitsch   PetscCheck(match, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "Requires MATMPIAIJ matrix as input");
52069566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(PetscObjectComm((PetscObject)A), &size));
520777c65a98SStefano Zampini   if (size == 1) {
520877c65a98SStefano Zampini     if (scall == MAT_INITIAL_MATRIX) {
52099566063dSJacob Faibussowitsch       PetscCall(PetscObjectReference((PetscObject)mpimat->A));
521077c65a98SStefano Zampini       *A_loc = mpimat->A;
521177c65a98SStefano Zampini     } else if (scall == MAT_REUSE_MATRIX) {
52129566063dSJacob Faibussowitsch       PetscCall(MatCopy(mpimat->A, *A_loc, SAME_NONZERO_PATTERN));
521377c65a98SStefano Zampini     }
52143ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
521577c65a98SStefano Zampini   }
521670a9ba44SHong Zhang 
52179566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_Getlocalmat, A, 0, 0, 0));
5218f4f49eeaSPierre Jolivet   a  = (Mat_SeqAIJ *)mpimat->A->data;
5219f4f49eeaSPierre Jolivet   b  = (Mat_SeqAIJ *)mpimat->B->data;
52209371c9d4SSatish Balay   ai = a->i;
52219371c9d4SSatish Balay   aj = a->j;
52229371c9d4SSatish Balay   bi = b->i;
52239371c9d4SSatish Balay   bj = b->j;
52249566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(mpimat->A, &aav));
52259566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(mpimat->B, &bav));
5226ce496241SStefano Zampini   aa = aav;
5227ce496241SStefano Zampini   ba = bav;
522801b7ae99SHong Zhang   if (scall == MAT_INITIAL_MATRIX) {
52299566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(1 + am, &ci));
5230dea91ad1SHong Zhang     ci[0] = 0;
5231ad540459SPierre Jolivet     for (i = 0; i < am; i++) ci[i + 1] = ci[i] + (ai[i + 1] - ai[i]) + (bi[i + 1] - bi[i]);
52329566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(1 + ci[am], &cj));
52339566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(1 + ci[am], &ca));
5234dea91ad1SHong Zhang     k = 0;
523501b7ae99SHong Zhang     for (i = 0; i < am; i++) {
52365a7d977cSHong Zhang       ncols_o = bi[i + 1] - bi[i];
52375a7d977cSHong Zhang       ncols_d = ai[i + 1] - ai[i];
523801b7ae99SHong Zhang       /* off-diagonal portion of A */
52395a7d977cSHong Zhang       for (jo = 0; jo < ncols_o; jo++) {
52405a7d977cSHong Zhang         col = cmap[*bj];
52415a7d977cSHong Zhang         if (col >= cstart) break;
52429371c9d4SSatish Balay         cj[k] = col;
52439371c9d4SSatish Balay         bj++;
52445a7d977cSHong Zhang         ca[k++] = *ba++;
52455a7d977cSHong Zhang       }
52465a7d977cSHong Zhang       /* diagonal portion of A */
52475a7d977cSHong Zhang       for (j = 0; j < ncols_d; j++) {
52485a7d977cSHong Zhang         cj[k]   = cstart + *aj++;
52495a7d977cSHong Zhang         ca[k++] = *aa++;
52505a7d977cSHong Zhang       }
52515a7d977cSHong Zhang       /* off-diagonal portion of A */
52525a7d977cSHong Zhang       for (j = jo; j < ncols_o; j++) {
52535a7d977cSHong Zhang         cj[k]   = cmap[*bj++];
52545a7d977cSHong Zhang         ca[k++] = *ba++;
52555a7d977cSHong Zhang       }
525625616d81SHong Zhang     }
5257dea91ad1SHong Zhang     /* put together the new matrix */
52589566063dSJacob Faibussowitsch     PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, am, A->cmap->N, ci, cj, ca, A_loc));
5259dea91ad1SHong Zhang     /* MatCreateSeqAIJWithArrays flags matrix so PETSc doesn't free the user's arrays. */
5260dea91ad1SHong Zhang     /* Since these are PETSc arrays, change flags to free them as necessary. */
5261dea91ad1SHong Zhang     mat          = (Mat_SeqAIJ *)(*A_loc)->data;
5262e6b907acSBarry Smith     mat->free_a  = PETSC_TRUE;
5263e6b907acSBarry Smith     mat->free_ij = PETSC_TRUE;
5264dea91ad1SHong Zhang     mat->nonew   = 0;
52655a7d977cSHong Zhang   } else if (scall == MAT_REUSE_MATRIX) {
52665a7d977cSHong Zhang     mat = (Mat_SeqAIJ *)(*A_loc)->data;
5267fff043a9SJunchao Zhang     ci  = mat->i;
5268fff043a9SJunchao Zhang     cj  = mat->j;
52699566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayWrite(*A_loc, &cam));
52705a7d977cSHong Zhang     for (i = 0; i < am; i++) {
52715a7d977cSHong Zhang       /* off-diagonal portion of A */
52725a7d977cSHong Zhang       ncols_o = bi[i + 1] - bi[i];
52735a7d977cSHong Zhang       for (jo = 0; jo < ncols_o; jo++) {
52745a7d977cSHong Zhang         col = cmap[*bj];
52755a7d977cSHong Zhang         if (col >= cstart) break;
52769371c9d4SSatish Balay         *cam++ = *ba++;
52779371c9d4SSatish Balay         bj++;
52785a7d977cSHong Zhang       }
52795a7d977cSHong Zhang       /* diagonal portion of A */
5280ecc9b87dSHong Zhang       ncols_d = ai[i + 1] - ai[i];
5281a77337e4SBarry Smith       for (j = 0; j < ncols_d; j++) *cam++ = *aa++;
52825a7d977cSHong Zhang       /* off-diagonal portion of A */
5283f33d1a9aSHong Zhang       for (j = jo; j < ncols_o; j++) {
52849371c9d4SSatish Balay         *cam++ = *ba++;
52859371c9d4SSatish Balay         bj++;
5286f33d1a9aSHong Zhang       }
52875a7d977cSHong Zhang     }
52889566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayWrite(*A_loc, &cam));
528998921bdaSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid MatReuse %d", (int)scall);
52909566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(mpimat->A, &aav));
52919566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(mpimat->B, &bav));
52929566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_Getlocalmat, A, 0, 0, 0));
52933ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
529425616d81SHong Zhang }
529525616d81SHong Zhang 
5296ed502f03SStefano Zampini /*@
529711a5261eSBarry Smith   MatMPIAIJGetLocalMatMerge - Creates a `MATSEQAIJ` from a `MATMPIAIJ` matrix by taking all its local rows and putting them into a sequential matrix with
52984cf0e950SBarry Smith   mlocal rows and n columns. Where n is the sum of the number of columns of the diagonal and off-diagonal part
5299ed502f03SStefano Zampini 
5300ed502f03SStefano Zampini   Not Collective
5301ed502f03SStefano Zampini 
5302ed502f03SStefano Zampini   Input Parameters:
5303ed502f03SStefano Zampini + A     - the matrix
530411a5261eSBarry Smith - scall - either `MAT_INITIAL_MATRIX` or `MAT_REUSE_MATRIX`
5305ed502f03SStefano Zampini 
5306d8d19677SJose E. Roman   Output Parameters:
53072ef1f0ffSBarry Smith + glob  - sequential `IS` with global indices associated with the columns of the local sequential matrix generated (can be `NULL`)
5308ed502f03SStefano Zampini - A_loc - the local sequential matrix generated
5309ed502f03SStefano Zampini 
5310ed502f03SStefano Zampini   Level: developer
5311ed502f03SStefano Zampini 
531211a5261eSBarry Smith   Note:
53132ef1f0ffSBarry Smith   This is different from `MatMPIAIJGetLocalMat()` since the first columns in the returning matrix are those associated with the diagonal
53144cf0e950SBarry Smith   part, then those associated with the off-diagonal part (in its local ordering)
5315ed502f03SStefano Zampini 
53161cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MatGetOwnershipRange()`, `MatMPIAIJGetLocalMat()`, `MatMPIAIJGetLocalMatCondensed()`
5317ed502f03SStefano Zampini @*/
5318d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJGetLocalMatMerge(Mat A, MatReuse scall, IS *glob, Mat *A_loc)
5319d71ae5a4SJacob Faibussowitsch {
5320ed502f03SStefano Zampini   Mat             Ao, Ad;
5321ed502f03SStefano Zampini   const PetscInt *cmap;
5322ed502f03SStefano Zampini   PetscMPIInt     size;
5323ed502f03SStefano Zampini   PetscErrorCode (*f)(Mat, MatReuse, IS *, Mat *);
5324ed502f03SStefano Zampini 
5325ed502f03SStefano Zampini   PetscFunctionBegin;
53269566063dSJacob Faibussowitsch   PetscCall(MatMPIAIJGetSeqAIJ(A, &Ad, &Ao, &cmap));
53279566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(PetscObjectComm((PetscObject)A), &size));
5328ed502f03SStefano Zampini   if (size == 1) {
5329ed502f03SStefano Zampini     if (scall == MAT_INITIAL_MATRIX) {
53309566063dSJacob Faibussowitsch       PetscCall(PetscObjectReference((PetscObject)Ad));
5331ed502f03SStefano Zampini       *A_loc = Ad;
5332ed502f03SStefano Zampini     } else if (scall == MAT_REUSE_MATRIX) {
53339566063dSJacob Faibussowitsch       PetscCall(MatCopy(Ad, *A_loc, SAME_NONZERO_PATTERN));
5334ed502f03SStefano Zampini     }
53359566063dSJacob Faibussowitsch     if (glob) PetscCall(ISCreateStride(PetscObjectComm((PetscObject)Ad), Ad->cmap->n, Ad->cmap->rstart, 1, glob));
53363ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
5337ed502f03SStefano Zampini   }
53389566063dSJacob Faibussowitsch   PetscCall(PetscObjectQueryFunction((PetscObject)A, "MatMPIAIJGetLocalMatMerge_C", &f));
53399566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_Getlocalmat, A, 0, 0, 0));
5340ed502f03SStefano Zampini   if (f) {
53419566063dSJacob Faibussowitsch     PetscCall((*f)(A, scall, glob, A_loc));
5342ed502f03SStefano Zampini   } else {
5343ed502f03SStefano Zampini     Mat_SeqAIJ        *a = (Mat_SeqAIJ *)Ad->data;
5344ed502f03SStefano Zampini     Mat_SeqAIJ        *b = (Mat_SeqAIJ *)Ao->data;
5345ed502f03SStefano Zampini     Mat_SeqAIJ        *c;
5346ed502f03SStefano Zampini     PetscInt          *ai = a->i, *aj = a->j;
5347ed502f03SStefano Zampini     PetscInt          *bi = b->i, *bj = b->j;
5348ed502f03SStefano Zampini     PetscInt          *ci, *cj;
5349ed502f03SStefano Zampini     const PetscScalar *aa, *ba;
5350ed502f03SStefano Zampini     PetscScalar       *ca;
5351ed502f03SStefano Zampini     PetscInt           i, j, am, dn, on;
5352ed502f03SStefano Zampini 
53539566063dSJacob Faibussowitsch     PetscCall(MatGetLocalSize(Ad, &am, &dn));
53549566063dSJacob Faibussowitsch     PetscCall(MatGetLocalSize(Ao, NULL, &on));
53559566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(Ad, &aa));
53569566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(Ao, &ba));
5357ed502f03SStefano Zampini     if (scall == MAT_INITIAL_MATRIX) {
5358ed502f03SStefano Zampini       PetscInt k;
53599566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(1 + am, &ci));
53609566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(ai[am] + bi[am], &cj));
53619566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(ai[am] + bi[am], &ca));
5362ed502f03SStefano Zampini       ci[0] = 0;
5363ed502f03SStefano Zampini       for (i = 0, k = 0; i < am; i++) {
5364ed502f03SStefano Zampini         const PetscInt ncols_o = bi[i + 1] - bi[i];
5365ed502f03SStefano Zampini         const PetscInt ncols_d = ai[i + 1] - ai[i];
5366ed502f03SStefano Zampini         ci[i + 1]              = ci[i] + ncols_o + ncols_d;
5367ed502f03SStefano Zampini         /* diagonal portion of A */
5368ed502f03SStefano Zampini         for (j = 0; j < ncols_d; j++, k++) {
5369ed502f03SStefano Zampini           cj[k] = *aj++;
5370ed502f03SStefano Zampini           ca[k] = *aa++;
5371ed502f03SStefano Zampini         }
5372ed502f03SStefano Zampini         /* off-diagonal portion of A */
5373ed502f03SStefano Zampini         for (j = 0; j < ncols_o; j++, k++) {
5374ed502f03SStefano Zampini           cj[k] = dn + *bj++;
5375ed502f03SStefano Zampini           ca[k] = *ba++;
5376ed502f03SStefano Zampini         }
5377ed502f03SStefano Zampini       }
5378ed502f03SStefano Zampini       /* put together the new matrix */
53799566063dSJacob Faibussowitsch       PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, am, dn + on, ci, cj, ca, A_loc));
5380ed502f03SStefano Zampini       /* MatCreateSeqAIJWithArrays flags matrix so PETSc doesn't free the user's arrays. */
5381ed502f03SStefano Zampini       /* Since these are PETSc arrays, change flags to free them as necessary. */
5382ed502f03SStefano Zampini       c          = (Mat_SeqAIJ *)(*A_loc)->data;
5383ed502f03SStefano Zampini       c->free_a  = PETSC_TRUE;
5384ed502f03SStefano Zampini       c->free_ij = PETSC_TRUE;
5385ed502f03SStefano Zampini       c->nonew   = 0;
53869566063dSJacob Faibussowitsch       PetscCall(MatSetType(*A_loc, ((PetscObject)Ad)->type_name));
5387ed502f03SStefano Zampini     } else if (scall == MAT_REUSE_MATRIX) {
53889566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJGetArrayWrite(*A_loc, &ca));
5389ed502f03SStefano Zampini       for (i = 0; i < am; i++) {
5390ed502f03SStefano Zampini         const PetscInt ncols_d = ai[i + 1] - ai[i];
5391ed502f03SStefano Zampini         const PetscInt ncols_o = bi[i + 1] - bi[i];
5392ed502f03SStefano Zampini         /* diagonal portion of A */
5393ed502f03SStefano Zampini         for (j = 0; j < ncols_d; j++) *ca++ = *aa++;
5394ed502f03SStefano Zampini         /* off-diagonal portion of A */
5395ed502f03SStefano Zampini         for (j = 0; j < ncols_o; j++) *ca++ = *ba++;
5396ed502f03SStefano Zampini       }
53979566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJRestoreArrayWrite(*A_loc, &ca));
539898921bdaSJacob Faibussowitsch     } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Invalid MatReuse %d", (int)scall);
53999566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(Ad, &aa));
54009566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(Ao, &aa));
5401ed502f03SStefano Zampini     if (glob) {
5402ed502f03SStefano Zampini       PetscInt cst, *gidx;
5403ed502f03SStefano Zampini 
54049566063dSJacob Faibussowitsch       PetscCall(MatGetOwnershipRangeColumn(A, &cst, NULL));
54059566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(dn + on, &gidx));
5406ed502f03SStefano Zampini       for (i = 0; i < dn; i++) gidx[i] = cst + i;
5407ed502f03SStefano Zampini       for (i = 0; i < on; i++) gidx[i + dn] = cmap[i];
54089566063dSJacob Faibussowitsch       PetscCall(ISCreateGeneral(PetscObjectComm((PetscObject)Ad), dn + on, gidx, PETSC_OWN_POINTER, glob));
5409ed502f03SStefano Zampini     }
5410ed502f03SStefano Zampini   }
54119566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_Getlocalmat, A, 0, 0, 0));
54123ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
5413ed502f03SStefano Zampini }
5414ed502f03SStefano Zampini 
541532fba14fSHong Zhang /*@C
541611a5261eSBarry Smith   MatMPIAIJGetLocalMatCondensed - Creates a `MATSEQAIJ` matrix from an `MATMPIAIJ` matrix by taking all its local rows and NON-ZERO columns
541732fba14fSHong Zhang 
541832fba14fSHong Zhang   Not Collective
541932fba14fSHong Zhang 
542032fba14fSHong Zhang   Input Parameters:
542132fba14fSHong Zhang + A     - the matrix
542211a5261eSBarry Smith . scall - either `MAT_INITIAL_MATRIX` or `MAT_REUSE_MATRIX`
542320f4b53cSBarry Smith . row   - index set of rows to extract (or `NULL`)
542420f4b53cSBarry Smith - col   - index set of columns to extract (or `NULL`)
542532fba14fSHong Zhang 
542632fba14fSHong Zhang   Output Parameter:
542732fba14fSHong Zhang . A_loc - the local sequential matrix generated
542832fba14fSHong Zhang 
542932fba14fSHong Zhang   Level: developer
543032fba14fSHong Zhang 
54311cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATMPIAIJ`, `MatGetOwnershipRange()`, `MatMPIAIJGetLocalMat()`
543232fba14fSHong Zhang @*/
5433d71ae5a4SJacob Faibussowitsch PetscErrorCode MatMPIAIJGetLocalMatCondensed(Mat A, MatReuse scall, IS *row, IS *col, Mat *A_loc)
5434d71ae5a4SJacob Faibussowitsch {
543532fba14fSHong Zhang   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
543632fba14fSHong Zhang   PetscInt    i, start, end, ncols, nzA, nzB, *cmap, imark, *idx;
543732fba14fSHong Zhang   IS          isrowa, iscola;
543832fba14fSHong Zhang   Mat        *aloc;
54394a2b5492SBarry Smith   PetscBool   match;
544032fba14fSHong Zhang 
544132fba14fSHong Zhang   PetscFunctionBegin;
54429566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompare((PetscObject)A, MATMPIAIJ, &match));
544328b400f6SJacob Faibussowitsch   PetscCheck(match, PetscObjectComm((PetscObject)A), PETSC_ERR_SUP, "Requires MATMPIAIJ matrix as input");
54449566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_Getlocalmatcondensed, A, 0, 0, 0));
544532fba14fSHong Zhang   if (!row) {
54469371c9d4SSatish Balay     start = A->rmap->rstart;
54479371c9d4SSatish Balay     end   = A->rmap->rend;
54489566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PETSC_COMM_SELF, end - start, start, 1, &isrowa));
544932fba14fSHong Zhang   } else {
545032fba14fSHong Zhang     isrowa = *row;
545132fba14fSHong Zhang   }
545232fba14fSHong Zhang   if (!col) {
5453d0f46423SBarry Smith     start = A->cmap->rstart;
545432fba14fSHong Zhang     cmap  = a->garray;
5455d0f46423SBarry Smith     nzA   = a->A->cmap->n;
5456d0f46423SBarry Smith     nzB   = a->B->cmap->n;
54579566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(nzA + nzB, &idx));
545832fba14fSHong Zhang     ncols = 0;
545932fba14fSHong Zhang     for (i = 0; i < nzB; i++) {
546032fba14fSHong Zhang       if (cmap[i] < start) idx[ncols++] = cmap[i];
546132fba14fSHong Zhang       else break;
546232fba14fSHong Zhang     }
546332fba14fSHong Zhang     imark = i;
546432fba14fSHong Zhang     for (i = 0; i < nzA; i++) idx[ncols++] = start + i;
546532fba14fSHong Zhang     for (i = imark; i < nzB; i++) idx[ncols++] = cmap[i];
54669566063dSJacob Faibussowitsch     PetscCall(ISCreateGeneral(PETSC_COMM_SELF, ncols, idx, PETSC_OWN_POINTER, &iscola));
546732fba14fSHong Zhang   } else {
546832fba14fSHong Zhang     iscola = *col;
546932fba14fSHong Zhang   }
547032fba14fSHong Zhang   if (scall != MAT_INITIAL_MATRIX) {
54719566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(1, &aloc));
547232fba14fSHong Zhang     aloc[0] = *A_loc;
547332fba14fSHong Zhang   }
54749566063dSJacob Faibussowitsch   PetscCall(MatCreateSubMatrices(A, 1, &isrowa, &iscola, scall, &aloc));
5475109e0772SStefano Zampini   if (!col) { /* attach global id of condensed columns */
54769566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)aloc[0], "_petsc_GetLocalMatCondensed_iscol", (PetscObject)iscola));
5477109e0772SStefano Zampini   }
547832fba14fSHong Zhang   *A_loc = aloc[0];
54799566063dSJacob Faibussowitsch   PetscCall(PetscFree(aloc));
548048a46eb9SPierre Jolivet   if (!row) PetscCall(ISDestroy(&isrowa));
548148a46eb9SPierre Jolivet   if (!col) PetscCall(ISDestroy(&iscola));
54829566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_Getlocalmatcondensed, A, 0, 0, 0));
54833ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
548432fba14fSHong Zhang }
548532fba14fSHong Zhang 
54865c65b9ecSFande Kong /*
54875c65b9ecSFande Kong  * Create a sequential AIJ matrix based on row indices. a whole column is extracted once a row is matched.
54885c65b9ecSFande Kong  * Row could be local or remote.The routine is designed to be scalable in memory so that nothing is based
54895c65b9ecSFande Kong  * on a global size.
54905c65b9ecSFande Kong  * */
5491ba38deedSJacob Faibussowitsch static PetscErrorCode MatCreateSeqSubMatrixWithRows_Private(Mat P, IS rows, Mat *P_oth)
5492d71ae5a4SJacob Faibussowitsch {
54935c65b9ecSFande Kong   Mat_MPIAIJ            *p  = (Mat_MPIAIJ *)P->data;
5494f4f49eeaSPierre Jolivet   Mat_SeqAIJ            *pd = (Mat_SeqAIJ *)p->A->data, *po = (Mat_SeqAIJ *)p->B->data, *p_oth;
5495131c27b5Sprj-   PetscInt               plocalsize, nrows, *ilocal, *oilocal, i, lidx, *nrcols, *nlcols, ncol;
5496131c27b5Sprj-   PetscMPIInt            owner;
54975c65b9ecSFande Kong   PetscSFNode           *iremote, *oiremote;
54985c65b9ecSFande Kong   const PetscInt        *lrowindices;
54995c65b9ecSFande Kong   PetscSF                sf, osf;
55005c65b9ecSFande Kong   PetscInt               pcstart, *roffsets, *loffsets, *pnnz, j;
55015c65b9ecSFande Kong   PetscInt               ontotalcols, dntotalcols, ntotalcols, nout;
55025c65b9ecSFande Kong   MPI_Comm               comm;
55035c65b9ecSFande Kong   ISLocalToGlobalMapping mapping;
5504fff043a9SJunchao Zhang   const PetscScalar     *pd_a, *po_a;
55055c65b9ecSFande Kong 
55065c65b9ecSFande Kong   PetscFunctionBegin;
55079566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)P, &comm));
55085c65b9ecSFande Kong   /* plocalsize is the number of roots
55095c65b9ecSFande Kong    * nrows is the number of leaves
55105c65b9ecSFande Kong    * */
55119566063dSJacob Faibussowitsch   PetscCall(MatGetLocalSize(P, &plocalsize, NULL));
55129566063dSJacob Faibussowitsch   PetscCall(ISGetLocalSize(rows, &nrows));
55139566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(nrows, &iremote));
55149566063dSJacob Faibussowitsch   PetscCall(ISGetIndices(rows, &lrowindices));
55155c65b9ecSFande Kong   for (i = 0; i < nrows; i++) {
55165c65b9ecSFande Kong     /* Find a remote index and an owner for a row
55175c65b9ecSFande Kong      * The row could be local or remote
55185c65b9ecSFande Kong      * */
551934bcad68SFande Kong     owner = 0;
552034bcad68SFande Kong     lidx  = 0;
55219566063dSJacob Faibussowitsch     PetscCall(PetscLayoutFindOwnerIndex(P->rmap, lrowindices[i], &owner, &lidx));
55225c65b9ecSFande Kong     iremote[i].index = lidx;
55235c65b9ecSFande Kong     iremote[i].rank  = owner;
55245c65b9ecSFande Kong   }
55255c65b9ecSFande Kong   /* Create SF to communicate how many nonzero columns for each row */
55269566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(comm, &sf));
5527f332b1cbSPierre Jolivet   /* SF will figure out the number of nonzero columns for each row, and their
55285c65b9ecSFande Kong    * offsets
55295c65b9ecSFande Kong    * */
55309566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraph(sf, plocalsize, nrows, NULL, PETSC_OWN_POINTER, iremote, PETSC_OWN_POINTER));
55319566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(sf));
55329566063dSJacob Faibussowitsch   PetscCall(PetscSFSetUp(sf));
5533bc8e477aSFande Kong 
55349566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(2 * (plocalsize + 1), &roffsets));
55359566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(2 * plocalsize, &nrcols));
55369566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(nrows, &pnnz));
55375c65b9ecSFande Kong   roffsets[0] = 0;
55385c65b9ecSFande Kong   roffsets[1] = 0;
55395c65b9ecSFande Kong   for (i = 0; i < plocalsize; i++) {
55404cf0e950SBarry Smith     /* diagonal */
55415c65b9ecSFande Kong     nrcols[i * 2 + 0] = pd->i[i + 1] - pd->i[i];
55424cf0e950SBarry Smith     /* off-diagonal */
55435c65b9ecSFande Kong     nrcols[i * 2 + 1] = po->i[i + 1] - po->i[i];
55445c65b9ecSFande Kong     /* compute offsets so that we relative location for each row */
55455c65b9ecSFande Kong     roffsets[(i + 1) * 2 + 0] = roffsets[i * 2 + 0] + nrcols[i * 2 + 0];
55465c65b9ecSFande Kong     roffsets[(i + 1) * 2 + 1] = roffsets[i * 2 + 1] + nrcols[i * 2 + 1];
55475c65b9ecSFande Kong   }
55489566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(2 * nrows, &nlcols));
55499566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(2 * nrows, &loffsets));
55505c65b9ecSFande Kong   /* 'r' means root, and 'l' means leaf */
55519566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(sf, MPIU_2INT, nrcols, nlcols, MPI_REPLACE));
55529566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(sf, MPIU_2INT, roffsets, loffsets, MPI_REPLACE));
55539566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(sf, MPIU_2INT, nrcols, nlcols, MPI_REPLACE));
55549566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(sf, MPIU_2INT, roffsets, loffsets, MPI_REPLACE));
55559566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sf));
55569566063dSJacob Faibussowitsch   PetscCall(PetscFree(roffsets));
55579566063dSJacob Faibussowitsch   PetscCall(PetscFree(nrcols));
55585c65b9ecSFande Kong   dntotalcols = 0;
55595c65b9ecSFande Kong   ontotalcols = 0;
5560bc8e477aSFande Kong   ncol        = 0;
55615c65b9ecSFande Kong   for (i = 0; i < nrows; i++) {
55625c65b9ecSFande Kong     pnnz[i] = nlcols[i * 2 + 0] + nlcols[i * 2 + 1];
5563bc8e477aSFande Kong     ncol    = PetscMax(pnnz[i], ncol);
55644cf0e950SBarry Smith     /* diagonal */
55655c65b9ecSFande Kong     dntotalcols += nlcols[i * 2 + 0];
55664cf0e950SBarry Smith     /* off-diagonal */
55675c65b9ecSFande Kong     ontotalcols += nlcols[i * 2 + 1];
55685c65b9ecSFande Kong   }
55695c65b9ecSFande Kong   /* We do not need to figure the right number of columns
55705c65b9ecSFande Kong    * since all the calculations will be done by going through the raw data
55715c65b9ecSFande Kong    * */
55729566063dSJacob Faibussowitsch   PetscCall(MatCreateSeqAIJ(PETSC_COMM_SELF, nrows, ncol, 0, pnnz, P_oth));
55739566063dSJacob Faibussowitsch   PetscCall(MatSetUp(*P_oth));
55749566063dSJacob Faibussowitsch   PetscCall(PetscFree(pnnz));
55755c65b9ecSFande Kong   p_oth = (Mat_SeqAIJ *)(*P_oth)->data;
55764cf0e950SBarry Smith   /* diagonal */
55779566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(dntotalcols, &iremote));
55784cf0e950SBarry Smith   /* off-diagonal */
55799566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(ontotalcols, &oiremote));
55804cf0e950SBarry Smith   /* diagonal */
55819566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(dntotalcols, &ilocal));
55824cf0e950SBarry Smith   /* off-diagonal */
55839566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(ontotalcols, &oilocal));
55845c65b9ecSFande Kong   dntotalcols = 0;
55855c65b9ecSFande Kong   ontotalcols = 0;
55865c65b9ecSFande Kong   ntotalcols  = 0;
55875c65b9ecSFande Kong   for (i = 0; i < nrows; i++) {
558834bcad68SFande Kong     owner = 0;
55899566063dSJacob Faibussowitsch     PetscCall(PetscLayoutFindOwnerIndex(P->rmap, lrowindices[i], &owner, NULL));
55905c65b9ecSFande Kong     /* Set iremote for diag matrix */
55915c65b9ecSFande Kong     for (j = 0; j < nlcols[i * 2 + 0]; j++) {
55925c65b9ecSFande Kong       iremote[dntotalcols].index = loffsets[i * 2 + 0] + j;
55935c65b9ecSFande Kong       iremote[dntotalcols].rank  = owner;
55945c65b9ecSFande Kong       /* P_oth is seqAIJ so that ilocal need to point to the first part of memory */
55955c65b9ecSFande Kong       ilocal[dntotalcols++] = ntotalcols++;
55965c65b9ecSFande Kong     }
55974cf0e950SBarry Smith     /* off-diagonal */
55985c65b9ecSFande Kong     for (j = 0; j < nlcols[i * 2 + 1]; j++) {
55995c65b9ecSFande Kong       oiremote[ontotalcols].index = loffsets[i * 2 + 1] + j;
56005c65b9ecSFande Kong       oiremote[ontotalcols].rank  = owner;
56015c65b9ecSFande Kong       oilocal[ontotalcols++]      = ntotalcols++;
56025c65b9ecSFande Kong     }
56035c65b9ecSFande Kong   }
56049566063dSJacob Faibussowitsch   PetscCall(ISRestoreIndices(rows, &lrowindices));
56059566063dSJacob Faibussowitsch   PetscCall(PetscFree(loffsets));
56069566063dSJacob Faibussowitsch   PetscCall(PetscFree(nlcols));
56079566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(comm, &sf));
56085c65b9ecSFande Kong   /* P serves as roots and P_oth is leaves
56095c65b9ecSFande Kong    * Diag matrix
56105c65b9ecSFande Kong    * */
56119566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraph(sf, pd->i[plocalsize], dntotalcols, ilocal, PETSC_OWN_POINTER, iremote, PETSC_OWN_POINTER));
56129566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(sf));
56139566063dSJacob Faibussowitsch   PetscCall(PetscSFSetUp(sf));
56145c65b9ecSFande Kong 
56159566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(comm, &osf));
56164cf0e950SBarry Smith   /* off-diagonal */
56179566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraph(osf, po->i[plocalsize], ontotalcols, oilocal, PETSC_OWN_POINTER, oiremote, PETSC_OWN_POINTER));
56189566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(osf));
56199566063dSJacob Faibussowitsch   PetscCall(PetscSFSetUp(osf));
56209566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(p->A, &pd_a));
56219566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArrayRead(p->B, &po_a));
56224cf0e950SBarry Smith   /* operate on the matrix internal data to save memory */
56239566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(sf, MPIU_SCALAR, pd_a, p_oth->a, MPI_REPLACE));
56249566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(osf, MPIU_SCALAR, po_a, p_oth->a, MPI_REPLACE));
56259566063dSJacob Faibussowitsch   PetscCall(MatGetOwnershipRangeColumn(P, &pcstart, NULL));
56265c65b9ecSFande Kong   /* Convert to global indices for diag matrix */
56275c65b9ecSFande Kong   for (i = 0; i < pd->i[plocalsize]; i++) pd->j[i] += pcstart;
56289566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(sf, MPIU_INT, pd->j, p_oth->j, MPI_REPLACE));
56295c65b9ecSFande Kong   /* We want P_oth store global indices */
56309566063dSJacob Faibussowitsch   PetscCall(ISLocalToGlobalMappingCreate(comm, 1, p->B->cmap->n, p->garray, PETSC_COPY_VALUES, &mapping));
56315c65b9ecSFande Kong   /* Use memory scalable approach */
56329566063dSJacob Faibussowitsch   PetscCall(ISLocalToGlobalMappingSetType(mapping, ISLOCALTOGLOBALMAPPINGHASH));
56339566063dSJacob Faibussowitsch   PetscCall(ISLocalToGlobalMappingApply(mapping, po->i[plocalsize], po->j, po->j));
56349566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastBegin(osf, MPIU_INT, po->j, p_oth->j, MPI_REPLACE));
56359566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(sf, MPIU_INT, pd->j, p_oth->j, MPI_REPLACE));
56365c65b9ecSFande Kong   /* Convert back to local indices */
56375c65b9ecSFande Kong   for (i = 0; i < pd->i[plocalsize]; i++) pd->j[i] -= pcstart;
56389566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(osf, MPIU_INT, po->j, p_oth->j, MPI_REPLACE));
56395c65b9ecSFande Kong   nout = 0;
56409566063dSJacob Faibussowitsch   PetscCall(ISGlobalToLocalMappingApply(mapping, IS_GTOLM_DROP, po->i[plocalsize], po->j, &nout, po->j));
564108401ef6SPierre Jolivet   PetscCheck(nout == po->i[plocalsize], comm, PETSC_ERR_ARG_INCOMP, "n %" PetscInt_FMT " does not equal to nout %" PetscInt_FMT " ", po->i[plocalsize], nout);
56429566063dSJacob Faibussowitsch   PetscCall(ISLocalToGlobalMappingDestroy(&mapping));
56435c65b9ecSFande Kong   /* Exchange values */
56449566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(sf, MPIU_SCALAR, pd_a, p_oth->a, MPI_REPLACE));
56459566063dSJacob Faibussowitsch   PetscCall(PetscSFBcastEnd(osf, MPIU_SCALAR, po_a, p_oth->a, MPI_REPLACE));
56469566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(p->A, &pd_a));
56479566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArrayRead(p->B, &po_a));
56485c65b9ecSFande Kong   /* Stop PETSc from shrinking memory */
56495c65b9ecSFande Kong   for (i = 0; i < nrows; i++) p_oth->ilen[i] = p_oth->imax[i];
56509566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(*P_oth, MAT_FINAL_ASSEMBLY));
56519566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(*P_oth, MAT_FINAL_ASSEMBLY));
56525c65b9ecSFande Kong   /* Attach PetscSF objects to P_oth so that we can reuse it later */
56539566063dSJacob Faibussowitsch   PetscCall(PetscObjectCompose((PetscObject)*P_oth, "diagsf", (PetscObject)sf));
56549566063dSJacob Faibussowitsch   PetscCall(PetscObjectCompose((PetscObject)*P_oth, "offdiagsf", (PetscObject)osf));
56559566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sf));
56569566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&osf));
56573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
56585c65b9ecSFande Kong }
56595c65b9ecSFande Kong 
56605c65b9ecSFande Kong /*
56615c65b9ecSFande Kong  * Creates a SeqAIJ matrix by taking rows of B that equal to nonzero columns of local A
56625c65b9ecSFande Kong  * This supports MPIAIJ and MAIJ
56635c65b9ecSFande Kong  * */
5664d71ae5a4SJacob Faibussowitsch PetscErrorCode MatGetBrowsOfAcols_MPIXAIJ(Mat A, Mat P, PetscInt dof, MatReuse reuse, Mat *P_oth)
5665d71ae5a4SJacob Faibussowitsch {
56665c65b9ecSFande Kong   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data, *p = (Mat_MPIAIJ *)P->data;
5667bc8e477aSFande Kong   Mat_SeqAIJ *p_oth;
5668bc8e477aSFande Kong   IS          rows, map;
5669bc8e477aSFande Kong   PetscHMapI  hamp;
5670bc8e477aSFande Kong   PetscInt    i, htsize, *rowindices, off, *mapping, key, count;
56715c65b9ecSFande Kong   MPI_Comm    comm;
56725c65b9ecSFande Kong   PetscSF     sf, osf;
5673bc8e477aSFande Kong   PetscBool   has;
56745c65b9ecSFande Kong 
56755c65b9ecSFande Kong   PetscFunctionBegin;
56769566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)A, &comm));
56779566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_GetBrowsOfAocols, A, P, 0, 0));
56785c65b9ecSFande Kong   /* If it is the first time, create an index set of off-diag nonzero columns of A,
56795c65b9ecSFande Kong    *  and then create a submatrix (that often is an overlapping matrix)
56805c65b9ecSFande Kong    * */
56815c65b9ecSFande Kong   if (reuse == MAT_INITIAL_MATRIX) {
56825c65b9ecSFande Kong     /* Use a hash table to figure out unique keys */
5683eec179cfSJacob Faibussowitsch     PetscCall(PetscHMapICreateWithSize(a->B->cmap->n, &hamp));
56849566063dSJacob Faibussowitsch     PetscCall(PetscCalloc1(a->B->cmap->n, &mapping));
5685bc8e477aSFande Kong     count = 0;
5686bc8e477aSFande Kong     /* Assume that  a->g is sorted, otherwise the following does not make sense */
5687bc8e477aSFande Kong     for (i = 0; i < a->B->cmap->n; i++) {
5688bc8e477aSFande Kong       key = a->garray[i] / dof;
56899566063dSJacob Faibussowitsch       PetscCall(PetscHMapIHas(hamp, key, &has));
5690bc8e477aSFande Kong       if (!has) {
5691bc8e477aSFande Kong         mapping[i] = count;
56929566063dSJacob Faibussowitsch         PetscCall(PetscHMapISet(hamp, key, count++));
5693bc8e477aSFande Kong       } else {
5694bc8e477aSFande Kong         /* Current 'i' has the same value the previous step */
5695bc8e477aSFande Kong         mapping[i] = count - 1;
56965c65b9ecSFande Kong       }
5697bc8e477aSFande Kong     }
56989566063dSJacob Faibussowitsch     PetscCall(ISCreateGeneral(comm, a->B->cmap->n, mapping, PETSC_OWN_POINTER, &map));
56999566063dSJacob Faibussowitsch     PetscCall(PetscHMapIGetSize(hamp, &htsize));
5700eec179cfSJacob Faibussowitsch     PetscCheck(htsize == count, comm, PETSC_ERR_ARG_INCOMP, " Size of hash map %" PetscInt_FMT " is inconsistent with count %" PetscInt_FMT, htsize, count);
57019566063dSJacob Faibussowitsch     PetscCall(PetscCalloc1(htsize, &rowindices));
57025c65b9ecSFande Kong     off = 0;
57039566063dSJacob Faibussowitsch     PetscCall(PetscHMapIGetKeys(hamp, &off, rowindices));
57049566063dSJacob Faibussowitsch     PetscCall(PetscHMapIDestroy(&hamp));
57059566063dSJacob Faibussowitsch     PetscCall(PetscSortInt(htsize, rowindices));
57069566063dSJacob Faibussowitsch     PetscCall(ISCreateGeneral(comm, htsize, rowindices, PETSC_OWN_POINTER, &rows));
57075c65b9ecSFande Kong     /* In case, the matrix was already created but users want to recreate the matrix */
57089566063dSJacob Faibussowitsch     PetscCall(MatDestroy(P_oth));
57099566063dSJacob Faibussowitsch     PetscCall(MatCreateSeqSubMatrixWithRows_Private(P, rows, P_oth));
57109566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)*P_oth, "aoffdiagtopothmapping", (PetscObject)map));
57119566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&map));
57129566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&rows));
57135c65b9ecSFande Kong   } else if (reuse == MAT_REUSE_MATRIX) {
57145c65b9ecSFande Kong     /* If matrix was already created, we simply update values using SF objects
571535cb6cd3SPierre Jolivet      * that as attached to the matrix earlier.
5716fff043a9SJunchao Zhang      */
5717fff043a9SJunchao Zhang     const PetscScalar *pd_a, *po_a;
5718fff043a9SJunchao Zhang 
57199566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*P_oth, "diagsf", (PetscObject *)&sf));
57209566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)*P_oth, "offdiagsf", (PetscObject *)&osf));
572108401ef6SPierre Jolivet     PetscCheck(sf && osf, comm, PETSC_ERR_ARG_NULL, "Matrix is not initialized yet");
57225c65b9ecSFande Kong     p_oth = (Mat_SeqAIJ *)(*P_oth)->data;
57235c65b9ecSFande Kong     /* Update values in place */
57249566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(p->A, &pd_a));
57259566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(p->B, &po_a));
57269566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(sf, MPIU_SCALAR, pd_a, p_oth->a, MPI_REPLACE));
57279566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastBegin(osf, MPIU_SCALAR, po_a, p_oth->a, MPI_REPLACE));
57289566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(sf, MPIU_SCALAR, pd_a, p_oth->a, MPI_REPLACE));
57299566063dSJacob Faibussowitsch     PetscCall(PetscSFBcastEnd(osf, MPIU_SCALAR, po_a, p_oth->a, MPI_REPLACE));
57309566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(p->A, &pd_a));
57319566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(p->B, &po_a));
57326718818eSStefano Zampini   } else SETERRQ(comm, PETSC_ERR_ARG_UNKNOWN_TYPE, "Unknown reuse type");
57339566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_GetBrowsOfAocols, A, P, 0, 0));
57343ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
57355c65b9ecSFande Kong }
57365c65b9ecSFande Kong 
573725616d81SHong Zhang /*@C
573820f4b53cSBarry Smith   MatGetBrowsOfAcols - Returns `IS` that contain rows of `B` that equal to nonzero columns of local `A`
573925616d81SHong Zhang 
5740c3339decSBarry Smith   Collective
574125616d81SHong Zhang 
574225616d81SHong Zhang   Input Parameters:
574311a5261eSBarry Smith + A     - the first matrix in `MATMPIAIJ` format
574411a5261eSBarry Smith . B     - the second matrix in `MATMPIAIJ` format
574511a5261eSBarry Smith - scall - either `MAT_INITIAL_MATRIX` or `MAT_REUSE_MATRIX`
574625616d81SHong Zhang 
5747f1a722f8SMatthew G. Knepley   Output Parameters:
574827430b45SBarry Smith + rowb  - On input index sets of rows of B to extract (or `NULL`), modified on output
574927430b45SBarry Smith . colb  - On input index sets of columns of B to extract (or `NULL`), modified on output
5750f1a722f8SMatthew G. Knepley - B_seq - the sequential matrix generated
575125616d81SHong Zhang 
575225616d81SHong Zhang   Level: developer
575325616d81SHong Zhang 
575420f4b53cSBarry Smith .seealso: `Mat`, `MATMPIAIJ`, `IS`, `MatReuse`
575525616d81SHong Zhang @*/
5756d71ae5a4SJacob Faibussowitsch PetscErrorCode MatGetBrowsOfAcols(Mat A, Mat B, MatReuse scall, IS *rowb, IS *colb, Mat *B_seq)
5757d71ae5a4SJacob Faibussowitsch {
5758899cda47SBarry Smith   Mat_MPIAIJ *a = (Mat_MPIAIJ *)A->data;
5759b1d57f15SBarry Smith   PetscInt   *idx, i, start, ncols, nzA, nzB, *cmap, imark;
576025616d81SHong Zhang   IS          isrowb, iscolb;
57610298fd71SBarry Smith   Mat        *bseq = NULL;
576225616d81SHong Zhang 
576325616d81SHong Zhang   PetscFunctionBegin;
576420f4b53cSBarry Smith   PetscCheck(A->cmap->rstart == B->rmap->rstart && A->cmap->rend == B->rmap->rend, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Matrix local dimensions are incompatible, (%" PetscInt_FMT ", %" PetscInt_FMT ") != (%" PetscInt_FMT ",%" PetscInt_FMT ")",
576520f4b53cSBarry Smith              A->cmap->rstart, A->cmap->rend, B->rmap->rstart, B->rmap->rend);
57669566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_GetBrowsOfAcols, A, B, 0, 0));
576725616d81SHong Zhang 
576825616d81SHong Zhang   if (scall == MAT_INITIAL_MATRIX) {
5769d0f46423SBarry Smith     start = A->cmap->rstart;
577025616d81SHong Zhang     cmap  = a->garray;
5771d0f46423SBarry Smith     nzA   = a->A->cmap->n;
5772d0f46423SBarry Smith     nzB   = a->B->cmap->n;
57739566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(nzA + nzB, &idx));
577425616d81SHong Zhang     ncols = 0;
57750390132cSHong Zhang     for (i = 0; i < nzB; i++) { /* row < local row index */
577625616d81SHong Zhang       if (cmap[i] < start) idx[ncols++] = cmap[i];
577725616d81SHong Zhang       else break;
577825616d81SHong Zhang     }
577925616d81SHong Zhang     imark = i;
57800390132cSHong Zhang     for (i = 0; i < nzA; i++) idx[ncols++] = start + i;   /* local rows */
57810390132cSHong Zhang     for (i = imark; i < nzB; i++) idx[ncols++] = cmap[i]; /* row > local row index */
57829566063dSJacob Faibussowitsch     PetscCall(ISCreateGeneral(PETSC_COMM_SELF, ncols, idx, PETSC_OWN_POINTER, &isrowb));
57839566063dSJacob Faibussowitsch     PetscCall(ISCreateStride(PETSC_COMM_SELF, B->cmap->N, 0, 1, &iscolb));
578425616d81SHong Zhang   } else {
578508401ef6SPierre Jolivet     PetscCheck(rowb && colb, PETSC_COMM_SELF, PETSC_ERR_SUP, "IS rowb and colb must be provided for MAT_REUSE_MATRIX");
57869371c9d4SSatish Balay     isrowb = *rowb;
57879371c9d4SSatish Balay     iscolb = *colb;
57889566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(1, &bseq));
578925616d81SHong Zhang     bseq[0] = *B_seq;
579025616d81SHong Zhang   }
57919566063dSJacob Faibussowitsch   PetscCall(MatCreateSubMatrices(B, 1, &isrowb, &iscolb, scall, &bseq));
579225616d81SHong Zhang   *B_seq = bseq[0];
57939566063dSJacob Faibussowitsch   PetscCall(PetscFree(bseq));
579425616d81SHong Zhang   if (!rowb) {
57959566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&isrowb));
579625616d81SHong Zhang   } else {
579725616d81SHong Zhang     *rowb = isrowb;
579825616d81SHong Zhang   }
579925616d81SHong Zhang   if (!colb) {
58009566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&iscolb));
580125616d81SHong Zhang   } else {
580225616d81SHong Zhang     *colb = iscolb;
580325616d81SHong Zhang   }
58049566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_GetBrowsOfAcols, A, B, 0, 0));
58053ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
580625616d81SHong Zhang }
5807429d309bSHong Zhang 
5808f8487c73SHong Zhang /*
580927430b45SBarry Smith     MatGetBrowsOfAoCols_MPIAIJ - Creates a `MATSEQAIJ` matrix by taking rows of B that equal to nonzero columns
581001b7ae99SHong Zhang     of the OFF-DIAGONAL portion of local A
5811429d309bSHong Zhang 
5812c3339decSBarry Smith     Collective
5813429d309bSHong Zhang 
5814429d309bSHong Zhang    Input Parameters:
581527430b45SBarry Smith +    A,B - the matrices in `MATMPIAIJ` format
581627430b45SBarry Smith -    scall - either `MAT_INITIAL_MATRIX` or `MAT_REUSE_MATRIX`
5817429d309bSHong Zhang 
5818429d309bSHong Zhang    Output Parameter:
58190298fd71SBarry Smith +    startsj_s - starting point in B's sending j-arrays, saved for MAT_REUSE (or NULL)
58200298fd71SBarry Smith .    startsj_r - starting point in B's receiving j-arrays, saved for MAT_REUSE (or NULL)
58210298fd71SBarry Smith .    bufa_ptr - array for sending matrix values, saved for MAT_REUSE (or NULL)
5822598bc09dSHong Zhang -    B_oth - the sequential matrix generated with size aBn=a->B->cmap->n by B->cmap->N
5823429d309bSHong Zhang 
582411a5261eSBarry Smith     Developer Note:
582511a5261eSBarry Smith     This directly accesses information inside the VecScatter associated with the matrix-vector product
58266eb45d04SBarry Smith      for this matrix. This is not desirable..
58276eb45d04SBarry Smith 
5828429d309bSHong Zhang     Level: developer
5829429d309bSHong Zhang 
5830f8487c73SHong Zhang */
58316497c311SBarry Smith 
5832d71ae5a4SJacob Faibussowitsch PetscErrorCode MatGetBrowsOfAoCols_MPIAIJ(Mat A, Mat B, MatReuse scall, PetscInt **startsj_s, PetscInt **startsj_r, MatScalar **bufa_ptr, Mat *B_oth)
5833d71ae5a4SJacob Faibussowitsch {
5834899cda47SBarry Smith   Mat_MPIAIJ        *a = (Mat_MPIAIJ *)A->data;
58354b8d542aSHong Zhang   VecScatter         ctx;
5836ce94432eSBarry Smith   MPI_Comm           comm;
58373515ee7fSJunchao Zhang   const PetscMPIInt *rprocs, *sprocs;
58386497c311SBarry Smith   PetscMPIInt        nrecvs, nsends;
58393515ee7fSJunchao Zhang   const PetscInt    *srow, *rstarts, *sstarts;
5840277f51e8SBarry Smith   PetscInt          *rowlen, *bufj, *bufJ, ncols = 0, aBn = a->B->cmap->n, row, *b_othi, *b_othj, *rvalues = NULL, *svalues = NULL, *cols, sbs, rbs;
58416497c311SBarry Smith   PetscInt           i, j, k = 0, l, ll, nrows, *rstartsj = NULL, *sstartsj, len;
5842277f51e8SBarry Smith   PetscScalar       *b_otha, *bufa, *bufA, *vals = NULL;
5843ddea5d60SJunchao Zhang   MPI_Request       *reqs = NULL, *rwaits = NULL, *swaits = NULL;
5844ddea5d60SJunchao Zhang   PetscMPIInt        size, tag, rank, nreqs;
5845429d309bSHong Zhang 
5846429d309bSHong Zhang   PetscFunctionBegin;
58479566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)A, &comm));
58489566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
5849a7c7454dSHong Zhang 
585020f4b53cSBarry Smith   PetscCheck(A->cmap->rstart == B->rmap->rstart && A->cmap->rend == B->rmap->rend, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Matrix local dimensions are incompatible, (%" PetscInt_FMT ", %" PetscInt_FMT ") != (%" PetscInt_FMT ",%" PetscInt_FMT ")",
585120f4b53cSBarry Smith              A->cmap->rstart, A->cmap->rend, B->rmap->rstart, B->rmap->rend);
58529566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(MAT_GetBrowsOfAocols, A, B, 0, 0));
58539566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
5854a6b2eed2SHong Zhang 
5855ec07b8f8SHong Zhang   if (size == 1) {
5856ec07b8f8SHong Zhang     startsj_s = NULL;
5857ec07b8f8SHong Zhang     bufa_ptr  = NULL;
585852f7967eSHong Zhang     *B_oth    = NULL;
58593ba16761SJacob Faibussowitsch     PetscFunctionReturn(PETSC_SUCCESS);
5860ec07b8f8SHong Zhang   }
5861ec07b8f8SHong Zhang 
5862fa83eaafSHong Zhang   ctx = a->Mvctx;
58634b8d542aSHong Zhang   tag = ((PetscObject)ctx)->tag;
58644b8d542aSHong Zhang 
58659566063dSJacob Faibussowitsch   PetscCall(VecScatterGetRemote_Private(ctx, PETSC_TRUE /*send*/, &nsends, &sstarts, &srow, &sprocs, &sbs));
58663515ee7fSJunchao Zhang   /* rprocs[] must be ordered so that indices received from them are ordered in rvalues[], which is key to algorithms used in this subroutine */
58679566063dSJacob Faibussowitsch   PetscCall(VecScatterGetRemoteOrdered_Private(ctx, PETSC_FALSE /*recv*/, &nrecvs, &rstarts, NULL /*indices not needed*/, &rprocs, &rbs));
58689566063dSJacob Faibussowitsch   PetscCall(PetscMPIIntCast(nsends + nrecvs, &nreqs));
58699566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(nreqs, &reqs));
5870ddea5d60SJunchao Zhang   rwaits = reqs;
58718e3a54c0SPierre Jolivet   swaits = PetscSafePointerPlusOffset(reqs, nrecvs);
5872429d309bSHong Zhang 
5873b7f45c76SHong Zhang   if (!startsj_s || !bufa_ptr) scall = MAT_INITIAL_MATRIX;
5874429d309bSHong Zhang   if (scall == MAT_INITIAL_MATRIX) {
5875a6b2eed2SHong Zhang     /* i-array */
5876a6b2eed2SHong Zhang     /*  post receives */
58779566063dSJacob Faibussowitsch     if (nrecvs) PetscCall(PetscMalloc1(rbs * (rstarts[nrecvs] - rstarts[0]), &rvalues)); /* rstarts can be NULL when nrecvs=0 */
5878a6b2eed2SHong Zhang     for (i = 0; i < nrecvs; i++) {
587974268593SBarry Smith       rowlen = rvalues + rstarts[i] * rbs;
5880e42f35eeSHong Zhang       nrows  = (rstarts[i + 1] - rstarts[i]) * rbs; /* num of indices to be received */
58816497c311SBarry Smith       PetscCallMPI(MPIU_Irecv(rowlen, nrows, MPIU_INT, rprocs[i], tag, comm, rwaits + i));
5882429d309bSHong Zhang     }
5883a6b2eed2SHong Zhang 
5884a6b2eed2SHong Zhang     /* pack the outgoing message */
58859566063dSJacob Faibussowitsch     PetscCall(PetscMalloc2(nsends + 1, &sstartsj, nrecvs + 1, &rstartsj));
58862205254eSKarl Rupp 
58872205254eSKarl Rupp     sstartsj[0] = 0;
58882205254eSKarl Rupp     rstartsj[0] = 0;
5889a6b2eed2SHong Zhang     len         = 0; /* total length of j or a array to be sent */
58903515ee7fSJunchao Zhang     if (nsends) {
58913515ee7fSJunchao Zhang       k = sstarts[0]; /* ATTENTION: sstarts[0] and rstarts[0] are not necessarily zero */
58929566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(sbs * (sstarts[nsends] - sstarts[0]), &svalues));
58933515ee7fSJunchao Zhang     }
5894a6b2eed2SHong Zhang     for (i = 0; i < nsends; i++) {
58953515ee7fSJunchao Zhang       rowlen = svalues + (sstarts[i] - sstarts[0]) * sbs;
5896e42f35eeSHong Zhang       nrows  = sstarts[i + 1] - sstarts[i]; /* num of block rows */
589787025532SHong Zhang       for (j = 0; j < nrows; j++) {
5898d0f46423SBarry Smith         row = srow[k] + B->rmap->range[rank]; /* global row idx */
5899e42f35eeSHong Zhang         for (l = 0; l < sbs; l++) {
59009566063dSJacob Faibussowitsch           PetscCall(MatGetRow_MPIAIJ(B, row + l, &ncols, NULL, NULL)); /* rowlength */
59012205254eSKarl Rupp 
5902e42f35eeSHong Zhang           rowlen[j * sbs + l] = ncols;
59032205254eSKarl Rupp 
5904e42f35eeSHong Zhang           len += ncols;
59059566063dSJacob Faibussowitsch           PetscCall(MatRestoreRow_MPIAIJ(B, row + l, &ncols, NULL, NULL));
5906e42f35eeSHong Zhang         }
5907a6b2eed2SHong Zhang         k++;
5908429d309bSHong Zhang       }
59096497c311SBarry Smith       PetscCallMPI(MPIU_Isend(rowlen, nrows * sbs, MPIU_INT, sprocs[i], tag, comm, swaits + i));
59102205254eSKarl Rupp 
5911dea91ad1SHong Zhang       sstartsj[i + 1] = len; /* starting point of (i+1)-th outgoing msg in bufj and bufa */
5912429d309bSHong Zhang     }
591387025532SHong Zhang     /* recvs and sends of i-array are completed */
59149566063dSJacob Faibussowitsch     if (nreqs) PetscCallMPI(MPI_Waitall(nreqs, reqs, MPI_STATUSES_IGNORE));
59159566063dSJacob Faibussowitsch     PetscCall(PetscFree(svalues));
5916e42f35eeSHong Zhang 
5917a6b2eed2SHong Zhang     /* allocate buffers for sending j and a arrays */
59189566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(len + 1, &bufj));
59199566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(len + 1, &bufa));
5920a6b2eed2SHong Zhang 
592187025532SHong Zhang     /* create i-array of B_oth */
59229566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(aBn + 2, &b_othi));
59232205254eSKarl Rupp 
592487025532SHong Zhang     b_othi[0] = 0;
5925a6b2eed2SHong Zhang     len       = 0; /* total length of j or a array to be received */
5926a6b2eed2SHong Zhang     k         = 0;
5927a6b2eed2SHong Zhang     for (i = 0; i < nrecvs; i++) {
59283515ee7fSJunchao Zhang       rowlen = rvalues + (rstarts[i] - rstarts[0]) * rbs;
59293515ee7fSJunchao Zhang       nrows  = (rstarts[i + 1] - rstarts[i]) * rbs; /* num of rows to be received */
593087025532SHong Zhang       for (j = 0; j < nrows; j++) {
593187025532SHong Zhang         b_othi[k + 1] = b_othi[k] + rowlen[j];
59329566063dSJacob Faibussowitsch         PetscCall(PetscIntSumError(rowlen[j], len, &len));
5933f91af8c7SBarry Smith         k++;
5934a6b2eed2SHong Zhang       }
5935dea91ad1SHong Zhang       rstartsj[i + 1] = len; /* starting point of (i+1)-th incoming msg in bufj and bufa */
5936a6b2eed2SHong Zhang     }
59379566063dSJacob Faibussowitsch     PetscCall(PetscFree(rvalues));
5938a6b2eed2SHong Zhang 
59396aad120cSJose E. Roman     /* allocate space for j and a arrays of B_oth */
59409566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(b_othi[aBn] + 1, &b_othj));
59419566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(b_othi[aBn] + 1, &b_otha));
5942a6b2eed2SHong Zhang 
594387025532SHong Zhang     /* j-array */
5944a6b2eed2SHong Zhang     /*  post receives of j-array */
5945a6b2eed2SHong Zhang     for (i = 0; i < nrecvs; i++) {
594687025532SHong Zhang       nrows = rstartsj[i + 1] - rstartsj[i]; /* length of the msg received */
59476497c311SBarry Smith       PetscCallMPI(MPIU_Irecv(b_othj + rstartsj[i], nrows, MPIU_INT, rprocs[i], tag, comm, rwaits + i));
5948a6b2eed2SHong Zhang     }
5949e42f35eeSHong Zhang 
5950e42f35eeSHong Zhang     /* pack the outgoing message j-array */
59513515ee7fSJunchao Zhang     if (nsends) k = sstarts[0];
5952a6b2eed2SHong Zhang     for (i = 0; i < nsends; i++) {
5953e42f35eeSHong Zhang       nrows = sstarts[i + 1] - sstarts[i]; /* num of block rows */
5954a6b2eed2SHong Zhang       bufJ  = bufj + sstartsj[i];
595587025532SHong Zhang       for (j = 0; j < nrows; j++) {
5956d0f46423SBarry Smith         row = srow[k++] + B->rmap->range[rank]; /* global row idx */
5957e42f35eeSHong Zhang         for (ll = 0; ll < sbs; ll++) {
59589566063dSJacob Faibussowitsch           PetscCall(MatGetRow_MPIAIJ(B, row + ll, &ncols, &cols, NULL));
5959ad540459SPierre Jolivet           for (l = 0; l < ncols; l++) *bufJ++ = cols[l];
59609566063dSJacob Faibussowitsch           PetscCall(MatRestoreRow_MPIAIJ(B, row + ll, &ncols, &cols, NULL));
5961e42f35eeSHong Zhang         }
596287025532SHong Zhang       }
59636497c311SBarry Smith       PetscCallMPI(MPIU_Isend(bufj + sstartsj[i], sstartsj[i + 1] - sstartsj[i], MPIU_INT, sprocs[i], tag, comm, swaits + i));
596487025532SHong Zhang     }
596587025532SHong Zhang 
596687025532SHong Zhang     /* recvs and sends of j-array are completed */
59679566063dSJacob Faibussowitsch     if (nreqs) PetscCallMPI(MPI_Waitall(nreqs, reqs, MPI_STATUSES_IGNORE));
596887025532SHong Zhang   } else if (scall == MAT_REUSE_MATRIX) {
5969b7f45c76SHong Zhang     sstartsj = *startsj_s;
59701d79065fSBarry Smith     rstartsj = *startsj_r;
597187025532SHong Zhang     bufa     = *bufa_ptr;
59729566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayWrite(*B_oth, &b_otha));
5973ddea5d60SJunchao Zhang   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Matrix P does not possess an object container");
597487025532SHong Zhang 
597587025532SHong Zhang   /* a-array */
597687025532SHong Zhang   /*  post receives of a-array */
597787025532SHong Zhang   for (i = 0; i < nrecvs; i++) {
597887025532SHong Zhang     nrows = rstartsj[i + 1] - rstartsj[i]; /* length of the msg received */
59796497c311SBarry Smith     PetscCallMPI(MPIU_Irecv(b_otha + rstartsj[i], nrows, MPIU_SCALAR, rprocs[i], tag, comm, rwaits + i));
598087025532SHong Zhang   }
5981e42f35eeSHong Zhang 
5982e42f35eeSHong Zhang   /* pack the outgoing message a-array */
59833515ee7fSJunchao Zhang   if (nsends) k = sstarts[0];
598487025532SHong Zhang   for (i = 0; i < nsends; i++) {
5985e42f35eeSHong Zhang     nrows = sstarts[i + 1] - sstarts[i]; /* num of block rows */
598687025532SHong Zhang     bufA  = bufa + sstartsj[i];
598787025532SHong Zhang     for (j = 0; j < nrows; j++) {
5988d0f46423SBarry Smith       row = srow[k++] + B->rmap->range[rank]; /* global row idx */
5989e42f35eeSHong Zhang       for (ll = 0; ll < sbs; ll++) {
59909566063dSJacob Faibussowitsch         PetscCall(MatGetRow_MPIAIJ(B, row + ll, &ncols, NULL, &vals));
5991ad540459SPierre Jolivet         for (l = 0; l < ncols; l++) *bufA++ = vals[l];
59929566063dSJacob Faibussowitsch         PetscCall(MatRestoreRow_MPIAIJ(B, row + ll, &ncols, NULL, &vals));
5993e42f35eeSHong Zhang       }
5994a6b2eed2SHong Zhang     }
59956497c311SBarry Smith     PetscCallMPI(MPIU_Isend(bufa + sstartsj[i], sstartsj[i + 1] - sstartsj[i], MPIU_SCALAR, sprocs[i], tag, comm, swaits + i));
5996a6b2eed2SHong Zhang   }
599787025532SHong Zhang   /* recvs and sends of a-array are completed */
59989566063dSJacob Faibussowitsch   if (nreqs) PetscCallMPI(MPI_Waitall(nreqs, reqs, MPI_STATUSES_IGNORE));
59999566063dSJacob Faibussowitsch   PetscCall(PetscFree(reqs));
6000a6b2eed2SHong Zhang 
600187025532SHong Zhang   if (scall == MAT_INITIAL_MATRIX) {
6002dd460d27SBarry Smith     Mat_SeqAIJ *b_oth;
6003dd460d27SBarry Smith 
6004a6b2eed2SHong Zhang     /* put together the new matrix */
60059566063dSJacob Faibussowitsch     PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, aBn, B->cmap->N, b_othi, b_othj, b_otha, B_oth));
6006a6b2eed2SHong Zhang 
6007a6b2eed2SHong Zhang     /* MatCreateSeqAIJWithArrays flags matrix so PETSc doesn't free the user's arrays. */
6008a6b2eed2SHong Zhang     /* Since these are PETSc arrays, change flags to free them as necessary. */
600987025532SHong Zhang     b_oth          = (Mat_SeqAIJ *)(*B_oth)->data;
6010e6b907acSBarry Smith     b_oth->free_a  = PETSC_TRUE;
6011e6b907acSBarry Smith     b_oth->free_ij = PETSC_TRUE;
601287025532SHong Zhang     b_oth->nonew   = 0;
6013a6b2eed2SHong Zhang 
60149566063dSJacob Faibussowitsch     PetscCall(PetscFree(bufj));
6015b7f45c76SHong Zhang     if (!startsj_s || !bufa_ptr) {
60169566063dSJacob Faibussowitsch       PetscCall(PetscFree2(sstartsj, rstartsj));
60179566063dSJacob Faibussowitsch       PetscCall(PetscFree(bufa_ptr));
6018dea91ad1SHong Zhang     } else {
6019b7f45c76SHong Zhang       *startsj_s = sstartsj;
60201d79065fSBarry Smith       *startsj_r = rstartsj;
602187025532SHong Zhang       *bufa_ptr  = bufa;
602287025532SHong Zhang     }
6023fff043a9SJunchao Zhang   } else if (scall == MAT_REUSE_MATRIX) {
60249566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayWrite(*B_oth, &b_otha));
6025dea91ad1SHong Zhang   }
60263515ee7fSJunchao Zhang 
60279566063dSJacob Faibussowitsch   PetscCall(VecScatterRestoreRemote_Private(ctx, PETSC_TRUE, &nsends, &sstarts, &srow, &sprocs, &sbs));
60289566063dSJacob Faibussowitsch   PetscCall(VecScatterRestoreRemoteOrdered_Private(ctx, PETSC_FALSE, &nrecvs, &rstarts, NULL, &rprocs, &rbs));
60299566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(MAT_GetBrowsOfAocols, A, B, 0, 0));
60303ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6031429d309bSHong Zhang }
6032ccd8e176SBarry Smith 
6033cc2e6a90SBarry Smith PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJCRL(Mat, MatType, MatReuse, Mat *);
6034cc2e6a90SBarry Smith PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJPERM(Mat, MatType, MatReuse, Mat *);
6035ca9cdca7SRichard Tran Mills PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJSELL(Mat, MatType, MatReuse, Mat *);
60369779e05dSSatish Balay #if defined(PETSC_HAVE_MKL_SPARSE)
6037a84739b8SRichard Tran Mills PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJMKL(Mat, MatType, MatReuse, Mat *);
6038191b95cbSRichard Tran Mills #endif
6039ae8d29abSPierre Jolivet PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIBAIJ(Mat, MatType, MatReuse, Mat *);
6040cc2e6a90SBarry Smith PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPISBAIJ(Mat, MatType, MatReuse, Mat *);
60415d7652ecSHong Zhang #if defined(PETSC_HAVE_ELEMENTAL)
6042cc2e6a90SBarry Smith PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_Elemental(Mat, MatType, MatReuse, Mat *);
60435d7652ecSHong Zhang #endif
6044d24d4204SJose E. Roman #if defined(PETSC_HAVE_SCALAPACK)
6045d24d4204SJose E. Roman PETSC_INTERN PetscErrorCode MatConvert_AIJ_ScaLAPACK(Mat, MatType, MatReuse, Mat *);
6046d24d4204SJose E. Roman #endif
604763c07aadSStefano Zampini #if defined(PETSC_HAVE_HYPRE)
604863c07aadSStefano Zampini PETSC_INTERN PetscErrorCode MatConvert_AIJ_HYPRE(Mat, MatType, MatReuse, Mat *);
604963c07aadSStefano Zampini #endif
60503338378cSStefano Zampini #if defined(PETSC_HAVE_CUDA)
60513338378cSStefano Zampini PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJCUSPARSE(Mat, MatType, MatReuse, Mat *);
60523338378cSStefano Zampini #endif
6053d5e393b6SSuyash Tandon #if defined(PETSC_HAVE_HIP)
6054d5e393b6SSuyash Tandon PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJHIPSPARSE(Mat, MatType, MatReuse, Mat *);
6055d5e393b6SSuyash Tandon #endif
60563d0639e7SStefano Zampini #if defined(PETSC_HAVE_KOKKOS_KERNELS)
60573d0639e7SStefano Zampini PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPIAIJKokkos(Mat, MatType, MatReuse, Mat *);
60583d0639e7SStefano Zampini #endif
6059d4002b98SHong Zhang PETSC_INTERN PetscErrorCode MatConvert_MPIAIJ_MPISELL(Mat, MatType, MatReuse, Mat *);
60604222ddf1SHong Zhang PETSC_INTERN PetscErrorCode MatConvert_XAIJ_IS(Mat, MatType, MatReuse, Mat *);
60614222ddf1SHong Zhang PETSC_INTERN PetscErrorCode MatProductSetFromOptions_IS_XAIJ(Mat);
606217667f90SBarry Smith 
6063fc4dec0aSBarry Smith /*
6064fc4dec0aSBarry Smith     Computes (B'*A')' since computing B*A directly is untenable
6065fc4dec0aSBarry Smith 
6066fc4dec0aSBarry Smith                n                       p                          p
60672da392ccSBarry Smith         [             ]       [             ]         [                 ]
60682da392ccSBarry Smith       m [      A      ]  *  n [       B     ]   =   m [         C       ]
60692da392ccSBarry Smith         [             ]       [             ]         [                 ]
6070fc4dec0aSBarry Smith 
6071fc4dec0aSBarry Smith */
6072d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatMatMultNumeric_MPIDense_MPIAIJ(Mat A, Mat B, Mat C)
6073d71ae5a4SJacob Faibussowitsch {
6074fc4dec0aSBarry Smith   Mat At, Bt, Ct;
6075fc4dec0aSBarry Smith 
6076fc4dec0aSBarry Smith   PetscFunctionBegin;
60779566063dSJacob Faibussowitsch   PetscCall(MatTranspose(A, MAT_INITIAL_MATRIX, &At));
60789566063dSJacob Faibussowitsch   PetscCall(MatTranspose(B, MAT_INITIAL_MATRIX, &Bt));
6079fb842aefSJose E. Roman   PetscCall(MatMatMult(Bt, At, MAT_INITIAL_MATRIX, PETSC_CURRENT, &Ct));
60809566063dSJacob Faibussowitsch   PetscCall(MatDestroy(&At));
60819566063dSJacob Faibussowitsch   PetscCall(MatDestroy(&Bt));
60827fb60732SBarry Smith   PetscCall(MatTransposeSetPrecursor(Ct, C));
60839566063dSJacob Faibussowitsch   PetscCall(MatTranspose(Ct, MAT_REUSE_MATRIX, &C));
60849566063dSJacob Faibussowitsch   PetscCall(MatDestroy(&Ct));
60853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6086fc4dec0aSBarry Smith }
6087fc4dec0aSBarry Smith 
6088d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatMatMultSymbolic_MPIDense_MPIAIJ(Mat A, Mat B, PetscReal fill, Mat C)
6089d71ae5a4SJacob Faibussowitsch {
60906718818eSStefano Zampini   PetscBool cisdense;
6091fc4dec0aSBarry Smith 
6092fc4dec0aSBarry Smith   PetscFunctionBegin;
609308401ef6SPierre Jolivet   PetscCheck(A->cmap->n == B->rmap->n, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "A->cmap->n %" PetscInt_FMT " != B->rmap->n %" PetscInt_FMT, A->cmap->n, B->rmap->n);
60949566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(C, A->rmap->n, B->cmap->n, A->rmap->N, B->cmap->N));
60959566063dSJacob Faibussowitsch   PetscCall(MatSetBlockSizesFromMats(C, A, B));
6096d5e393b6SSuyash Tandon   PetscCall(PetscObjectTypeCompareAny((PetscObject)C, &cisdense, MATMPIDENSE, MATMPIDENSECUDA, MATMPIDENSEHIP, ""));
609748a46eb9SPierre Jolivet   if (!cisdense) PetscCall(MatSetType(C, ((PetscObject)A)->type_name));
60989566063dSJacob Faibussowitsch   PetscCall(MatSetUp(C));
6099f75ecaa4SHong Zhang 
61004222ddf1SHong Zhang   C->ops->matmultnumeric = MatMatMultNumeric_MPIDense_MPIAIJ;
61013ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6102fc4dec0aSBarry Smith }
6103fc4dec0aSBarry Smith 
6104d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatProductSetFromOptions_MPIDense_MPIAIJ_AB(Mat C)
6105d71ae5a4SJacob Faibussowitsch {
61064222ddf1SHong Zhang   Mat_Product *product = C->product;
61074222ddf1SHong Zhang   Mat          A = product->A, B = product->B;
6108fc4dec0aSBarry Smith 
6109fc4dec0aSBarry Smith   PetscFunctionBegin;
611020f4b53cSBarry Smith   PetscCheck(A->cmap->rstart == B->rmap->rstart && A->cmap->rend == B->rmap->rend, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Matrix local dimensions are incompatible, (%" PetscInt_FMT ", %" PetscInt_FMT ") != (%" PetscInt_FMT ",%" PetscInt_FMT ")",
611120f4b53cSBarry Smith              A->cmap->rstart, A->cmap->rend, B->rmap->rstart, B->rmap->rend);
61124222ddf1SHong Zhang   C->ops->matmultsymbolic = MatMatMultSymbolic_MPIDense_MPIAIJ;
61134222ddf1SHong Zhang   C->ops->productsymbolic = MatProductSymbolic_AB;
61143ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6115fc4dec0aSBarry Smith }
6116fc4dec0aSBarry Smith 
6117d71ae5a4SJacob Faibussowitsch PETSC_INTERN PetscErrorCode MatProductSetFromOptions_MPIDense_MPIAIJ(Mat C)
6118d71ae5a4SJacob Faibussowitsch {
61194222ddf1SHong Zhang   Mat_Product *product = C->product;
61204222ddf1SHong Zhang 
61214222ddf1SHong Zhang   PetscFunctionBegin;
612248a46eb9SPierre Jolivet   if (product->type == MATPRODUCT_AB) PetscCall(MatProductSetFromOptions_MPIDense_MPIAIJ_AB(C));
61233ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
61244222ddf1SHong Zhang }
6125394ed5ebSJunchao Zhang 
612627430b45SBarry Smith /*
612727430b45SBarry Smith    Merge two sets of sorted nonzeros and return a CSR for the merged (sequential) matrix
6128394ed5ebSJunchao Zhang 
6129394ed5ebSJunchao Zhang   Input Parameters:
6130394ed5ebSJunchao Zhang 
6131651b1cf9SStefano Zampini     j1,rowBegin1,rowEnd1,jmap1: describe the first set of nonzeros (Set1)
6132651b1cf9SStefano Zampini     j2,rowBegin2,rowEnd2,jmap2: describe the second set of nonzeros (Set2)
6133394ed5ebSJunchao Zhang 
6134158ec288SJunchao Zhang     mat: both sets' nonzeros are on m rows, where m is the number of local rows of the matrix mat
6135394ed5ebSJunchao Zhang 
6136394ed5ebSJunchao Zhang     For Set1, j1[] contains column indices of the nonzeros.
6137394ed5ebSJunchao Zhang     For the k-th row (0<=k<m), [rowBegin1[k],rowEnd1[k]) index into j1[] and point to the begin/end nonzero in row k
6138394ed5ebSJunchao Zhang     respectively (note rowEnd1[k] is not necessarily equal to rwoBegin1[k+1]). Indices in this range of j1[] are sorted,
6139394ed5ebSJunchao Zhang     but might have repeats. jmap1[t+1] - jmap1[t] is the number of repeats for the t-th unique nonzero in Set1.
6140394ed5ebSJunchao Zhang 
6141394ed5ebSJunchao Zhang     Similar for Set2.
6142394ed5ebSJunchao Zhang 
6143394ed5ebSJunchao Zhang     This routine merges the two sets of nonzeros row by row and removes repeats.
6144394ed5ebSJunchao Zhang 
6145158ec288SJunchao Zhang   Output Parameters: (memory is allocated by the caller)
6146394ed5ebSJunchao Zhang 
6147394ed5ebSJunchao Zhang     i[],j[]: the CSR of the merged matrix, which has m rows.
6148394ed5ebSJunchao Zhang     imap1[]: the k-th unique nonzero in Set1 (k=0,1,...) corresponds to imap1[k]-th unique nonzero in the merged matrix.
6149394ed5ebSJunchao Zhang     imap2[]: similar to imap1[], but for Set2.
6150394ed5ebSJunchao Zhang     Note we order nonzeros row-by-row and from left to right.
6151394ed5ebSJunchao Zhang */
6152d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatMergeEntries_Internal(Mat mat, const PetscInt j1[], const PetscInt j2[], const PetscCount rowBegin1[], const PetscCount rowEnd1[], const PetscCount rowBegin2[], const PetscCount rowEnd2[], const PetscCount jmap1[], const PetscCount jmap2[], PetscCount imap1[], PetscCount imap2[], PetscInt i[], PetscInt j[])
6153d71ae5a4SJacob Faibussowitsch {
6154394ed5ebSJunchao Zhang   PetscInt   r, m; /* Row index of mat */
6155394ed5ebSJunchao Zhang   PetscCount t, t1, t2, b1, e1, b2, e2;
6156394ed5ebSJunchao Zhang 
6157394ed5ebSJunchao Zhang   PetscFunctionBegin;
61589566063dSJacob Faibussowitsch   PetscCall(MatGetLocalSize(mat, &m, NULL));
6159394ed5ebSJunchao Zhang   t1 = t2 = t = 0; /* Count unique nonzeros of in Set1, Set1 and the merged respectively */
6160394ed5ebSJunchao Zhang   i[0]        = 0;
6161394ed5ebSJunchao Zhang   for (r = 0; r < m; r++) { /* Do row by row merging */
6162394ed5ebSJunchao Zhang     b1 = rowBegin1[r];
6163394ed5ebSJunchao Zhang     e1 = rowEnd1[r];
6164394ed5ebSJunchao Zhang     b2 = rowBegin2[r];
6165394ed5ebSJunchao Zhang     e2 = rowEnd2[r];
6166394ed5ebSJunchao Zhang     while (b1 < e1 && b2 < e2) {
6167394ed5ebSJunchao Zhang       if (j1[b1] == j2[b2]) { /* Same column index and hence same nonzero */
6168394ed5ebSJunchao Zhang         j[t]      = j1[b1];
6169394ed5ebSJunchao Zhang         imap1[t1] = t;
6170394ed5ebSJunchao Zhang         imap2[t2] = t;
6171394ed5ebSJunchao Zhang         b1 += jmap1[t1 + 1] - jmap1[t1]; /* Jump to next unique local nonzero */
6172394ed5ebSJunchao Zhang         b2 += jmap2[t2 + 1] - jmap2[t2]; /* Jump to next unique remote nonzero */
61739371c9d4SSatish Balay         t1++;
61749371c9d4SSatish Balay         t2++;
61759371c9d4SSatish Balay         t++;
6176394ed5ebSJunchao Zhang       } else if (j1[b1] < j2[b2]) {
6177394ed5ebSJunchao Zhang         j[t]      = j1[b1];
6178394ed5ebSJunchao Zhang         imap1[t1] = t;
6179394ed5ebSJunchao Zhang         b1 += jmap1[t1 + 1] - jmap1[t1];
61809371c9d4SSatish Balay         t1++;
61819371c9d4SSatish Balay         t++;
6182394ed5ebSJunchao Zhang       } else {
6183394ed5ebSJunchao Zhang         j[t]      = j2[b2];
6184394ed5ebSJunchao Zhang         imap2[t2] = t;
6185394ed5ebSJunchao Zhang         b2 += jmap2[t2 + 1] - jmap2[t2];
61869371c9d4SSatish Balay         t2++;
61879371c9d4SSatish Balay         t++;
6188394ed5ebSJunchao Zhang       }
6189394ed5ebSJunchao Zhang     }
6190394ed5ebSJunchao Zhang     /* Merge the remaining in either j1[] or j2[] */
6191394ed5ebSJunchao Zhang     while (b1 < e1) {
6192394ed5ebSJunchao Zhang       j[t]      = j1[b1];
6193394ed5ebSJunchao Zhang       imap1[t1] = t;
6194394ed5ebSJunchao Zhang       b1 += jmap1[t1 + 1] - jmap1[t1];
61959371c9d4SSatish Balay       t1++;
61969371c9d4SSatish Balay       t++;
6197394ed5ebSJunchao Zhang     }
6198394ed5ebSJunchao Zhang     while (b2 < e2) {
6199394ed5ebSJunchao Zhang       j[t]      = j2[b2];
6200394ed5ebSJunchao Zhang       imap2[t2] = t;
6201394ed5ebSJunchao Zhang       b2 += jmap2[t2 + 1] - jmap2[t2];
62029371c9d4SSatish Balay       t2++;
62039371c9d4SSatish Balay       t++;
6204394ed5ebSJunchao Zhang     }
62056497c311SBarry Smith     PetscCall(PetscIntCast(t, i + r + 1));
6206394ed5ebSJunchao Zhang   }
62073ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6208394ed5ebSJunchao Zhang }
6209394ed5ebSJunchao Zhang 
621027430b45SBarry Smith /*
621127430b45SBarry Smith   Split nonzeros in a block of local rows into two subsets: those in the diagonal block and those in the off-diagonal block
6212394ed5ebSJunchao Zhang 
6213394ed5ebSJunchao Zhang   Input Parameters:
6214394ed5ebSJunchao Zhang     mat: an MPI matrix that provides row and column layout information for splitting. Let's say its number of local rows is m.
6215394ed5ebSJunchao Zhang     n,i[],j[],perm[]: there are n input entries, belonging to m rows. Row/col indices of the entries are stored in i[] and j[]
6216394ed5ebSJunchao Zhang       respectively, along with a permutation array perm[]. Length of the i[],j[],perm[] arrays is n.
6217394ed5ebSJunchao Zhang 
6218394ed5ebSJunchao Zhang       i[] is already sorted, but within a row, j[] is not sorted and might have repeats.
6219394ed5ebSJunchao Zhang       i[] might contain negative indices at the beginning, which means the corresponding entries should be ignored in the splitting.
6220394ed5ebSJunchao Zhang 
6221394ed5ebSJunchao Zhang   Output Parameters:
6222394ed5ebSJunchao Zhang     j[],perm[]: the routine needs to sort j[] within each row along with perm[].
6223394ed5ebSJunchao Zhang     rowBegin[],rowMid[],rowEnd[]: of length m, and the memory is preallocated and zeroed by the caller.
6224394ed5ebSJunchao Zhang       They contain indices pointing to j[]. For 0<=r<m, [rowBegin[r],rowMid[r]) point to begin/end entries of row r of the diagonal block,
6225394ed5ebSJunchao Zhang       and [rowMid[r],rowEnd[r]) point to begin/end entries of row r of the off-diagonal block.
6226394ed5ebSJunchao Zhang 
6227394ed5ebSJunchao Zhang     Aperm[],Ajmap[],Atot,Annz: Arrays are allocated by this routine.
6228158ec288SJunchao Zhang       Atot: number of entries belonging to the diagonal block.
6229158ec288SJunchao Zhang       Annz: number of unique nonzeros belonging to the diagonal block.
6230394ed5ebSJunchao Zhang       Aperm[Atot] stores values from perm[] for entries belonging to the diagonal block. Length of Aperm[] is Atot, though it may also count
6231394ed5ebSJunchao Zhang         repeats (i.e., same 'i,j' pair).
6232394ed5ebSJunchao Zhang       Ajmap[Annz+1] stores the number of repeats of each unique entry belonging to the diagonal block. More precisely, Ajmap[t+1] - Ajmap[t]
6233394ed5ebSJunchao Zhang         is the number of repeats for the t-th unique entry in the diagonal block. Ajmap[0] is always 0.
6234394ed5ebSJunchao Zhang 
6235394ed5ebSJunchao Zhang       Atot: number of entries belonging to the diagonal block
6236394ed5ebSJunchao Zhang       Annz: number of unique nonzeros belonging to the diagonal block.
6237394ed5ebSJunchao Zhang 
6238394ed5ebSJunchao Zhang     Bperm[], Bjmap[], Btot, Bnnz are similar but for the off-diagonal block.
6239394ed5ebSJunchao Zhang 
6240158ec288SJunchao Zhang     Aperm[],Bperm[],Ajmap[] and Bjmap[] are allocated separately by this routine with PetscMalloc1().
6241394ed5ebSJunchao Zhang */
6242d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatSplitEntries_Internal(Mat mat, PetscCount n, const PetscInt i[], PetscInt j[], PetscCount perm[], PetscCount rowBegin[], PetscCount rowMid[], PetscCount rowEnd[], PetscCount *Atot_, PetscCount **Aperm_, PetscCount *Annz_, PetscCount **Ajmap_, PetscCount *Btot_, PetscCount **Bperm_, PetscCount *Bnnz_, PetscCount **Bjmap_)
6243d71ae5a4SJacob Faibussowitsch {
6244394ed5ebSJunchao Zhang   PetscInt    cstart, cend, rstart, rend, row, col;
6245394ed5ebSJunchao Zhang   PetscCount  Atot = 0, Btot = 0; /* Total number of nonzeros in the diagonal and off-diagonal blocks */
6246394ed5ebSJunchao Zhang   PetscCount  Annz = 0, Bnnz = 0; /* Number of unique nonzeros in the diagonal and off-diagonal blocks */
6247394ed5ebSJunchao Zhang   PetscCount  k, m, p, q, r, s, mid;
6248394ed5ebSJunchao Zhang   PetscCount *Aperm, *Bperm, *Ajmap, *Bjmap;
6249394ed5ebSJunchao Zhang 
6250394ed5ebSJunchao Zhang   PetscFunctionBegin;
62519566063dSJacob Faibussowitsch   PetscCall(PetscLayoutGetRange(mat->rmap, &rstart, &rend));
62529566063dSJacob Faibussowitsch   PetscCall(PetscLayoutGetRange(mat->cmap, &cstart, &cend));
6253394ed5ebSJunchao Zhang   m = rend - rstart;
6254394ed5ebSJunchao Zhang 
6255651b1cf9SStefano Zampini   /* Skip negative rows */
6256651b1cf9SStefano Zampini   for (k = 0; k < n; k++)
62579371c9d4SSatish Balay     if (i[k] >= 0) break;
6258394ed5ebSJunchao Zhang 
6259394ed5ebSJunchao Zhang   /* Process [k,n): sort and partition each local row into diag and offdiag portions,
6260394ed5ebSJunchao Zhang      fill rowBegin[], rowMid[], rowEnd[], and count Atot, Btot, Annz, Bnnz.
6261394ed5ebSJunchao Zhang   */
6262394ed5ebSJunchao Zhang   while (k < n) {
6263394ed5ebSJunchao Zhang     row = i[k];
6264394ed5ebSJunchao Zhang     /* Entries in [k,s) are in one row. Shift diagonal block col indices so that diag is ahead of offdiag after sorting the row */
62659371c9d4SSatish Balay     for (s = k; s < n; s++)
62669371c9d4SSatish Balay       if (i[s] != row) break;
6267651b1cf9SStefano Zampini 
62681690c2aeSBarry Smith     /* Shift diag columns to range of [-PETSC_INT_MAX, -1] */
6269394ed5ebSJunchao Zhang     for (p = k; p < s; p++) {
62701690c2aeSBarry Smith       if (j[p] >= cstart && j[p] < cend) j[p] -= PETSC_INT_MAX;
627154c59aa7SJacob Faibussowitsch       else PetscAssert((j[p] >= 0) && (j[p] <= mat->cmap->N), PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Column index %" PetscInt_FMT " is out of range", j[p]);
6272394ed5ebSJunchao Zhang     }
62739566063dSJacob Faibussowitsch     PetscCall(PetscSortIntWithCountArray(s - k, j + k, perm + k));
6274158ec288SJunchao Zhang     PetscCall(PetscSortedIntUpperBound(j, k, s, -1, &mid)); /* Separate [k,s) into [k,mid) for diag and [mid,s) for offdiag */
6275394ed5ebSJunchao Zhang     rowBegin[row - rstart] = k;
6276394ed5ebSJunchao Zhang     rowMid[row - rstart]   = mid;
6277394ed5ebSJunchao Zhang     rowEnd[row - rstart]   = s;
6278394ed5ebSJunchao Zhang 
6279394ed5ebSJunchao Zhang     /* Count nonzeros of this diag/offdiag row, which might have repeats */
6280394ed5ebSJunchao Zhang     Atot += mid - k;
6281394ed5ebSJunchao Zhang     Btot += s - mid;
6282394ed5ebSJunchao Zhang 
6283651b1cf9SStefano Zampini     /* Count unique nonzeros of this diag row */
6284394ed5ebSJunchao Zhang     for (p = k; p < mid;) {
6285394ed5ebSJunchao Zhang       col = j[p];
62869371c9d4SSatish Balay       do {
62871690c2aeSBarry Smith         j[p] += PETSC_INT_MAX; /* Revert the modified diagonal indices */
62889371c9d4SSatish Balay         p++;
6289651b1cf9SStefano Zampini       } while (p < mid && j[p] == col);
6290394ed5ebSJunchao Zhang       Annz++;
6291394ed5ebSJunchao Zhang     }
6292394ed5ebSJunchao Zhang 
6293651b1cf9SStefano Zampini     /* Count unique nonzeros of this offdiag row */
6294394ed5ebSJunchao Zhang     for (p = mid; p < s;) {
6295394ed5ebSJunchao Zhang       col = j[p];
6296d71ae5a4SJacob Faibussowitsch       do {
6297d71ae5a4SJacob Faibussowitsch         p++;
6298d71ae5a4SJacob Faibussowitsch       } while (p < s && j[p] == col);
6299394ed5ebSJunchao Zhang       Bnnz++;
6300394ed5ebSJunchao Zhang     }
6301394ed5ebSJunchao Zhang     k = s;
6302394ed5ebSJunchao Zhang   }
6303394ed5ebSJunchao Zhang 
6304394ed5ebSJunchao Zhang   /* Allocation according to Atot, Btot, Annz, Bnnz */
6305158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Atot, &Aperm));
6306158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Btot, &Bperm));
6307158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Annz + 1, &Ajmap));
6308158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Bnnz + 1, &Bjmap));
6309394ed5ebSJunchao Zhang 
63106aad120cSJose E. Roman   /* Re-scan indices and copy diag/offdiag permutation indices to Aperm, Bperm and also fill Ajmap and Bjmap */
6311394ed5ebSJunchao Zhang   Ajmap[0] = Bjmap[0] = Atot = Btot = Annz = Bnnz = 0;
6312394ed5ebSJunchao Zhang   for (r = 0; r < m; r++) {
6313394ed5ebSJunchao Zhang     k   = rowBegin[r];
6314394ed5ebSJunchao Zhang     mid = rowMid[r];
6315394ed5ebSJunchao Zhang     s   = rowEnd[r];
63168e3a54c0SPierre Jolivet     PetscCall(PetscArraycpy(PetscSafePointerPlusOffset(Aperm, Atot), PetscSafePointerPlusOffset(perm, k), mid - k));
63178e3a54c0SPierre Jolivet     PetscCall(PetscArraycpy(PetscSafePointerPlusOffset(Bperm, Btot), PetscSafePointerPlusOffset(perm, mid), s - mid));
6318394ed5ebSJunchao Zhang     Atot += mid - k;
6319394ed5ebSJunchao Zhang     Btot += s - mid;
6320394ed5ebSJunchao Zhang 
6321394ed5ebSJunchao Zhang     /* Scan column indices in this row and find out how many repeats each unique nonzero has */
6322394ed5ebSJunchao Zhang     for (p = k; p < mid;) {
6323394ed5ebSJunchao Zhang       col = j[p];
6324394ed5ebSJunchao Zhang       q   = p;
6325d71ae5a4SJacob Faibussowitsch       do {
6326d71ae5a4SJacob Faibussowitsch         p++;
6327d71ae5a4SJacob Faibussowitsch       } while (p < mid && j[p] == col);
6328394ed5ebSJunchao Zhang       Ajmap[Annz + 1] = Ajmap[Annz] + (p - q);
6329394ed5ebSJunchao Zhang       Annz++;
6330394ed5ebSJunchao Zhang     }
6331394ed5ebSJunchao Zhang 
6332394ed5ebSJunchao Zhang     for (p = mid; p < s;) {
6333394ed5ebSJunchao Zhang       col = j[p];
6334394ed5ebSJunchao Zhang       q   = p;
6335d71ae5a4SJacob Faibussowitsch       do {
6336d71ae5a4SJacob Faibussowitsch         p++;
6337d71ae5a4SJacob Faibussowitsch       } while (p < s && j[p] == col);
6338394ed5ebSJunchao Zhang       Bjmap[Bnnz + 1] = Bjmap[Bnnz] + (p - q);
6339394ed5ebSJunchao Zhang       Bnnz++;
6340394ed5ebSJunchao Zhang     }
6341394ed5ebSJunchao Zhang   }
6342394ed5ebSJunchao Zhang   /* Output */
6343394ed5ebSJunchao Zhang   *Aperm_ = Aperm;
6344394ed5ebSJunchao Zhang   *Annz_  = Annz;
6345394ed5ebSJunchao Zhang   *Atot_  = Atot;
6346394ed5ebSJunchao Zhang   *Ajmap_ = Ajmap;
6347394ed5ebSJunchao Zhang   *Bperm_ = Bperm;
6348394ed5ebSJunchao Zhang   *Bnnz_  = Bnnz;
6349394ed5ebSJunchao Zhang   *Btot_  = Btot;
6350394ed5ebSJunchao Zhang   *Bjmap_ = Bjmap;
63513ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6352394ed5ebSJunchao Zhang }
6353394ed5ebSJunchao Zhang 
635427430b45SBarry Smith /*
635527430b45SBarry Smith   Expand the jmap[] array to make a new one in view of nonzeros in the merged matrix
6356158ec288SJunchao Zhang 
6357158ec288SJunchao Zhang   Input Parameters:
6358158ec288SJunchao Zhang     nnz1: number of unique nonzeros in a set that was used to produce imap[], jmap[]
6359158ec288SJunchao Zhang     nnz:  number of unique nonzeros in the merged matrix
6360158ec288SJunchao Zhang     imap[nnz1]: i-th nonzero in the set is the imap[i]-th nonzero in the merged matrix
6361651b1cf9SStefano Zampini     jmap[nnz1+1]: i-th nonzero in the set has jmap[i+1] - jmap[i] repeats in the set
6362158ec288SJunchao Zhang 
6363158ec288SJunchao Zhang   Output Parameter: (memory is allocated by the caller)
6364158ec288SJunchao Zhang     jmap_new[nnz+1]: i-th nonzero in the merged matrix has jmap_new[i+1] - jmap_new[i] repeats in the set
6365158ec288SJunchao Zhang 
6366158ec288SJunchao Zhang   Example:
6367158ec288SJunchao Zhang     nnz1 = 4
6368158ec288SJunchao Zhang     nnz  = 6
6369158ec288SJunchao Zhang     imap = [1,3,4,5]
6370158ec288SJunchao Zhang     jmap = [0,3,5,6,7]
6371158ec288SJunchao Zhang    then,
6372158ec288SJunchao Zhang     jmap_new = [0,0,3,3,5,6,7]
6373158ec288SJunchao Zhang */
6374d71ae5a4SJacob Faibussowitsch static PetscErrorCode ExpandJmap_Internal(PetscCount nnz1, PetscCount nnz, const PetscCount imap[], const PetscCount jmap[], PetscCount jmap_new[])
6375d71ae5a4SJacob Faibussowitsch {
6376158ec288SJunchao Zhang   PetscCount k, p;
6377158ec288SJunchao Zhang 
6378158ec288SJunchao Zhang   PetscFunctionBegin;
6379158ec288SJunchao Zhang   jmap_new[0] = 0;
6380158ec288SJunchao Zhang   p           = nnz;                /* p loops over jmap_new[] backwards */
6381158ec288SJunchao Zhang   for (k = nnz1 - 1; k >= 0; k--) { /* k loops over imap[] */
6382158ec288SJunchao Zhang     for (; p > imap[k]; p--) jmap_new[p] = jmap[k + 1];
6383158ec288SJunchao Zhang   }
6384158ec288SJunchao Zhang   for (; p >= 0; p--) jmap_new[p] = jmap[0];
63853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6386158ec288SJunchao Zhang }
6387158ec288SJunchao Zhang 
638849abdd8aSBarry Smith static PetscErrorCode MatCOOStructDestroy_MPIAIJ(void **data)
63892c4ab24aSJunchao Zhang {
639049abdd8aSBarry Smith   MatCOOStruct_MPIAIJ *coo = (MatCOOStruct_MPIAIJ *)*data;
63912c4ab24aSJunchao Zhang 
63922c4ab24aSJunchao Zhang   PetscFunctionBegin;
63932c4ab24aSJunchao Zhang   PetscCall(PetscSFDestroy(&coo->sf));
63942c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Aperm1));
63952c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Bperm1));
63962c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Ajmap1));
63972c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Bjmap1));
63982c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Aimap2));
63992c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Bimap2));
64002c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Aperm2));
64012c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Bperm2));
64022c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Ajmap2));
64032c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Bjmap2));
64042c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo->Cperm1));
64052c4ab24aSJunchao Zhang   PetscCall(PetscFree2(coo->sendbuf, coo->recvbuf));
64062c4ab24aSJunchao Zhang   PetscCall(PetscFree(coo));
64072c4ab24aSJunchao Zhang   PetscFunctionReturn(PETSC_SUCCESS);
64082c4ab24aSJunchao Zhang }
64092c4ab24aSJunchao Zhang 
6410d71ae5a4SJacob Faibussowitsch PetscErrorCode MatSetPreallocationCOO_MPIAIJ(Mat mat, PetscCount coo_n, PetscInt coo_i[], PetscInt coo_j[])
6411d71ae5a4SJacob Faibussowitsch {
6412394ed5ebSJunchao Zhang   MPI_Comm             comm;
6413394ed5ebSJunchao Zhang   PetscMPIInt          rank, size;
6414394ed5ebSJunchao Zhang   PetscInt             m, n, M, N, rstart, rend, cstart, cend; /* Sizes, indices of row/col, therefore with type PetscInt */
6415394ed5ebSJunchao Zhang   PetscCount           k, p, q, rem;                           /* Loop variables over coo arrays */
6416394ed5ebSJunchao Zhang   Mat_MPIAIJ          *mpiaij = (Mat_MPIAIJ *)mat->data;
64172c4ab24aSJunchao Zhang   PetscContainer       container;
64182c4ab24aSJunchao Zhang   MatCOOStruct_MPIAIJ *coo;
6419394ed5ebSJunchao Zhang 
6420394ed5ebSJunchao Zhang   PetscFunctionBegin;
64219566063dSJacob Faibussowitsch   PetscCall(PetscFree(mpiaij->garray));
64229566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&mpiaij->lvec));
6423cbc6b225SStefano Zampini #if defined(PETSC_USE_CTABLE)
6424eec179cfSJacob Faibussowitsch   PetscCall(PetscHMapIDestroy(&mpiaij->colmap));
6425cbc6b225SStefano Zampini #else
64269566063dSJacob Faibussowitsch   PetscCall(PetscFree(mpiaij->colmap));
6427cbc6b225SStefano Zampini #endif
64289566063dSJacob Faibussowitsch   PetscCall(VecScatterDestroy(&mpiaij->Mvctx));
6429cbc6b225SStefano Zampini   mat->assembled     = PETSC_FALSE;
6430cbc6b225SStefano Zampini   mat->was_assembled = PETSC_FALSE;
6431cbc6b225SStefano Zampini 
64329566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetComm((PetscObject)mat, &comm));
64339566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(comm, &size));
64349566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(comm, &rank));
64359566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(mat->rmap));
64369566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(mat->cmap));
64379566063dSJacob Faibussowitsch   PetscCall(PetscLayoutGetRange(mat->rmap, &rstart, &rend));
64389566063dSJacob Faibussowitsch   PetscCall(PetscLayoutGetRange(mat->cmap, &cstart, &cend));
64399566063dSJacob Faibussowitsch   PetscCall(MatGetLocalSize(mat, &m, &n));
64409566063dSJacob Faibussowitsch   PetscCall(MatGetSize(mat, &M, &N));
6441394ed5ebSJunchao Zhang 
64426aad120cSJose E. Roman   /* Sort (i,j) by row along with a permutation array, so that the to-be-ignored */
6443394ed5ebSJunchao Zhang   /* entries come first, then local rows, then remote rows.                     */
6444394ed5ebSJunchao Zhang   PetscCount n1 = coo_n, *perm1;
6445e8729f6fSJunchao Zhang   PetscInt  *i1 = coo_i, *j1 = coo_j;
6446e8729f6fSJunchao Zhang 
6447e8729f6fSJunchao Zhang   PetscCall(PetscMalloc1(n1, &perm1));
6448394ed5ebSJunchao Zhang   for (k = 0; k < n1; k++) perm1[k] = k;
6449394ed5ebSJunchao Zhang 
6450394ed5ebSJunchao Zhang   /* Manipulate indices so that entries with negative row or col indices will have smallest
6451394ed5ebSJunchao Zhang      row indices, local entries will have greater but negative row indices, and remote entries
6452394ed5ebSJunchao Zhang      will have positive row indices.
6453394ed5ebSJunchao Zhang   */
6454394ed5ebSJunchao Zhang   for (k = 0; k < n1; k++) {
64551690c2aeSBarry Smith     if (i1[k] < 0 || j1[k] < 0) i1[k] = PETSC_INT_MIN;                /* e.g., -2^31, minimal to move them ahead */
64561690c2aeSBarry Smith     else if (i1[k] >= rstart && i1[k] < rend) i1[k] -= PETSC_INT_MAX; /* e.g., minus 2^31-1 to shift local rows to range of [-PETSC_INT_MAX, -1] */
6457f7d195e4SLawrence Mitchell     else {
6458f7d195e4SLawrence Mitchell       PetscCheck(!mat->nooffprocentries, PETSC_COMM_SELF, PETSC_ERR_USER_INPUT, "MAT_NO_OFF_PROC_ENTRIES is set but insert to remote rows");
64591690c2aeSBarry Smith       if (mpiaij->donotstash) i1[k] = PETSC_INT_MIN; /* Ignore offproc entries as if they had negative indices */
6460f7d195e4SLawrence Mitchell     }
6461394ed5ebSJunchao Zhang   }
6462394ed5ebSJunchao Zhang 
6463da81f932SPierre Jolivet   /* Sort by row; after that, [0,k) have ignored entries, [k,rem) have local rows and [rem,n1) have remote rows */
64649566063dSJacob Faibussowitsch   PetscCall(PetscSortIntWithIntCountArrayPair(n1, i1, j1, perm1));
6465651b1cf9SStefano Zampini 
6466651b1cf9SStefano Zampini   /* Advance k to the first entry we need to take care of */
6467651b1cf9SStefano Zampini   for (k = 0; k < n1; k++)
64681690c2aeSBarry Smith     if (i1[k] > PETSC_INT_MIN) break;
64696497c311SBarry Smith   PetscCount i1start = k;
6470651b1cf9SStefano Zampini 
64711690c2aeSBarry Smith   PetscCall(PetscSortedIntUpperBound(i1, k, n1, rend - 1 - PETSC_INT_MAX, &rem)); /* rem is upper bound of the last local row */
64721690c2aeSBarry Smith   for (; k < rem; k++) i1[k] += PETSC_INT_MAX;                                    /* Revert row indices of local rows*/
6473394ed5ebSJunchao Zhang 
6474394ed5ebSJunchao Zhang   /*           Send remote rows to their owner                                  */
6475394ed5ebSJunchao Zhang   /* Find which rows should be sent to which remote ranks*/
6476394ed5ebSJunchao Zhang   PetscInt        nsend = 0; /* Number of MPI ranks to send data to */
6477394ed5ebSJunchao Zhang   PetscMPIInt    *sendto;    /* [nsend], storing remote ranks */
6478394ed5ebSJunchao Zhang   PetscInt       *nentries;  /* [nsend], storing number of entries sent to remote ranks; Assume PetscInt is big enough for this count, and error if not */
6479394ed5ebSJunchao Zhang   const PetscInt *ranges;
6480394ed5ebSJunchao Zhang   PetscInt        maxNsend = size >= 128 ? 128 : size; /* Assume max 128 neighbors; realloc when needed */
6481394ed5ebSJunchao Zhang 
64829566063dSJacob Faibussowitsch   PetscCall(PetscLayoutGetRanges(mat->rmap, &ranges));
64839566063dSJacob Faibussowitsch   PetscCall(PetscMalloc2(maxNsend, &sendto, maxNsend, &nentries));
6484394ed5ebSJunchao Zhang   for (k = rem; k < n1;) {
6485394ed5ebSJunchao Zhang     PetscMPIInt owner;
6486394ed5ebSJunchao Zhang     PetscInt    firstRow, lastRow;
6487cbc6b225SStefano Zampini 
6488394ed5ebSJunchao Zhang     /* Locate a row range */
6489394ed5ebSJunchao Zhang     firstRow = i1[k]; /* first row of this owner */
64909566063dSJacob Faibussowitsch     PetscCall(PetscLayoutFindOwner(mat->rmap, firstRow, &owner));
6491394ed5ebSJunchao Zhang     lastRow = ranges[owner + 1] - 1; /* last row of this owner */
6492394ed5ebSJunchao Zhang 
6493394ed5ebSJunchao Zhang     /* Find the first index 'p' in [k,n) with i[p] belonging to next owner */
64949566063dSJacob Faibussowitsch     PetscCall(PetscSortedIntUpperBound(i1, k, n1, lastRow, &p));
6495394ed5ebSJunchao Zhang 
6496394ed5ebSJunchao Zhang     /* All entries in [k,p) belong to this remote owner */
6497394ed5ebSJunchao Zhang     if (nsend >= maxNsend) { /* Double the remote ranks arrays if not long enough */
6498394ed5ebSJunchao Zhang       PetscMPIInt *sendto2;
6499394ed5ebSJunchao Zhang       PetscInt    *nentries2;
6500394ed5ebSJunchao Zhang       PetscInt     maxNsend2 = (maxNsend <= size / 2) ? maxNsend * 2 : size;
6501cbc6b225SStefano Zampini 
65029566063dSJacob Faibussowitsch       PetscCall(PetscMalloc2(maxNsend2, &sendto2, maxNsend2, &nentries2));
65039566063dSJacob Faibussowitsch       PetscCall(PetscArraycpy(sendto2, sendto, maxNsend));
65049566063dSJacob Faibussowitsch       PetscCall(PetscArraycpy(nentries2, nentries2, maxNsend + 1));
65059566063dSJacob Faibussowitsch       PetscCall(PetscFree2(sendto, nentries2));
6506394ed5ebSJunchao Zhang       sendto   = sendto2;
6507394ed5ebSJunchao Zhang       nentries = nentries2;
6508394ed5ebSJunchao Zhang       maxNsend = maxNsend2;
6509394ed5ebSJunchao Zhang     }
6510394ed5ebSJunchao Zhang     sendto[nsend] = owner;
65116497c311SBarry Smith     PetscCall(PetscIntCast(p - k, &nentries[nsend]));
6512394ed5ebSJunchao Zhang     nsend++;
6513394ed5ebSJunchao Zhang     k = p;
6514394ed5ebSJunchao Zhang   }
6515394ed5ebSJunchao Zhang 
6516394ed5ebSJunchao Zhang   /* Build 1st SF to know offsets on remote to send data */
6517394ed5ebSJunchao Zhang   PetscSF      sf1;
6518394ed5ebSJunchao Zhang   PetscInt     nroots = 1, nroots2 = 0;
6519394ed5ebSJunchao Zhang   PetscInt     nleaves = nsend, nleaves2 = 0;
6520394ed5ebSJunchao Zhang   PetscInt    *offsets;
6521394ed5ebSJunchao Zhang   PetscSFNode *iremote;
6522394ed5ebSJunchao Zhang 
65239566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(comm, &sf1));
65249566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(nsend, &iremote));
65259566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(nsend, &offsets));
6526394ed5ebSJunchao Zhang   for (k = 0; k < nsend; k++) {
6527394ed5ebSJunchao Zhang     iremote[k].rank  = sendto[k];
6528394ed5ebSJunchao Zhang     iremote[k].index = 0;
6529394ed5ebSJunchao Zhang     nleaves2 += nentries[k];
653054c59aa7SJacob Faibussowitsch     PetscCheck(nleaves2 >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Number of SF leaves is too large for PetscInt");
6531394ed5ebSJunchao Zhang   }
65329566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraph(sf1, nroots, nleaves, NULL, PETSC_OWN_POINTER, iremote, PETSC_OWN_POINTER));
65339566063dSJacob Faibussowitsch   PetscCall(PetscSFFetchAndOpWithMemTypeBegin(sf1, MPIU_INT, PETSC_MEMTYPE_HOST, &nroots2 /*rootdata*/, PETSC_MEMTYPE_HOST, nentries /*leafdata*/, PETSC_MEMTYPE_HOST, offsets /*leafupdate*/, MPI_SUM));
65349566063dSJacob Faibussowitsch   PetscCall(PetscSFFetchAndOpEnd(sf1, MPIU_INT, &nroots2, nentries, offsets, MPI_SUM)); /* Would nroots2 overflow, we check offsets[] below */
65359566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&sf1));
6536e978a55eSPierre Jolivet   PetscAssert(nleaves2 == n1 - rem, PETSC_COMM_SELF, PETSC_ERR_PLIB, "nleaves2 %" PetscInt_FMT " != number of remote entries %" PetscCount_FMT, nleaves2, n1 - rem);
6537394ed5ebSJunchao Zhang 
6538394ed5ebSJunchao Zhang   /* Build 2nd SF to send remote COOs to their owner */
6539394ed5ebSJunchao Zhang   PetscSF sf2;
6540394ed5ebSJunchao Zhang   nroots  = nroots2;
6541394ed5ebSJunchao Zhang   nleaves = nleaves2;
65429566063dSJacob Faibussowitsch   PetscCall(PetscSFCreate(comm, &sf2));
65439566063dSJacob Faibussowitsch   PetscCall(PetscSFSetFromOptions(sf2));
65449566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(nleaves, &iremote));
6545394ed5ebSJunchao Zhang   p = 0;
6546394ed5ebSJunchao Zhang   for (k = 0; k < nsend; k++) {
654754c59aa7SJacob Faibussowitsch     PetscCheck(offsets[k] >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Number of SF roots is too large for PetscInt");
6548394ed5ebSJunchao Zhang     for (q = 0; q < nentries[k]; q++, p++) {
6549394ed5ebSJunchao Zhang       iremote[p].rank = sendto[k];
65506497c311SBarry Smith       PetscCall(PetscIntCast(offsets[k] + q, &iremote[p].index));
6551394ed5ebSJunchao Zhang     }
6552394ed5ebSJunchao Zhang   }
65539566063dSJacob Faibussowitsch   PetscCall(PetscSFSetGraph(sf2, nroots, nleaves, NULL, PETSC_OWN_POINTER, iremote, PETSC_OWN_POINTER));
6554394ed5ebSJunchao Zhang 
6555394ed5ebSJunchao Zhang   /* Send the remote COOs to their owner */
6556394ed5ebSJunchao Zhang   PetscInt    n2 = nroots, *i2, *j2; /* Buffers for received COOs from other ranks, along with a permutation array */
6557394ed5ebSJunchao Zhang   PetscCount *perm2;                 /* Though PetscInt is enough for remote entries, we use PetscCount here as we want to reuse MatSplitEntries_Internal() */
65589566063dSJacob Faibussowitsch   PetscCall(PetscMalloc3(n2, &i2, n2, &j2, n2, &perm2));
6559834dcf29SHansol Suh   PetscAssert(rem == 0 || i1 != NULL, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Cannot add nonzero offset to null");
6560834dcf29SHansol Suh   PetscAssert(rem == 0 || j1 != NULL, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Cannot add nonzero offset to null");
6561de0a9f35SPierre Jolivet   PetscInt *i1prem = PetscSafePointerPlusOffset(i1, rem);
6562de0a9f35SPierre Jolivet   PetscInt *j1prem = PetscSafePointerPlusOffset(j1, rem);
6563834dcf29SHansol Suh   PetscCall(PetscSFReduceWithMemTypeBegin(sf2, MPIU_INT, PETSC_MEMTYPE_HOST, i1prem, PETSC_MEMTYPE_HOST, i2, MPI_REPLACE));
6564834dcf29SHansol Suh   PetscCall(PetscSFReduceEnd(sf2, MPIU_INT, i1prem, i2, MPI_REPLACE));
6565834dcf29SHansol Suh   PetscCall(PetscSFReduceWithMemTypeBegin(sf2, MPIU_INT, PETSC_MEMTYPE_HOST, j1prem, PETSC_MEMTYPE_HOST, j2, MPI_REPLACE));
6566834dcf29SHansol Suh   PetscCall(PetscSFReduceEnd(sf2, MPIU_INT, j1prem, j2, MPI_REPLACE));
6567394ed5ebSJunchao Zhang 
65689566063dSJacob Faibussowitsch   PetscCall(PetscFree(offsets));
65699566063dSJacob Faibussowitsch   PetscCall(PetscFree2(sendto, nentries));
6570394ed5ebSJunchao Zhang 
6571394ed5ebSJunchao Zhang   /* Sort received COOs by row along with the permutation array     */
6572394ed5ebSJunchao Zhang   for (k = 0; k < n2; k++) perm2[k] = k;
65739566063dSJacob Faibussowitsch   PetscCall(PetscSortIntWithIntCountArrayPair(n2, i2, j2, perm2));
6574394ed5ebSJunchao Zhang 
6575651b1cf9SStefano Zampini   /* sf2 only sends contiguous leafdata to contiguous rootdata. We record the permutation which will be used to fill leafdata */
6576651b1cf9SStefano Zampini   PetscCount *Cperm1;
6577834dcf29SHansol Suh   PetscAssert(rem == 0 || perm1 != NULL, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Cannot add nonzero offset to null");
6578de0a9f35SPierre Jolivet   PetscCount *perm1prem = PetscSafePointerPlusOffset(perm1, rem);
6579651b1cf9SStefano Zampini   PetscCall(PetscMalloc1(nleaves, &Cperm1));
6580834dcf29SHansol Suh   PetscCall(PetscArraycpy(Cperm1, perm1prem, nleaves));
6581651b1cf9SStefano Zampini 
6582651b1cf9SStefano Zampini   /* Support for HYPRE matrices, kind of a hack.
6583651b1cf9SStefano Zampini      Swap min column with diagonal so that diagonal values will go first */
6584651b1cf9SStefano Zampini   PetscBool hypre;
658517b874c6SStefano Zampini   PetscCall(PetscStrcmp("_internal_COO_mat_for_hypre", ((PetscObject)mat)->name, &hypre));
6586651b1cf9SStefano Zampini   if (hypre) {
6587651b1cf9SStefano Zampini     PetscInt *minj;
6588651b1cf9SStefano Zampini     PetscBT   hasdiag;
6589651b1cf9SStefano Zampini 
6590651b1cf9SStefano Zampini     PetscCall(PetscBTCreate(m, &hasdiag));
6591651b1cf9SStefano Zampini     PetscCall(PetscMalloc1(m, &minj));
65921690c2aeSBarry Smith     for (k = 0; k < m; k++) minj[k] = PETSC_INT_MAX;
6593651b1cf9SStefano Zampini     for (k = i1start; k < rem; k++) {
6594651b1cf9SStefano Zampini       if (j1[k] < cstart || j1[k] >= cend) continue;
6595651b1cf9SStefano Zampini       const PetscInt rindex = i1[k] - rstart;
6596651b1cf9SStefano Zampini       if ((j1[k] - cstart) == rindex) PetscCall(PetscBTSet(hasdiag, rindex));
6597651b1cf9SStefano Zampini       minj[rindex] = PetscMin(minj[rindex], j1[k]);
6598651b1cf9SStefano Zampini     }
6599651b1cf9SStefano Zampini     for (k = 0; k < n2; k++) {
6600651b1cf9SStefano Zampini       if (j2[k] < cstart || j2[k] >= cend) continue;
6601651b1cf9SStefano Zampini       const PetscInt rindex = i2[k] - rstart;
6602651b1cf9SStefano Zampini       if ((j2[k] - cstart) == rindex) PetscCall(PetscBTSet(hasdiag, rindex));
6603651b1cf9SStefano Zampini       minj[rindex] = PetscMin(minj[rindex], j2[k]);
6604651b1cf9SStefano Zampini     }
6605651b1cf9SStefano Zampini     for (k = i1start; k < rem; k++) {
6606651b1cf9SStefano Zampini       const PetscInt rindex = i1[k] - rstart;
6607651b1cf9SStefano Zampini       if (j1[k] < cstart || j1[k] >= cend || !PetscBTLookup(hasdiag, rindex)) continue;
6608651b1cf9SStefano Zampini       if (j1[k] == minj[rindex]) j1[k] = i1[k] + (cstart - rstart);
6609651b1cf9SStefano Zampini       else if ((j1[k] - cstart) == rindex) j1[k] = minj[rindex];
6610651b1cf9SStefano Zampini     }
6611651b1cf9SStefano Zampini     for (k = 0; k < n2; k++) {
6612651b1cf9SStefano Zampini       const PetscInt rindex = i2[k] - rstart;
6613651b1cf9SStefano Zampini       if (j2[k] < cstart || j2[k] >= cend || !PetscBTLookup(hasdiag, rindex)) continue;
6614651b1cf9SStefano Zampini       if (j2[k] == minj[rindex]) j2[k] = i2[k] + (cstart - rstart);
6615651b1cf9SStefano Zampini       else if ((j2[k] - cstart) == rindex) j2[k] = minj[rindex];
6616651b1cf9SStefano Zampini     }
6617651b1cf9SStefano Zampini     PetscCall(PetscBTDestroy(&hasdiag));
6618651b1cf9SStefano Zampini     PetscCall(PetscFree(minj));
6619651b1cf9SStefano Zampini   }
6620651b1cf9SStefano Zampini 
6621651b1cf9SStefano Zampini   /* Split local COOs and received COOs into diag/offdiag portions */
6622651b1cf9SStefano Zampini   PetscCount *rowBegin1, *rowMid1, *rowEnd1;
6623651b1cf9SStefano Zampini   PetscCount *Ajmap1, *Aperm1, *Bjmap1, *Bperm1;
6624651b1cf9SStefano Zampini   PetscCount  Annz1, Bnnz1, Atot1, Btot1;
6625394ed5ebSJunchao Zhang   PetscCount *rowBegin2, *rowMid2, *rowEnd2;
6626394ed5ebSJunchao Zhang   PetscCount *Ajmap2, *Aperm2, *Bjmap2, *Bperm2;
6627394ed5ebSJunchao Zhang   PetscCount  Annz2, Bnnz2, Atot2, Btot2;
6628394ed5ebSJunchao Zhang 
6629651b1cf9SStefano Zampini   PetscCall(PetscCalloc3(m, &rowBegin1, m, &rowMid1, m, &rowEnd1));
66309566063dSJacob Faibussowitsch   PetscCall(PetscCalloc3(m, &rowBegin2, m, &rowMid2, m, &rowEnd2));
6631651b1cf9SStefano Zampini   PetscCall(MatSplitEntries_Internal(mat, rem, i1, j1, perm1, rowBegin1, rowMid1, rowEnd1, &Atot1, &Aperm1, &Annz1, &Ajmap1, &Btot1, &Bperm1, &Bnnz1, &Bjmap1));
66329566063dSJacob Faibussowitsch   PetscCall(MatSplitEntries_Internal(mat, n2, i2, j2, perm2, rowBegin2, rowMid2, rowEnd2, &Atot2, &Aperm2, &Annz2, &Ajmap2, &Btot2, &Bperm2, &Bnnz2, &Bjmap2));
6633394ed5ebSJunchao Zhang 
6634394ed5ebSJunchao Zhang   /* Merge local COOs with received COOs: diag with diag, offdiag with offdiag */
6635394ed5ebSJunchao Zhang   PetscInt *Ai, *Bi;
6636394ed5ebSJunchao Zhang   PetscInt *Aj, *Bj;
6637394ed5ebSJunchao Zhang 
66389566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m + 1, &Ai));
66399566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(m + 1, &Bi));
66409566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(Annz1 + Annz2, &Aj)); /* Since local and remote entries might have dups, we might allocate excess memory */
66419566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(Bnnz1 + Bnnz2, &Bj));
6642394ed5ebSJunchao Zhang 
6643394ed5ebSJunchao Zhang   PetscCount *Aimap1, *Bimap1, *Aimap2, *Bimap2;
6644158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Annz1, &Aimap1));
6645158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Bnnz1, &Bimap1));
6646158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Annz2, &Aimap2));
6647158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Bnnz2, &Bimap2));
6648394ed5ebSJunchao Zhang 
66499566063dSJacob Faibussowitsch   PetscCall(MatMergeEntries_Internal(mat, j1, j2, rowBegin1, rowMid1, rowBegin2, rowMid2, Ajmap1, Ajmap2, Aimap1, Aimap2, Ai, Aj));
66509566063dSJacob Faibussowitsch   PetscCall(MatMergeEntries_Internal(mat, j1, j2, rowMid1, rowEnd1, rowMid2, rowEnd2, Bjmap1, Bjmap2, Bimap1, Bimap2, Bi, Bj));
6651158ec288SJunchao Zhang 
6652158ec288SJunchao Zhang   /* Expand Ajmap1/Bjmap1 to make them based off nonzeros in A/B, since we     */
6653158ec288SJunchao Zhang   /* expect nonzeros in A/B most likely have local contributing entries        */
6654158ec288SJunchao Zhang   PetscInt    Annz = Ai[m];
6655158ec288SJunchao Zhang   PetscInt    Bnnz = Bi[m];
6656158ec288SJunchao Zhang   PetscCount *Ajmap1_new, *Bjmap1_new;
6657158ec288SJunchao Zhang 
6658158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Annz + 1, &Ajmap1_new));
6659158ec288SJunchao Zhang   PetscCall(PetscMalloc1(Bnnz + 1, &Bjmap1_new));
6660158ec288SJunchao Zhang 
6661158ec288SJunchao Zhang   PetscCall(ExpandJmap_Internal(Annz1, Annz, Aimap1, Ajmap1, Ajmap1_new));
6662158ec288SJunchao Zhang   PetscCall(ExpandJmap_Internal(Bnnz1, Bnnz, Bimap1, Bjmap1, Bjmap1_new));
6663158ec288SJunchao Zhang 
6664158ec288SJunchao Zhang   PetscCall(PetscFree(Aimap1));
6665158ec288SJunchao Zhang   PetscCall(PetscFree(Ajmap1));
6666158ec288SJunchao Zhang   PetscCall(PetscFree(Bimap1));
6667158ec288SJunchao Zhang   PetscCall(PetscFree(Bjmap1));
66689566063dSJacob Faibussowitsch   PetscCall(PetscFree3(rowBegin1, rowMid1, rowEnd1));
66699566063dSJacob Faibussowitsch   PetscCall(PetscFree3(rowBegin2, rowMid2, rowEnd2));
6670e8729f6fSJunchao Zhang   PetscCall(PetscFree(perm1));
66719566063dSJacob Faibussowitsch   PetscCall(PetscFree3(i2, j2, perm2));
6672394ed5ebSJunchao Zhang 
6673158ec288SJunchao Zhang   Ajmap1 = Ajmap1_new;
6674158ec288SJunchao Zhang   Bjmap1 = Bjmap1_new;
6675158ec288SJunchao Zhang 
6676394ed5ebSJunchao Zhang   /* Reallocate Aj, Bj once we know actual numbers of unique nonzeros in A and B */
6677394ed5ebSJunchao Zhang   if (Annz < Annz1 + Annz2) {
6678394ed5ebSJunchao Zhang     PetscInt *Aj_new;
66799566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(Annz, &Aj_new));
66809566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(Aj_new, Aj, Annz));
66819566063dSJacob Faibussowitsch     PetscCall(PetscFree(Aj));
6682394ed5ebSJunchao Zhang     Aj = Aj_new;
6683394ed5ebSJunchao Zhang   }
6684394ed5ebSJunchao Zhang 
6685394ed5ebSJunchao Zhang   if (Bnnz < Bnnz1 + Bnnz2) {
6686394ed5ebSJunchao Zhang     PetscInt *Bj_new;
66879566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(Bnnz, &Bj_new));
66889566063dSJacob Faibussowitsch     PetscCall(PetscArraycpy(Bj_new, Bj, Bnnz));
66899566063dSJacob Faibussowitsch     PetscCall(PetscFree(Bj));
6690394ed5ebSJunchao Zhang     Bj = Bj_new;
6691394ed5ebSJunchao Zhang   }
6692394ed5ebSJunchao Zhang 
6693cbc6b225SStefano Zampini   /* Create new submatrices for on-process and off-process coupling                  */
6694394ed5ebSJunchao Zhang   PetscScalar     *Aa, *Ba;
6695cbc6b225SStefano Zampini   MatType          rtype;
6696394ed5ebSJunchao Zhang   Mat_SeqAIJ      *a, *b;
6697cf8ba265SJunchao Zhang   PetscObjectState state;
66989566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(Annz, &Aa)); /* Zero matrix on device */
66999566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(Bnnz, &Ba));
6700394ed5ebSJunchao Zhang   /* make Aj[] local, i.e, based off the start column of the diagonal portion */
67019371c9d4SSatish Balay   if (cstart) {
67029371c9d4SSatish Balay     for (k = 0; k < Annz; k++) Aj[k] -= cstart;
67039371c9d4SSatish Balay   }
6704c508b908SBarry Smith 
67059566063dSJacob Faibussowitsch   PetscCall(MatGetRootType_Private(mat, &rtype));
6706c508b908SBarry Smith 
6707c508b908SBarry Smith   MatSeqXAIJGetOptions_Private(mpiaij->A);
6708c508b908SBarry Smith   PetscCall(MatDestroy(&mpiaij->A));
67099566063dSJacob Faibussowitsch   PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, m, n, Ai, Aj, Aa, &mpiaij->A));
67100da474c6SJeremy L Thompson   PetscCall(MatSetBlockSizesFromMats(mpiaij->A, mat, mat));
6711c508b908SBarry Smith   MatSeqXAIJRestoreOptions_Private(mpiaij->A);
6712c508b908SBarry Smith 
6713c508b908SBarry Smith   MatSeqXAIJGetOptions_Private(mpiaij->B);
6714c508b908SBarry Smith   PetscCall(MatDestroy(&mpiaij->B));
67159566063dSJacob Faibussowitsch   PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, m, mat->cmap->N, Bi, Bj, Ba, &mpiaij->B));
67160da474c6SJeremy L Thompson   PetscCall(MatSetBlockSizesFromMats(mpiaij->B, mat, mat));
6717c508b908SBarry Smith   MatSeqXAIJRestoreOptions_Private(mpiaij->B);
6718c508b908SBarry Smith 
67199566063dSJacob Faibussowitsch   PetscCall(MatSetUpMultiply_MPIAIJ(mat));
67205bb69915SJunchao Zhang   mat->was_assembled = PETSC_TRUE; // was_assembled in effect means the Mvctx is built; doing so avoids redundant MatSetUpMultiply_MPIAIJ
6721cf8ba265SJunchao Zhang   state              = mpiaij->A->nonzerostate + mpiaij->B->nonzerostate;
6722462c564dSBarry Smith   PetscCallMPI(MPIU_Allreduce(&state, &mat->nonzerostate, 1, MPIU_INT64, MPI_SUM, PetscObjectComm((PetscObject)mat)));
6723cbc6b225SStefano Zampini 
6724394ed5ebSJunchao Zhang   a          = (Mat_SeqAIJ *)mpiaij->A->data;
6725394ed5ebSJunchao Zhang   b          = (Mat_SeqAIJ *)mpiaij->B->data;
67269f0612e4SBarry Smith   a->free_a  = PETSC_TRUE;
67279f0612e4SBarry Smith   a->free_ij = PETSC_TRUE;
67289f0612e4SBarry Smith   b->free_a  = PETSC_TRUE;
67299f0612e4SBarry Smith   b->free_ij = PETSC_TRUE;
673017b874c6SStefano Zampini   a->maxnz   = a->nz;
673117b874c6SStefano Zampini   b->maxnz   = b->nz;
6732394ed5ebSJunchao Zhang 
6733cbc6b225SStefano Zampini   /* conversion must happen AFTER multiply setup */
67349566063dSJacob Faibussowitsch   PetscCall(MatConvert(mpiaij->A, rtype, MAT_INPLACE_MATRIX, &mpiaij->A));
67359566063dSJacob Faibussowitsch   PetscCall(MatConvert(mpiaij->B, rtype, MAT_INPLACE_MATRIX, &mpiaij->B));
67369566063dSJacob Faibussowitsch   PetscCall(VecDestroy(&mpiaij->lvec));
67379566063dSJacob Faibussowitsch   PetscCall(MatCreateVecs(mpiaij->B, &mpiaij->lvec, NULL));
6738cbc6b225SStefano Zampini 
67392c4ab24aSJunchao Zhang   // Put the COO struct in a container and then attach that to the matrix
67402c4ab24aSJunchao Zhang   PetscCall(PetscMalloc1(1, &coo));
67412c4ab24aSJunchao Zhang   coo->n       = coo_n;
67422c4ab24aSJunchao Zhang   coo->sf      = sf2;
67432c4ab24aSJunchao Zhang   coo->sendlen = nleaves;
67442c4ab24aSJunchao Zhang   coo->recvlen = nroots;
67452c4ab24aSJunchao Zhang   coo->Annz    = Annz;
67462c4ab24aSJunchao Zhang   coo->Bnnz    = Bnnz;
67472c4ab24aSJunchao Zhang   coo->Annz2   = Annz2;
67482c4ab24aSJunchao Zhang   coo->Bnnz2   = Bnnz2;
67492c4ab24aSJunchao Zhang   coo->Atot1   = Atot1;
67502c4ab24aSJunchao Zhang   coo->Atot2   = Atot2;
67512c4ab24aSJunchao Zhang   coo->Btot1   = Btot1;
67522c4ab24aSJunchao Zhang   coo->Btot2   = Btot2;
67532c4ab24aSJunchao Zhang   coo->Ajmap1  = Ajmap1;
67542c4ab24aSJunchao Zhang   coo->Aperm1  = Aperm1;
67552c4ab24aSJunchao Zhang   coo->Bjmap1  = Bjmap1;
67562c4ab24aSJunchao Zhang   coo->Bperm1  = Bperm1;
67572c4ab24aSJunchao Zhang   coo->Aimap2  = Aimap2;
67582c4ab24aSJunchao Zhang   coo->Ajmap2  = Ajmap2;
67592c4ab24aSJunchao Zhang   coo->Aperm2  = Aperm2;
67602c4ab24aSJunchao Zhang   coo->Bimap2  = Bimap2;
67612c4ab24aSJunchao Zhang   coo->Bjmap2  = Bjmap2;
67622c4ab24aSJunchao Zhang   coo->Bperm2  = Bperm2;
67632c4ab24aSJunchao Zhang   coo->Cperm1  = Cperm1;
67642c4ab24aSJunchao Zhang   // Allocate in preallocation. If not used, it has zero cost on host
67652c4ab24aSJunchao Zhang   PetscCall(PetscMalloc2(coo->sendlen, &coo->sendbuf, coo->recvlen, &coo->recvbuf));
67662c4ab24aSJunchao Zhang   PetscCall(PetscContainerCreate(PETSC_COMM_SELF, &container));
67672c4ab24aSJunchao Zhang   PetscCall(PetscContainerSetPointer(container, coo));
676849abdd8aSBarry Smith   PetscCall(PetscContainerSetCtxDestroy(container, MatCOOStructDestroy_MPIAIJ));
67692c4ab24aSJunchao Zhang   PetscCall(PetscObjectCompose((PetscObject)mat, "__PETSc_MatCOOStruct_Host", (PetscObject)container));
67702c4ab24aSJunchao Zhang   PetscCall(PetscContainerDestroy(&container));
67713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6772394ed5ebSJunchao Zhang }
6773394ed5ebSJunchao Zhang 
6774d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatSetValuesCOO_MPIAIJ(Mat mat, const PetscScalar v[], InsertMode imode)
6775d71ae5a4SJacob Faibussowitsch {
6776394ed5ebSJunchao Zhang   Mat_MPIAIJ          *mpiaij = (Mat_MPIAIJ *)mat->data;
6777394ed5ebSJunchao Zhang   Mat                  A = mpiaij->A, B = mpiaij->B;
6778394ed5ebSJunchao Zhang   PetscScalar         *Aa, *Ba;
67792c4ab24aSJunchao Zhang   PetscScalar         *sendbuf, *recvbuf;
67802c4ab24aSJunchao Zhang   const PetscCount    *Ajmap1, *Ajmap2, *Aimap2;
67812c4ab24aSJunchao Zhang   const PetscCount    *Bjmap1, *Bjmap2, *Bimap2;
67822c4ab24aSJunchao Zhang   const PetscCount    *Aperm1, *Aperm2, *Bperm1, *Bperm2;
67832c4ab24aSJunchao Zhang   const PetscCount    *Cperm1;
67842c4ab24aSJunchao Zhang   PetscContainer       container;
67852c4ab24aSJunchao Zhang   MatCOOStruct_MPIAIJ *coo;
6786394ed5ebSJunchao Zhang 
6787394ed5ebSJunchao Zhang   PetscFunctionBegin;
67882c4ab24aSJunchao Zhang   PetscCall(PetscObjectQuery((PetscObject)mat, "__PETSc_MatCOOStruct_Host", (PetscObject *)&container));
67892c4ab24aSJunchao Zhang   PetscCheck(container, PetscObjectComm((PetscObject)mat), PETSC_ERR_PLIB, "Not found MatCOOStruct on this matrix");
67902c4ab24aSJunchao Zhang   PetscCall(PetscContainerGetPointer(container, (void **)&coo));
67912c4ab24aSJunchao Zhang   sendbuf = coo->sendbuf;
67922c4ab24aSJunchao Zhang   recvbuf = coo->recvbuf;
67932c4ab24aSJunchao Zhang   Ajmap1  = coo->Ajmap1;
67942c4ab24aSJunchao Zhang   Ajmap2  = coo->Ajmap2;
67952c4ab24aSJunchao Zhang   Aimap2  = coo->Aimap2;
67962c4ab24aSJunchao Zhang   Bjmap1  = coo->Bjmap1;
67972c4ab24aSJunchao Zhang   Bjmap2  = coo->Bjmap2;
67982c4ab24aSJunchao Zhang   Bimap2  = coo->Bimap2;
67992c4ab24aSJunchao Zhang   Aperm1  = coo->Aperm1;
68002c4ab24aSJunchao Zhang   Aperm2  = coo->Aperm2;
68012c4ab24aSJunchao Zhang   Bperm1  = coo->Bperm1;
68022c4ab24aSJunchao Zhang   Bperm2  = coo->Bperm2;
68032c4ab24aSJunchao Zhang   Cperm1  = coo->Cperm1;
68042c4ab24aSJunchao Zhang 
68059566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(A, &Aa)); /* Might read and write matrix values */
68069566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJGetArray(B, &Ba));
6807394ed5ebSJunchao Zhang 
6808394ed5ebSJunchao Zhang   /* Pack entries to be sent to remote */
68092c4ab24aSJunchao Zhang   for (PetscCount i = 0; i < coo->sendlen; i++) sendbuf[i] = v[Cperm1[i]];
6810394ed5ebSJunchao Zhang 
6811394ed5ebSJunchao Zhang   /* Send remote entries to their owner and overlap the communication with local computation */
68122c4ab24aSJunchao Zhang   PetscCall(PetscSFReduceWithMemTypeBegin(coo->sf, MPIU_SCALAR, PETSC_MEMTYPE_HOST, sendbuf, PETSC_MEMTYPE_HOST, recvbuf, MPI_REPLACE));
6813394ed5ebSJunchao Zhang   /* Add local entries to A and B */
68142c4ab24aSJunchao Zhang   for (PetscCount i = 0; i < coo->Annz; i++) { /* All nonzeros in A are either zero'ed or added with a value (i.e., initialized) */
6815da81f932SPierre Jolivet     PetscScalar sum = 0.0;                     /* Do partial summation first to improve numerical stability */
6816158ec288SJunchao Zhang     for (PetscCount k = Ajmap1[i]; k < Ajmap1[i + 1]; k++) sum += v[Aperm1[k]];
6817158ec288SJunchao Zhang     Aa[i] = (imode == INSERT_VALUES ? 0.0 : Aa[i]) + sum;
6818394ed5ebSJunchao Zhang   }
68192c4ab24aSJunchao Zhang   for (PetscCount i = 0; i < coo->Bnnz; i++) {
6820158ec288SJunchao Zhang     PetscScalar sum = 0.0;
6821158ec288SJunchao Zhang     for (PetscCount k = Bjmap1[i]; k < Bjmap1[i + 1]; k++) sum += v[Bperm1[k]];
6822158ec288SJunchao Zhang     Ba[i] = (imode == INSERT_VALUES ? 0.0 : Ba[i]) + sum;
6823394ed5ebSJunchao Zhang   }
68242c4ab24aSJunchao Zhang   PetscCall(PetscSFReduceEnd(coo->sf, MPIU_SCALAR, sendbuf, recvbuf, MPI_REPLACE));
6825394ed5ebSJunchao Zhang 
6826394ed5ebSJunchao Zhang   /* Add received remote entries to A and B */
68272c4ab24aSJunchao Zhang   for (PetscCount i = 0; i < coo->Annz2; i++) {
6828394ed5ebSJunchao Zhang     for (PetscCount k = Ajmap2[i]; k < Ajmap2[i + 1]; k++) Aa[Aimap2[i]] += recvbuf[Aperm2[k]];
6829394ed5ebSJunchao Zhang   }
68302c4ab24aSJunchao Zhang   for (PetscCount i = 0; i < coo->Bnnz2; i++) {
6831394ed5ebSJunchao Zhang     for (PetscCount k = Bjmap2[i]; k < Bjmap2[i + 1]; k++) Ba[Bimap2[i]] += recvbuf[Bperm2[k]];
6832394ed5ebSJunchao Zhang   }
68339566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArray(A, &Aa));
68349566063dSJacob Faibussowitsch   PetscCall(MatSeqAIJRestoreArray(B, &Ba));
68353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6836394ed5ebSJunchao Zhang }
6837394ed5ebSJunchao Zhang 
6838ccd8e176SBarry Smith /*MC
6839ccd8e176SBarry Smith    MATMPIAIJ - MATMPIAIJ = "mpiaij" - A matrix type to be used for parallel sparse matrices.
6840ccd8e176SBarry Smith 
6841ccd8e176SBarry Smith    Options Database Keys:
684211a5261eSBarry Smith . -mat_type mpiaij - sets the matrix type to `MATMPIAIJ` during a call to `MatSetFromOptions()`
6843ccd8e176SBarry Smith 
6844ccd8e176SBarry Smith    Level: beginner
68450cd7f59aSBarry Smith 
68460cd7f59aSBarry Smith    Notes:
68472ef1f0ffSBarry Smith    `MatSetValues()` may be called for this matrix type with a `NULL` argument for the numerical values,
68480cd7f59aSBarry Smith     in this case the values associated with the rows and columns one passes in are set to zero
68490cd7f59aSBarry Smith     in the matrix
68500cd7f59aSBarry Smith 
685111a5261eSBarry Smith     `MatSetOptions`(,`MAT_STRUCTURE_ONLY`,`PETSC_TRUE`) may be called for this matrix type. In this no
685211a5261eSBarry Smith     space is allocated for the nonzero entries and any entries passed with `MatSetValues()` are ignored
6853ccd8e176SBarry Smith 
68541cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MATSEQAIJ`, `MATAIJ`, `MatCreateAIJ()`
6855ccd8e176SBarry Smith M*/
6856d71ae5a4SJacob Faibussowitsch PETSC_EXTERN PetscErrorCode MatCreate_MPIAIJ(Mat B)
6857d71ae5a4SJacob Faibussowitsch {
6858ccd8e176SBarry Smith   Mat_MPIAIJ *b;
6859ccd8e176SBarry Smith   PetscMPIInt size;
6860ccd8e176SBarry Smith 
6861ccd8e176SBarry Smith   PetscFunctionBegin;
68629566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(PetscObjectComm((PetscObject)B), &size));
68632205254eSKarl Rupp 
68644dfa11a4SJacob Faibussowitsch   PetscCall(PetscNew(&b));
6865ccd8e176SBarry Smith   B->data       = (void *)b;
6866aea10558SJacob Faibussowitsch   B->ops[0]     = MatOps_Values;
6867ccd8e176SBarry Smith   B->assembled  = PETSC_FALSE;
6868ccd8e176SBarry Smith   B->insertmode = NOT_SET_VALUES;
6869ccd8e176SBarry Smith   b->size       = size;
68702205254eSKarl Rupp 
68719566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)B), &b->rank));
6872ccd8e176SBarry Smith 
6873ccd8e176SBarry Smith   /* build cache for off array entries formed */
68749566063dSJacob Faibussowitsch   PetscCall(MatStashCreate_Private(PetscObjectComm((PetscObject)B), 1, &B->stash));
68752205254eSKarl Rupp 
6876ccd8e176SBarry Smith   b->donotstash  = PETSC_FALSE;
6877f4259b30SLisandro Dalcin   b->colmap      = NULL;
6878f4259b30SLisandro Dalcin   b->garray      = NULL;
6879ccd8e176SBarry Smith   b->roworiented = PETSC_TRUE;
6880ccd8e176SBarry Smith 
6881ccd8e176SBarry Smith   /* stuff used for matrix vector multiply */
68820298fd71SBarry Smith   b->lvec  = NULL;
68830298fd71SBarry Smith   b->Mvctx = NULL;
6884ccd8e176SBarry Smith 
6885ccd8e176SBarry Smith   /* stuff for MatGetRow() */
6886f4259b30SLisandro Dalcin   b->rowindices   = NULL;
6887f4259b30SLisandro Dalcin   b->rowvalues    = NULL;
6888ccd8e176SBarry Smith   b->getrowactive = PETSC_FALSE;
6889ccd8e176SBarry Smith 
6890f719121fSJed Brown   /* flexible pointer used in CUSPARSE classes */
68910298fd71SBarry Smith   b->spptr = NULL;
6892f60c3dc2SHong Zhang 
68939566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatMPIAIJSetUseScalableIncreaseOverlap_C", MatMPIAIJSetUseScalableIncreaseOverlap_MPIAIJ));
68949566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatStoreValues_C", MatStoreValues_MPIAIJ));
68959566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatRetrieveValues_C", MatRetrieveValues_MPIAIJ));
68969566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatIsTranspose_C", MatIsTranspose_MPIAIJ));
68979566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatMPIAIJSetPreallocation_C", MatMPIAIJSetPreallocation_MPIAIJ));
68989566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatResetPreallocation_C", MatResetPreallocation_MPIAIJ));
6899674b392bSAlexander   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatResetHash_C", MatResetHash_MPIAIJ));
69009566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatMPIAIJSetPreallocationCSR_C", MatMPIAIJSetPreallocationCSR_MPIAIJ));
69019566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatDiagonalScaleLocal_C", MatDiagonalScaleLocal_MPIAIJ));
69029566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijperm_C", MatConvert_MPIAIJ_MPIAIJPERM));
69039566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijsell_C", MatConvert_MPIAIJ_MPIAIJSELL));
69043d0639e7SStefano Zampini #if defined(PETSC_HAVE_CUDA)
69059566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijcusparse_C", MatConvert_MPIAIJ_MPIAIJCUSPARSE));
69063d0639e7SStefano Zampini #endif
6907d5e393b6SSuyash Tandon #if defined(PETSC_HAVE_HIP)
6908d5e393b6SSuyash Tandon   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijhipsparse_C", MatConvert_MPIAIJ_MPIAIJHIPSPARSE));
6909d5e393b6SSuyash Tandon #endif
69103d0639e7SStefano Zampini #if defined(PETSC_HAVE_KOKKOS_KERNELS)
69119566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijkokkos_C", MatConvert_MPIAIJ_MPIAIJKokkos));
69123d0639e7SStefano Zampini #endif
69139779e05dSSatish Balay #if defined(PETSC_HAVE_MKL_SPARSE)
69149566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijmkl_C", MatConvert_MPIAIJ_MPIAIJMKL));
6915191b95cbSRichard Tran Mills #endif
69169566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpiaijcrl_C", MatConvert_MPIAIJ_MPIAIJCRL));
69179566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpibaij_C", MatConvert_MPIAIJ_MPIBAIJ));
69189566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpisbaij_C", MatConvert_MPIAIJ_MPISBAIJ));
69199566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpidense_C", MatConvert_MPIAIJ_MPIDense));
69205d7652ecSHong Zhang #if defined(PETSC_HAVE_ELEMENTAL)
69219566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_elemental_C", MatConvert_MPIAIJ_Elemental));
69225d7652ecSHong Zhang #endif
6923d24d4204SJose E. Roman #if defined(PETSC_HAVE_SCALAPACK)
69249566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_scalapack_C", MatConvert_AIJ_ScaLAPACK));
6925d24d4204SJose E. Roman #endif
69269566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_is_C", MatConvert_XAIJ_IS));
69279566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_mpisell_C", MatConvert_MPIAIJ_MPISELL));
69283dad0653Sstefano_zampini #if defined(PETSC_HAVE_HYPRE)
69299566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatConvert_mpiaij_hypre_C", MatConvert_AIJ_HYPRE));
69309566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatProductSetFromOptions_transpose_mpiaij_mpiaij_C", MatProductSetFromOptions_Transpose_AIJ_AIJ));
69313dad0653Sstefano_zampini #endif
69329566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatProductSetFromOptions_is_mpiaij_C", MatProductSetFromOptions_IS_XAIJ));
69339566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatProductSetFromOptions_mpiaij_mpiaij_C", MatProductSetFromOptions_MPIAIJ));
69349566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatSetPreallocationCOO_C", MatSetPreallocationCOO_MPIAIJ));
69359566063dSJacob Faibussowitsch   PetscCall(PetscObjectComposeFunction((PetscObject)B, "MatSetValuesCOO_C", MatSetValuesCOO_MPIAIJ));
69369566063dSJacob Faibussowitsch   PetscCall(PetscObjectChangeTypeName((PetscObject)B, MATMPIAIJ));
69373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
6938ccd8e176SBarry Smith }
693981824310SBarry Smith 
69405d83a8b1SBarry Smith /*@
694111a5261eSBarry Smith   MatCreateMPIAIJWithSplitArrays - creates a `MATMPIAIJ` matrix using arrays that contain the "diagonal"
694203bfb495SBarry Smith   and "off-diagonal" part of the matrix in CSR format.
694303bfb495SBarry Smith 
6944d083f849SBarry Smith   Collective
694503bfb495SBarry Smith 
694603bfb495SBarry Smith   Input Parameters:
694703bfb495SBarry Smith + comm - MPI communicator
694811a5261eSBarry Smith . m    - number of local rows (Cannot be `PETSC_DECIDE`)
694903bfb495SBarry Smith . n    - This value should be the same as the local size used in creating the
6950d8a51d2aSBarry Smith          x vector for the matrix-vector product $y = Ax$. (or `PETSC_DECIDE` to have
69512ef1f0ffSBarry Smith          calculated if `N` is given) For square matrices `n` is almost always `m`.
69522ef1f0ffSBarry Smith . M    - number of global rows (or `PETSC_DETERMINE` to have calculated if `m` is given)
69532ef1f0ffSBarry Smith . N    - number of global columns (or `PETSC_DETERMINE` to have calculated if `n` is given)
6954483a2f95SBarry Smith . i    - row indices for "diagonal" portion of matrix; that is i[0] = 0, i[row] = i[row-1] + number of elements in that row of the matrix
695504ccdda3SJunchao Zhang . j    - column indices, which must be local, i.e., based off the start column of the diagonal portion
695603bfb495SBarry Smith . a    - matrix values
6957483a2f95SBarry Smith . oi   - row indices for "off-diagonal" portion of matrix; that is oi[0] = 0, oi[row] = oi[row-1] + number of elements in that row of the matrix
69582ef1f0ffSBarry Smith . oj   - column indices, which must be global, representing global columns in the `MATMPIAIJ` matrix
695903bfb495SBarry Smith - oa   - matrix values
696003bfb495SBarry Smith 
696103bfb495SBarry Smith   Output Parameter:
696203bfb495SBarry Smith . mat - the matrix
696303bfb495SBarry Smith 
696403bfb495SBarry Smith   Level: advanced
696503bfb495SBarry Smith 
696603bfb495SBarry Smith   Notes:
6967f13dfd9eSBarry Smith   The `i`, `j`, and `a` arrays ARE NOT copied by this routine into the internal format used by PETSc (even in Fortran). The user
6968292fb18eSBarry Smith   must free the arrays once the matrix has been destroyed and not before.
696903bfb495SBarry Smith 
69702ef1f0ffSBarry Smith   The `i` and `j` indices are 0 based
697103bfb495SBarry Smith 
69722ef1f0ffSBarry Smith   See `MatCreateAIJ()` for the definition of "diagonal" and "off-diagonal" portion of the matrix
697303bfb495SBarry Smith 
69747b55108eSBarry Smith   This sets local rows and cannot be used to set off-processor values.
69757b55108eSBarry Smith 
6976dca341c0SJed Brown   Use of this routine is discouraged because it is inflexible and cumbersome to use. It is extremely rare that a
6977dca341c0SJed Brown   legacy application natively assembles into exactly this split format. The code to do so is nontrivial and does
6978dca341c0SJed Brown   not easily support in-place reassembly. It is recommended to use MatSetValues() (or a variant thereof) because
6979dca341c0SJed Brown   the resulting assembly is easier to implement, will work with any matrix format, and the user does not have to
698011a5261eSBarry Smith   keep track of the underlying array. Use `MatSetOption`(A,`MAT_NO_OFF_PROC_ENTRIES`,`PETSC_TRUE`) to disable all
6981dca341c0SJed Brown   communication if it is known that only local entries will be set.
698203bfb495SBarry Smith 
69831cc06b55SBarry Smith .seealso: [](ch_matrices), `Mat`, `MatCreate()`, `MatCreateSeqAIJ()`, `MatSetValues()`, `MatMPIAIJSetPreallocation()`, `MatMPIAIJSetPreallocationCSR()`,
6984db781477SPatrick Sanan           `MATMPIAIJ`, `MatCreateAIJ()`, `MatCreateMPIAIJWithArrays()`
69852b26979fSBarry Smith @*/
6986d71ae5a4SJacob Faibussowitsch PetscErrorCode MatCreateMPIAIJWithSplitArrays(MPI_Comm comm, PetscInt m, PetscInt n, PetscInt M, PetscInt N, PetscInt i[], PetscInt j[], PetscScalar a[], PetscInt oi[], PetscInt oj[], PetscScalar oa[], Mat *mat)
6987d71ae5a4SJacob Faibussowitsch {
698803bfb495SBarry Smith   Mat_MPIAIJ *maij;
698903bfb495SBarry Smith 
699003bfb495SBarry Smith   PetscFunctionBegin;
699108401ef6SPierre Jolivet   PetscCheck(m >= 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "local number of rows (m) cannot be PETSC_DECIDE, or negative");
6992aed4548fSBarry Smith   PetscCheck(i[0] == 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "i (row indices) must start with 0");
6993aed4548fSBarry Smith   PetscCheck(oi[0] == 0, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "oi (row indices) must start with 0");
69949566063dSJacob Faibussowitsch   PetscCall(MatCreate(comm, mat));
69959566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(*mat, m, n, M, N));
69969566063dSJacob Faibussowitsch   PetscCall(MatSetType(*mat, MATMPIAIJ));
699703bfb495SBarry Smith   maij = (Mat_MPIAIJ *)(*mat)->data;
69982205254eSKarl Rupp 
69998d7a6e47SBarry Smith   (*mat)->preallocated = PETSC_TRUE;
700003bfb495SBarry Smith 
70019566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp((*mat)->rmap));
70029566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp((*mat)->cmap));
700303bfb495SBarry Smith 
70049566063dSJacob Faibussowitsch   PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, m, n, i, j, a, &maij->A));
70059566063dSJacob Faibussowitsch   PetscCall(MatCreateSeqAIJWithArrays(PETSC_COMM_SELF, m, (*mat)->cmap->N, oi, oj, oa, &maij->B));
700603bfb495SBarry Smith 
70079566063dSJacob Faibussowitsch   PetscCall(MatSetOption(*mat, MAT_NO_OFF_PROC_ENTRIES, PETSC_TRUE));
70089566063dSJacob Faibussowitsch   PetscCall(MatAssemblyBegin(*mat, MAT_FINAL_ASSEMBLY));
70099566063dSJacob Faibussowitsch   PetscCall(MatAssemblyEnd(*mat, MAT_FINAL_ASSEMBLY));
70109566063dSJacob Faibussowitsch   PetscCall(MatSetOption(*mat, MAT_NO_OFF_PROC_ENTRIES, PETSC_FALSE));
70119566063dSJacob Faibussowitsch   PetscCall(MatSetOption(*mat, MAT_NEW_NONZERO_LOCATION_ERR, PETSC_TRUE));
70123ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
701303bfb495SBarry Smith }
701403bfb495SBarry Smith 
70154e84afc0SStefano Zampini typedef struct {
70164e84afc0SStefano Zampini   Mat       *mp;    /* intermediate products */
70174e84afc0SStefano Zampini   PetscBool *mptmp; /* is the intermediate product temporary ? */
70184e84afc0SStefano Zampini   PetscInt   cp;    /* number of intermediate products */
70194e84afc0SStefano Zampini 
70204e84afc0SStefano Zampini   /* support for MatGetBrowsOfAoCols_MPIAIJ for P_oth */
70214e84afc0SStefano Zampini   PetscInt    *startsj_s, *startsj_r;
70224e84afc0SStefano Zampini   PetscScalar *bufa;
70234e84afc0SStefano Zampini   Mat          P_oth;
70244e84afc0SStefano Zampini 
70254e84afc0SStefano Zampini   /* may take advantage of merging product->B */
7026ddea5d60SJunchao Zhang   Mat Bloc; /* B-local by merging diag and off-diag */
70274e84afc0SStefano Zampini 
7028ddea5d60SJunchao Zhang   /* cusparse does not have support to split between symbolic and numeric phases.
70294e84afc0SStefano Zampini      When api_user is true, we don't need to update the numerical values
70304e84afc0SStefano Zampini      of the temporary storage */
70314e84afc0SStefano Zampini   PetscBool reusesym;
70324e84afc0SStefano Zampini 
70334e84afc0SStefano Zampini   /* support for COO values insertion */
7034ddea5d60SJunchao Zhang   PetscScalar *coo_v, *coo_w; /* store on-process and off-process COO scalars, and used as MPI recv/send buffers respectively */
7035ddea5d60SJunchao Zhang   PetscInt   **own;           /* own[i] points to address of on-process COO indices for Mat mp[i] */
7036ddea5d60SJunchao Zhang   PetscInt   **off;           /* off[i] points to address of off-process COO indices for Mat mp[i] */
7037ddea5d60SJunchao Zhang   PetscBool    hasoffproc;    /* if true, have off-process values insertion (i.e. AtB or PtAP) */
7038c215019aSStefano Zampini   PetscSF      sf;            /* used for non-local values insertion and memory malloc */
7039c215019aSStefano Zampini   PetscMemType mtype;
70404e84afc0SStefano Zampini 
70414e84afc0SStefano Zampini   /* customization */
70424e84afc0SStefano Zampini   PetscBool abmerge;
7043abb89eb1SStefano Zampini   PetscBool P_oth_bind;
70444e84afc0SStefano Zampini } MatMatMPIAIJBACKEND;
70454e84afc0SStefano Zampini 
7046ba38deedSJacob Faibussowitsch static PetscErrorCode MatDestroy_MatMatMPIAIJBACKEND(void *data)
7047d71ae5a4SJacob Faibussowitsch {
70484e84afc0SStefano Zampini   MatMatMPIAIJBACKEND *mmdata = (MatMatMPIAIJBACKEND *)data;
70494e84afc0SStefano Zampini   PetscInt             i;
70504e84afc0SStefano Zampini 
70514e84afc0SStefano Zampini   PetscFunctionBegin;
70529566063dSJacob Faibussowitsch   PetscCall(PetscFree2(mmdata->startsj_s, mmdata->startsj_r));
70539566063dSJacob Faibussowitsch   PetscCall(PetscFree(mmdata->bufa));
70549566063dSJacob Faibussowitsch   PetscCall(PetscSFFree(mmdata->sf, mmdata->mtype, mmdata->coo_v));
70559566063dSJacob Faibussowitsch   PetscCall(PetscSFFree(mmdata->sf, mmdata->mtype, mmdata->coo_w));
70569566063dSJacob Faibussowitsch   PetscCall(MatDestroy(&mmdata->P_oth));
70579566063dSJacob Faibussowitsch   PetscCall(MatDestroy(&mmdata->Bloc));
70589566063dSJacob Faibussowitsch   PetscCall(PetscSFDestroy(&mmdata->sf));
705948a46eb9SPierre Jolivet   for (i = 0; i < mmdata->cp; i++) PetscCall(MatDestroy(&mmdata->mp[i]));
70609566063dSJacob Faibussowitsch   PetscCall(PetscFree2(mmdata->mp, mmdata->mptmp));
70619566063dSJacob Faibussowitsch   PetscCall(PetscFree(mmdata->own[0]));
70629566063dSJacob Faibussowitsch   PetscCall(PetscFree(mmdata->own));
70639566063dSJacob Faibussowitsch   PetscCall(PetscFree(mmdata->off[0]));
70649566063dSJacob Faibussowitsch   PetscCall(PetscFree(mmdata->off));
70659566063dSJacob Faibussowitsch   PetscCall(PetscFree(mmdata));
70663ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
70674e84afc0SStefano Zampini }
70684e84afc0SStefano Zampini 
7069fff043a9SJunchao Zhang /* Copy selected n entries with indices in idx[] of A to v[].
7070fff043a9SJunchao Zhang    If idx is NULL, copy the whole data array of A to v[]
7071fff043a9SJunchao Zhang  */
7072d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatSeqAIJCopySubArray(Mat A, PetscInt n, const PetscInt idx[], PetscScalar v[])
7073d71ae5a4SJacob Faibussowitsch {
7074c215019aSStefano Zampini   PetscErrorCode (*f)(Mat, PetscInt, const PetscInt[], PetscScalar[]);
7075c215019aSStefano Zampini 
7076c215019aSStefano Zampini   PetscFunctionBegin;
70779566063dSJacob Faibussowitsch   PetscCall(PetscObjectQueryFunction((PetscObject)A, "MatSeqAIJCopySubArray_C", &f));
7078c215019aSStefano Zampini   if (f) {
70799566063dSJacob Faibussowitsch     PetscCall((*f)(A, n, idx, v));
7080c215019aSStefano Zampini   } else {
7081c215019aSStefano Zampini     const PetscScalar *vv;
7082c215019aSStefano Zampini 
70839566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArrayRead(A, &vv));
7084c215019aSStefano Zampini     if (n && idx) {
7085c215019aSStefano Zampini       PetscScalar    *w  = v;
7086c215019aSStefano Zampini       const PetscInt *oi = idx;
7087c215019aSStefano Zampini       PetscInt        j;
7088c215019aSStefano Zampini 
7089c215019aSStefano Zampini       for (j = 0; j < n; j++) *w++ = vv[*oi++];
7090c215019aSStefano Zampini     } else {
70919566063dSJacob Faibussowitsch       PetscCall(PetscArraycpy(v, vv, n));
7092c215019aSStefano Zampini     }
70939566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArrayRead(A, &vv));
7094c215019aSStefano Zampini   }
70953ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
7096c215019aSStefano Zampini }
7097c215019aSStefano Zampini 
7098d71ae5a4SJacob Faibussowitsch static PetscErrorCode MatProductNumeric_MPIAIJBACKEND(Mat C)
7099d71ae5a4SJacob Faibussowitsch {
71004e84afc0SStefano Zampini   MatMatMPIAIJBACKEND *mmdata;
71014e84afc0SStefano Zampini   PetscInt             i, n_d, n_o;
71024e84afc0SStefano Zampini 
71034e84afc0SStefano Zampini   PetscFunctionBegin;
71044e84afc0SStefano Zampini   MatCheckProduct(C, 1);
710528b400f6SJacob Faibussowitsch   PetscCheck(C->product->data, PetscObjectComm((PetscObject)C), PETSC_ERR_PLIB, "Product data empty");
71064e84afc0SStefano Zampini   mmdata = (MatMatMPIAIJBACKEND *)C->product->data;
71074e84afc0SStefano Zampini   if (!mmdata->reusesym) { /* update temporary matrices */
710848a46eb9SPierre Jolivet     if (mmdata->P_oth) PetscCall(MatGetBrowsOfAoCols_MPIAIJ(C->product->A, C->product->B, MAT_REUSE_MATRIX, &mmdata->startsj_s, &mmdata->startsj_r, &mmdata->bufa, &mmdata->P_oth));
710948a46eb9SPierre Jolivet     if (mmdata->Bloc) PetscCall(MatMPIAIJGetLocalMatMerge(C->product->B, MAT_REUSE_MATRIX, NULL, &mmdata->Bloc));
71104e84afc0SStefano Zampini   }
71114e84afc0SStefano Zampini   mmdata->reusesym = PETSC_FALSE;
7112abb89eb1SStefano Zampini 
7113abb89eb1SStefano Zampini   for (i = 0; i < mmdata->cp; i++) {
711408401ef6SPierre Jolivet     PetscCheck(mmdata->mp[i]->ops->productnumeric, PetscObjectComm((PetscObject)mmdata->mp[i]), PETSC_ERR_PLIB, "Missing numeric op for %s", MatProductTypes[mmdata->mp[i]->product->type]);
71159566063dSJacob Faibussowitsch     PetscCall((*mmdata->mp[i]->ops->productnumeric)(mmdata->mp[i]));
7116abb89eb1SStefano Zampini   }
71174e84afc0SStefano Zampini   for (i = 0, n_d = 0, n_o = 0; i < mmdata->cp; i++) {
71186497c311SBarry Smith     PetscInt noff;
71194e84afc0SStefano Zampini 
71206497c311SBarry Smith     PetscCall(PetscIntCast(mmdata->off[i + 1] - mmdata->off[i], &noff));
71214e84afc0SStefano Zampini     if (mmdata->mptmp[i]) continue;
71224e84afc0SStefano Zampini     if (noff) {
71236497c311SBarry Smith       PetscInt nown;
7124c215019aSStefano Zampini 
71256497c311SBarry Smith       PetscCall(PetscIntCast(mmdata->own[i + 1] - mmdata->own[i], &nown));
71269566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJCopySubArray(mmdata->mp[i], noff, mmdata->off[i], mmdata->coo_w + n_o));
71279566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJCopySubArray(mmdata->mp[i], nown, mmdata->own[i], mmdata->coo_v + n_d));
71284e84afc0SStefano Zampini       n_o += noff;
71294e84afc0SStefano Zampini       n_d += nown;
71304e84afc0SStefano Zampini     } else {
7131c215019aSStefano Zampini       Mat_SeqAIJ *mm = (Mat_SeqAIJ *)mmdata->mp[i]->data;
7132c215019aSStefano Zampini 
71339566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJCopySubArray(mmdata->mp[i], mm->nz, NULL, mmdata->coo_v + n_d));
71344e84afc0SStefano Zampini       n_d += mm->nz;
71354e84afc0SStefano Zampini     }
71364e84afc0SStefano Zampini   }
7137c215019aSStefano Zampini   if (mmdata->hasoffproc) { /* offprocess insertion */
71389566063dSJacob Faibussowitsch     PetscCall(PetscSFGatherBegin(mmdata->sf, MPIU_SCALAR, mmdata->coo_w, mmdata->coo_v + n_d));
71399566063dSJacob Faibussowitsch     PetscCall(PetscSFGatherEnd(mmdata->sf, MPIU_SCALAR, mmdata->coo_w, mmdata->coo_v + n_d));
71404e84afc0SStefano Zampini   }
71419566063dSJacob Faibussowitsch   PetscCall(MatSetValuesCOO(C, mmdata->coo_v, INSERT_VALUES));
71423ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
71434e84afc0SStefano Zampini }
71444e84afc0SStefano Zampini 
71454e84afc0SStefano Zampini /* Support for Pt * A, A * P, or Pt * A * P */
71464e84afc0SStefano Zampini #define MAX_NUMBER_INTERMEDIATE 4
7147d71ae5a4SJacob Faibussowitsch PetscErrorCode MatProductSymbolic_MPIAIJBACKEND(Mat C)
7148d71ae5a4SJacob Faibussowitsch {
71494e84afc0SStefano Zampini   Mat_Product           *product = C->product;
7150ddea5d60SJunchao Zhang   Mat                    A, P, mp[MAX_NUMBER_INTERMEDIATE]; /* A, P and a series of intermediate matrices */
71514e84afc0SStefano Zampini   Mat_MPIAIJ            *a, *p;
71524e84afc0SStefano Zampini   MatMatMPIAIJBACKEND   *mmdata;
71534e84afc0SStefano Zampini   ISLocalToGlobalMapping P_oth_l2g = NULL;
71544e84afc0SStefano Zampini   IS                     glob      = NULL;
71554e84afc0SStefano Zampini   const char            *prefix;
71564e84afc0SStefano Zampini   char                   pprefix[256];
71574e84afc0SStefano Zampini   const PetscInt        *globidx, *P_oth_idx;
715882a78a4eSJed Brown   PetscInt               i, j, cp, m, n, M, N, *coo_i, *coo_j;
715982a78a4eSJed Brown   PetscCount             ncoo, ncoo_d, ncoo_o, ncoo_oown;
7160ddea5d60SJunchao Zhang   PetscInt               cmapt[MAX_NUMBER_INTERMEDIATE], rmapt[MAX_NUMBER_INTERMEDIATE]; /* col/row map type for each Mat in mp[]. */
7161ddea5d60SJunchao Zhang                                                                                          /* type-0: consecutive, start from 0; type-1: consecutive with */
7162ddea5d60SJunchao Zhang                                                                                          /* a base offset; type-2: sparse with a local to global map table */
7163ddea5d60SJunchao Zhang   const PetscInt *cmapa[MAX_NUMBER_INTERMEDIATE], *rmapa[MAX_NUMBER_INTERMEDIATE];       /* col/row local to global map array (table) for type-2 map type */
7164ddea5d60SJunchao Zhang 
71654e84afc0SStefano Zampini   MatProductType ptype;
7166d5e393b6SSuyash Tandon   PetscBool      mptmp[MAX_NUMBER_INTERMEDIATE], hasoffproc = PETSC_FALSE, iscuda, iship, iskokk;
71674e84afc0SStefano Zampini   PetscMPIInt    size;
71684e84afc0SStefano Zampini 
71694e84afc0SStefano Zampini   PetscFunctionBegin;
71704e84afc0SStefano Zampini   MatCheckProduct(C, 1);
717128b400f6SJacob Faibussowitsch   PetscCheck(!product->data, PetscObjectComm((PetscObject)C), PETSC_ERR_PLIB, "Product data not empty");
71724e84afc0SStefano Zampini   ptype = product->type;
7173b94d7dedSBarry Smith   if (product->A->symmetric == PETSC_BOOL3_TRUE && ptype == MATPRODUCT_AtB) {
7174fa046f9fSJunchao Zhang     ptype                                          = MATPRODUCT_AB;
7175fa046f9fSJunchao Zhang     product->symbolic_used_the_fact_A_is_symmetric = PETSC_TRUE;
7176fa046f9fSJunchao Zhang   }
71774e84afc0SStefano Zampini   switch (ptype) {
71784e84afc0SStefano Zampini   case MATPRODUCT_AB:
71794e84afc0SStefano Zampini     A          = product->A;
71804e84afc0SStefano Zampini     P          = product->B;
71814e84afc0SStefano Zampini     m          = A->rmap->n;
71824e84afc0SStefano Zampini     n          = P->cmap->n;
71834e84afc0SStefano Zampini     M          = A->rmap->N;
71844e84afc0SStefano Zampini     N          = P->cmap->N;
7185ddea5d60SJunchao Zhang     hasoffproc = PETSC_FALSE; /* will not scatter mat product values to other processes */
71864e84afc0SStefano Zampini     break;
71874e84afc0SStefano Zampini   case MATPRODUCT_AtB:
71884e84afc0SStefano Zampini     P          = product->A;
71894e84afc0SStefano Zampini     A          = product->B;
71904e84afc0SStefano Zampini     m          = P->cmap->n;
71914e84afc0SStefano Zampini     n          = A->cmap->n;
71924e84afc0SStefano Zampini     M          = P->cmap->N;
71934e84afc0SStefano Zampini     N          = A->cmap->N;
71944e84afc0SStefano Zampini     hasoffproc = PETSC_TRUE;
71954e84afc0SStefano Zampini     break;
71964e84afc0SStefano Zampini   case MATPRODUCT_PtAP:
71974e84afc0SStefano Zampini     A          = product->A;
71984e84afc0SStefano Zampini     P          = product->B;
71994e84afc0SStefano Zampini     m          = P->cmap->n;
72004e84afc0SStefano Zampini     n          = P->cmap->n;
72014e84afc0SStefano Zampini     M          = P->cmap->N;
72024e84afc0SStefano Zampini     N          = P->cmap->N;
72034e84afc0SStefano Zampini     hasoffproc = PETSC_TRUE;
72044e84afc0SStefano Zampini     break;
7205d71ae5a4SJacob Faibussowitsch   default:
7206d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)C), PETSC_ERR_PLIB, "Not for product type %s", MatProductTypes[ptype]);
72074e84afc0SStefano Zampini   }
72089566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_size(PetscObjectComm((PetscObject)C), &size));
72094e84afc0SStefano Zampini   if (size == 1) hasoffproc = PETSC_FALSE;
72104e84afc0SStefano Zampini 
72114e84afc0SStefano Zampini   /* defaults */
72124e84afc0SStefano Zampini   for (i = 0; i < MAX_NUMBER_INTERMEDIATE; i++) {
72134e84afc0SStefano Zampini     mp[i]    = NULL;
72144e84afc0SStefano Zampini     mptmp[i] = PETSC_FALSE;
72154e84afc0SStefano Zampini     rmapt[i] = -1;
72164e84afc0SStefano Zampini     cmapt[i] = -1;
72174e84afc0SStefano Zampini     rmapa[i] = NULL;
72184e84afc0SStefano Zampini     cmapa[i] = NULL;
72194e84afc0SStefano Zampini   }
72204e84afc0SStefano Zampini 
72214e84afc0SStefano Zampini   /* customization */
72229566063dSJacob Faibussowitsch   PetscCall(PetscNew(&mmdata));
72234e84afc0SStefano Zampini   mmdata->reusesym = product->api_user;
72244e84afc0SStefano Zampini   if (ptype == MATPRODUCT_AB) {
72254e84afc0SStefano Zampini     if (product->api_user) {
7226d0609cedSBarry Smith       PetscOptionsBegin(PetscObjectComm((PetscObject)C), ((PetscObject)C)->prefix, "MatMatMult", "Mat");
72279566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-matmatmult_backend_mergeB", "Merge product->B local matrices", "MatMatMult", mmdata->abmerge, &mmdata->abmerge, NULL));
72289566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-matmatmult_backend_pothbind", "Bind P_oth to CPU", "MatBindToCPU", mmdata->P_oth_bind, &mmdata->P_oth_bind, NULL));
7229d0609cedSBarry Smith       PetscOptionsEnd();
72304e84afc0SStefano Zampini     } else {
7231d0609cedSBarry Smith       PetscOptionsBegin(PetscObjectComm((PetscObject)C), ((PetscObject)C)->prefix, "MatProduct_AB", "Mat");
72329566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-mat_product_algorithm_backend_mergeB", "Merge product->B local matrices", "MatMatMult", mmdata->abmerge, &mmdata->abmerge, NULL));
72339566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-mat_product_algorithm_backend_pothbind", "Bind P_oth to CPU", "MatBindToCPU", mmdata->P_oth_bind, &mmdata->P_oth_bind, NULL));
7234d0609cedSBarry Smith       PetscOptionsEnd();
7235abb89eb1SStefano Zampini     }
7236abb89eb1SStefano Zampini   } else if (ptype == MATPRODUCT_PtAP) {
7237abb89eb1SStefano Zampini     if (product->api_user) {
7238d0609cedSBarry Smith       PetscOptionsBegin(PetscObjectComm((PetscObject)C), ((PetscObject)C)->prefix, "MatPtAP", "Mat");
72399566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-matptap_backend_pothbind", "Bind P_oth to CPU", "MatBindToCPU", mmdata->P_oth_bind, &mmdata->P_oth_bind, NULL));
7240d0609cedSBarry Smith       PetscOptionsEnd();
7241abb89eb1SStefano Zampini     } else {
7242d0609cedSBarry Smith       PetscOptionsBegin(PetscObjectComm((PetscObject)C), ((PetscObject)C)->prefix, "MatProduct_PtAP", "Mat");
72439566063dSJacob Faibussowitsch       PetscCall(PetscOptionsBool("-mat_product_algorithm_backend_pothbind", "Bind P_oth to CPU", "MatBindToCPU", mmdata->P_oth_bind, &mmdata->P_oth_bind, NULL));
7244d0609cedSBarry Smith       PetscOptionsEnd();
72454e84afc0SStefano Zampini     }
72464e84afc0SStefano Zampini   }
72474e84afc0SStefano Zampini   a = (Mat_MPIAIJ *)A->data;
72484e84afc0SStefano Zampini   p = (Mat_MPIAIJ *)P->data;
72499566063dSJacob Faibussowitsch   PetscCall(MatSetSizes(C, m, n, M, N));
72509566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(C->rmap));
72519566063dSJacob Faibussowitsch   PetscCall(PetscLayoutSetUp(C->cmap));
72529566063dSJacob Faibussowitsch   PetscCall(MatSetType(C, ((PetscObject)A)->type_name));
72539566063dSJacob Faibussowitsch   PetscCall(MatGetOptionsPrefix(C, &prefix));
7254ddea5d60SJunchao Zhang 
7255ddea5d60SJunchao Zhang   cp = 0;
72564e84afc0SStefano Zampini   switch (ptype) {
72574e84afc0SStefano Zampini   case MATPRODUCT_AB: /* A * P */
72589566063dSJacob Faibussowitsch     PetscCall(MatGetBrowsOfAoCols_MPIAIJ(A, P, MAT_INITIAL_MATRIX, &mmdata->startsj_s, &mmdata->startsj_r, &mmdata->bufa, &mmdata->P_oth));
72594e84afc0SStefano Zampini 
7260ddea5d60SJunchao Zhang     /* A_diag * P_local (merged or not) */
7261ddea5d60SJunchao Zhang     if (mmdata->abmerge) { /* P's diagonal and off-diag blocks are merged to one matrix, then multiplied by A_diag */
72624e84afc0SStefano Zampini       /* P is product->B */
72639566063dSJacob Faibussowitsch       PetscCall(MatMPIAIJGetLocalMatMerge(P, MAT_INITIAL_MATRIX, &glob, &mmdata->Bloc));
72649566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(a->A, mmdata->Bloc, NULL, &mp[cp]));
72659566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AB));
72669566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
72679566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
72689566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
72699566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
72704e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
72719566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
72729566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
72739566063dSJacob Faibussowitsch       PetscCall(ISGetIndices(glob, &globidx));
72744e84afc0SStefano Zampini       rmapt[cp] = 1;
72754e84afc0SStefano Zampini       cmapt[cp] = 2;
72764e84afc0SStefano Zampini       cmapa[cp] = globidx;
72774e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
72784e84afc0SStefano Zampini       cp++;
7279ddea5d60SJunchao Zhang     } else { /* A_diag * P_diag and A_diag * P_off */
72809566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(a->A, p->A, NULL, &mp[cp]));
72819566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AB));
72829566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
72839566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
72849566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
72859566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
72864e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
72879566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
72889566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
72894e84afc0SStefano Zampini       rmapt[cp] = 1;
72904e84afc0SStefano Zampini       cmapt[cp] = 1;
72914e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
72924e84afc0SStefano Zampini       cp++;
72939566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(a->A, p->B, NULL, &mp[cp]));
72949566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AB));
72959566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
72969566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
72979566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
72989566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
72994e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
73009566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
73019566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
73024e84afc0SStefano Zampini       rmapt[cp] = 1;
73034e84afc0SStefano Zampini       cmapt[cp] = 2;
73044e84afc0SStefano Zampini       cmapa[cp] = p->garray;
73054e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
73064e84afc0SStefano Zampini       cp++;
73074e84afc0SStefano Zampini     }
7308ddea5d60SJunchao Zhang 
7309ddea5d60SJunchao Zhang     /* A_off * P_other */
73104e84afc0SStefano Zampini     if (mmdata->P_oth) {
73119566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJCompactOutExtraColumns_SeqAIJ(mmdata->P_oth, &P_oth_l2g)); /* make P_oth use local col ids */
73129566063dSJacob Faibussowitsch       PetscCall(ISLocalToGlobalMappingGetIndices(P_oth_l2g, &P_oth_idx));
7313f4f49eeaSPierre Jolivet       PetscCall(MatSetType(mmdata->P_oth, ((PetscObject)a->B)->type_name));
73149566063dSJacob Faibussowitsch       PetscCall(MatBindToCPU(mmdata->P_oth, mmdata->P_oth_bind));
73159566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(a->B, mmdata->P_oth, NULL, &mp[cp]));
73169566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AB));
73179566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
73189566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
73199566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
73209566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
73214e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
73229566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
73239566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
73244e84afc0SStefano Zampini       rmapt[cp] = 1;
73254e84afc0SStefano Zampini       cmapt[cp] = 2;
73264e84afc0SStefano Zampini       cmapa[cp] = P_oth_idx;
73274e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
73284e84afc0SStefano Zampini       cp++;
73294e84afc0SStefano Zampini     }
73304e84afc0SStefano Zampini     break;
7331ddea5d60SJunchao Zhang 
73324e84afc0SStefano Zampini   case MATPRODUCT_AtB: /* (P^t * A): P_diag * A_loc + P_off * A_loc */
73334e84afc0SStefano Zampini     /* A is product->B */
73349566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJGetLocalMatMerge(A, MAT_INITIAL_MATRIX, &glob, &mmdata->Bloc));
7335ddea5d60SJunchao Zhang     if (A == P) { /* when A==P, we can take advantage of the already merged mmdata->Bloc */
73369566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(mmdata->Bloc, mmdata->Bloc, NULL, &mp[cp]));
73379566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AtB));
73389566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
73399566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
73409566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
73419566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
73424e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
73439566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
73449566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
73459566063dSJacob Faibussowitsch       PetscCall(ISGetIndices(glob, &globidx));
73464e84afc0SStefano Zampini       rmapt[cp] = 2;
73474e84afc0SStefano Zampini       rmapa[cp] = globidx;
73484e84afc0SStefano Zampini       cmapt[cp] = 2;
73494e84afc0SStefano Zampini       cmapa[cp] = globidx;
73504e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
73514e84afc0SStefano Zampini       cp++;
73524e84afc0SStefano Zampini     } else {
73539566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(p->A, mmdata->Bloc, NULL, &mp[cp]));
73549566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AtB));
73559566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
73569566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
73579566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
73589566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
73594e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
73609566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
73619566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
73629566063dSJacob Faibussowitsch       PetscCall(ISGetIndices(glob, &globidx));
73634e84afc0SStefano Zampini       rmapt[cp] = 1;
73644e84afc0SStefano Zampini       cmapt[cp] = 2;
73654e84afc0SStefano Zampini       cmapa[cp] = globidx;
73664e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
73674e84afc0SStefano Zampini       cp++;
73689566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(p->B, mmdata->Bloc, NULL, &mp[cp]));
73699566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AtB));
73709566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
73719566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
73729566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
73739566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
73744e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
73759566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
73769566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
73774e84afc0SStefano Zampini       rmapt[cp] = 2;
73784e84afc0SStefano Zampini       rmapa[cp] = p->garray;
73794e84afc0SStefano Zampini       cmapt[cp] = 2;
73804e84afc0SStefano Zampini       cmapa[cp] = globidx;
73814e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
73824e84afc0SStefano Zampini       cp++;
73834e84afc0SStefano Zampini     }
73844e84afc0SStefano Zampini     break;
73854e84afc0SStefano Zampini   case MATPRODUCT_PtAP:
73869566063dSJacob Faibussowitsch     PetscCall(MatGetBrowsOfAoCols_MPIAIJ(A, P, MAT_INITIAL_MATRIX, &mmdata->startsj_s, &mmdata->startsj_r, &mmdata->bufa, &mmdata->P_oth));
73874e84afc0SStefano Zampini     /* P is product->B */
73889566063dSJacob Faibussowitsch     PetscCall(MatMPIAIJGetLocalMatMerge(P, MAT_INITIAL_MATRIX, &glob, &mmdata->Bloc));
73899566063dSJacob Faibussowitsch     PetscCall(MatProductCreate(a->A, mmdata->Bloc, NULL, &mp[cp]));
73909566063dSJacob Faibussowitsch     PetscCall(MatProductSetType(mp[cp], MATPRODUCT_PtAP));
73919566063dSJacob Faibussowitsch     PetscCall(MatProductSetFill(mp[cp], product->fill));
73929566063dSJacob Faibussowitsch     PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
73939566063dSJacob Faibussowitsch     PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
73949566063dSJacob Faibussowitsch     PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
73954e84afc0SStefano Zampini     mp[cp]->product->api_user = product->api_user;
73969566063dSJacob Faibussowitsch     PetscCall(MatProductSetFromOptions(mp[cp]));
73979566063dSJacob Faibussowitsch     PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
73989566063dSJacob Faibussowitsch     PetscCall(ISGetIndices(glob, &globidx));
73994e84afc0SStefano Zampini     rmapt[cp] = 2;
74004e84afc0SStefano Zampini     rmapa[cp] = globidx;
74014e84afc0SStefano Zampini     cmapt[cp] = 2;
74024e84afc0SStefano Zampini     cmapa[cp] = globidx;
74034e84afc0SStefano Zampini     mptmp[cp] = PETSC_FALSE;
74044e84afc0SStefano Zampini     cp++;
74054e84afc0SStefano Zampini     if (mmdata->P_oth) {
74069566063dSJacob Faibussowitsch       PetscCall(MatSeqAIJCompactOutExtraColumns_SeqAIJ(mmdata->P_oth, &P_oth_l2g));
74079566063dSJacob Faibussowitsch       PetscCall(ISLocalToGlobalMappingGetIndices(P_oth_l2g, &P_oth_idx));
7408f4f49eeaSPierre Jolivet       PetscCall(MatSetType(mmdata->P_oth, ((PetscObject)a->B)->type_name));
74099566063dSJacob Faibussowitsch       PetscCall(MatBindToCPU(mmdata->P_oth, mmdata->P_oth_bind));
74109566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(a->B, mmdata->P_oth, NULL, &mp[cp]));
74119566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AB));
74129566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
74139566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
74149566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
74159566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
74164e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
74179566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
74189566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
74194e84afc0SStefano Zampini       mptmp[cp] = PETSC_TRUE;
74204e84afc0SStefano Zampini       cp++;
74219566063dSJacob Faibussowitsch       PetscCall(MatProductCreate(mmdata->Bloc, mp[1], NULL, &mp[cp]));
74229566063dSJacob Faibussowitsch       PetscCall(MatProductSetType(mp[cp], MATPRODUCT_AtB));
74239566063dSJacob Faibussowitsch       PetscCall(MatProductSetFill(mp[cp], product->fill));
74249566063dSJacob Faibussowitsch       PetscCall(PetscSNPrintf(pprefix, sizeof(pprefix), "backend_p%" PetscInt_FMT "_", cp));
74259566063dSJacob Faibussowitsch       PetscCall(MatSetOptionsPrefix(mp[cp], prefix));
74269566063dSJacob Faibussowitsch       PetscCall(MatAppendOptionsPrefix(mp[cp], pprefix));
74274e84afc0SStefano Zampini       mp[cp]->product->api_user = product->api_user;
74289566063dSJacob Faibussowitsch       PetscCall(MatProductSetFromOptions(mp[cp]));
74299566063dSJacob Faibussowitsch       PetscCall((*mp[cp]->ops->productsymbolic)(mp[cp]));
74304e84afc0SStefano Zampini       rmapt[cp] = 2;
74314e84afc0SStefano Zampini       rmapa[cp] = globidx;
74324e84afc0SStefano Zampini       cmapt[cp] = 2;
74334e84afc0SStefano Zampini       cmapa[cp] = P_oth_idx;
74344e84afc0SStefano Zampini       mptmp[cp] = PETSC_FALSE;
74354e84afc0SStefano Zampini       cp++;
74364e84afc0SStefano Zampini     }
74374e84afc0SStefano Zampini     break;
7438d71ae5a4SJacob Faibussowitsch   default:
7439d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)C), PETSC_ERR_PLIB, "Not for product type %s", MatProductTypes[ptype]);
74404e84afc0SStefano Zampini   }
74414e84afc0SStefano Zampini   /* sanity check */
74429371c9d4SSatish Balay   if (size > 1)
74439371c9d4SSatish Balay     for (i = 0; i < cp; i++) PetscCheck(rmapt[i] != 2 || hasoffproc, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Unexpected offproc map type for product %" PetscInt_FMT, i);
74444e84afc0SStefano Zampini 
74459566063dSJacob Faibussowitsch   PetscCall(PetscMalloc2(cp, &mmdata->mp, cp, &mmdata->mptmp));
7446ddea5d60SJunchao Zhang   for (i = 0; i < cp; i++) {
7447ddea5d60SJunchao Zhang     mmdata->mp[i]    = mp[i];
7448ddea5d60SJunchao Zhang     mmdata->mptmp[i] = mptmp[i];
7449ddea5d60SJunchao Zhang   }
74504e84afc0SStefano Zampini   mmdata->cp             = cp;
74514e84afc0SStefano Zampini   C->product->data       = mmdata;
74524e84afc0SStefano Zampini   C->product->destroy    = MatDestroy_MatMatMPIAIJBACKEND;
74534e84afc0SStefano Zampini   C->ops->productnumeric = MatProductNumeric_MPIAIJBACKEND;
74544e84afc0SStefano Zampini 
7455c215019aSStefano Zampini   /* memory type */
7456c215019aSStefano Zampini   mmdata->mtype = PETSC_MEMTYPE_HOST;
74579566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompareAny((PetscObject)C, &iscuda, MATSEQAIJCUSPARSE, MATMPIAIJCUSPARSE, ""));
7458d5e393b6SSuyash Tandon   PetscCall(PetscObjectTypeCompareAny((PetscObject)C, &iship, MATSEQAIJHIPSPARSE, MATMPIAIJHIPSPARSE, ""));
74599566063dSJacob Faibussowitsch   PetscCall(PetscObjectTypeCompareAny((PetscObject)C, &iskokk, MATSEQAIJKOKKOS, MATMPIAIJKOKKOS, ""));
7460c215019aSStefano Zampini   if (iscuda) mmdata->mtype = PETSC_MEMTYPE_CUDA;
7461d5e393b6SSuyash Tandon   else if (iship) mmdata->mtype = PETSC_MEMTYPE_HIP;
74623214990dSStefano Zampini   else if (iskokk) mmdata->mtype = PETSC_MEMTYPE_KOKKOS;
7463c215019aSStefano Zampini 
74644e84afc0SStefano Zampini   /* prepare coo coordinates for values insertion */
7465ddea5d60SJunchao Zhang 
7466ddea5d60SJunchao Zhang   /* count total nonzeros of those intermediate seqaij Mats
7467ddea5d60SJunchao Zhang     ncoo_d:    # of nonzeros of matrices that do not have offproc entries
7468ddea5d60SJunchao Zhang     ncoo_o:    # of nonzeros (of matrices that might have offproc entries) that will be inserted to remote procs
7469ddea5d60SJunchao Zhang     ncoo_oown: # of nonzeros (of matrices that might have offproc entries) that will be inserted locally
7470ddea5d60SJunchao Zhang   */
74714e84afc0SStefano Zampini   for (cp = 0, ncoo_d = 0, ncoo_o = 0, ncoo_oown = 0; cp < mmdata->cp; cp++) {
74724e84afc0SStefano Zampini     Mat_SeqAIJ *mm = (Mat_SeqAIJ *)mp[cp]->data;
74734e84afc0SStefano Zampini     if (mptmp[cp]) continue;
7474ddea5d60SJunchao Zhang     if (rmapt[cp] == 2 && hasoffproc) { /* the rows need to be scatter to all processes (might include self) */
74754e84afc0SStefano Zampini       const PetscInt *rmap = rmapa[cp];
74764e84afc0SStefano Zampini       const PetscInt  mr   = mp[cp]->rmap->n;
74774e84afc0SStefano Zampini       const PetscInt  rs   = C->rmap->rstart;
74784e84afc0SStefano Zampini       const PetscInt  re   = C->rmap->rend;
74794e84afc0SStefano Zampini       const PetscInt *ii   = mm->i;
74804e84afc0SStefano Zampini       for (i = 0; i < mr; i++) {
74814e84afc0SStefano Zampini         const PetscInt gr = rmap[i];
74824e84afc0SStefano Zampini         const PetscInt nz = ii[i + 1] - ii[i];
7483ddea5d60SJunchao Zhang         if (gr < rs || gr >= re) ncoo_o += nz; /* this row is offproc */
7484ddea5d60SJunchao Zhang         else ncoo_oown += nz;                  /* this row is local */
74854e84afc0SStefano Zampini       }
74864e84afc0SStefano Zampini     } else ncoo_d += mm->nz;
74874e84afc0SStefano Zampini   }
7488ddea5d60SJunchao Zhang 
7489ddea5d60SJunchao Zhang   /*
7490ddea5d60SJunchao Zhang     ncoo: total number of nonzeros (including those inserted by remote procs) belonging to this proc
7491ddea5d60SJunchao Zhang 
7492ddea5d60SJunchao Zhang     ncoo = ncoo_d + ncoo_oown + ncoo2, which ncoo2 is number of nonzeros inserted to me by other procs.
7493ddea5d60SJunchao Zhang 
7494d5b43468SJose E. Roman     off[0] points to a big index array, which is shared by off[1,2,...]. Similarly, for own[0].
7495ddea5d60SJunchao Zhang 
7496ddea5d60SJunchao Zhang     off[p]: points to the segment for matrix mp[p], storing location of nonzeros that mp[p] will insert to others
7497ddea5d60SJunchao Zhang     own[p]: points to the segment for matrix mp[p], storing location of nonzeros that mp[p] will insert locally
7498ddea5d60SJunchao Zhang     so, off[p+1]-off[p] is the number of nonzeros that mp[p] will send to others.
7499ddea5d60SJunchao Zhang 
7500ddea5d60SJunchao Zhang     coo_i/j/v[]: [ncoo] row/col/val of nonzeros belonging to this proc.
7501da81f932SPierre Jolivet     Ex. coo_i[]: the beginning part (of size ncoo_d + ncoo_oown) stores i of local nonzeros, and the remaining part stores i of nonzeros I will receive.
7502ddea5d60SJunchao Zhang   */
75039566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(mmdata->cp + 1, &mmdata->off)); /* +1 to make a csr-like data structure */
75049566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1(mmdata->cp + 1, &mmdata->own));
7505ddea5d60SJunchao Zhang 
7506ddea5d60SJunchao Zhang   /* gather (i,j) of nonzeros inserted by remote procs */
7507ddea5d60SJunchao Zhang   if (hasoffproc) {
75084e84afc0SStefano Zampini     PetscSF  msf;
75094e84afc0SStefano Zampini     PetscInt ncoo2, *coo_i2, *coo_j2;
75104e84afc0SStefano Zampini 
75119566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(ncoo_o, &mmdata->off[0]));
75129566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(ncoo_oown, &mmdata->own[0]));
75139566063dSJacob Faibussowitsch     PetscCall(PetscMalloc2(ncoo_o, &coo_i, ncoo_o, &coo_j)); /* to collect (i,j) of entries to be sent to others */
7514ddea5d60SJunchao Zhang 
75154e84afc0SStefano Zampini     for (cp = 0, ncoo_o = 0; cp < mmdata->cp; cp++) {
75164e84afc0SStefano Zampini       Mat_SeqAIJ *mm     = (Mat_SeqAIJ *)mp[cp]->data;
75174e84afc0SStefano Zampini       PetscInt   *idxoff = mmdata->off[cp];
75184e84afc0SStefano Zampini       PetscInt   *idxown = mmdata->own[cp];
7519ddea5d60SJunchao Zhang       if (!mptmp[cp] && rmapt[cp] == 2) { /* row map is sparse */
75204e84afc0SStefano Zampini         const PetscInt *rmap = rmapa[cp];
75214e84afc0SStefano Zampini         const PetscInt *cmap = cmapa[cp];
75224e84afc0SStefano Zampini         const PetscInt *ii   = mm->i;
75234e84afc0SStefano Zampini         PetscInt       *coi  = coo_i + ncoo_o;
75244e84afc0SStefano Zampini         PetscInt       *coj  = coo_j + ncoo_o;
75254e84afc0SStefano Zampini         const PetscInt  mr   = mp[cp]->rmap->n;
75264e84afc0SStefano Zampini         const PetscInt  rs   = C->rmap->rstart;
75274e84afc0SStefano Zampini         const PetscInt  re   = C->rmap->rend;
75284e84afc0SStefano Zampini         const PetscInt  cs   = C->cmap->rstart;
75294e84afc0SStefano Zampini         for (i = 0; i < mr; i++) {
75304e84afc0SStefano Zampini           const PetscInt *jj = mm->j + ii[i];
75314e84afc0SStefano Zampini           const PetscInt  gr = rmap[i];
75324e84afc0SStefano Zampini           const PetscInt  nz = ii[i + 1] - ii[i];
7533ddea5d60SJunchao Zhang           if (gr < rs || gr >= re) { /* this is an offproc row */
75344e84afc0SStefano Zampini             for (j = ii[i]; j < ii[i + 1]; j++) {
75354e84afc0SStefano Zampini               *coi++    = gr;
75364e84afc0SStefano Zampini               *idxoff++ = j;
75374e84afc0SStefano Zampini             }
75384e84afc0SStefano Zampini             if (!cmapt[cp]) { /* already global */
75394e84afc0SStefano Zampini               for (j = 0; j < nz; j++) *coj++ = jj[j];
75404e84afc0SStefano Zampini             } else if (cmapt[cp] == 1) { /* local to global for owned columns of C */
75414e84afc0SStefano Zampini               for (j = 0; j < nz; j++) *coj++ = jj[j] + cs;
75424e84afc0SStefano Zampini             } else { /* offdiag */
75434e84afc0SStefano Zampini               for (j = 0; j < nz; j++) *coj++ = cmap[jj[j]];
75444e84afc0SStefano Zampini             }
75454e84afc0SStefano Zampini             ncoo_o += nz;
7546ddea5d60SJunchao Zhang           } else { /* this is a local row */
75474e84afc0SStefano Zampini             for (j = ii[i]; j < ii[i + 1]; j++) *idxown++ = j;
75484e84afc0SStefano Zampini           }
75494e84afc0SStefano Zampini         }
75504e84afc0SStefano Zampini       }
75514e84afc0SStefano Zampini       mmdata->off[cp + 1] = idxoff;
75524e84afc0SStefano Zampini       mmdata->own[cp + 1] = idxown;
75534e84afc0SStefano Zampini     }
75544e84afc0SStefano Zampini 
75559566063dSJacob Faibussowitsch     PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)C), &mmdata->sf));
75566497c311SBarry Smith     PetscInt incoo_o;
75576497c311SBarry Smith     PetscCall(PetscIntCast(ncoo_o, &incoo_o));
75586497c311SBarry Smith     PetscCall(PetscSFSetGraphLayout(mmdata->sf, C->rmap, incoo_o /*nleaves*/, NULL /*ilocal*/, PETSC_OWN_POINTER, coo_i));
75599566063dSJacob Faibussowitsch     PetscCall(PetscSFGetMultiSF(mmdata->sf, &msf));
75609566063dSJacob Faibussowitsch     PetscCall(PetscSFGetGraph(msf, &ncoo2 /*nroots*/, NULL, NULL, NULL));
75614e84afc0SStefano Zampini     ncoo = ncoo_d + ncoo_oown + ncoo2;
75629566063dSJacob Faibussowitsch     PetscCall(PetscMalloc2(ncoo, &coo_i2, ncoo, &coo_j2));
75639566063dSJacob Faibussowitsch     PetscCall(PetscSFGatherBegin(mmdata->sf, MPIU_INT, coo_i, coo_i2 + ncoo_d + ncoo_oown)); /* put (i,j) of remote nonzeros at back */
75649566063dSJacob Faibussowitsch     PetscCall(PetscSFGatherEnd(mmdata->sf, MPIU_INT, coo_i, coo_i2 + ncoo_d + ncoo_oown));
75659566063dSJacob Faibussowitsch     PetscCall(PetscSFGatherBegin(mmdata->sf, MPIU_INT, coo_j, coo_j2 + ncoo_d + ncoo_oown));
75669566063dSJacob Faibussowitsch     PetscCall(PetscSFGatherEnd(mmdata->sf, MPIU_INT, coo_j, coo_j2 + ncoo_d + ncoo_oown));
75679566063dSJacob Faibussowitsch     PetscCall(PetscFree2(coo_i, coo_j));
7568ddea5d60SJunchao Zhang     /* allocate MPI send buffer to collect nonzero values to be sent to remote procs */
75699566063dSJacob Faibussowitsch     PetscCall(PetscSFMalloc(mmdata->sf, mmdata->mtype, ncoo_o * sizeof(PetscScalar), (void **)&mmdata->coo_w));
75704e84afc0SStefano Zampini     coo_i = coo_i2;
75714e84afc0SStefano Zampini     coo_j = coo_j2;
75724e84afc0SStefano Zampini   } else { /* no offproc values insertion */
75734e84afc0SStefano Zampini     ncoo = ncoo_d;
75749566063dSJacob Faibussowitsch     PetscCall(PetscMalloc2(ncoo, &coo_i, ncoo, &coo_j));
7575c215019aSStefano Zampini 
75769566063dSJacob Faibussowitsch     PetscCall(PetscSFCreate(PetscObjectComm((PetscObject)C), &mmdata->sf));
75779566063dSJacob Faibussowitsch     PetscCall(PetscSFSetGraph(mmdata->sf, 0, 0, NULL, PETSC_OWN_POINTER, NULL, PETSC_OWN_POINTER));
75789566063dSJacob Faibussowitsch     PetscCall(PetscSFSetUp(mmdata->sf));
75794e84afc0SStefano Zampini   }
7580c215019aSStefano Zampini   mmdata->hasoffproc = hasoffproc;
75814e84afc0SStefano Zampini 
7582ddea5d60SJunchao Zhang   /* gather (i,j) of nonzeros inserted locally */
75834e84afc0SStefano Zampini   for (cp = 0, ncoo_d = 0; cp < mmdata->cp; cp++) {
75844e84afc0SStefano Zampini     Mat_SeqAIJ     *mm   = (Mat_SeqAIJ *)mp[cp]->data;
75854e84afc0SStefano Zampini     PetscInt       *coi  = coo_i + ncoo_d;
75864e84afc0SStefano Zampini     PetscInt       *coj  = coo_j + ncoo_d;
75874e84afc0SStefano Zampini     const PetscInt *jj   = mm->j;
75884e84afc0SStefano Zampini     const PetscInt *ii   = mm->i;
75894e84afc0SStefano Zampini     const PetscInt *cmap = cmapa[cp];
75904e84afc0SStefano Zampini     const PetscInt *rmap = rmapa[cp];
75914e84afc0SStefano Zampini     const PetscInt  mr   = mp[cp]->rmap->n;
75924e84afc0SStefano Zampini     const PetscInt  rs   = C->rmap->rstart;
75934e84afc0SStefano Zampini     const PetscInt  re   = C->rmap->rend;
75944e84afc0SStefano Zampini     const PetscInt  cs   = C->cmap->rstart;
75954e84afc0SStefano Zampini 
75964e84afc0SStefano Zampini     if (mptmp[cp]) continue;
7597ddea5d60SJunchao Zhang     if (rmapt[cp] == 1) { /* consecutive rows */
7598ddea5d60SJunchao Zhang       /* fill coo_i */
75994e84afc0SStefano Zampini       for (i = 0; i < mr; i++) {
76004e84afc0SStefano Zampini         const PetscInt gr = i + rs;
76014e84afc0SStefano Zampini         for (j = ii[i]; j < ii[i + 1]; j++) coi[j] = gr;
76024e84afc0SStefano Zampini       }
7603ddea5d60SJunchao Zhang       /* fill coo_j */
7604ddea5d60SJunchao Zhang       if (!cmapt[cp]) { /* type-0, already global */
76059566063dSJacob Faibussowitsch         PetscCall(PetscArraycpy(coj, jj, mm->nz));
7606ddea5d60SJunchao Zhang       } else if (cmapt[cp] == 1) {                        /* type-1, local to global for consecutive columns of C */
7607ddea5d60SJunchao Zhang         for (j = 0; j < mm->nz; j++) coj[j] = jj[j] + cs; /* lid + col start */
7608ddea5d60SJunchao Zhang       } else {                                            /* type-2, local to global for sparse columns */
76094e84afc0SStefano Zampini         for (j = 0; j < mm->nz; j++) coj[j] = cmap[jj[j]];
76104e84afc0SStefano Zampini       }
76114e84afc0SStefano Zampini       ncoo_d += mm->nz;
7612ddea5d60SJunchao Zhang     } else if (rmapt[cp] == 2) { /* sparse rows */
76134e84afc0SStefano Zampini       for (i = 0; i < mr; i++) {
76144e84afc0SStefano Zampini         const PetscInt *jj = mm->j + ii[i];
76154e84afc0SStefano Zampini         const PetscInt  gr = rmap[i];
76164e84afc0SStefano Zampini         const PetscInt  nz = ii[i + 1] - ii[i];
7617ddea5d60SJunchao Zhang         if (gr >= rs && gr < re) { /* local rows */
76184e84afc0SStefano Zampini           for (j = ii[i]; j < ii[i + 1]; j++) *coi++ = gr;
7619ddea5d60SJunchao Zhang           if (!cmapt[cp]) { /* type-0, already global */
76204e84afc0SStefano Zampini             for (j = 0; j < nz; j++) *coj++ = jj[j];
76214e84afc0SStefano Zampini           } else if (cmapt[cp] == 1) { /* local to global for owned columns of C */
76224e84afc0SStefano Zampini             for (j = 0; j < nz; j++) *coj++ = jj[j] + cs;
7623ddea5d60SJunchao Zhang           } else { /* type-2, local to global for sparse columns */
76244e84afc0SStefano Zampini             for (j = 0; j < nz; j++) *coj++ = cmap[jj[j]];
76254e84afc0SStefano Zampini           }
76264e84afc0SStefano Zampini           ncoo_d += nz;
76274e84afc0SStefano Zampini         }
76284e84afc0SStefano Zampini       }
76294e84afc0SStefano Zampini     }
76304e84afc0SStefano Zampini   }
763148a46eb9SPierre Jolivet   if (glob) PetscCall(ISRestoreIndices(glob, &globidx));
76329566063dSJacob Faibussowitsch   PetscCall(ISDestroy(&glob));
763348a46eb9SPierre Jolivet   if (P_oth_l2g) PetscCall(ISLocalToGlobalMappingRestoreIndices(P_oth_l2g, &P_oth_idx));
76349566063dSJacob Faibussowitsch   PetscCall(ISLocalToGlobalMappingDestroy(&P_oth_l2g));
7635ddea5d60SJunchao Zhang   /* allocate an array to store all nonzeros (inserted locally or remotely) belonging to this proc */
76369566063dSJacob Faibussowitsch   PetscCall(PetscSFMalloc(mmdata->sf, mmdata->mtype, ncoo * sizeof(PetscScalar), (void **)&mmdata->coo_v));
76374e84afc0SStefano Zampini 
763839cfb508SMark Adams   /* set block sizes */
763939cfb508SMark Adams   A = product->A;
764039cfb508SMark Adams   P = product->B;
764139cfb508SMark Adams   switch (ptype) {
764239cfb508SMark Adams   case MATPRODUCT_PtAP:
764358b7e2c1SStefano Zampini     PetscCall(MatSetBlockSizes(C, P->cmap->bs, P->cmap->bs));
764439cfb508SMark Adams     break;
764539cfb508SMark Adams   case MATPRODUCT_RARt:
764658b7e2c1SStefano Zampini     PetscCall(MatSetBlockSizes(C, P->rmap->bs, P->rmap->bs));
764739cfb508SMark Adams     break;
764839cfb508SMark Adams   case MATPRODUCT_ABC:
764939cfb508SMark Adams     PetscCall(MatSetBlockSizesFromMats(C, A, product->C));
765039cfb508SMark Adams     break;
765139cfb508SMark Adams   case MATPRODUCT_AB:
765239cfb508SMark Adams     PetscCall(MatSetBlockSizesFromMats(C, A, P));
765339cfb508SMark Adams     break;
765439cfb508SMark Adams   case MATPRODUCT_AtB:
765558b7e2c1SStefano Zampini     PetscCall(MatSetBlockSizes(C, A->cmap->bs, P->cmap->bs));
765639cfb508SMark Adams     break;
765739cfb508SMark Adams   case MATPRODUCT_ABt:
765858b7e2c1SStefano Zampini     PetscCall(MatSetBlockSizes(C, A->rmap->bs, P->rmap->bs));
765939cfb508SMark Adams     break;
766039cfb508SMark Adams   default:
766139cfb508SMark Adams     SETERRQ(PetscObjectComm((PetscObject)C), PETSC_ERR_PLIB, "Not for ProductType %s", MatProductTypes[ptype]);
766239cfb508SMark Adams   }
766339cfb508SMark Adams 
76644e84afc0SStefano Zampini   /* preallocate with COO data */
76659566063dSJacob Faibussowitsch   PetscCall(MatSetPreallocationCOO(C, ncoo, coo_i, coo_j));
76669566063dSJacob Faibussowitsch   PetscCall(PetscFree2(coo_i, coo_j));
76673ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
76684e84afc0SStefano Zampini }
76694e84afc0SStefano Zampini 
7670d71ae5a4SJacob Faibussowitsch PetscErrorCode MatProductSetFromOptions_MPIAIJBACKEND(Mat mat)
7671d71ae5a4SJacob Faibussowitsch {
76724e84afc0SStefano Zampini   Mat_Product *product = mat->product;
76734e84afc0SStefano Zampini #if defined(PETSC_HAVE_DEVICE)
76744e84afc0SStefano Zampini   PetscBool match  = PETSC_FALSE;
7675abb89eb1SStefano Zampini   PetscBool usecpu = PETSC_FALSE;
76764e84afc0SStefano Zampini #else
76774e84afc0SStefano Zampini   PetscBool match = PETSC_TRUE;
76784e84afc0SStefano Zampini #endif
76794e84afc0SStefano Zampini 
76804e84afc0SStefano Zampini   PetscFunctionBegin;
76814e84afc0SStefano Zampini   MatCheckProduct(mat, 1);
76824e84afc0SStefano Zampini #if defined(PETSC_HAVE_DEVICE)
768348a46eb9SPierre Jolivet   if (!product->A->boundtocpu && !product->B->boundtocpu) PetscCall(PetscObjectTypeCompare((PetscObject)product->B, ((PetscObject)product->A)->type_name, &match));
768465e4b4d4SStefano Zampini   if (match) { /* we can always fallback to the CPU if requested */
7685abb89eb1SStefano Zampini     switch (product->type) {
7686abb89eb1SStefano Zampini     case MATPRODUCT_AB:
7687abb89eb1SStefano Zampini       if (product->api_user) {
7688d0609cedSBarry Smith         PetscOptionsBegin(PetscObjectComm((PetscObject)mat), ((PetscObject)mat)->prefix, "MatMatMult", "Mat");
76899566063dSJacob Faibussowitsch         PetscCall(PetscOptionsBool("-matmatmult_backend_cpu", "Use CPU code", "MatMatMult", usecpu, &usecpu, NULL));
7690d0609cedSBarry Smith         PetscOptionsEnd();
7691abb89eb1SStefano Zampini       } else {
7692d0609cedSBarry Smith         PetscOptionsBegin(PetscObjectComm((PetscObject)mat), ((PetscObject)mat)->prefix, "MatProduct_AB", "Mat");
76939566063dSJacob Faibussowitsch         PetscCall(PetscOptionsBool("-mat_product_algorithm_backend_cpu", "Use CPU code", "MatMatMult", usecpu, &usecpu, NULL));
7694d0609cedSBarry Smith         PetscOptionsEnd();
7695abb89eb1SStefano Zampini       }
7696abb89eb1SStefano Zampini       break;
7697abb89eb1SStefano Zampini     case MATPRODUCT_AtB:
7698abb89eb1SStefano Zampini       if (product->api_user) {
7699d0609cedSBarry Smith         PetscOptionsBegin(PetscObjectComm((PetscObject)mat), ((PetscObject)mat)->prefix, "MatTransposeMatMult", "Mat");
77009566063dSJacob Faibussowitsch         PetscCall(PetscOptionsBool("-mattransposematmult_backend_cpu", "Use CPU code", "MatTransposeMatMult", usecpu, &usecpu, NULL));
7701d0609cedSBarry Smith         PetscOptionsEnd();
7702abb89eb1SStefano Zampini       } else {
7703d0609cedSBarry Smith         PetscOptionsBegin(PetscObjectComm((PetscObject)mat), ((PetscObject)mat)->prefix, "MatProduct_AtB", "Mat");
77049566063dSJacob Faibussowitsch         PetscCall(PetscOptionsBool("-mat_product_algorithm_backend_cpu", "Use CPU code", "MatTransposeMatMult", usecpu, &usecpu, NULL));
7705d0609cedSBarry Smith         PetscOptionsEnd();
7706abb89eb1SStefano Zampini       }
7707abb89eb1SStefano Zampini       break;
7708abb89eb1SStefano Zampini     case MATPRODUCT_PtAP:
7709abb89eb1SStefano Zampini       if (product->api_user) {
7710d0609cedSBarry Smith         PetscOptionsBegin(PetscObjectComm((PetscObject)mat), ((PetscObject)mat)->prefix, "MatPtAP", "Mat");
77119566063dSJacob Faibussowitsch         PetscCall(PetscOptionsBool("-matptap_backend_cpu", "Use CPU code", "MatPtAP", usecpu, &usecpu, NULL));
7712d0609cedSBarry Smith         PetscOptionsEnd();
7713abb89eb1SStefano Zampini       } else {
7714d0609cedSBarry Smith         PetscOptionsBegin(PetscObjectComm((PetscObject)mat), ((PetscObject)mat)->prefix, "MatProduct_PtAP", "Mat");
77159566063dSJacob Faibussowitsch         PetscCall(PetscOptionsBool("-mat_product_algorithm_backend_cpu", "Use CPU code", "MatPtAP", usecpu, &usecpu, NULL));
7716d0609cedSBarry Smith         PetscOptionsEnd();
7717abb89eb1SStefano Zampini       }
7718abb89eb1SStefano Zampini       break;
7719d71ae5a4SJacob Faibussowitsch     default:
7720d71ae5a4SJacob Faibussowitsch       break;
7721abb89eb1SStefano Zampini     }
7722abb89eb1SStefano Zampini     match = (PetscBool)!usecpu;
7723abb89eb1SStefano Zampini   }
77244e84afc0SStefano Zampini #endif
77254e84afc0SStefano Zampini   if (match) {
77264e84afc0SStefano Zampini     switch (product->type) {
77274e84afc0SStefano Zampini     case MATPRODUCT_AB:
77284e84afc0SStefano Zampini     case MATPRODUCT_AtB:
7729d71ae5a4SJacob Faibussowitsch     case MATPRODUCT_PtAP:
7730d71ae5a4SJacob Faibussowitsch       mat->ops->productsymbolic = MatProductSymbolic_MPIAIJBACKEND;
7731d71ae5a4SJacob Faibussowitsch       break;
7732d71ae5a4SJacob Faibussowitsch     default:
7733d71ae5a4SJacob Faibussowitsch       break;
77344e84afc0SStefano Zampini     }
77354e84afc0SStefano Zampini   }
77364e84afc0SStefano Zampini   /* fallback to MPIAIJ ops */
77379566063dSJacob Faibussowitsch   if (!mat->ops->productsymbolic) PetscCall(MatProductSetFromOptions_MPIAIJ(mat));
77383ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
773981824310SBarry Smith }
774098921bdaSJacob Faibussowitsch 
774198921bdaSJacob Faibussowitsch /*
774272833a62Smarkadams4    Produces a set of block column indices of the matrix row, one for each block represented in the original row
774372833a62Smarkadams4 
774472833a62Smarkadams4    n - the number of block indices in cc[]
774572833a62Smarkadams4    cc - the block indices (must be large enough to contain the indices)
774672833a62Smarkadams4 */
7747d71ae5a4SJacob Faibussowitsch static inline PetscErrorCode MatCollapseRow(Mat Amat, PetscInt row, PetscInt bs, PetscInt *n, PetscInt *cc)
7748d71ae5a4SJacob Faibussowitsch {
774972833a62Smarkadams4   PetscInt        cnt = -1, nidx, j;
775072833a62Smarkadams4   const PetscInt *idx;
775172833a62Smarkadams4 
775272833a62Smarkadams4   PetscFunctionBegin;
775372833a62Smarkadams4   PetscCall(MatGetRow(Amat, row, &nidx, &idx, NULL));
775472833a62Smarkadams4   if (nidx) {
775572833a62Smarkadams4     cnt     = 0;
775672833a62Smarkadams4     cc[cnt] = idx[0] / bs;
775772833a62Smarkadams4     for (j = 1; j < nidx; j++) {
775872833a62Smarkadams4       if (cc[cnt] < idx[j] / bs) cc[++cnt] = idx[j] / bs;
775972833a62Smarkadams4     }
776072833a62Smarkadams4   }
776172833a62Smarkadams4   PetscCall(MatRestoreRow(Amat, row, &nidx, &idx, NULL));
776272833a62Smarkadams4   *n = cnt + 1;
77633ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
776472833a62Smarkadams4 }
776572833a62Smarkadams4 
776672833a62Smarkadams4 /*
776772833a62Smarkadams4     Produces a set of block column indices of the matrix block row, one for each block represented in the original set of rows
776872833a62Smarkadams4 
776972833a62Smarkadams4     ncollapsed - the number of block indices
777072833a62Smarkadams4     collapsed - the block indices (must be large enough to contain the indices)
777172833a62Smarkadams4 */
7772d71ae5a4SJacob Faibussowitsch static inline PetscErrorCode MatCollapseRows(Mat Amat, PetscInt start, PetscInt bs, PetscInt *w0, PetscInt *w1, PetscInt *w2, PetscInt *ncollapsed, PetscInt **collapsed)
7773d71ae5a4SJacob Faibussowitsch {
777472833a62Smarkadams4   PetscInt i, nprev, *cprev = w0, ncur = 0, *ccur = w1, *merged = w2, *cprevtmp;
777572833a62Smarkadams4 
777672833a62Smarkadams4   PetscFunctionBegin;
777772833a62Smarkadams4   PetscCall(MatCollapseRow(Amat, start, bs, &nprev, cprev));
777872833a62Smarkadams4   for (i = start + 1; i < start + bs; i++) {
777972833a62Smarkadams4     PetscCall(MatCollapseRow(Amat, i, bs, &ncur, ccur));
778072833a62Smarkadams4     PetscCall(PetscMergeIntArray(nprev, cprev, ncur, ccur, &nprev, &merged));
77819371c9d4SSatish Balay     cprevtmp = cprev;
77829371c9d4SSatish Balay     cprev    = merged;
77839371c9d4SSatish Balay     merged   = cprevtmp;
778472833a62Smarkadams4   }
778572833a62Smarkadams4   *ncollapsed = nprev;
778672833a62Smarkadams4   if (collapsed) *collapsed = cprev;
77873ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
778872833a62Smarkadams4 }
778972833a62Smarkadams4 
77902d776b49SBarry Smith /*
779172833a62Smarkadams4  MatCreateGraph_Simple_AIJ - create simple scalar matrix (graph) from potentially blocked matrix
779272833a62Smarkadams4 
779372833a62Smarkadams4  Input Parameter:
779472833a62Smarkadams4  . Amat - matrix
779572833a62Smarkadams4  - symmetrize - make the result symmetric
779672833a62Smarkadams4  + scale - scale with diagonal
779772833a62Smarkadams4 
779872833a62Smarkadams4  Output Parameter:
779972833a62Smarkadams4  . a_Gmat - output scalar graph >= 0
780072833a62Smarkadams4 
780172833a62Smarkadams4 */
7802e02fb3cdSMark Adams PETSC_INTERN PetscErrorCode MatCreateGraph_Simple_AIJ(Mat Amat, PetscBool symmetrize, PetscBool scale, PetscReal filter, PetscInt index_size, PetscInt index[], Mat *a_Gmat)
7803d71ae5a4SJacob Faibussowitsch {
780472833a62Smarkadams4   PetscInt  Istart, Iend, Ii, jj, kk, ncols, nloc, NN, MM, bs;
780572833a62Smarkadams4   MPI_Comm  comm;
780672833a62Smarkadams4   Mat       Gmat;
780772833a62Smarkadams4   PetscBool ismpiaij, isseqaij;
780872833a62Smarkadams4   Mat       a, b, c;
780972833a62Smarkadams4   MatType   jtype;
781072833a62Smarkadams4 
781172833a62Smarkadams4   PetscFunctionBegin;
781272833a62Smarkadams4   PetscCall(PetscObjectGetComm((PetscObject)Amat, &comm));
781372833a62Smarkadams4   PetscCall(MatGetOwnershipRange(Amat, &Istart, &Iend));
781472833a62Smarkadams4   PetscCall(MatGetSize(Amat, &MM, &NN));
781572833a62Smarkadams4   PetscCall(MatGetBlockSize(Amat, &bs));
781672833a62Smarkadams4   nloc = (Iend - Istart) / bs;
781772833a62Smarkadams4 
781872833a62Smarkadams4   PetscCall(PetscObjectBaseTypeCompare((PetscObject)Amat, MATSEQAIJ, &isseqaij));
781972833a62Smarkadams4   PetscCall(PetscObjectBaseTypeCompare((PetscObject)Amat, MATMPIAIJ, &ismpiaij));
782072833a62Smarkadams4   PetscCheck(isseqaij || ismpiaij, comm, PETSC_ERR_USER, "Require (MPI)AIJ matrix type");
782172833a62Smarkadams4 
782272833a62Smarkadams4   /* TODO GPU: these calls are potentially expensive if matrices are large and we want to use the GPU */
782372833a62Smarkadams4   /* A solution consists in providing a new API, MatAIJGetCollapsedAIJ, and each class can provide a fast
782472833a62Smarkadams4      implementation */
782572833a62Smarkadams4   if (bs > 1) {
782672833a62Smarkadams4     PetscCall(MatGetType(Amat, &jtype));
782772833a62Smarkadams4     PetscCall(MatCreate(comm, &Gmat));
782872833a62Smarkadams4     PetscCall(MatSetType(Gmat, jtype));
782972833a62Smarkadams4     PetscCall(MatSetSizes(Gmat, nloc, nloc, PETSC_DETERMINE, PETSC_DETERMINE));
783072833a62Smarkadams4     PetscCall(MatSetBlockSizes(Gmat, 1, 1));
783172833a62Smarkadams4     if (isseqaij || ((Mat_MPIAIJ *)Amat->data)->garray) {
783272833a62Smarkadams4       PetscInt  *d_nnz, *o_nnz;
78332cf69117Smarkadams4       MatScalar *aa, val, *AA;
78342cf69117Smarkadams4       PetscInt  *aj, *ai, *AJ, nc, nmax = 0;
78356497c311SBarry Smith 
78369371c9d4SSatish Balay       if (isseqaij) {
78379371c9d4SSatish Balay         a = Amat;
78389371c9d4SSatish Balay         b = NULL;
78399371c9d4SSatish Balay       } else {
784072833a62Smarkadams4         Mat_MPIAIJ *d = (Mat_MPIAIJ *)Amat->data;
78419371c9d4SSatish Balay         a             = d->A;
78429371c9d4SSatish Balay         b             = d->B;
784372833a62Smarkadams4       }
784472833a62Smarkadams4       PetscCall(PetscInfo(Amat, "New bs>1 Graph. nloc=%" PetscInt_FMT "\n", nloc));
784532603206SJames Wright       PetscCall(PetscMalloc2(nloc, &d_nnz, (isseqaij ? 0 : nloc), &o_nnz));
784672833a62Smarkadams4       for (c = a, kk = 0; c && kk < 2; c = b, kk++) {
78472cf69117Smarkadams4         PetscInt       *nnz = (c == a) ? d_nnz : o_nnz;
784859ee9f9fSPierre Jolivet         const PetscInt *cols1, *cols2;
78496497c311SBarry Smith 
785059ee9f9fSPierre Jolivet         for (PetscInt brow = 0, nc1, nc2, ok = 1; brow < nloc * bs; brow += bs) { // block rows
785159ee9f9fSPierre Jolivet           PetscCall(MatGetRow(c, brow, &nc2, &cols2, NULL));
785259ee9f9fSPierre Jolivet           nnz[brow / bs] = nc2 / bs;
785359ee9f9fSPierre Jolivet           if (nc2 % bs) ok = 0;
785472833a62Smarkadams4           if (nnz[brow / bs] > nmax) nmax = nnz[brow / bs];
785559ee9f9fSPierre Jolivet           for (PetscInt ii = 1; ii < bs; ii++) { // check for non-dense blocks
785659ee9f9fSPierre Jolivet             PetscCall(MatGetRow(c, brow + ii, &nc1, &cols1, NULL));
785759ee9f9fSPierre Jolivet             if (nc1 != nc2) ok = 0;
785859ee9f9fSPierre Jolivet             else {
785959ee9f9fSPierre Jolivet               for (PetscInt jj = 0; jj < nc1 && ok == 1; jj++) {
786059ee9f9fSPierre Jolivet                 if (cols1[jj] != cols2[jj]) ok = 0;
786159ee9f9fSPierre Jolivet                 if (cols1[jj] % bs != jj % bs) ok = 0;
786272833a62Smarkadams4               }
786359ee9f9fSPierre Jolivet             }
786459ee9f9fSPierre Jolivet             PetscCall(MatRestoreRow(c, brow + ii, &nc1, &cols1, NULL));
786559ee9f9fSPierre Jolivet           }
786659ee9f9fSPierre Jolivet           PetscCall(MatRestoreRow(c, brow, &nc2, &cols2, NULL));
786772833a62Smarkadams4           if (!ok) {
786872833a62Smarkadams4             PetscCall(PetscFree2(d_nnz, o_nnz));
786959ee9f9fSPierre Jolivet             PetscCall(PetscInfo(Amat, "Found sparse blocks - revert to slow method\n"));
787072833a62Smarkadams4             goto old_bs;
787172833a62Smarkadams4           }
787272833a62Smarkadams4         }
787372833a62Smarkadams4       }
787472833a62Smarkadams4       PetscCall(MatSeqAIJSetPreallocation(Gmat, 0, d_nnz));
787572833a62Smarkadams4       PetscCall(MatMPIAIJSetPreallocation(Gmat, 0, d_nnz, 0, o_nnz));
787672833a62Smarkadams4       PetscCall(PetscFree2(d_nnz, o_nnz));
78772cf69117Smarkadams4       PetscCall(PetscMalloc2(nmax, &AA, nmax, &AJ));
787872833a62Smarkadams4       // diag
787972833a62Smarkadams4       for (PetscInt brow = 0, n, grow; brow < nloc * bs; brow += bs) { // block rows
788072833a62Smarkadams4         Mat_SeqAIJ *aseq = (Mat_SeqAIJ *)a->data;
78816497c311SBarry Smith 
788272833a62Smarkadams4         ai = aseq->i;
788372833a62Smarkadams4         n  = ai[brow + 1] - ai[brow];
788472833a62Smarkadams4         aj = aseq->j + ai[brow];
78856497c311SBarry Smith         for (PetscInt k = 0; k < n; k += bs) {   // block columns
788672833a62Smarkadams4           AJ[k / bs] = aj[k] / bs + Istart / bs; // diag starts at (Istart,Istart)
788772833a62Smarkadams4           val        = 0;
7888e02fb3cdSMark Adams           if (index_size == 0) {
78896497c311SBarry Smith             for (PetscInt ii = 0; ii < bs; ii++) { // rows in block
789072833a62Smarkadams4               aa = aseq->a + ai[brow + ii] + k;
78916497c311SBarry Smith               for (PetscInt jj = 0; jj < bs; jj++) {    // columns in block
789272833a62Smarkadams4                 val += PetscAbs(PetscRealPart(aa[jj])); // a sort of norm
789372833a62Smarkadams4               }
789472833a62Smarkadams4             }
7895e02fb3cdSMark Adams           } else {                                            // use (index,index) value if provided
78966497c311SBarry Smith             for (PetscInt iii = 0; iii < index_size; iii++) { // rows in block
78976497c311SBarry Smith               PetscInt ii = index[iii];
7898e02fb3cdSMark Adams               aa          = aseq->a + ai[brow + ii] + k;
78996497c311SBarry Smith               for (PetscInt jjj = 0; jjj < index_size; jjj++) { // columns in block
79006497c311SBarry Smith                 PetscInt jj = index[jjj];
7901cd5bc9d0SMark Adams                 val += PetscAbs(PetscRealPart(aa[jj]));
7902e02fb3cdSMark Adams               }
7903e02fb3cdSMark Adams             }
7904e02fb3cdSMark Adams           }
7905835f2295SStefano Zampini           PetscAssert(k / bs < nmax, comm, PETSC_ERR_USER, "k / bs (%" PetscInt_FMT ") >= nmax (%" PetscInt_FMT ")", k / bs, nmax);
790672833a62Smarkadams4           AA[k / bs] = val;
790772833a62Smarkadams4         }
790872833a62Smarkadams4         grow = Istart / bs + brow / bs;
790966521e1fSMark Adams         PetscCall(MatSetValues(Gmat, 1, &grow, n / bs, AJ, AA, ADD_VALUES));
791072833a62Smarkadams4       }
791172833a62Smarkadams4       // off-diag
791272833a62Smarkadams4       if (ismpiaij) {
791372833a62Smarkadams4         Mat_MPIAIJ        *aij = (Mat_MPIAIJ *)Amat->data;
791472833a62Smarkadams4         const PetscScalar *vals;
791572833a62Smarkadams4         const PetscInt    *cols, *garray = aij->garray;
79166497c311SBarry Smith 
791772833a62Smarkadams4         PetscCheck(garray, PETSC_COMM_SELF, PETSC_ERR_USER, "No garray ?");
791872833a62Smarkadams4         for (PetscInt brow = 0, grow; brow < nloc * bs; brow += bs) { // block rows
791972833a62Smarkadams4           PetscCall(MatGetRow(b, brow, &ncols, &cols, NULL));
79206497c311SBarry Smith           for (PetscInt k = 0, cidx = 0; k < ncols; k += bs, cidx++) {
792159ee9f9fSPierre Jolivet             PetscAssert(k / bs < nmax, comm, PETSC_ERR_USER, "k / bs >= nmax");
792272833a62Smarkadams4             AA[k / bs] = 0;
792372833a62Smarkadams4             AJ[cidx]   = garray[cols[k]] / bs;
792472833a62Smarkadams4           }
792572833a62Smarkadams4           nc = ncols / bs;
792672833a62Smarkadams4           PetscCall(MatRestoreRow(b, brow, &ncols, &cols, NULL));
7927e02fb3cdSMark Adams           if (index_size == 0) {
79286497c311SBarry Smith             for (PetscInt ii = 0; ii < bs; ii++) { // rows in block
792972833a62Smarkadams4               PetscCall(MatGetRow(b, brow + ii, &ncols, &cols, &vals));
79306497c311SBarry Smith               for (PetscInt k = 0; k < ncols; k += bs) {
79316497c311SBarry Smith                 for (PetscInt jj = 0; jj < bs; jj++) { // cols in block
7932835f2295SStefano Zampini                   PetscAssert(k / bs < nmax, comm, PETSC_ERR_USER, "k / bs (%" PetscInt_FMT ") >= nmax (%" PetscInt_FMT ")", k / bs, nmax);
793372833a62Smarkadams4                   AA[k / bs] += PetscAbs(PetscRealPart(vals[k + jj]));
793472833a62Smarkadams4                 }
793572833a62Smarkadams4               }
793672833a62Smarkadams4               PetscCall(MatRestoreRow(b, brow + ii, &ncols, &cols, &vals));
793772833a62Smarkadams4             }
7938e02fb3cdSMark Adams           } else {                                            // use (index,index) value if provided
79396497c311SBarry Smith             for (PetscInt iii = 0; iii < index_size; iii++) { // rows in block
79406497c311SBarry Smith               PetscInt ii = index[iii];
7941e02fb3cdSMark Adams               PetscCall(MatGetRow(b, brow + ii, &ncols, &cols, &vals));
79426497c311SBarry Smith               for (PetscInt k = 0; k < ncols; k += bs) {
79436497c311SBarry Smith                 for (PetscInt jjj = 0; jjj < index_size; jjj++) { // cols in block
79446497c311SBarry Smith                   PetscInt jj = index[jjj];
7945e02fb3cdSMark Adams                   AA[k / bs] += PetscAbs(PetscRealPart(vals[k + jj]));
7946e02fb3cdSMark Adams                 }
7947e02fb3cdSMark Adams               }
7948e02fb3cdSMark Adams               PetscCall(MatRestoreRow(b, brow + ii, &ncols, &cols, &vals));
7949e02fb3cdSMark Adams             }
7950e02fb3cdSMark Adams           }
795172833a62Smarkadams4           grow = Istart / bs + brow / bs;
795266521e1fSMark Adams           PetscCall(MatSetValues(Gmat, 1, &grow, nc, AJ, AA, ADD_VALUES));
795372833a62Smarkadams4         }
795472833a62Smarkadams4       }
795572833a62Smarkadams4       PetscCall(MatAssemblyBegin(Gmat, MAT_FINAL_ASSEMBLY));
795672833a62Smarkadams4       PetscCall(MatAssemblyEnd(Gmat, MAT_FINAL_ASSEMBLY));
79572cf69117Smarkadams4       PetscCall(PetscFree2(AA, AJ));
795872833a62Smarkadams4     } else {
795972833a62Smarkadams4       const PetscScalar *vals;
796072833a62Smarkadams4       const PetscInt    *idx;
796172833a62Smarkadams4       PetscInt          *d_nnz, *o_nnz, *w0, *w1, *w2;
796272833a62Smarkadams4     old_bs:
796372833a62Smarkadams4       /*
796472833a62Smarkadams4        Determine the preallocation needed for the scalar matrix derived from the vector matrix.
796572833a62Smarkadams4        */
796672833a62Smarkadams4       PetscCall(PetscInfo(Amat, "OLD bs>1 CreateGraph\n"));
796732603206SJames Wright       PetscCall(PetscMalloc2(nloc, &d_nnz, (isseqaij ? 0 : nloc), &o_nnz));
796872833a62Smarkadams4       if (isseqaij) {
796972833a62Smarkadams4         PetscInt max_d_nnz;
79706497c311SBarry Smith 
797172833a62Smarkadams4         /*
797272833a62Smarkadams4          Determine exact preallocation count for (sequential) scalar matrix
797372833a62Smarkadams4          */
797472833a62Smarkadams4         PetscCall(MatSeqAIJGetMaxRowNonzeros(Amat, &max_d_nnz));
797572833a62Smarkadams4         max_d_nnz = PetscMin(nloc, bs * max_d_nnz);
797672833a62Smarkadams4         PetscCall(PetscMalloc3(max_d_nnz, &w0, max_d_nnz, &w1, max_d_nnz, &w2));
797748a46eb9SPierre Jolivet         for (Ii = 0, jj = 0; Ii < Iend; Ii += bs, jj++) PetscCall(MatCollapseRows(Amat, Ii, bs, w0, w1, w2, &d_nnz[jj], NULL));
797872833a62Smarkadams4         PetscCall(PetscFree3(w0, w1, w2));
797972833a62Smarkadams4       } else if (ismpiaij) {
798072833a62Smarkadams4         Mat             Daij, Oaij;
798172833a62Smarkadams4         const PetscInt *garray;
798272833a62Smarkadams4         PetscInt        max_d_nnz;
79836497c311SBarry Smith 
798472833a62Smarkadams4         PetscCall(MatMPIAIJGetSeqAIJ(Amat, &Daij, &Oaij, &garray));
798572833a62Smarkadams4         /*
798672833a62Smarkadams4          Determine exact preallocation count for diagonal block portion of scalar matrix
798772833a62Smarkadams4          */
798872833a62Smarkadams4         PetscCall(MatSeqAIJGetMaxRowNonzeros(Daij, &max_d_nnz));
798972833a62Smarkadams4         max_d_nnz = PetscMin(nloc, bs * max_d_nnz);
799072833a62Smarkadams4         PetscCall(PetscMalloc3(max_d_nnz, &w0, max_d_nnz, &w1, max_d_nnz, &w2));
799148a46eb9SPierre Jolivet         for (Ii = 0, jj = 0; Ii < Iend - Istart; Ii += bs, jj++) PetscCall(MatCollapseRows(Daij, Ii, bs, w0, w1, w2, &d_nnz[jj], NULL));
799272833a62Smarkadams4         PetscCall(PetscFree3(w0, w1, w2));
799372833a62Smarkadams4         /*
799472833a62Smarkadams4          Over estimate (usually grossly over), preallocation count for off-diagonal portion of scalar matrix
799572833a62Smarkadams4          */
799672833a62Smarkadams4         for (Ii = 0, jj = 0; Ii < Iend - Istart; Ii += bs, jj++) {
799772833a62Smarkadams4           o_nnz[jj] = 0;
799872833a62Smarkadams4           for (kk = 0; kk < bs; kk++) { /* rows that get collapsed to a single row */
799972833a62Smarkadams4             PetscCall(MatGetRow(Oaij, Ii + kk, &ncols, NULL, NULL));
800072833a62Smarkadams4             o_nnz[jj] += ncols;
800172833a62Smarkadams4             PetscCall(MatRestoreRow(Oaij, Ii + kk, &ncols, NULL, NULL));
800272833a62Smarkadams4           }
800372833a62Smarkadams4           if (o_nnz[jj] > (NN / bs - nloc)) o_nnz[jj] = NN / bs - nloc;
800472833a62Smarkadams4         }
800572833a62Smarkadams4       } else SETERRQ(comm, PETSC_ERR_USER, "Require AIJ matrix type");
800672833a62Smarkadams4       /* get scalar copy (norms) of matrix */
800772833a62Smarkadams4       PetscCall(MatSeqAIJSetPreallocation(Gmat, 0, d_nnz));
800872833a62Smarkadams4       PetscCall(MatMPIAIJSetPreallocation(Gmat, 0, d_nnz, 0, o_nnz));
800972833a62Smarkadams4       PetscCall(PetscFree2(d_nnz, o_nnz));
801072833a62Smarkadams4       for (Ii = Istart; Ii < Iend; Ii++) {
801172833a62Smarkadams4         PetscInt dest_row = Ii / bs;
80126497c311SBarry Smith 
801372833a62Smarkadams4         PetscCall(MatGetRow(Amat, Ii, &ncols, &idx, &vals));
801472833a62Smarkadams4         for (jj = 0; jj < ncols; jj++) {
801572833a62Smarkadams4           PetscInt    dest_col = idx[jj] / bs;
801672833a62Smarkadams4           PetscScalar sv       = PetscAbs(PetscRealPart(vals[jj]));
80176497c311SBarry Smith 
801872833a62Smarkadams4           PetscCall(MatSetValues(Gmat, 1, &dest_row, 1, &dest_col, &sv, ADD_VALUES));
801972833a62Smarkadams4         }
802072833a62Smarkadams4         PetscCall(MatRestoreRow(Amat, Ii, &ncols, &idx, &vals));
802172833a62Smarkadams4       }
802272833a62Smarkadams4       PetscCall(MatAssemblyBegin(Gmat, MAT_FINAL_ASSEMBLY));
802372833a62Smarkadams4       PetscCall(MatAssemblyEnd(Gmat, MAT_FINAL_ASSEMBLY));
802472833a62Smarkadams4     }
802572833a62Smarkadams4   } else {
80262d776b49SBarry Smith     if (symmetrize || filter >= 0 || scale) PetscCall(MatDuplicate(Amat, MAT_COPY_VALUES, &Gmat));
80272d776b49SBarry Smith     else {
80282d776b49SBarry Smith       Gmat = Amat;
80292d776b49SBarry Smith       PetscCall(PetscObjectReference((PetscObject)Gmat));
80302d776b49SBarry Smith     }
80319371c9d4SSatish Balay     if (isseqaij) {
80329371c9d4SSatish Balay       a = Gmat;
80339371c9d4SSatish Balay       b = NULL;
80349371c9d4SSatish Balay     } else {
803572833a62Smarkadams4       Mat_MPIAIJ *d = (Mat_MPIAIJ *)Gmat->data;
80369371c9d4SSatish Balay       a             = d->A;
80379371c9d4SSatish Balay       b             = d->B;
803872833a62Smarkadams4     }
80392d776b49SBarry Smith     if (filter >= 0 || scale) {
80402d776b49SBarry Smith       /* take absolute value of each entry */
804172833a62Smarkadams4       for (c = a, kk = 0; c && kk < 2; c = b, kk++) {
804272833a62Smarkadams4         MatInfo      info;
804372833a62Smarkadams4         PetscScalar *avals;
80446497c311SBarry Smith 
804572833a62Smarkadams4         PetscCall(MatGetInfo(c, MAT_LOCAL, &info));
804672833a62Smarkadams4         PetscCall(MatSeqAIJGetArray(c, &avals));
804772833a62Smarkadams4         for (int jj = 0; jj < info.nz_used; jj++) avals[jj] = PetscAbsScalar(avals[jj]);
804872833a62Smarkadams4         PetscCall(MatSeqAIJRestoreArray(c, &avals));
804972833a62Smarkadams4       }
805072833a62Smarkadams4     }
80512d776b49SBarry Smith   }
805272833a62Smarkadams4   if (symmetrize) {
8053b94d7dedSBarry Smith     PetscBool isset, issym;
80546497c311SBarry Smith 
8055b94d7dedSBarry Smith     PetscCall(MatIsSymmetricKnown(Amat, &isset, &issym));
8056b94d7dedSBarry Smith     if (!isset || !issym) {
805772833a62Smarkadams4       Mat matTrans;
80586497c311SBarry Smith 
805972833a62Smarkadams4       PetscCall(MatTranspose(Gmat, MAT_INITIAL_MATRIX, &matTrans));
80601fcb517eSBarry Smith       PetscCall(MatAXPY(Gmat, 1.0, matTrans, Gmat->structurally_symmetric == PETSC_BOOL3_TRUE ? SAME_NONZERO_PATTERN : DIFFERENT_NONZERO_PATTERN));
806172833a62Smarkadams4       PetscCall(MatDestroy(&matTrans));
806272833a62Smarkadams4     }
806372833a62Smarkadams4     PetscCall(MatSetOption(Gmat, MAT_SYMMETRIC, PETSC_TRUE));
80642d776b49SBarry Smith   } else if (Amat != Gmat) PetscCall(MatPropagateSymmetryOptions(Amat, Gmat));
806572833a62Smarkadams4   if (scale) {
806672833a62Smarkadams4     /* scale c for all diagonal values = 1 or -1 */
806772833a62Smarkadams4     Vec diag;
80686497c311SBarry Smith 
806972833a62Smarkadams4     PetscCall(MatCreateVecs(Gmat, &diag, NULL));
807072833a62Smarkadams4     PetscCall(MatGetDiagonal(Gmat, diag));
807172833a62Smarkadams4     PetscCall(VecReciprocal(diag));
807272833a62Smarkadams4     PetscCall(VecSqrtAbs(diag));
807372833a62Smarkadams4     PetscCall(MatDiagonalScale(Gmat, diag, diag));
807472833a62Smarkadams4     PetscCall(VecDestroy(&diag));
807572833a62Smarkadams4   }
807672833a62Smarkadams4   PetscCall(MatViewFromOptions(Gmat, NULL, "-mat_graph_view"));
80772d776b49SBarry Smith   if (filter >= 0) {
80782ce66baaSPierre Jolivet     PetscCall(MatFilter(Gmat, filter, PETSC_TRUE, PETSC_TRUE));
80792ce66baaSPierre Jolivet     PetscCall(MatViewFromOptions(Gmat, NULL, "-mat_filter_graph_view"));
80802d776b49SBarry Smith   }
808172833a62Smarkadams4   *a_Gmat = Gmat;
80823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
808372833a62Smarkadams4 }
808472833a62Smarkadams4 
808572833a62Smarkadams4 /*
808698921bdaSJacob Faibussowitsch     Special version for direct calls from Fortran
808798921bdaSJacob Faibussowitsch */
808898921bdaSJacob Faibussowitsch 
808998921bdaSJacob Faibussowitsch /* Change these macros so can be used in void function */
80909566063dSJacob Faibussowitsch /* Identical to PetscCallVoid, except it assigns to *_ierr */
80919566063dSJacob Faibussowitsch #undef PetscCall
80929371c9d4SSatish Balay #define PetscCall(...) \
80939371c9d4SSatish Balay   do { \
80945f80ce2aSJacob Faibussowitsch     PetscErrorCode ierr_msv_mpiaij = __VA_ARGS__; \
809598921bdaSJacob Faibussowitsch     if (PetscUnlikely(ierr_msv_mpiaij)) { \
809698921bdaSJacob Faibussowitsch       *_ierr = PetscError(PETSC_COMM_SELF, __LINE__, PETSC_FUNCTION_NAME, __FILE__, ierr_msv_mpiaij, PETSC_ERROR_REPEAT, " "); \
809798921bdaSJacob Faibussowitsch       return; \
809898921bdaSJacob Faibussowitsch     } \
809998921bdaSJacob Faibussowitsch   } while (0)
810098921bdaSJacob Faibussowitsch 
810198921bdaSJacob Faibussowitsch #undef SETERRQ
81029371c9d4SSatish Balay #define SETERRQ(comm, ierr, ...) \
81039371c9d4SSatish Balay   do { \
810498921bdaSJacob Faibussowitsch     *_ierr = PetscError(comm, __LINE__, PETSC_FUNCTION_NAME, __FILE__, ierr, PETSC_ERROR_INITIAL, __VA_ARGS__); \
810598921bdaSJacob Faibussowitsch     return; \
810698921bdaSJacob Faibussowitsch   } while (0)
810798921bdaSJacob Faibussowitsch 
810898921bdaSJacob Faibussowitsch #if defined(PETSC_HAVE_FORTRAN_CAPS)
810998921bdaSJacob Faibussowitsch   #define matsetvaluesmpiaij_ MATSETVALUESMPIAIJ
811098921bdaSJacob Faibussowitsch #elif !defined(PETSC_HAVE_FORTRAN_UNDERSCORE)
811198921bdaSJacob Faibussowitsch   #define matsetvaluesmpiaij_ matsetvaluesmpiaij
811298921bdaSJacob Faibussowitsch #else
811398921bdaSJacob Faibussowitsch #endif
8114d71ae5a4SJacob Faibussowitsch PETSC_EXTERN void matsetvaluesmpiaij_(Mat *mmat, PetscInt *mm, const PetscInt im[], PetscInt *mn, const PetscInt in[], const PetscScalar v[], InsertMode *maddv, PetscErrorCode *_ierr)
8115d71ae5a4SJacob Faibussowitsch {
811698921bdaSJacob Faibussowitsch   Mat         mat = *mmat;
811798921bdaSJacob Faibussowitsch   PetscInt    m = *mm, n = *mn;
811898921bdaSJacob Faibussowitsch   InsertMode  addv = *maddv;
811998921bdaSJacob Faibussowitsch   Mat_MPIAIJ *aij  = (Mat_MPIAIJ *)mat->data;
812098921bdaSJacob Faibussowitsch   PetscScalar value;
812198921bdaSJacob Faibussowitsch 
812298921bdaSJacob Faibussowitsch   MatCheckPreallocated(mat, 1);
812398921bdaSJacob Faibussowitsch   if (mat->insertmode == NOT_SET_VALUES) mat->insertmode = addv;
81245f80ce2aSJacob Faibussowitsch   else PetscCheck(mat->insertmode == addv, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONGSTATE, "Cannot mix add values and insert values");
812598921bdaSJacob Faibussowitsch   {
812698921bdaSJacob Faibussowitsch     PetscInt  i, j, rstart = mat->rmap->rstart, rend = mat->rmap->rend;
812798921bdaSJacob Faibussowitsch     PetscInt  cstart = mat->cmap->rstart, cend = mat->cmap->rend, row, col;
812898921bdaSJacob Faibussowitsch     PetscBool roworiented = aij->roworiented;
812998921bdaSJacob Faibussowitsch 
813098921bdaSJacob Faibussowitsch     /* Some Variables required in the macro */
813198921bdaSJacob Faibussowitsch     Mat         A     = aij->A;
813298921bdaSJacob Faibussowitsch     Mat_SeqAIJ *a     = (Mat_SeqAIJ *)A->data;
813398921bdaSJacob Faibussowitsch     PetscInt   *aimax = a->imax, *ai = a->i, *ailen = a->ilen, *aj = a->j;
813498921bdaSJacob Faibussowitsch     MatScalar  *aa;
8135f4f49eeaSPierre Jolivet     PetscBool   ignorezeroentries = ((a->ignorezeroentries && (addv == ADD_VALUES)) ? PETSC_TRUE : PETSC_FALSE);
813698921bdaSJacob Faibussowitsch     Mat         B                 = aij->B;
813798921bdaSJacob Faibussowitsch     Mat_SeqAIJ *b                 = (Mat_SeqAIJ *)B->data;
813898921bdaSJacob Faibussowitsch     PetscInt   *bimax = b->imax, *bi = b->i, *bilen = b->ilen, *bj = b->j, bm = aij->B->rmap->n, am = aij->A->rmap->n;
813998921bdaSJacob Faibussowitsch     MatScalar  *ba;
814098921bdaSJacob Faibussowitsch     /* This variable below is only for the PETSC_HAVE_VIENNACL or PETSC_HAVE_CUDA cases, but we define it in all cases because we
814198921bdaSJacob Faibussowitsch      * cannot use "#if defined" inside a macro. */
814298921bdaSJacob Faibussowitsch     PETSC_UNUSED PetscBool inserted = PETSC_FALSE;
814398921bdaSJacob Faibussowitsch 
814498921bdaSJacob Faibussowitsch     PetscInt  *rp1, *rp2, ii, nrow1, nrow2, _i, rmax1, rmax2, N, low1, high1, low2, high2, t, lastcol1, lastcol2;
814598921bdaSJacob Faibussowitsch     PetscInt   nonew = a->nonew;
814698921bdaSJacob Faibussowitsch     MatScalar *ap1, *ap2;
814798921bdaSJacob Faibussowitsch 
814898921bdaSJacob Faibussowitsch     PetscFunctionBegin;
81499566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArray(A, &aa));
81509566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJGetArray(B, &ba));
815198921bdaSJacob Faibussowitsch     for (i = 0; i < m; i++) {
815298921bdaSJacob Faibussowitsch       if (im[i] < 0) continue;
81536bdcaf15SBarry Smith       PetscCheck(im[i] < mat->rmap->N, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Row too large: row %" PetscInt_FMT " max %" PetscInt_FMT, im[i], mat->rmap->N - 1);
815498921bdaSJacob Faibussowitsch       if (im[i] >= rstart && im[i] < rend) {
815598921bdaSJacob Faibussowitsch         row      = im[i] - rstart;
815698921bdaSJacob Faibussowitsch         lastcol1 = -1;
815798921bdaSJacob Faibussowitsch         rp1      = aj + ai[row];
815898921bdaSJacob Faibussowitsch         ap1      = aa + ai[row];
815998921bdaSJacob Faibussowitsch         rmax1    = aimax[row];
816098921bdaSJacob Faibussowitsch         nrow1    = ailen[row];
816198921bdaSJacob Faibussowitsch         low1     = 0;
816298921bdaSJacob Faibussowitsch         high1    = nrow1;
816398921bdaSJacob Faibussowitsch         lastcol2 = -1;
816498921bdaSJacob Faibussowitsch         rp2      = bj + bi[row];
816598921bdaSJacob Faibussowitsch         ap2      = ba + bi[row];
816698921bdaSJacob Faibussowitsch         rmax2    = bimax[row];
816798921bdaSJacob Faibussowitsch         nrow2    = bilen[row];
816898921bdaSJacob Faibussowitsch         low2     = 0;
816998921bdaSJacob Faibussowitsch         high2    = nrow2;
817098921bdaSJacob Faibussowitsch 
817198921bdaSJacob Faibussowitsch         for (j = 0; j < n; j++) {
817298921bdaSJacob Faibussowitsch           if (roworiented) value = v[i * n + j];
817398921bdaSJacob Faibussowitsch           else value = v[i + j * m];
817498921bdaSJacob Faibussowitsch           if (ignorezeroentries && value == 0.0 && (addv == ADD_VALUES) && im[i] != in[j]) continue;
817598921bdaSJacob Faibussowitsch           if (in[j] >= cstart && in[j] < cend) {
817698921bdaSJacob Faibussowitsch             col = in[j] - cstart;
817798921bdaSJacob Faibussowitsch             MatSetValues_SeqAIJ_A_Private(row, col, value, addv, im[i], in[j]);
817898921bdaSJacob Faibussowitsch           } else if (in[j] < 0) continue;
817998921bdaSJacob Faibussowitsch           else if (PetscUnlikelyDebug(in[j] >= mat->cmap->N)) {
818063a3b9bcSJacob Faibussowitsch             SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Column too large: col %" PetscInt_FMT " max %" PetscInt_FMT, in[j], mat->cmap->N - 1);
818198921bdaSJacob Faibussowitsch           } else {
818298921bdaSJacob Faibussowitsch             if (mat->was_assembled) {
818348a46eb9SPierre Jolivet               if (!aij->colmap) PetscCall(MatCreateColmap_MPIAIJ_Private(mat));
818498921bdaSJacob Faibussowitsch #if defined(PETSC_USE_CTABLE)
8185eec179cfSJacob Faibussowitsch               PetscCall(PetscHMapIGetWithDefault(aij->colmap, in[j] + 1, 0, &col));
818698921bdaSJacob Faibussowitsch               col--;
818798921bdaSJacob Faibussowitsch #else
818898921bdaSJacob Faibussowitsch               col = aij->colmap[in[j]] - 1;
818998921bdaSJacob Faibussowitsch #endif
8190f4f49eeaSPierre Jolivet               if (col < 0 && !((Mat_SeqAIJ *)aij->A->data)->nonew) {
8191eb14dd14SAlex Lindsay                 PetscCall(MatDisAssemble_MPIAIJ(mat, PETSC_FALSE));
819298921bdaSJacob Faibussowitsch                 col = in[j];
819398921bdaSJacob Faibussowitsch                 /* Reinitialize the variables required by MatSetValues_SeqAIJ_B_Private() */
819498921bdaSJacob Faibussowitsch                 B        = aij->B;
819598921bdaSJacob Faibussowitsch                 b        = (Mat_SeqAIJ *)B->data;
81969371c9d4SSatish Balay                 bimax    = b->imax;
81979371c9d4SSatish Balay                 bi       = b->i;
81989371c9d4SSatish Balay                 bilen    = b->ilen;
81999371c9d4SSatish Balay                 bj       = b->j;
820098921bdaSJacob Faibussowitsch                 rp2      = bj + bi[row];
820198921bdaSJacob Faibussowitsch                 ap2      = ba + bi[row];
820298921bdaSJacob Faibussowitsch                 rmax2    = bimax[row];
820398921bdaSJacob Faibussowitsch                 nrow2    = bilen[row];
820498921bdaSJacob Faibussowitsch                 low2     = 0;
820598921bdaSJacob Faibussowitsch                 high2    = nrow2;
820698921bdaSJacob Faibussowitsch                 bm       = aij->B->rmap->n;
820798921bdaSJacob Faibussowitsch                 ba       = b->a;
820898921bdaSJacob Faibussowitsch                 inserted = PETSC_FALSE;
820998921bdaSJacob Faibussowitsch               }
821098921bdaSJacob Faibussowitsch             } else col = in[j];
821198921bdaSJacob Faibussowitsch             MatSetValues_SeqAIJ_B_Private(row, col, value, addv, im[i], in[j]);
821298921bdaSJacob Faibussowitsch           }
821398921bdaSJacob Faibussowitsch         }
821498921bdaSJacob Faibussowitsch       } else if (!aij->donotstash) {
821598921bdaSJacob Faibussowitsch         if (roworiented) {
82169566063dSJacob Faibussowitsch           PetscCall(MatStashValuesRow_Private(&mat->stash, im[i], n, in, v + i * n, (PetscBool)(ignorezeroentries && (addv == ADD_VALUES))));
821798921bdaSJacob Faibussowitsch         } else {
82189566063dSJacob Faibussowitsch           PetscCall(MatStashValuesCol_Private(&mat->stash, im[i], n, in, v + i, m, (PetscBool)(ignorezeroentries && (addv == ADD_VALUES))));
821998921bdaSJacob Faibussowitsch         }
822098921bdaSJacob Faibussowitsch       }
822198921bdaSJacob Faibussowitsch     }
82229566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArray(A, &aa));
82239566063dSJacob Faibussowitsch     PetscCall(MatSeqAIJRestoreArray(B, &ba));
822498921bdaSJacob Faibussowitsch   }
822598921bdaSJacob Faibussowitsch   PetscFunctionReturnVoid();
822698921bdaSJacob Faibussowitsch }
822772833a62Smarkadams4 
822898921bdaSJacob Faibussowitsch /* Undefining these here since they were redefined from their original definition above! No
822998921bdaSJacob Faibussowitsch  * other PETSc functions should be defined past this point, as it is impossible to recover the
823098921bdaSJacob Faibussowitsch  * original definitions */
82319566063dSJacob Faibussowitsch #undef PetscCall
823298921bdaSJacob Faibussowitsch #undef SETERRQ
8233