Examples
========

A minimal usage pattern for writing an UnstructuredGrid file is:

.. code-block:: fortran

   use vtkhdf_ug_file_type
   type(vtkhdf_ug_file) :: file
   integer :: stat
   character(:), allocatable :: errmsg

   call file%create("mesh.vtkhdf", comm, stat, errmsg)
   call file%write_mesh(points, cnode, xcnode, types)
   call file%write_cell_data("pressure", pressure)
   call file%close()

This illustrates the required ordering of calls: create the file,
write the mesh, write any static or temporal datasets, and finally close.
For temporal datasets, first capture the returned cell or point data handle
and then use that handle for each temporal write. For each step, call
``start_time_step(time)``, write temporal datasets, then call
``finalize_time_step()``.

For MultiBlock output, first capture the handle returned by ``add_block`` and
use that handle for subsequent block operations:

.. code-block:: fortran

   use vtkhdf_mb_file_type
   type(vtkhdf_mb_file) :: file
   type(vtkhdf_block_handle) :: block

   call file%create("mb.vtkhdf", comm, stat, errmsg)
   block = file%add_block("fluid", is_temporal=.true.)
   call file%write_mesh(block, points, cnode, xcnode, types)
   call file%close()

More complete examples (serial and MPI-parallel, UnstructuredGrid and
MultiBlockDataSet) are provided in the ``examples`` directory of
the project repository.