PETSc version 3.17.5

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);

Level

advanced

Location