PETSc version 3.16.5
Fix/Edit manual page

# DMPlexLocalVectorView

Saves a local vector

### Synopsis

    #include "petscdmplex.h"
    PetscErrorCode DMPlexLocalVectorView(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 local section on which vec is defined; may be the same as dm
| vec | - The local 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);

          DMGetLocalVector(sectiondm, &vec);

          PetscObjectSetName((PetscObject)vec, "vec_name");

          DMPlexTopologyView(dm, viewer);

          DMPlexSectionView(dm, viewer, sectiondm);

          DMPlexLocalVectorView(dm, viewer, sectiondm, vec);

          DMRestoreLocalVector(sectiondm, &vec);

          DMDestroy(&sectiondm);

          DMDestroy(&dm);

### See Also

DMPlexTopologyView(), DMPlexSectionView(), DMPlexGlobalVectorView(), DMPlexGlobalVectorLoad(), DMPlexLocalVectorLoad()

### Level

advanced

### Location

src/dm/impls/plex/plex.c
Index of all DMPLEX routines
Table of Contents for all manual pages
Index of all manual pages