PetscViewerHDF5PushGroup — PETSc 3.25.4 documentation

Skip to main content
`Ctrl`+`K`

# PetscViewerHDF5PushGroup

Set the current HDF5 group for output

## Synopsis

    PetscErrorCode PetscViewerHDF5PushGroup(PetscViewer viewer, const char name[])

Not Collective

## Input Parameters

- viewer - the `PetscViewer` of type `PETSCVIEWERHDF5`

- name - The group name

## 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 Notes

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
src/snes/tutorials/ex12.c
src/tao/tutorials/ex3.c
src/ts/tutorials/ex30.c

## Implementations

PetscViewerHDF5PushGroup_HDF5() in src/sys/classes/viewer/impls/hdf5/impl/ihdf5v.c

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