PetscViewerHDF5PushGroup#

Set the current HDF5 group for output

Synopsis#

#include "petscviewerhdf5.h" 
PetscErrorCode PetscViewerHDF5PushGroup(PetscViewer viewer, const char name[])

Not collective

Input Parameters#

Notes#

This is designed to mnemonically resemble the Unix cd command.

  If name begins with '/', it is interpreted as an absolute path fully replacing current group, otherwise it is taken as relative to the current group.
  NULL, empty string, or any sequence of all slashes (e.g. "///") is interpreted as the root group "/".
  "." means the current group is pushed again.

Example#

Suppose the current group is “/a”.

  • If name is NULL, empty string, or a sequence of all slashes (e.g. “///”), then the new group will be “/”. . If name is “.”, then the new group will be “/a”. . If name is “b”, then the new group will be “/a/b”.

  • If name is “/b”, then the new group will be “/b”.

Developer Note#

The root group “/” is internally stored as NULL.

See Also#

Viewers: Looking at PETSc Objects, PETSCVIEWERHDF5, PetscViewerHDF5Open(), PetscViewerHDF5PopGroup(), PetscViewerHDF5GetGroup(), PetscViewerHDF5OpenGroup(), PetscViewerHDF5WriteGroup()

Level#

intermediate

Location#

src/sys/classes/viewer/impls/hdf5/hdf5v.c

Examples#

src/vec/vec/tutorials/ex19.c.html
src/snes/tutorials/ex12.c.html
src/tao/tutorials/ex3.c.html


Edit on GitLab

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