README.doc for HDF-EOS Plug-in for HDFView2.3

1. Download HDFView (currently version 2.3) for the desired platform (file hdfview_install_{linux, solaris, irix}_{vm, novm}.bin ) from NCSA site http://hdf.ncsa.uiuc.edu/hdf-java-html/hdfview/index.html and install it as directed below:

• Unix, Linux:
  • To install, type:   sh ./hdfview_install_{linux, solaris, irix}_{vm, novm}.bin
  • To run, type:   ./hdfview
• Windows:
  • To install, type: hdfview_install_windows_vm.exe
  • To run, select HDFView from the menu, Start -> programs -> NCSA HDFView 2.3 -> HDFView 2.3

OR:

• To install, double click on hdfview_install_windows_vm.exe and follow the install wizard
• To run, select HDFView from the menu, Start -> programs -> NCSA HDFView 2.3 -> HDFView 2.3

2. Extract files (directories) from the the HDF-EOS plug-in tar (or zip) file for the desired platform and copy them to the HDFView’s lib/ext directory.  For windows put zlib1.dll file in the directory where HDFView.exe is located.
3. Run HDFView as directed above.
4. Register the new FileFormat from HDFView: Go to "Tools" --> "Add File Format" and add the full class name of the FileFormat with a file extension and key associated to the file format

HDF-EOS formats are as follows:

Hdf-Eos2:hdfeos.he2.HE2File:he2

Hdf-Eos5:hdfeos.he5.HE5File:he5

Type first one and then click OK. Repeat it for the second format.

5. Check the Tools->User Options->Default Module and check the list for TreeView, MetadataView, TableView, and ImageView. You should be able to change those values to be hdfeos.view.HETreeView, hdfeos.view.HEMetaDataView, hdfeos.view.HETableView, and hdfeos.view.HEDefaultImageView respectively. Without changing these settings, hdfeos files will open as regular hdf4 or h5 files. If you do not see those options in the pull out menus close HDFView and start again. Repeat step 5.

6. Check the Tools->User Options->General Setting Module and click on

“Browse …” for “Help Document”. Choose the “ug08hdfeos.html” in the directory …../hdfview/lib/ext/UsersGuide

Without this change the HDF-EOS user’s guide will only open as text in

Help->HEView User’s Guide. However, with change “User’s Guide” will include both HDF and HDF-EOS Plug-in User’s Guides.

7. Close HDFView to save changes. Reopen it for Viewing HDF-EOS files.
8. If you desire to view HDF-EOS files as regular hdf4 or h5 files, repeat step 5 and set modules to default hdf settings. You need to close and open HDFView after settings to activate them.

Note: After first setting of HDF-EOS file format (steps 4, 5, 6, 7) HDFView creates a file called “.hdfview2.3” in your home directory (HDFView always show the location of this file in the “Log Info” at the bottom window). It contains supported file types and settings. If this file had existed from an earlier version (or if HOME directory is shared between platforms and the installation has already been done for another platform) of HDFView with HDF-EOS plugins, then you may not need to perform steps 4 to 7.