PETSc version 3.16.6
Fix/Edit manual page

DMPlexGlobalVectorView

Saves a global vector

Synopsis

#include "petscdmplex.h"   
PetscErrorCode DMPlexGlobalVectorView(DM dm, PetscViewer viewer, DM sectiondm, Vec vec)
Collective on DM

Input Parameters

dm - The DM that represents the topology
viewer - The PetscViewer to save data with
sectiondm - The DM that contains the global section on which vec is defined
vec - The global vector to be saved

Notes

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 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.

Typical calling sequence

      DMCreate(PETSC_COMM_WORLD, &dm);
      DMSetType(dm, DMPLEX);
      PetscObjectSetName((PetscObject)dm, "topologydm_name");
      DMClone(dm, &sectiondm);
      PetscObjectSetName((PetscObject)sectiondm, "sectiondm_name");
      PetscSectionCreate(PETSC_COMM_WORLD, &section);
      DMPlexGetChart(sectiondm, &pStart, &pEnd);
      PetscSectionSetChart(section, pStart, pEnd);
      PetscSectionSetUp(section);
      DMSetLocalSection(sectiondm, section);
      PetscSectionDestroy(&section);
      DMGetGlobalVector(sectiondm, &vec);
      PetscObjectSetName((PetscObject)vec, "vec_name");
      DMPlexTopologyView(dm, viewer);
      DMPlexSectionView(dm, viewer, sectiondm);
      DMPlexGlobalVectorView(dm, viewer, sectiondm, vec);
      DMRestoreGlobalVector(sectiondm, &vec);
      DMDestroy(&sectiondm);
      DMDestroy(&dm);

See Also

DMPlexTopologyView(), DMPlexSectionView(), DMPlexLocalVectorView(), DMPlexGlobalVectorLoad(), DMPlexLocalVectorLoad()

Level

advanced

Location

src/dm/impls/plex/plex.c

Examples

src/dm/impls/plex/tutorials/ex12.c.html

Index of all DMPLEX routines
Table of Contents for all manual pages
Index of all manual pages