#
# This example creates an HDF5 file group.h5 and a group MyGroup in it 
# using H5Py interfaces to the HDF5 library. 
#
import sys
import h5py

# Uncomment the next line if you want to save the output from this script to a file named "out".
#sys.stdout = open('out', 'w')
#
# Use 'w' to remove existing file and create a new one; use 'w-' if
# create operation should fail when the file already exists.
#
print("Creating an HDF5 file with the name group.h5...")
file = h5py.File('group.h5','w')
#
# Show the Root group which is created when the file is created.
#
print("When an HDF5 file is created, it has a Root group with the name '",file.name,"'.")
#
# Create a group with the name "MyGroup"
#
print("Creating a group MyGroup in the file...")
group = file.create_group("MyGroup")
# 
# Print the content of the Root group
#
print("An HDF5 group is a container for other objects; a group is similar to Python dictionary with the keys being the links to the group members.")
print("Show the members of the Root group using dictionary key method:", list(file.keys()))
#
# Another way to show the content of the Root group.
print("Show the members of the Root group using the list function:", list(file))
#
# Close the file before exiting; H5Py will close the group.
#
file.close()