<?php
$page_title = "HDFView User's Guide - Getting Started";
include ("../../../links.php");
include ("../../../includes/header.html");
?>
<link href="edit.css" rel="stylesheet" type="text/css" />
<p>
<a href="index.html">[Index]</a>
<a href="ug01introduction.html">[1]</a>
<a href="ug02start.html">[2]</a>
<a href="ug03objects.html">[3]</a>
<a href="ug04treeview.html">[4]</a>
<a href="ug05spreadsheet.html">[5]</a>
<a href="ug06imageview.html">[6]</a>
<a href="ug07textview.html">[7]</a> </p>
<h1><fieldset>Chapter 2: Getting Started</fieldset></h1>
<p>
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.</p>
<ul class="ul">
<li><a href="ug02start.html#ug02main">2.1 The Main Window</a></li>
<li><a href="ug02start.html#ug02load">2.2 Opening a File</a></li>
<li><a href="ug02start.html#ug02tree">2.3 Tree View of File Hierarchy</a></li>
<li><a href="ug02start.html#ug02message">2.4 Status Information</a></li>
<li><a href="ug02start.html#ug02property">2.5 Viewing HDF Metadata</a></li>
<li><a href="ug02start.html#ug02modules">2.6 Selecting GUI mModules</a></li>
</ul>
<hr />
<h2>
<a name="ug02main"></a>2.1 The Main Window</h2>
<p>
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.</p>
<p>
The main window consists of five components: <b>Menu bar, Tool bar, File bar,
Tree panel, Data Panel, Info panel.</b></p>
<center><p>
<img src="images/hdfview.gif" />
<br /><b>The main window</b></p></center>
<ul class="ul">
<li>
<b><i>Menu bar</i></b><br />
The Menu bar is where you choose menu commands: “File”,
“Window”, “Tools”, and “Help”.</li>
<li>
<b><i>Tool bar</i></b><br />
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.</li>
<li>
<b><i>File bar</i></b><br />
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.</li>
<li>
<b><i>Tree panel</i></b><br />
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.</li>
<li>
<b><i>Data panel</i></b><br />
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.</li>
<li>
<b><i>Info panel</i></b><br />
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.</li>
</ul>
<h2>Menu bar</h2>
<p>
The Menu bar 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.</p>
<p>
<i><b>File menu</b></i><br />
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.</p>
<center><p>
<img src="images/menu_file.gif" />
<br /><b>File menu</b></p></center>
<i><b>Window menu</b></i><br />
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
<em>active</em> 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.
<center><p>
<img src="images/menu_window.gif" />
<br /><b>Window menu</b></p></center>
<p><i><b>Tools menu</b></i><br />
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 Options”
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 User's Guide
specified by the path. The font size will be
used to specify the display font size of the tree view and elsewhere.
The data delimiter determines the separator used when you save data
values into text files or paste data values from other applications
to an HDFView spreadsheet. </p>
<center><p>
<img src="images/menu_option.gif" />
<br /><b>Tools menu</b></p></center>
<i><b>Help menu</b></i><br />
The Help menu displays the User's Guide, the version of the HDF4 and HDF5
libraries, and the About box.
<center><p>
<img src="images/menu_help.gif" />
<br /><b>Help menu</b></p></center>
<h2>
<a name="ug02load"></a>2.2 Opening a File</h2>
<p>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. </p>
<center><p>
<img src="images/file_manager.gif" />
<br /><b>Local file manager (Windows)</b></p></center>
<h2>
<a name="ug02tree"></a>2.3 Tree View of File Hierarchy</h2>
<p>
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
<a href="http://www.hdfgroup.org/HDF5/doc/"> HDF5 Documentation</a> and
<a href="http://www.hdfgroup.org/doc.html"> HDF4 Documentation</a>.</p>
<p>
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), committed datatypes, and links.</p>
<p>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.</p>
<p>
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. </p>
<center>
<p><img src="images/tree_view.gif" />
<br /><b>Tree view</b></p></center>
<h2>
<a name="ug02message"></a>2.4 Viewing Status Information</h2>
<p>
Short status information and feedback messages are displayed in the information
panel. Such information includes error messages and feedback from user's
actions. Click on the “Log Info” and “Metadata”
tabs to switch between
viewing status information and viewing metadata.</p>
<h2>
<a name="ug02property"></a>2.5 Viewing HDF Metadata</h2>
<p>
To see the metadata of a data object, right-click the data object. The
Properties dialog box opens and displays metadata information
such as name, type, attributes, datatype, dataspace, and members.</p>
<center>
<p><img src="images/property_general_dataset.gif" />
<br />
<b>Properties dialog box</b></p>
</center>
<p>
To view a user block in text, right-click the file node (the root group)
to open the Properties dialog box. Click the “User Block” tab in the
dialog box to show the user block information in text.</p>
<center>
<p><img src="images/property_userblock.gif" />
<br />
<b>User block in text</b></p>
</center>
<h2>
<a name="ug02modules"></a>2.6 Selecting GUI Modules</h2>
<p>
HDFView displays data with a default GUI module when opening a dataset
by default. You can set default modules from the Tools menu:
click on “Tools” --> “User Options” -->
“Default Module”.
The new default Tree View takes effect only after you restart HDFView.</p>
<center><p>
<img src="images/module_defaults.gif" />
<br /><b>Set default modules</b></p></center>
<p>
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.
<center><p>
<img src="images/module_select_imageview.gif" />
<br /><b>Select an ImageView </b></p></center>
<!-- BEGIN OF FOOTER INFO -->
<hr noshade size=1 />
<p>
<a href="index.html">[Index]</a>
<a href="ug01introduction.html">[1]</a>
<a href="ug02start.html">[2]</a>
<a href="ug03objects.html">[3]</a>
<a href="ug04treeview.html">[4]</a>
<a href="ug05spreadsheet.html">[5]</a>
<a href="ug06imageview.html">[6]</a>
<a href="ug07textview.html">[7]</a> </p>
<p>
<!-- END OF FOOTER INFO -->
<!--
<?php
include ("../../../includes/footer.html");
?>
-->
