xref: /petsc/src/dm/impls/network/networkcreate.c (revision 62aa33baec912248a234e90eff09bca4b3b58035)
15f2c45f1SShri Abhyankar #define PETSCDM_DLL
2af0996ceSBarry Smith #include <petsc/private/dmnetworkimpl.h>    /*I   "petscdmnetwork.h"   I*/
35f2c45f1SShri Abhyankar #include <petscdmda.h>
45f2c45f1SShri Abhyankar 
54416b707SBarry Smith PetscErrorCode  DMSetFromOptions_Network(PetscOptionItems *PetscOptionsObject,DM dm)
65f2c45f1SShri Abhyankar {
75f2c45f1SShri Abhyankar   PetscErrorCode ierr;
85f2c45f1SShri Abhyankar 
95f2c45f1SShri Abhyankar   PetscFunctionBegin;
105f2c45f1SShri Abhyankar   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
111a1499c8SBarry Smith   ierr = PetscOptionsHead(PetscOptionsObject,"DMNetwork Options");CHKERRQ(ierr);
125f2c45f1SShri Abhyankar   ierr = PetscOptionsTail();CHKERRQ(ierr);
135f2c45f1SShri Abhyankar   PetscFunctionReturn(0);
145f2c45f1SShri Abhyankar }
155f2c45f1SShri Abhyankar 
165f2c45f1SShri Abhyankar /* External function declarations here */
175f2c45f1SShri Abhyankar extern PetscErrorCode DMCreateMatrix_Network(DM, Mat*);
185f2c45f1SShri Abhyankar extern PetscErrorCode DMDestroy_Network(DM);
195f2c45f1SShri Abhyankar extern PetscErrorCode DMView_Network(DM, PetscViewer);
205f2c45f1SShri Abhyankar extern PetscErrorCode DMGlobalToLocalBegin_Network(DM, Vec, InsertMode, Vec);
215f2c45f1SShri Abhyankar extern PetscErrorCode DMGlobalToLocalEnd_Network(DM, Vec, InsertMode, Vec);
225f2c45f1SShri Abhyankar extern PetscErrorCode DMLocalToGlobalBegin_Network(DM, Vec, InsertMode, Vec);
235f2c45f1SShri Abhyankar extern PetscErrorCode DMLocalToGlobalEnd_Network(DM, Vec, InsertMode, Vec);
245f2c45f1SShri Abhyankar extern PetscErrorCode DMSetUp_Network(DM);
258415c774SShri Abhyankar extern PetscErrorCode DMClone_Network(DM, DM*);
265f2c45f1SShri Abhyankar 
27a81b7fe4SHong Zhang static PetscErrorCode VecArrayPrint_private(PetscViewer viewer,PetscInt n,const PetscScalar *xv)
28a81b7fe4SHong Zhang {
29a81b7fe4SHong Zhang   PetscErrorCode ierr;
30a81b7fe4SHong Zhang   PetscInt       i;
31a81b7fe4SHong Zhang 
32a81b7fe4SHong Zhang   PetscFunctionBegin;
33a81b7fe4SHong Zhang   for (i=0; i<n; i++) {
34a81b7fe4SHong Zhang #if defined(PETSC_USE_COMPLEX)
35a81b7fe4SHong Zhang     if (PetscImaginaryPart(xv[i]) > 0.0) {
36a81b7fe4SHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"    %g + %g i\n",(double)PetscRealPart(xv[i]),(double)PetscImaginaryPart(xv[i]));CHKERRQ(ierr);
37a81b7fe4SHong Zhang     } else if (PetscImaginaryPart(xv[i]) < 0.0) {
38a81b7fe4SHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"    %g - %g i\n",(double)PetscRealPart(xv[i]),-(double)PetscImaginaryPart(xv[i]));CHKERRQ(ierr);
39a81b7fe4SHong Zhang     } else {
40a81b7fe4SHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"    %g\n",(double)PetscRealPart(xv[i]));CHKERRQ(ierr);
41a81b7fe4SHong Zhang     }
42a81b7fe4SHong Zhang #else
43a81b7fe4SHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"    %g\n",(double)xv[i]);CHKERRQ(ierr);
44a81b7fe4SHong Zhang #endif
45a81b7fe4SHong Zhang   }
46a81b7fe4SHong Zhang   PetscFunctionReturn(0);
47a81b7fe4SHong Zhang }
48a81b7fe4SHong Zhang 
494dc485aaSHong Zhang static PetscErrorCode VecView_Network_Seq(DM networkdm,Vec X,PetscViewer viewer)
504dc485aaSHong Zhang {
514dc485aaSHong Zhang   PetscErrorCode    ierr;
52a81b7fe4SHong Zhang   PetscInt          e,v,Start,End,offset,nvar;
534dc485aaSHong Zhang   const PetscScalar *xv;
54*62aa33baSHong Zhang   DM_Network        *network = (DM_Network*)networkdm->data;
554dc485aaSHong Zhang 
564dc485aaSHong Zhang   PetscFunctionBegin;
574dc485aaSHong Zhang   ierr = VecGetArrayRead(X,&xv);CHKERRQ(ierr);
584dc485aaSHong Zhang 
594dc485aaSHong Zhang   /* iterate over edges */
604dc485aaSHong Zhang   ierr = DMNetworkGetEdgeRange(networkdm,&Start,&End);CHKERRQ(ierr);
614dc485aaSHong Zhang   for (e=Start; e<End; e++) {
624dc485aaSHong Zhang     ierr = DMNetworkGetVariableOffset(networkdm,e,&offset);CHKERRQ(ierr);
634dc485aaSHong Zhang     ierr = DMNetworkGetNumVariables(networkdm,e,&nvar);CHKERRQ(ierr);
644dc485aaSHong Zhang     if (!nvar) continue;
65a81b7fe4SHong Zhang 
664dc485aaSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Edge %D:\n",e-Start);CHKERRQ(ierr);
67a81b7fe4SHong Zhang     ierr = VecArrayPrint_private(viewer,nvar,xv+offset);CHKERRQ(ierr);
684dc485aaSHong Zhang   }
694dc485aaSHong Zhang 
704dc485aaSHong Zhang   /* iterate over vertices */
714dc485aaSHong Zhang   ierr = DMNetworkGetVertexRange(networkdm,&Start,&End);CHKERRQ(ierr);
724dc485aaSHong Zhang   for (v=Start; v<End; v++) {
734dc485aaSHong Zhang     ierr = DMNetworkGetVariableOffset(networkdm,v,&offset);CHKERRQ(ierr);
744dc485aaSHong Zhang     ierr = DMNetworkGetNumVariables(networkdm,v,&nvar);CHKERRQ(ierr);
754dc485aaSHong Zhang     if (!nvar) continue;
76a81b7fe4SHong Zhang 
77*62aa33baSHong Zhang     printf("network->header[%d].id = %d\n",v,network->header[v].id);
78*62aa33baSHong Zhang 
794dc485aaSHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"  Vertex %D:\n",v-Start);CHKERRQ(ierr);
80a81b7fe4SHong Zhang     ierr = VecArrayPrint_private(viewer,nvar,xv+offset);CHKERRQ(ierr);
814dc485aaSHong Zhang   }
824dc485aaSHong Zhang   ierr = PetscViewerFlush(viewer);CHKERRQ(ierr);
834dc485aaSHong Zhang   ierr = VecRestoreArrayRead(X,&xv);CHKERRQ(ierr);
844dc485aaSHong Zhang   PetscFunctionReturn(0);
854dc485aaSHong Zhang }
864dc485aaSHong Zhang 
874062a5e5SHong Zhang static PetscErrorCode VecView_Network_MPI(DM networkdm,Vec X,PetscViewer viewer)
884062a5e5SHong Zhang {
894062a5e5SHong Zhang   PetscErrorCode    ierr;
90e8c2e809SHong Zhang   PetscInt          i,e,v,eStart,eEnd,vStart,vEnd,offset,nvar,len_loc,len,k;
914062a5e5SHong Zhang   const PetscScalar *xv;
924062a5e5SHong Zhang   MPI_Comm          comm;
934062a5e5SHong Zhang   PetscMPIInt       size,rank,tag = ((PetscObject)viewer)->tag;
944062a5e5SHong Zhang   Vec               localX;
954062a5e5SHong Zhang   PetscBool         ghostvtex;
964062a5e5SHong Zhang   PetscScalar       *values;
97a81b7fe4SHong Zhang   PetscInt          j,n,ne,nv;
984062a5e5SHong Zhang   MPI_Status        status;
99*62aa33baSHong Zhang   DM_Network        *network = (DM_Network*)networkdm->data;
1004062a5e5SHong Zhang 
1014062a5e5SHong Zhang   PetscFunctionBegin;
1024062a5e5SHong Zhang   ierr = PetscObjectGetComm((PetscObject)networkdm,&comm);CHKERRQ(ierr);
1034062a5e5SHong Zhang   ierr = MPI_Comm_size(comm,&size);CHKERRQ(ierr);
1044062a5e5SHong Zhang   ierr = MPI_Comm_rank(comm,&rank);CHKERRQ(ierr);
1054062a5e5SHong Zhang 
1064062a5e5SHong Zhang   ierr = DMGetLocalVector(networkdm,&localX);CHKERRQ(ierr);
1074062a5e5SHong Zhang   ierr = DMGlobalToLocalBegin(networkdm,X,INSERT_VALUES,localX);CHKERRQ(ierr);
1084062a5e5SHong Zhang   ierr = DMGlobalToLocalEnd(networkdm,X,INSERT_VALUES,localX);CHKERRQ(ierr);
1094062a5e5SHong Zhang   ierr = VecGetArrayRead(localX,&xv);CHKERRQ(ierr);
1104062a5e5SHong Zhang 
1114062a5e5SHong Zhang   ierr = VecGetLocalSize(localX,&len_loc);CHKERRQ(ierr);
1124062a5e5SHong Zhang 
113e8c2e809SHong Zhang   ierr = DMNetworkGetEdgeRange(networkdm,&eStart,&eEnd);CHKERRQ(ierr);
1144062a5e5SHong Zhang   ierr = DMNetworkGetVertexRange(networkdm,&vStart,&vEnd);CHKERRQ(ierr);
115e8c2e809SHong Zhang   len_loc += 2*(1 + eEnd-eStart + vEnd-vStart);
1164062a5e5SHong Zhang 
1174062a5e5SHong Zhang   /* values = [nedges, offset, nvar, xe; nvertices, offsets, nvars, xv] */
1184062a5e5SHong Zhang   ierr = MPI_Allreduce(&len_loc,&len,1,MPIU_INT,MPI_MAX,comm);CHKERRQ(ierr);
1194062a5e5SHong Zhang   ierr = PetscCalloc1(len,&values);CHKERRQ(ierr);
1204062a5e5SHong Zhang 
1214062a5e5SHong Zhang   if (!rank) {
1224062a5e5SHong Zhang     ierr = PetscViewerASCIIPrintf(viewer,"Process [%d]\n",rank);CHKERRQ(ierr);
1234062a5e5SHong Zhang   }
1244062a5e5SHong Zhang 
1254062a5e5SHong Zhang   /* iterate over edges */
1264062a5e5SHong Zhang   k = 2;
127e8c2e809SHong Zhang   for (e=eStart; e<eEnd; e++) {
1284062a5e5SHong Zhang     ierr = DMNetworkGetVariableOffset(networkdm,e,&offset);CHKERRQ(ierr);
1294062a5e5SHong Zhang     ierr = DMNetworkGetNumVariables(networkdm,e,&nvar);CHKERRQ(ierr);
1304062a5e5SHong Zhang     if (!nvar) continue;
1314062a5e5SHong Zhang 
1324062a5e5SHong Zhang     values[0]  += 1; /* nedges */
1334062a5e5SHong Zhang     values[k++] = offset;
1344062a5e5SHong Zhang     values[k++] = nvar;
1354062a5e5SHong Zhang 
136*62aa33baSHong Zhang     //printf("network->header[%d].id = %p\n",e,&network->header[e]);
137*62aa33baSHong Zhang     printf("network->header[%d].id = %d\n",e,network->header[e].id);
138*62aa33baSHong Zhang 
1394062a5e5SHong Zhang     if (!rank) { /* print its own entries */
140e8c2e809SHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"  Edge %D:\n",e-eStart);CHKERRQ(ierr);
141a81b7fe4SHong Zhang       ierr = VecArrayPrint_private(viewer,nvar,xv+offset);CHKERRQ(ierr);
142a81b7fe4SHong Zhang     } else {
1434062a5e5SHong Zhang       for (i=offset; i< offset+nvar; i++) {
1444062a5e5SHong Zhang         values[k++] = xv[i];
1454062a5e5SHong Zhang       }
1464062a5e5SHong Zhang     }
1474062a5e5SHong Zhang   }
1484062a5e5SHong Zhang 
1494062a5e5SHong Zhang   /* iterate over vertices */
1504062a5e5SHong Zhang   for (v=vStart; v<vEnd; v++) {
1514062a5e5SHong Zhang     ierr = DMNetworkIsGhostVertex(networkdm,v,&ghostvtex);CHKERRQ(ierr);
1524062a5e5SHong Zhang     if (ghostvtex) continue;
1534062a5e5SHong Zhang     ierr = DMNetworkGetVariableOffset(networkdm,v,&offset);CHKERRQ(ierr);
1544062a5e5SHong Zhang     ierr = DMNetworkGetNumVariables(networkdm,v,&nvar);CHKERRQ(ierr);
1554062a5e5SHong Zhang     if (!nvar) continue;
1564062a5e5SHong Zhang 
1574062a5e5SHong Zhang     values[1]  += 1; /* nvertices */
1584062a5e5SHong Zhang     values[k++] = offset;
1594062a5e5SHong Zhang     values[k++] = nvar;
1604062a5e5SHong Zhang 
1614062a5e5SHong Zhang     if (!rank) {
162e8c2e809SHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"  Vertex %D:\n",v-vStart);CHKERRQ(ierr);
163*62aa33baSHong Zhang       printf("network->header[%d].id = %d\n",v,network->header[v].id);
1644062a5e5SHong Zhang     }
1654062a5e5SHong Zhang 
1664062a5e5SHong Zhang     if (!rank) {
167a81b7fe4SHong Zhang       ierr = VecArrayPrint_private(viewer,nvar,xv+offset);CHKERRQ(ierr);
1684062a5e5SHong Zhang     } else {
169a81b7fe4SHong Zhang       for (i=offset; i< offset+nvar; i++) {
1704062a5e5SHong Zhang         values[k++] = xv[i];
1714062a5e5SHong Zhang       }
1724062a5e5SHong Zhang     }
1734062a5e5SHong Zhang   }
1744062a5e5SHong Zhang 
1754062a5e5SHong Zhang   if (!rank) {
1764062a5e5SHong Zhang     /* proc[0] receives and prints messages */
1774062a5e5SHong Zhang     for (j=1; j<size; j++) {
1784062a5e5SHong Zhang       ierr = PetscViewerASCIIPrintf(viewer,"Process [%d]\n",j);CHKERRQ(ierr);
1794062a5e5SHong Zhang 
1804062a5e5SHong Zhang       ierr = MPI_Recv(values,(PetscMPIInt)len,MPIU_SCALAR,j,tag,comm,&status);CHKERRQ(ierr);
1814062a5e5SHong Zhang       ierr = MPI_Get_count(&status,MPIU_SCALAR,&n);CHKERRQ(ierr);
1824062a5e5SHong Zhang 
1834062a5e5SHong Zhang       ne = (PetscInt)values[0];
1844062a5e5SHong Zhang       nv = (PetscInt)values[1];
1854062a5e5SHong Zhang 
1864062a5e5SHong Zhang       /* print received edges */
1874062a5e5SHong Zhang       k  = 2;
1884062a5e5SHong Zhang       for (i=0; i<ne; i++) {
189a81b7fe4SHong Zhang         offset = (PetscInt)values[k++];
190a81b7fe4SHong Zhang         nvar   = (PetscInt)values[k++];
1914062a5e5SHong Zhang         ierr = PetscViewerASCIIPrintf(viewer,"  Edge %D:\n",i);CHKERRQ(ierr);
192a81b7fe4SHong Zhang         ierr = VecArrayPrint_private(viewer,nvar,values+k);CHKERRQ(ierr);
193a81b7fe4SHong Zhang         k   += nvar;
1944062a5e5SHong Zhang       }
1954062a5e5SHong Zhang 
1964062a5e5SHong Zhang       /* print received vertices */
1974062a5e5SHong Zhang       for (i=0; i<nv; i++) {
1984062a5e5SHong Zhang         offset = (PetscInt)values[k++];
1994062a5e5SHong Zhang         nvar   = (PetscInt)values[k++];
2004062a5e5SHong Zhang         ierr = PetscViewerASCIIPrintf(viewer,"  Vertex %D:\n",i);CHKERRQ(ierr);
201a81b7fe4SHong Zhang         ierr = VecArrayPrint_private(viewer,nvar,values+k);CHKERRQ(ierr);
202a81b7fe4SHong Zhang         k   += nvar;
2034062a5e5SHong Zhang       }
2044062a5e5SHong Zhang     }
2054062a5e5SHong Zhang   } else {
2064062a5e5SHong Zhang     /* sends values to proc[0] */
2074062a5e5SHong Zhang     ierr = MPI_Send((void*)values,k,MPIU_SCALAR,0,tag,comm);CHKERRQ(ierr);
2084062a5e5SHong Zhang   }
2094062a5e5SHong Zhang 
2104062a5e5SHong Zhang   ierr = PetscFree(values);CHKERRQ(ierr);
2114062a5e5SHong Zhang   ierr = VecRestoreArrayRead(localX,&xv);CHKERRQ(ierr);
2124062a5e5SHong Zhang   ierr = DMRestoreLocalVector(networkdm,&localX);CHKERRQ(ierr);
2134062a5e5SHong Zhang   PetscFunctionReturn(0);
2144062a5e5SHong Zhang }
2154062a5e5SHong Zhang 
2164dc485aaSHong Zhang PetscErrorCode VecView_Network(Vec v,PetscViewer viewer)
2174dc485aaSHong Zhang {
2184dc485aaSHong Zhang   DM             dm;
2194dc485aaSHong Zhang   PetscErrorCode ierr;
2204dc485aaSHong Zhang   PetscBool      isseq;
2214dc485aaSHong Zhang 
2224dc485aaSHong Zhang   PetscFunctionBegin;
2234dc485aaSHong Zhang   ierr = VecGetDM(v,&dm);CHKERRQ(ierr);
2244dc485aaSHong Zhang   if (!dm) SETERRQ(PetscObjectComm((PetscObject)v),PETSC_ERR_ARG_WRONG,"Vector not generated from a DM");
2254dc485aaSHong Zhang   ierr = PetscObjectTypeCompare((PetscObject)v,VECSEQ,&isseq);CHKERRQ(ierr);
2264dc485aaSHong Zhang   if (isseq) {
2274dc485aaSHong Zhang     ierr = VecView_Network_Seq(dm,v,viewer);CHKERRQ(ierr);
2284dc485aaSHong Zhang   } else {
2294062a5e5SHong Zhang     ierr = VecView_Network_MPI(dm,v,viewer);CHKERRQ(ierr);
2304dc485aaSHong Zhang   }
2314dc485aaSHong Zhang   PetscFunctionReturn(0);
2324dc485aaSHong Zhang }
2335f2c45f1SShri Abhyankar 
2345f2c45f1SShri Abhyankar static PetscErrorCode DMCreateGlobalVector_Network(DM dm,Vec *vec)
2355f2c45f1SShri Abhyankar {
2365f2c45f1SShri Abhyankar   PetscErrorCode ierr;
2375f2c45f1SShri Abhyankar   DM_Network     *network = (DM_Network*) dm->data;
2385f2c45f1SShri Abhyankar 
2395f2c45f1SShri Abhyankar   PetscFunctionBegin;
2405f2c45f1SShri Abhyankar   ierr = DMCreateGlobalVector(network->plex,vec);CHKERRQ(ierr);
2414dc485aaSHong Zhang   ierr = VecSetOperation(*vec, VECOP_VIEW, (void (*)(void)) VecView_Network);CHKERRQ(ierr);
2425f2c45f1SShri Abhyankar   ierr = VecSetDM(*vec,dm);CHKERRQ(ierr);
2435f2c45f1SShri Abhyankar   PetscFunctionReturn(0);
2445f2c45f1SShri Abhyankar }
2455f2c45f1SShri Abhyankar 
2465f2c45f1SShri Abhyankar static PetscErrorCode DMCreateLocalVector_Network(DM dm,Vec *vec)
2475f2c45f1SShri Abhyankar {
2485f2c45f1SShri Abhyankar   PetscErrorCode ierr;
2495f2c45f1SShri Abhyankar   DM_Network     *network = (DM_Network*) dm->data;
2505f2c45f1SShri Abhyankar 
2515f2c45f1SShri Abhyankar   PetscFunctionBegin;
2525f2c45f1SShri Abhyankar   ierr = DMCreateLocalVector(network->plex,vec);CHKERRQ(ierr);
2535f2c45f1SShri Abhyankar   ierr = VecSetDM(*vec,dm);CHKERRQ(ierr);
2545f2c45f1SShri Abhyankar   PetscFunctionReturn(0);
2555f2c45f1SShri Abhyankar }
2565f2c45f1SShri Abhyankar 
2575f2c45f1SShri Abhyankar PetscErrorCode DMInitialize_Network(DM dm)
2585f2c45f1SShri Abhyankar {
2595f2c45f1SShri Abhyankar 
2605f2c45f1SShri Abhyankar   PetscFunctionBegin;
2615f2c45f1SShri Abhyankar 
2625f2c45f1SShri Abhyankar   dm->ops->view                            = NULL;
2635f2c45f1SShri Abhyankar   dm->ops->setfromoptions                  = DMSetFromOptions_Network;
2648415c774SShri Abhyankar   dm->ops->clone                           = DMClone_Network;
2655f2c45f1SShri Abhyankar   dm->ops->setup                           = DMSetUp_Network;
2665f2c45f1SShri Abhyankar   dm->ops->createglobalvector              = DMCreateGlobalVector_Network;
2675f2c45f1SShri Abhyankar   dm->ops->createlocalvector               = DMCreateLocalVector_Network;
2685f2c45f1SShri Abhyankar   dm->ops->getlocaltoglobalmapping         = NULL;
2695f2c45f1SShri Abhyankar   dm->ops->createfieldis                   = NULL;
2705f2c45f1SShri Abhyankar   dm->ops->createcoordinatedm              = NULL;
2715f2c45f1SShri Abhyankar   dm->ops->getcoloring                     = 0;
2725f2c45f1SShri Abhyankar   dm->ops->creatematrix                    = DMCreateMatrix_Network;
2735f2c45f1SShri Abhyankar   dm->ops->createinterpolation             = 0;
2745f2c45f1SShri Abhyankar   dm->ops->getaggregates                   = 0;
2755f2c45f1SShri Abhyankar   dm->ops->getinjection                    = 0;
2765f2c45f1SShri Abhyankar   dm->ops->refine                          = 0;
2775f2c45f1SShri Abhyankar   dm->ops->coarsen                         = 0;
2785f2c45f1SShri Abhyankar   dm->ops->refinehierarchy                 = 0;
2795f2c45f1SShri Abhyankar   dm->ops->coarsenhierarchy                = 0;
2805f2c45f1SShri Abhyankar   dm->ops->globaltolocalbegin              = DMGlobalToLocalBegin_Network;
2815f2c45f1SShri Abhyankar   dm->ops->globaltolocalend                = DMGlobalToLocalEnd_Network;
2825f2c45f1SShri Abhyankar   dm->ops->localtoglobalbegin              = DMLocalToGlobalBegin_Network;
2835f2c45f1SShri Abhyankar   dm->ops->localtoglobalend                = DMLocalToGlobalEnd_Network;
2845f2c45f1SShri Abhyankar   dm->ops->destroy                         = DMDestroy_Network;
2855f2c45f1SShri Abhyankar   dm->ops->createsubdm                     = NULL;
2865f2c45f1SShri Abhyankar   dm->ops->locatepoints                    = NULL;
2875f2c45f1SShri Abhyankar   PetscFunctionReturn(0);
2885f2c45f1SShri Abhyankar }
2895f2c45f1SShri Abhyankar 
2908415c774SShri Abhyankar PetscErrorCode DMClone_Network(DM dm, DM *newdm)
2918415c774SShri Abhyankar {
2928415c774SShri Abhyankar   DM_Network     *network = (DM_Network *) dm->data;
2938415c774SShri Abhyankar   PetscErrorCode ierr;
2948415c774SShri Abhyankar 
2958415c774SShri Abhyankar   PetscFunctionBegin;
2968415c774SShri Abhyankar   network->refct++;
2978415c774SShri Abhyankar   (*newdm)->data = network;
2988415c774SShri Abhyankar   ierr = PetscObjectChangeTypeName((PetscObject) *newdm, DMNETWORK);CHKERRQ(ierr);
2998415c774SShri Abhyankar   ierr = DMInitialize_Network(*newdm);CHKERRQ(ierr);
3008415c774SShri Abhyankar   PetscFunctionReturn(0);
3018415c774SShri Abhyankar }
3028415c774SShri Abhyankar 
3035f2c45f1SShri Abhyankar /*MC
3045f2c45f1SShri Abhyankar   DMNETWORK = "network" - A DM object that encapsulates an unstructured network. The implementation is based on the DM object
3055f2c45f1SShri Abhyankar                           DMPlex that manages unstructured grids. Distributed networks use a non-overlapping partitioning of
3065f2c45f1SShri Abhyankar                           the edges. In the local representation, Vecs contain all unknowns in the interior and shared boundary.
3075f2c45f1SShri Abhyankar                           This is specified by a PetscSection object. Ownership in the global representation is determined by
3085f2c45f1SShri Abhyankar                           ownership of the underlying DMPlex points. This is specified by another PetscSection object.
3095f2c45f1SShri Abhyankar 
3105f2c45f1SShri Abhyankar   Level: intermediate
3115f2c45f1SShri Abhyankar 
3125f2c45f1SShri Abhyankar .seealso: DMType, DMNetworkCreate(), DMCreate(), DMSetType()
3135f2c45f1SShri Abhyankar M*/
3145f2c45f1SShri Abhyankar 
3155f2c45f1SShri Abhyankar PETSC_EXTERN PetscErrorCode DMCreate_Network(DM dm)
3165f2c45f1SShri Abhyankar {
3175f2c45f1SShri Abhyankar   DM_Network     *network;
3185f2c45f1SShri Abhyankar   PetscErrorCode ierr;
3195f2c45f1SShri Abhyankar 
3205f2c45f1SShri Abhyankar   PetscFunctionBegin;
3215f2c45f1SShri Abhyankar   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
3225f2c45f1SShri Abhyankar   ierr     = PetscNewLog(dm,&network);CHKERRQ(ierr);
3235f2c45f1SShri Abhyankar   dm->data = network;
3245f2c45f1SShri Abhyankar 
3255f2c45f1SShri Abhyankar   network->refct          = 1;
3265f2c45f1SShri Abhyankar   network->NNodes         = -1;
3275f2c45f1SShri Abhyankar   network->NEdges         = -1;
3285f2c45f1SShri Abhyankar   network->nNodes         = -1;
3295f2c45f1SShri Abhyankar   network->nEdges         = -1;
3305f2c45f1SShri Abhyankar 
33113c2a604SAdrian Maldonado 
3325f2c45f1SShri Abhyankar   ierr = DMInitialize_Network(dm);CHKERRQ(ierr);
3335f2c45f1SShri Abhyankar   PetscFunctionReturn(0);
3345f2c45f1SShri Abhyankar }
3355f2c45f1SShri Abhyankar 
3365f2c45f1SShri Abhyankar /*@
3375f2c45f1SShri Abhyankar   DMNetworkCreate - Creates a DMNetwork object, which encapsulates an unstructured network.
3385f2c45f1SShri Abhyankar 
3395f2c45f1SShri Abhyankar   Collective on MPI_Comm
3405f2c45f1SShri Abhyankar 
3415f2c45f1SShri Abhyankar   Input Parameter:
3425f2c45f1SShri Abhyankar . comm - The communicator for the DMNetwork object
3435f2c45f1SShri Abhyankar 
3445f2c45f1SShri Abhyankar   Output Parameter:
3455f2c45f1SShri Abhyankar . network  - The DMNetwork object
3465f2c45f1SShri Abhyankar 
3475f2c45f1SShri Abhyankar   Level: beginner
3485f2c45f1SShri Abhyankar 
3495f2c45f1SShri Abhyankar .keywords: DMNetwork, create
3505f2c45f1SShri Abhyankar @*/
3515f2c45f1SShri Abhyankar PetscErrorCode DMNetworkCreate(MPI_Comm comm, DM *network)
3525f2c45f1SShri Abhyankar {
3535f2c45f1SShri Abhyankar   PetscErrorCode ierr;
3545f2c45f1SShri Abhyankar 
3555f2c45f1SShri Abhyankar   PetscFunctionBegin;
3565f2c45f1SShri Abhyankar   PetscValidPointer(network,2);
3575f2c45f1SShri Abhyankar   ierr = DMCreate(comm, network);CHKERRQ(ierr);
3585f2c45f1SShri Abhyankar   ierr = DMSetType(*network, DMNETWORK);CHKERRQ(ierr);
3595f2c45f1SShri Abhyankar   PetscFunctionReturn(0);
3605f2c45f1SShri Abhyankar }
361