impls/plex/plex.c

2256 - sectiondm - The `DM` that contains the section to be saved, can be `NULL`
2263   In general `dm` and `sectiondm` are two different objects, the former carrying the topology and the latter carrying the section, and have been given a topology name and a section name, respectively, with `PetscObjectSetName()`. In practice, however, they can be the same object (or in case `sectiondm` is `NULL`) if it carries both topology and section; in that case the name of the object is used as both the topology name and the section name.
2267 PetscErrorCode DMPlexSectionView(DM dm, PetscViewer viewer, DM sectiondm)
2274   if (!sectiondm) sectiondm = dm;
2275   PetscValidHeaderSpecific(sectiondm, DM_CLASSID, 3);
2280     PetscCall(DMPlexSectionView_HDF5_Internal(dm, viewer, sectiondm));
2297 . sectiondm - The `DM` that contains the global section on which vec is defined, can be `NULL`
2303   In general `dm` and `sectiondm` are two different objects, the former carrying the topology and the latter carrying the section, and have been given a topology name and a section name, respectively, with `PetscObjectSetName()`. In practice, however, they can be the same object (or in case `sectiondm` is `NULL`) if it carries both topology and section; in that case the name of the object is used as both the topology name and the section name.
2310        DMClone(dm, &sectiondm);
2311        PetscObjectSetName((PetscObject)sectiondm, "sectiondm_name");
2313        DMPlexGetChart(sectiondm, &pStart, &pEnd);
2316        DMSetLocalSection(sectiondm, section);
2318        DMGetGlobalVector(sectiondm, &vec);
2321        DMPlexSectionView(dm, viewer, sectiondm);
2322        DMPlexGlobalVectorView(dm, viewer, sectiondm, vec);
2323        DMRestoreGlobalVector(sectiondm, &vec);
2324        DMDestroy(&sectiondm);
2330 PetscErrorCode DMPlexGlobalVectorView(DM dm, PetscViewer viewer, DM sectiondm, Vec vec)
2337   if (!sectiondm) sectiondm = dm;
2338   PetscValidHeaderSpecific(sectiondm, DM_CLASSID, 3);
2347     PetscCall(DMGetGlobalSection(sectiondm, &section));
2357     PetscCall(DMPlexGlobalVectorView_HDF5_Internal(dm, viewer, sectiondm, vec));
2374 . sectiondm - The `DM` that contains the local section on which `vec` is defined, can be `NULL`
2380   In general `dm` and `sectiondm` are two different objects, the former carrying the topology and the latter carrying the section, and have been given a topology name and a section name, respectively, with `PetscObjectSetName()`. In practice, however, they can be the same object (or in case `sectiondm` is `NULL`) if it carries both topology and section; in that case the name of the object is used as both the topology name and the section name.
2387        DMClone(dm, &sectiondm);
2388        PetscObjectSetName((PetscObject)sectiondm, "sectiondm_name");
2390        DMPlexGetChart(sectiondm, &pStart, &pEnd);
2393        DMSetLocalSection(sectiondm, section);
2394        DMGetLocalVector(sectiondm, &vec);
2397        DMPlexSectionView(dm, viewer, sectiondm);
2398        DMPlexLocalVectorView(dm, viewer, sectiondm, vec);
2399        DMRestoreLocalVector(sectiondm, &vec);
2400        DMDestroy(&sectiondm);
2406 PetscErrorCode DMPlexLocalVectorView(DM dm, PetscViewer viewer, DM sectiondm, Vec vec)
2413   if (!sectiondm) sectiondm = dm;
2414   PetscValidHeaderSpecific(sectiondm, DM_CLASSID, 3);
2423     PetscCall(DMGetLocalSection(sectiondm, &section));
2433     PetscCall(DMPlexLocalVectorView_HDF5_Internal(dm, viewer, sectiondm, vec));
2600 . sectiondm            - The `DM` into which the on-disk section (sectionA) is migrated, can be `NULL`
2604 + globalDofSF - The `PetscSF` that migrates any on-disk `Vec` data associated with sectionA into a global `Vec` associated with the `sectiondm`'s global section (`NULL` if not needed)
2605 - localDofSF  - The `PetscSF` that migrates any on-disk `Vec` data associated with sectionA into a local `Vec` associated with the `sectiondm`'s local section (`NULL` if not needed)
2612   In general `dm` and `sectiondm` are two different objects, the former carrying the topology and the latter carrying the section, and have been given a topology name and a section name, respectively, with `PetscObjectSetName()`. In practice, however, they can be the same object (or in case `sectiondm` is `NULL`) if it carries both topology and section; in that case the name of the object is used as both the topology name and the section name.
2614   The output parameter, `globalDofSF` (`localDofSF`), can later be used with `DMPlexGlobalVectorLoad()` (`DMPlexLocalVectorLoad()`) to load on-disk vectors into global (local) vectors associated with sectiondm's global (local) section.
2621   sectionB                   : sectiondm's local section constructed in this function
2622   vecB (local)               : a vector associated with sectiondm's local section
2623   vecB (global)              : a vector associated with sectiondm's global section
2641 PetscErrorCode DMPlexSectionLoad(DM dm, PetscViewer viewer, PeOp DM sectiondm, PetscSF globalToLocalPointSF, PeOp PetscSF *globalDofSF, PeOp PetscSF *localDofSF)
2648   if (!sectiondm) sectiondm = dm;
2649   PetscValidHeaderSpecific(sectiondm, DM_CLASSID, 3);
2657     PetscCall(DMPlexSectionLoad_HDF5_Internal(dm, viewer, sectiondm, globalToLocalPointSF, globalDofSF, localDofSF));
2674 . sectiondm - The `DM` that contains the global section on which vec is defined, can be `NULL`
2681   In general dm and sectiondm are two different objects, the former carrying the topology and the latter carrying the section, and have been given a topology name and a section name, respectively, with `PetscObjectSetName()`. In practice, however, they can be the same object (or in case `sectiondm` is `NULL`) if it carries both topology and section; in that case the name of the object is used as both the topology name and the section name.
2689        DMClone(dm, &sectiondm);
2690        PetscObjectSetName((PetscObject)sectiondm, "sectiondm_name");
2691        DMPlexSectionLoad(dm, viewer, sectiondm, sfX, &gsf, NULL);
2692        DMGetGlobalVector(sectiondm, &vec);
2694        DMPlexGlobalVectorLoad(dm, viewer, sectiondm, gsf, vec);
2695        DMRestoreGlobalVector(sectiondm, &vec);
2698        DMDestroy(&sectiondm);
2705 PetscErrorCode DMPlexGlobalVectorLoad(DM dm, PetscViewer viewer, DM sectiondm, PetscSF sf, Vec vec)
2712   if (!sectiondm) sectiondm = dm;
2713   PetscValidHeaderSpecific(sectiondm, DM_CLASSID, 3);
2723     PetscCall(DMGetGlobalSection(sectiondm, &section));
2733     PetscCall(DMPlexVecLoad_HDF5_Internal(dm, viewer, sectiondm, sf, vec));
2750 . sectiondm - The `DM` that contains the local section on which vec is defined, can be `NULL`
2757   In general `dm` and `sectiondm` are two different objects, the former carrying the topology and the latter carrying the section, and have been given a topology name and a section name, respectively, with `PetscObjectSetName()`. In practice, however, they can be the same object (or in case `sectiondm` is `NULL`) if it carries both topology and section; in that case the name of the object is used as both the topology name and the section name.
2765        DMClone(dm, &sectiondm);
2766        PetscObjectSetName((PetscObject)sectiondm, "sectiondm_name");
2767        DMPlexSectionLoad(dm, viewer, sectiondm, sfX, NULL, &lsf);
2768        DMGetLocalVector(sectiondm, &vec);
2770        DMPlexLocalVectorLoad(dm, viewer, sectiondm, lsf, vec);
2771        DMRestoreLocalVector(sectiondm, &vec);
2774        DMDestroy(&sectiondm);
2781 PetscErrorCode DMPlexLocalVectorLoad(DM dm, PetscViewer viewer, DM sectiondm, PetscSF sf, Vec vec)
2788   if (!sectiondm) sectiondm = dm;
2789   PetscValidHeaderSpecific(sectiondm, DM_CLASSID, 3);
2799     PetscCall(DMGetLocalSection(sectiondm, &section));
2809     PetscCall(DMPlexVecLoad_HDF5_Internal(dm, viewer, sectiondm, sf, vec));