Table 14A lists the names and descriptions of the utilities described in this section. Descriptions and examples of these routines follow.
TABLE 14A The HDF Command-Line Utilities
hdfls [-o][-l][-d][-v][-g][-s][-h][-t #] filename
14.2.1.3 Examples
A file called "aa.hdf" contains three items associated with a raster image; the image dimensions, a palette, and the raster image. To display information about the contents of this file, the following command is used.
hdfls aa.hdf
The following output is displayed:
aa.hdf: Image Dimensions-8: (Raster-8): (tag 200) Ref nos: 1 Image Palette-8: (Raster-8): (tag 201) Ref nos: 3 Raster Image-8: (Raster-8): (tag 202) Ref nos: 1
The following displays the same information with the length of each data element:
hdfls -l aa.hdf
This would result in the following information being displayed:
aa.hdf: Image Dimensions-8: (Raster-8) : (tag 200) Ref no 1 4 bytes Image Palette-8: (Raster-8) : (tag 201) Ref no 3 768 bytes Raster Image-8: (Raster-8) : (tag 202) Ref no 1 120000 bytes
14.2.2 Editing the Contents of an HDF File: hdfed
14.2.2.1 General Description
The hdfed utility allows experienced HDF users to manipulate the elements of an HDF file. These manipulations include
It is designed primarily for users who need to know about HDF files at the level of individual data elements. It is not designed to provide a comprehensive high-level view of the contents of an HDF file - other tools and utilities should be used for that purpose. To use hdfed one should be familiar with the components of an HDF file covered in the HDF Specifications manual.
14.2.2.2 Command-Line Syntax
The syntax of hdfed is
hdfed [-nobackup][-batch] filename
If a file named filename exists, it is opened and a backup is made of the file. Files may also be opened from within the editor.
#!/bin/csh -f set file=$1 shift hdfed -batch $file -nobackup << EOF info -all group $* close quit EOF echo ""
To receive usage information, as well as a quick list of the hdfed commands, type the command
hdfed -help
While in hdfed, the standard command prompt is displayed.
hdfed>
Many hdfed commands have qualifiers, or flags. For example, the info command may be followed by the -all, -long, -group, or -label flags.
TABLE 14B The hdfed Command Set
any hdfed command -help
Note that usage information cannot be obtained by typing only the command, with no flags. There are hdfed commands like delete that do not require an argument, so watch out for this kind of error.
item comparator value
next group next (same as "next group" as "group" is the default identifier) next tag = 720 next ref = 2 next image_size < 1000 next label = "abc"
The following is a more inclusive description of the hdfed commands.
Syntax: help Flags: None Description: Prints a help screen describing the basic purpose and functionality of the hdfed utility. Usage Example: hdfed> help hdfed allows sophisticated HDF users the ability to manipulate the elements in an HDF file. These manipulations include selecting groups ...
Syntax: open [-nobackup] filename Flags: -nobackup The specified file name is not backed up. Description: Opens the specified HDF file. Usage Example: hdfed> open -help open <file> [-nobackup] -nobackup Don't make a backup for this file. hdfed> hdfed> open h1 hdfed>
Syntax: info [-all] [-long] [-group] [-label] Flags: -all Displays information for all of the objects in the current file. -long Displays the long form of the information. -group Organizes the information into groups. -label Shows any labels. Description: Displays information for a data object. The listing for special elements will contain a special tag value (in Item 13 below it's 18347, which corresponds to DFTAG_VS) and the text "Unknown Tag". Usage Example: hdfed> info -all -label -long (1) Version Descriptor : (Tag 30) Ref: 1, Offset: 202, Length :92 (bytes) (2) Scientific Data : (Tag 702) Ref: 2, Offset: 294, Length : 200 (bytes) (3) Number type : (Tag 106) Ref: 2, Offset: 494, Length : 4 (bytes) (4) SciData description : (Tag 701) Ref: 2, Offset: 498, Length : 2 (bytes) (5) SciData max/min : (Tag 707) Ref: 2, Offset: 520, Length : 4 (bytes) *(6) Numeric Data Group : (Tag 720) Ref: 2, Offset: 524, Length : 12 (bytes) Label: Experiment #1 (7) Data Id Label : (Tag 104) Ref: 3, Offset: 536, Length : 17 (bytes) (8) Scientific Data : (Tag 702) Ref: 4, Offset: 553, Length : 400 (bytes) (9) Number type : (Tag 106) Ref: 4, Offset: 953, Length : 4 (bytes) (10) SciData description : (Tag 701) Ref: 4, Offset:957, Length : 22 (bytes) (11) Numeric Data Group : (Tag 720) Ref: 4, Offset: 979, Length : 8 (bytes) Label: Experiment #2 (12) Data Id Label : (Tag 104) Ref: 5, Offset: 987, Length : 17 (bytes) (13) Unknown Tag : (Tag 18347) Ref: 8, Offset: 0, Length : 40(bytes hdfed> hdfed> info -group -all **Group 1: Numeric Data Group : (Tag 720) Ref 2 Scientific Data : (Tag 702) Ref 2 SciData description : (Tag 701) Ref 2 SciData max/min : (Tag 707) Ref 2 **Group 2: Numeric Data Group : (Tag 720) Ref 4 Scientific Data : (Tag 702) Ref 4 SciData description : (Tag 701) Ref 4 **These do not belong to any group: Version Descriptor : (Tag 30) Ref 1 Number Type : (Tag 106) Ref 2 Data Id Label : (Tag 104) Ref 3 Number Type : (Tag 106) Ref 4 Data Id Label : (Tag 104) Ref 5 hdfed>
Syntax: prev predicate list Flags: None. Description: Moves to the next object that satisfies the predicate list. Usage Example: hdfed> info -all (1) Version Descriptor : (Tag 30) Ref 1 (2) Scientific Data : (Tag 702) Ref 2 (3) Number type : (Tag 106) Ref 2 (4) SciData description : (Tag 701) Ref 2 (5) SciData max/min : (Tag 707) Ref 2 *(6) Numeric Data Group : (Tag 720) Ref 2 (7) Data Id Label : (Tag 104) Ref 3 (8) Scientific Data : (Tag 702) Ref 4 (9) Number type : (Tag 106) Ref 4 (10) SciData description : (Tag 701) Ref 4 (11) Numeric Data Group : (Tag 720) Ref 4 (12) Data Id Label : (Tag 104) Ref 5 hdfed> hdfed> ! The '*' in the first column marks the current hdfed> ! position. hdfed> ! The 'next' and 'prev' commands work with predicates. hdfed> ! If I want to move to the max/min element, hdfed> ! I can use the 'tag=' predicate. hdfed> hdfed> prev tag=707 hdfed> info (5) SciData max/min (SciData) : (Tag 707) Ref:2 hdfed>
Syntax: next predicate list Flags: None. Description: Moves to the next object that satisfies the predicate. Usage Example: hdfed> ! Move in the file using next and prev hdfed> ! The move direction depends on the relative positions. hdfed> ! so it is often necessary to do an 'info -all' first. hdfed> info -all (1) Version Descriptor : (Tag 30) Ref 1 (2) Scientific Data : (Tag 702) Ref 2 (3) Number type : (Tag 106) Ref 2 (4) SciData description : (Tag 701) Ref 2 *(5) SciData max/min : (Tag 707) Ref 2 (6) Numeric Data Group : (Tag 720) Ref 2 (7) Data Id Label : (Tag 104) Ref 3 (8) Scientific Data : (Tag 702) Ref 4 (9) Number type : (Tag 106) Ref 4 (10) SciData description : (Tag 701) Ref 4 (11) Numeric Data Group : (Tag 720) Ref 4 (12) Data Id Label : (Tag 104) Ref 5 hdfed> hdfed> ! This predicate persists for the next and prev hdfed> ! commands. That means if I now type another 'next' hdfed> ! command, it will look for a tag that equals 707. hdfed> hdfed> next Reached end of file. Not moved. hdfed> info (5) SciData max.min (SciData) : (Tag 707) Ref: 2 hdfed> hdfed> next group hdfed> next group hdfed> info (11) Numeric Data Group : (Tag 720) Ref 4 hdfed>
Syntax: dump [-offset offset] [-length length] [-decimal|-short|-byte|-octal|-hexadecimal|-float| -double|-ascii] Flags: -offset Starting offset -length Length of the object to dump. -decimal Decimal format (32-bit integers) -short Decimal format (16-bit integers) -byte Decimal format (8-bit integers) -octal Octal format (the default) -hexadecimal Hexadecimal format -float Single-precision floating-point format (32-bit floats) -double Double-precision floating-point format (16-bit floats) -ascii ASCII format Description: Displays the contents of the current object in the specified format. Usage Example: hdfed> ! to see the binary representation of this element hdfed> hdfed> dump 0: 257400004 257200004 hdfed> hdfed> dump -short hdfed> 0: 702 4 701 4 hdfed>
Syntax: delete Flags: None. Description: Deletes the current object or group. Usage Example: hdfed> ! deleting groups hdfed> hdfed> ! If an element is required by other group it is alone. hdfed> ! However, this is not perfect as the method by which group hdfed> ! membership is determined can be pretty ad hoc. hdfed> hdfed> delete hdfed> ! This deletes the Scientific Data Group hdfed> info -all (1) Version Descriptor : (Tag 30) Ref 1 (2) Scientific Data : (Tag 702) Ref 2 (3) Number type : (Tag 106) Ref 2 (4) SciData description : (Tag 701) Ref 2 (5) SciData max/min : (Tag 707) Ref 2 (6) Numeric Data Group : (Tag 720) Ref 2 (7) Data Id Label : (Tag 104) Ref 3 (8) Number type : (Tag 106) Ref 4 (9) Data Id Label : (Tag 104) Ref 5 hdfed> hdfed> ! Notice that the Numeric Data Group with reference hdfed> ! number 4 is missing, and now there are only 9 hdfed> ! objects in the file. hdfed>
Syntax: annotate [-label] [-descriptor] [-editor editor] Flags: -label Edit a label (the default) -descriptor Edit a descriptor. -editor Use an editor. (Default is the editor referred to by the EDITOR environment variable. Description: Edits an annotation. Usage Example: hdfed> hdfed> ! Annotations are labels and descriptors hdfed> hdfed> prev -group hdfed> info -label (6) Numeric Data Group : (Tag 720) Ref 2 Label: Experiment #1 hdfed> annotate -editor /usr/ucb/ex "/tmp/he5091.1" 1 line, 14 characters :p Experiment #1 :s/$/ <more stuff>/ Experiment #1 <more stuff> :wq "/tmp/he5091.1" 1 line 27 characters hdfed> info -label (6) Numeric Data Group : (Tag 720) Ref 2 Label: Experiment #1 <more stuff> hdfed>
Syntax: write [-attachto tag reference number] filename Flags: -attachto Which element the annotation will be attached to. (only for writing annotations) Description: Writes an element or group into another HDF file. Usage Example: hdfed> hdfed> ! Write object or group to another HDF file. hdfed> hdfed> write test hdfed> hdfed> ! Let's take a look at the file 'test' hdfed> close; open test; info -all (1) Version Descriptor (Tag 30) Ref 1 (2) Scientific Data (Tag 702) Ref 2 (3) Number type (Tag 106) Ref 2 (4) SciData description (Tag 701) Ref 2 (5) SciData max/min (Tag 707) Ref 2 *(6) Numeric Data Group (Tag 720) Ref 2 hdfed> hdfed> close; hdfed>
Syntax: display [-position x-position y-position] [-expansion expansion] [-large] Flags: -position Image position on console screen -expansion Image expansion factor -large Make image as large as possible. Description: Displays image on screen. Usage Example: hdfed> ! We will open a file with some RIS8 images. hdfed> hdfed> open denm,HDF hdfed> display hdfed> hdfed> ! The 'display' command displays the current RIS8 hdfed> ! group image via ICR. I.e. if you are using NCSA Telnet hdfed> ! on a Mac II, this would display the images from denm.HDF hdfed> ! on your screen. hdfed> ! NOTE: not guaranteed to work otherwise. hdfed>
Syntax: putr8 [-image image filename palette filename] -verbose] Flags: -image Image file name template (Default is "img#.@.%") -palette Palette file name template (Default is "pal#") -verbose To give output of steps taken. Description: Writes a RIS8 group into raw image and palette files. Usage Example: hdfed> ! putr8 puts an RIS8 group into raw files hdfed> hdfed> putr8 -image my_image.#.@.% -palette testPalettes# -verbose Writing to file: my_image8.10.10 Writing to file: my_palette hdfed>
Syntax: close [-keep] Flags: -keep The backup file is not deleted. Description: Closes the HDF file opened by the last open command. Usage Example: hdfed> close hdfed>
Syntax: select predicate list command list Flags: None. Description: Step through all the elements in the HDF file that satisfies the predicates, and execute the command list. Usage Example: hdfed> ! To step through a file and, for example, putr8 on all hdfed> ! RIS8 groups we can use the select command. hdfed> hdfed> select tag=306 >> putr8 -image testImages# -palette testPalettes# -verbose >> end Writing to file: testImages8 Writing to file: testPalettes8 Writing to file: test Images14 Writing to file: testPalettes14 Writing to file: testImages21 Writing to file: testPalettes21 hdfed> hdfed> ! The 'select' and 'if' commands take the same hdfed> ! predicates as 'next' and 'pref'. There are also hdfed> ! the predicates 'succeed" and "fail" that test the hdfed> ! return status of the 'last' command. hdfed>
Syntax: put [-file filename] [-verbose] Flags: -file Output file name (Default is "elt#.@") -verbose Output diagnostic information. Description: Writes the raw binary image of the current object to a file. Usage Example: hdfed> ! The 'put' command writes an element into a binary file. hdfed> ! This is a dumb routine and does not know about the hdfed> ! formats of an element. hdfed> hdfed> put -file binary# hdfed> put -file myBinary -verbose Writing to file: myBinary hdfed>
Syntax: revert Flags: None. Description: Discards all changes made in the current hdfed session. Usage Example: hdfed> revert hdfed>
Syntax: getr8 image file name [x-dimension y-dimension] [-palette palette file name] [-raster|-rle|-imcomp] Flags: -palette Palette will be read from a binary file. -raster No compression will be performed during the write. (the default) -rle Run-length compression will be performed during the write. -imcomp IMCOMP compression will be performed during the write. Description: Reads a RIS8 group from binary files.
Syntax: if predicate list command list end Flags: None. Description: Executes commands in a loop if predicates are satisfied for each element processed.
Syntax: select predicate list command list end Flags: None. Description: Executes the list of commands for each element that satisfies the predicates.
Syntax: wait message Flags: None. Description: Prints a message, then waits for a carriage return to be typed.
14.2.3 Converting Floating-Point Data to SDS or RIS8: fp2hdf
14.2.3.1 General Description
The fp2hdf utility converts 32-bit floating-point arrays from either text files or 32-bit HDF floating-point scientific data sets to either 8-bit HDF raster image sets or 32-bit floating-point HDF scientific data sets, or both, and stores the results in an HDF file. (See Figure 14a.) The images can be scaled on a user-specified mean value.
The term scale is used to refer to the area between points on the axes. If these gaps are of equal size, a uniform scale is specified - for example, "1.0, 2.0, 3.0, . . . ". In an HDF file, scales may be omitted, but in a text file (as in the text file shown below) they must be included.
FIGURE 14a The fp2hdf Utility
14.2.3.2 Command-Line Syntax
The syntax of fp2hdf is as follows.
fp2hdf input filename [-o output filename] [-r] [-f] [-e | -i] horizontal resolution vertical resolution [-p palette filename] [-m mean]
The input filename parameter is the name of the file containing the unconverted data set in HDF format. If the format is text, see the discussion on the following page about how it must be organized.
The -e and the -i flags cannot be used simultaneously. Either pixel interpolation or bilinear interpolation can be chosen for image expansion, but not both.
number of rows number of columns maximum value minimum value scale for the vertical axis in an array scale for the horizontal axis in an array data element 1 data element 2 data element 3 ...
The arrays that contain the scale for the vertical and horizontal axes must have a size equal to the values specified in the number of rows and number of columns positions, respectively. The data elements are floating-point data and are assumed to be ordered by rows, left-to-right and top-to-bottom.
14.2.3.3 Examples
This is the fp2hdf command-line syntax used to convert floating-point data in the file named "infile1.txt" to the SDS format, and to store it as an SDS in the HDF output file "outfile1".
fp2hdf infile1.txt -o outfile1
fp2hdf infile2 -o outfile2 -r
fp2hdf infile3.txt -o outfile3 -r -f
fp2hdf input4.txt -o outfile4 -r -e 500 600 -p palfile
fp2hdf f* -o outfile5 -r -i 500 600
14.2.4 Converting Several RIS8 Images to One 3D SDS: ristosds
14.2.4.1 General Description
The ristosds utility creates a single HDF file consisting of a three-dimensional SDS from a set of HDF files containing one or more raster images. All images in the input HDF files must have the same dimensions. If a palette is to be included with the images, it should be in the first HDF input file. Only one palette can be associated with the images; any additional palette data encountered by the utility after the first palette has been processed will be ignored. 14.2.4.2 Command-Line Syntax
ristosds input filename 1, input filename 2, ... input filename n [-o output filename]
14.2.4.3 Examples
The contents of a directory consists of 20 files named "storm001.hdf", "storm002.hdf". ... "storm020.hdf". Each file contains a single RIS8 with a 100 x 200 raster image. A file that combines these 20 raster images into a 32-bit floating-point SDS with the dimensions 100 x 200 x 20 can be created with the following ristosds command:
ristosds storm*.hdf -o storm.hdf
14.2.5 Converting 8-Bit Raster Images to the HDF Format: r8tohdf
14.2.5.1 General Description
The r8tohdf utility converts a set of raw raster images to the HDF RIS8 format and writes them to a file. 14.2.5.2 Command-Line Syntax
r8tohdf [number of rows number of columns] output filename [-p palette filename] [-c|-r|-i] raw raster image filename 1, raw raster image filename 2, ... raw raster image filename n
14.2.5.3 Examples
A file named "rawras" contains a 256 x 512-byte raw raster image, and its palette is stored in a file name "mypal". To convert the information in these files to an RIS8 without compression and store the RIS8 in a file named "ras.hdf", enter the following r8tohdf command:
r8tohdf 256 512 ras.hdf -p mypal rawras
r8tohdf 800 1000 bigpic.hdf -c bigpic
r8tohdf 300 400 pic.hdf -i pic1 pic2 pic3
r8tohdf 256 512 ras.hdf -c rawras1 -p mypal rawras2 -r rawras3
14.2.6 Extracting 8-Bit Raster Images and Palettes from HDF Files: hdftor8
14.2.6.1 General Description
The hdftor8 utility extracts the raster images and/or palettes from an HDF file and stores them in one file that contains the raster image data and another that contains the palette data. 14.2.6.2 Command-Line Syntax
hdftor8 input HDF filename [-i] [-v] [-r raster image filename] [-p palette filename]
.#.@.%
where "#" represents the raster image number from the HDF file, "@" represents the x-dimension of the raster image and "%" represents the y-dimension of the raster image. For each palette file, the file name is given the extensions ".#", where "#" represents the palette number from the HDF format file.
14.2.6.3 Examples
A file named "denm.hdf" contains three 512 x 256 raster images and three palettes. To store these images and palettes in separate raster image and palette files, use the following hdftor8 command:
hdftor8 denm.hdf
Six files are created, named "img1.512.256:", "img2.512.256", "img3.512.256", "pal.1", "pal.2", and "pal.3".
14.2.7 Compressing RIS8 Images in an HDF File: hdfcomp
14.2.7.1 General Description
The hdfcomp utility reads RIS8 images from a set of HDF files, compresses them and stores the compressed data in a second HDF file. If the output HDF file exists, the compressed images will be appended to it. 14.2.7.2 Command-Line Syntax
hdfcomp output filename [-c|-r|-i] input filename 1, [-c|-r|-i] input filename 2, ... [-c|-r|-i] input filename n
14.2.7.3 Examples
A directory contains twenty files named "storm001", "storm002", ... "storm020". Each of these files contains a single RIS8 image. To compress these images using run-length encoding and store them in a file named"altcomp.hdf", use the following hdfcomp command:
hdfcomp allcomp.hdf -c storm*.hdf
14.2.8 Converting 24-Bit Raw Raster Images to RIS8 Images: r24hdf8
14.2.8.1 General Description
The r24hdf8 utility quantizes a raw RGB 24-bit raster image, creating an 8-bit image with a 256-color palette, then it stores the palette and raster image data in an HDF file. 14.2.8.2 Command-Line Syntax
r24hdf8 [x-dimension length y-dimension length] raw 24-bit image filename hdf ris8 image filename
The pixel order in the raw 24-bit image file is left-to-right and top-to-bottom. Each pixel data element consists of three contiguous bytes, the first representing the red intensity value, the second the green intensity value, and the third the blue intensity value. Use the ptox filter to convert the raster image data from a pixel-interlaced format to scan-plane interlaced.
14.2.8.3 Examples
A file named "rawraster" containing 24-bit raw raster images with x and y-dimensions of 480 x 640, respectively, must be converted to the HDF RIS8 format and stored in a file named "hdfraster". The following command is used to do this:
r24hdf8 480 640 rawraster hdfraster
14.2.9 Converting an HDF RIS24 Image to an HDF RIS8 Image: hdf24hdf8
14.2.9.1 General Description
The hdf24hdf8 utility quantizes an HDF RGB RIS24 pixel-interlaced image, producing an HDF RIS8 image with a 256-color palette and stores the palette and raster image data in an HDF file. 14.2.9.2 Command-Line Syntax
hdf24hdf8 ris24 image filename ris8 image filename
14.2.10 Converting Raw Palette Data to the HDF Palette Format: paltohdf
14.2.10.1 General Description
The paltohdf utility converts raw palette data to the HDF palette format. The raw palette data must have 768 bytes organized in the following order: first, 256 contiguous red intensity values, then 256 contiguous green intensity values, then 256 contiguous blue intensity values. The palette in the HDF file will have the RGB values pixel-interlaced, as follows.
red value green value blue value red value green value blue value ...
This is the standard HDF format for 8-bit palettes.
14.2.10.2 Command-Line Syntax
paltohdf raw format palette filename HDF format palette filename
If a HDF palette format file is specified that doesn't exist, it is created before the converted data is stored. If an HDF palette format file is specified that already exists, the converted data is appended to the file.
14.2.11 Extracting Palette Data from an HDF File: hdftopal
14.2.11.1 General Description
The hdftopal utility converts a palette in an HDF file to a raw palette in an non-HDF file. The raw palette will have 768 bytes with the first 256 bytes representing red intensity values, the second 256 bytes representing green intensity values, and the third 256 bytes representing blue intensity values. The utility performs the converse operation of the paltohdf utility. 14.2.11.2 Command-Line Syntax
hdftopal HDF format palette filename raw format palette filename
14.2.12 Compressing an HDF File: hdfpack
14.2.12.1 General Description
The hdfpack utility compresses all of the data in an HDF file and writes the compressed data to a second HDF file. 14.2.12.2 Command-Line Syntax
hdfpack [-i|-b] [-d number of data descriptors per block] [-t number of linked blocks per table entry] input HDF filename output HDF filename
14.2.12.3 Examples
To compress the data in the file named "aa.hdf" and store the compressed data in the file named "aa.cmp", use the following hdfpack command:
hdfpack aa.hdf aa.cmp
hdfpack -b bb.hdf bb.blk
14.2.13 Displaying Vdata Information: vshow
14.2.13.1 General Description
Displays information about either one Vdata object in an HDF file, or all Vdata objects in the file. 14.2.13.2 Command-Line Syntax
vshow input HDF filename [+|+vdata id]
14.2.13.3 Examples
Information about all of the Vdata objects in the HDF file named "image012.hdf" must be examined. The following command will display this information.
vshow image012.hdf +
14.2.14 Displaying General Information About the Contents of an HDF File: hdp
14.2.14.1 General Description
The hdp utility provides quick and general information about all objects in the specified HDF file. It can list the contents of HDF files at various levels with different details. It can also dump the data of one or more specific objects in the file. 14.2.14.2 Command-Line Syntax
hdp [-H command] filename
-H
|
Help
|
Displays usage information about the specified command. If no command is listed, information about all commands are displayed.
|
Like hdfed, hdp provides a set of commands that allow the user to determine what kind of information is to be displayed.
TABLE 14C The hdp Command Set
The list command
Syntax: list [-s|-l|-d] [-n|-c|-a] [-g|-t number name] [-ot|-of|-og|-on] message Flags: -s Short format. -l Long format. -d Debug format. -n Display the object name. -c Display the object class. -a Display the object description. -g Display groups only. -t Display objects with the specified tag number or name. -ot Sort by tag. -of Sort by position in the data descriptor list. -og Sort by group. -on Sort by name. Description: Display the contents of the HDF files in the specified format. As with the 'info' command, the listing for specialelements will contain a special tag value (for DFTAG_VS it's 18347) and the text "Unknown Tag".
Syntax: dumpsds [-i index | -r ref list | -n name list | -a] [-v|-h|-d] [-o filename | -b | -t] Flags: -i Dump SDSs with the specified index. -r Dump SDSs with the specified reference numbers. -n Dump SDSs with the specified names. -a Dump all SDSs. -v Display all SDS contents including annotations. -h Display the SDS header only. -d Display the SDS data only. -o Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. Description: Displays SDS information in the specified format.
Syntax: dumpvd [-i index | -r ref list | -n name list | -c class | [-a] [-v|-h|-f|-d] [-o filename | -b | -t] Flags: -i Dump vdatas with the specified index. -r Dump vdatas with the specified reference numbers. -c Dump vdatas with the specified class. -n Dump vdatas with the specified names. -a Dump all vdatas. -v Display all vdata contents including annotations. -h Display the vdata header only. -d Display the vdata data only. -f Display the vdata field data only. -o Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. Description: Displays vdata information in the specified format.
Syntax: dumpvg [-i index | -r ref list | -n name list | -c class | [-a] [-v|-h|-d] [-o filename | -b | -t] Flags: -i Dump vgroups with the specified index. -r Dump vgroups with the specified reference numbers. -c Dump vgroups with the specified class. -n Dump vgroups with the specified names. -a Dump all vgroups. -v Display all vgroup contents including annotations. -h Display the vgroup header only. -d Display the vgroup data only. -o Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. Description: Displays vgroup information in the specified format.
Syntax: dumprig [-i index | -r ref list | -m <8, 24> | [-a] [-v|-h|-d] [-o filename | -b | -t] Flags: -i Dump RIGs with the specified index. -r Dump RIGs with the specified reference numbers. -m Dump RIGs with the specified data length - 8- or 24-bit. -a Dump all RIGs. -v Display RIG contents including annotations. -h Display the RIG header only. -d Display the RIG data only. -o Print information to the specified file. -b Specify output file as binary. -t Specify output file as text. Description: Displays RIG information in the specified format.
14.2.15 The HDF User-Contributed Utilities
In addition to the command-line utilities supported by NCSA, a number of utilities have been contributed by HDF users. Although they are not supported by NCSA, these utilities are distributed by NCSA via anonymous ftp at hdf.ncsa.uiuc.edu in the "/pub/dist/HDF/contrib" directory. These utilities, which are listed and briefly described in Table 14D, will not be discussed in this manual.
Note that this list is current as of the release date of this manual. A updated list of all of the user-contributed HDF utilities is available in the "README" file at the HDF ftp site and directory location mentioned above.
TABLE 14D HDF User-Contributed Utilities