[Top] [Prev] [Next]

15.2 Displaying Data Contained in and General Information About the Contents of an HDF File: hdp (or HDF Dumper)

15.2.1 General Description

The hdp utility, also known as the HDF dumper, 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.

15.2.2 Command-line Syntax

hdp [ [-H command ] | [command ] ] filelist
The hdp option flags are described in Table 15B:

TABLE 15B
-H

Help:

Displays usage information about the specified command. If no command is listed, information about all commands are displayed.

hdp Option Flags

Like hdfed, hdp provides a set of commands that allow the user to determine what kind of information is to be displayed.

TABLE 15C - The hdp Command Set

Name
Description
list Displays the contents of the HDF files in the specified format.

dumpsds Displays the contents of the SDSs in the listed files.

dumpgr Displays the contents of the raster images in the listed files.

dumpvd Displays the contents of the vdata objects in the listed files.

dumpvg Displays the contents of the vgroup objects in the listed files.

dumprig Displays the contents of the RIGs in the listed files.

The list command

Syntax:	list [-acensldg] [-o<f|g|t|n>] [-t tag ] filelist
Flags:
	-a	Print annotations of selected items. (Sets long output.)
	-c	Print classes of selected items. (Sets long output.)
	-n	Print names or labels of selected items. (Sets long output.)
	-e	Print special element information for selected items. (Sets long output.)

	-s	Set output to short format.
	-l	Set output to long format.
	-d	Set output to debuffing format.

	-g	Display information for groups only.
	-t number	Display information for objects with the given tag number.
	-t name	Display information for objects with the given name.

	-of	Print items in the order found in the file.
	-og	Print items in group order.
	-ot	Print items in tag order. (default)
	-on	Print items in name or label order.

	filelist	Names of HDF input files, separated by spaces.
Description: Displays the contents of the HDF files in the specified format. As with the hdfed info command, the listing for special elements will contain a special tag value (for DFTAG_VS, it is 18347) and the text Unknown Tag.

The dumpsds command

Syntax:	hdp dumpsds [-a | -i indices | -r refs | -n names ] [-v | -h | -d] 
		[-o filename ] [-bx] filelist
Flags:	-a	Dump all SDSs in the file(s). (default)
	-i indices	Dump the SDSs at the positions listed in indices.
	-r refs	Dump the SDSs with reference numbers listed in refs.
	-n names	Dump the SDSs with names listed in names.

	-v	Dump all SDS contents, including annotations. (default)
	-h	Dump SDS header information only, no data or element annotations.
	-d	Dump SDS data only, no tag/ref or header information. Output is formatted for input to fp2hdf.

	-o filename	Print output to the file filename.
	-b	Output in binary format.
	-x	Output in ASCII format. (default)
	filelist	Names of HDF input files, separated by spaces.
Description: Displays SDS information in the specified format. The -r, -i, and -n flags can be selected together.

The dumpgr commad

Syntax:	hdp dumpgr [-a | -i indices | -r refs | -n names ] 
		[-v | -h | -d | -p] [-o filename ] [-bx] filelist
Flags:	-a	Dump all raster images (RIs) in the file(s). (default)
	-i indices	Dump the RIs indicated in indices.
	-r refs	Dump the RIs with reference numbers listed in refs.
	-n names	Dump the RIs with names listed in names.

	-v	Dump all RI contents, including all annotations. (default)
	-h	Dump RI header information only, no data or element annotations.
	-d	Dump RI data only, no tag/ref or header information. Output is formatted for input to fp2hdf.
	-p	Dump palette information for the requested images or for all images if no specific image is requested. With -h, dump only palette header information and no data; with -d, dump palette data and no header information; with -v or without any of -h, -d, or -v, dump palette data and header information.

	-o filename	Print output to file filename.
	-b	Output in binary format.
	-x	Output in ASCII format. (default)
	filelist	Names of HDF input files, separated by spaces.
Description: Displays GR raster image information in the specified format. The -r, -i, and -n flags can be selected together. GR images are always stored in pixel interlace mode (see Section 8.5.1 on page 264).



The dumpvd command

Syntax:	hdp dumpvd [-a | -i indices | -r refs | -n names | -c classes | 
		-f f1, f2, ...] [-v | -h | -d] [-o filename ] [-bx]
		filelist
Flags:	-a	Dump all vdatas in the file(s). (default)
	-i indices	Dump the vdatas at positions listed in indices.
	-r refs	Dump the vdatas with the reference numbers listed in refs.
	-n names	Dump all the vdatas with names listed in names.
	-c classes	Dump all the vdatas with the classes listed listed in classes.
	-f f1, f2, ...	
		Dump data based on the indicated fields in the vdata header.

	-v	Dump everything, including annotations. (default)
	-h	Dump vdata header information only, no data or element annotations.
	-d	Dump vdata data only, no tag/ref or header information. Output is formatted for input to fp2hdf.

	-o filename	Print output to file filename.
	-b	Output in binary format.
	-x	Output in ASCII format. (default)
	filelist	Names of HDF input files, separated by spaces.
Description: Displays vdata information in the specified format. The -r, -i, -n, and -c flags can be selected together.

The dumpvg command

Syntax: 	dumpvg [-a | -i indices | -r refs | -n names | -c classes ] 
		[-v | -h ] [-o filename ] filelist
Flags:	-a	Dump all vgroups in the file(s). (default)
	-i indices	Dump the vgroups at positions listed in indices.
	-r refs	Dump the vgroups with the reference numbers listed in refs.
	-n names	Dump all the vgroups with names listed in names.
	-c classes	Dump all the vgroups with classes listed in classes.

	-v	Dump everything, including annotations. (default)
	-h	Dump vgroup header information only, no data or element annotations.

	-o filename	Print output to file filename.
	filelist	Names of HDF input files, separated by spaces.
Description: Displays vgroup information in the specified format. The -r, -i, -n, and -c flags can be selected together. This command has no binary output option; it produces only ASCII text output.

The dumprig command

Syntax:	dumprig [-a | -i indices | -m n | -r refs ] [-dhv] 
		[-o filename [-b | -x]] filelist
Flags:	-a	Dump all RIGs in the specified file(s). (default)
	-i indices	Dump theRIGs with the positions listed in indices.
	-m n	Dump only RIGs with the specified data length. n can have a value of 8 or 24, for 8- or 24-bit raster images, respectively.
	-r refs	Dump the RIGs with the reference numbers listed in refs.

	-d	Dump RIG data only, no tag/ref or header information. Output is formatted for input to fp2hdf.
	-h	Dump RIG header information only, no data or element annotations.
	-v	Dump everything, including annotations. (default)

	-o filename	Print output to file filename.
	-b	Output in binary format.
	-x	Output in ASCII format. (default)
	filelist	Names of HDF input files, separated by spaces.
Description: Displays RIG information in the specified format. The -r, -i, and -m flags can be selected together.



[Top] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 05/19/99, NCSA HDF Development Group.