[Index] [1] [2] [3] [4] [5] [6] [7]

#
Chapter 2: Getting Started

This chapter assumes that you have installed HDFView and, along with "Chapter 3: The HDF Object Model," is designed to help you get to the point where you are actually looking at HDF datasets.

- 2.1 The Main Window
- 2.2 Opening a File
- 2.3 Tree View of File Hierarchy
- 2.4 Status Information
- 2.5 Viewing HDF Metadata
- 2.6 Selecting GUI mModules

## 2.1 The Main Window

When you first open HDFView, the HDFView window appears with an empty tree and data panel. After you open an HDF file, the structure of the file is displayed in the Tree Panel. The content of a data object is displayed in the Data panel by opening the data object.

The main window consists of five components: Menu bar, Tool bar, File bar, Tree panel, Data Panel, Info panel.

The Main Window

- Menu bar
  The Menu bar is where you choose menu commands: File, Window, Tools, and Help.
- Tool bar
  The Tool bar is located under the menu bar and displays buttons with icons that are shortcuts for commonly performed tasks, such as opening and closing a file zooming in or out of an image, or flipping forward and backward through data pages.
- File bar
  The File bar consists of a File/URL text field in which you enter information that leads or points to a file that you want to open. Valid file names include an absolute file name, a file path, and a URL to a remote file, such as /hdf-java-html/hdf5_test.h5.
- Tree panel
  The Tree panel is the left panel in the HDFView window. It displays the group structure of an HDF file as a tree of "folders". Other objects, such as dataset and image, are displayed as leaf objects in the tree.
- Data panel
  The data panel is the right panel in the HDFView window where the content of data objects is displayed. All the data windows are laid out in the data panel. You can display more one documents in the data panel.
- Info panel
  The Info panel is the bottom panel that spans the width of the HDFView window. It displays status information or metadata. Click the tab "Log Info" or the tab "Metadata" to view status information or metadata information, respectively. A status message includes file or data information, warning or error messages and the status of data processing. The Info panel can also be used as a quick way to view metadata of the selected object in the tree view when "Metadata" tab is selected.

## Menu bar

The menubar is at the top of the HDFView window. You can select a menu command from menu items or press key combinations from the keyboard to invoke the menu item's action without navigating through the menu hierarchy. For example, to exit HDFView, you can either press "Ctrl+Q" on the keyboard or select the Exit item from the File menu.

File menu
The File menu contains commands to open and close files, create and save files, and exit HDFView. It also displays a list of recently opened files from which you may selcct to reopen.

File Menu

[Comment: It would be better to describe the menus in the order in which thye appear, from left to right. The menu to the right of the File menu is the Windows menu and its description should be discussed here, followed by the Tools menu.]

Tools menu
The Tools menu contains a list of commands to launch tools such as image conversion, and user options. The current version has only one item: User Options. The User Option command launches a dialog box that allows you to change user preferences: the path of the user's guide, font size, and delimiter. When you launch the User's Guide command from the Help menu, the help tool opens the specified user's guide specified by the path. The font size will be used to specify the display font size of the tree view and otherselsewhere. The data delimiter determines the separator used when you save data values into text files or paste data values from other application to an HDFView spreadsheet.

Tools menu

Window menu
The Window menu displays a list of data windows along with close, tile, and cascade window commands. You can bring a data window to the front by choosing the data name from the Window menu. The Cascade and Tile commands cascade or tile all open windows. The Close command closes the active data window. The Close All command closes all open windows. All open data windows are listed at the bottom of the Window menu. Select one of the items on the list to bring that window to the front.

Window Menu

Help menu
The Help menu displays the User's Guide, the version of the HDF4 and HDF5 libraries and the About box.

Help Menu

## 2.2 Opening a File

[Comment: I've noticed an inconsistency in the way names of commands are expressed. Earlier the names did not appear in quotation marks, but then above and below quotations marks have been added, for example, the "Open" command, in contrast with the Open command. I don't which is preferred, but we need to pick one and use it consistently. In the previous section, I marked the quotation marks as deleted, but I'll refrain from doing them in case you want to keep them. Then, they should be added throughout, as needed.]

Select the "Open" command from file menu or click the "Open" icon in the tool bar to invoke the local file manager, and select a file to open from the local file manager. Selecting "Open Read-Only" opens a file with read-only permission, which means that editing functions are disabled , and changes are not allowed.

Local file manager (Windows)

## 2.3 Tree View of File Hierarchy

An HDF file contains one or more objects, optionally grouped in a hierarchy. For general information about the structure and contents of HDF files, see the HDF documentation at /HDF5/doc/ and /doc.html.

The structure of the file is displayed in the Tree panel, which is the left panel in the HDFView window. Data objects are represented as icons, and groups are represented by folders. An HDF file may contain groups, datasets (arrays), named datatypes and links.

The hierarchy of the file can be navigated by selecting folders to "open" a group, which displays the objects contained by the group. When an object is selected, the data is displayed appropriately in the data panel on the right.

You can open multiple files at one time. Files are listed as root objects in the tree. The following figure illustrates that an HDF5 file, hdf5_test.h5, and an HDF4 file, annras.hdf, are currently open.

Tree view

## 2.4 Viewing Status Information

Short status information and feedback messages are displayed in the information panel. Such information includes error messages and feedback from user's actions. Tab "Log Info" and "Metadata" to switch between viewing status information and viewing metadata.

## 2.5 Viewing HDF Metadata

To see the metadata of a data object, right-click the data object. The metadata dialog box opens and displays metadata information such as name, type, attributes, data type, data space, and members.

Metadata dialog box: General Properties of Dataset

To view a user block in text, right-click the file node (the root group) to open the metadata dialog box. Click the "User Block" tab in the metadata dialog box to show the user block information in text.

Metadata dialog box: User Block in Text General Properties of Dataset

## 2.6 Selecting GUI Modules

HDFView displays data with a default GUI module when opening a dataset by default. You can set default modules from the Tools menu: "Tools" --> "User Options" --> "Default Module". The new default Tree View takes effect only after you restart HDFView.

Set Default Modules

By default, data or attribute is displayed with default modules. You can also select a specific module for display. To select a module, use the "Open As" option from the popup menu from the TreeView to choose an optional TableView or ImageView.

Select an ImageView

[Index] [1] [2] [3] [4] [5] [6] [7]

##### Last Modified: December 16, 2008