Penguin

HDF

HDF

NAME SYNOPSIS DESCRIPTION DOCUMENTATION VENDOR VERSION LICENSE CONTACT FILES SEE ALSO


NAME

hdf - Hierarchical Data Format library

SYNOPSIS

-lmfhdf -ldf -ljpeg -lz

{HDFLIBDIR}/libmfhdf.a {HDFLIBDIR}/libdf.a {HDFLIBDIR}/libjpeg.a {HDFLIBDIR}/libz.a

DESCRIPTION

HDF is a multi-object file format that facilitates the transfer of various types of scientific data between machines and operating systems. Machines currently supported include the Cray, HP, Vax, Sun, IBM RS/6000, Silicon Graphics, Macintosh, and IBM PC computers. HDF allows self-definitions of data content and easy extensibility for future enhancements or compatibility with other standard formats. HDF includes Fortran and C calling interfaces,and utilities to prepare raw image of data files or for use with other NCSA software. The HDF library contains interfaces for storing and retrieving compressed or uncompressed 8-bit and 24-bit raster images with palettes, n-Dimensional scientific datasets and binary tables. An interface is also included that allows arbitray grouping of other HDF objects.

HDF Raster Images

HDF supports the storing of both 8-bit and 24-bit raster images. As well as storing information about the dimensions and palette of a raster image, HDF supports raster image compression. In previous versions of HDF, Run-length encoding and Imcomp compression were both supported. With HDF

HDF Scientific Data Sets

Scientific Data Sets (SDSs) are useful for storing n-Dimensional gridded data. The actual data in the dataset can be of any of the

  • The coordinate system to use when interpreting or displaying the data.
  • Scales to be used for each dimension.
  • Labels for each dimension and the dataset as a whole.
  • Units for each dimension and the data.
  • The valid max and min values for the data.
  • Calibration information for the data.
  • Fill or missing value information.
  • Ability of have more than one file open at a time.
  • A more general framework for meta-data within the SDS data-model

(allowing 'name = value' styel meta-data).

  • Support for an

HDF Annotations

Any object in an HDF file can have annotations associated with it. There are a number of types of annotations:

  • Labels are assumed to be short strings giving the

HDF Vset Interfaces

The Vset module provides interfaces to two basic HDF building blocks. Vgroups are generic grouping elements allowing a user to associate related objects within an HDF file. As Vgroups can contain other Vgroups, it is possible to build a hierarchical file. Vdatas are data structures made up of fields and records. Data is organized into 'fields' within each Vdata. Each field is identified by a unique 'fieldname'. The type of each field may be any of the basic number types that HDF supports. Fields of different types may exist within the same Vdata.

By combining Vdatas in Vgroups it is possible to represent higher level data constructs: mesh data, multi-variate datasets, sparse matrices, finite-element data, spreadsheets, splines, non-Cartesian coordinate data, etc.

HDF

HDF

EXAMPLES

All HDF routines require the header

To compile a program that makes HDF calls on most Unix platforms.

HDFINC = /usr/include/hdf (FORTRAN): f77 myprog.f -I{HDFINC} -o myprog -lmfhdf -ldf -ljpeg -lz (C): cc myprog.c -I{HDFINC} -o myprog -lmfhdf -ldf -ljpeg -lz

DOCUMENTATION

The HDF WWW page is located at http://hdf.ncsa.uiuc.edu/

For the vast majority of users, the

You may download the documentation via ftp on NCSA's anonymous ftp server. (ftp.ncsa.uiuc.edu:/HDF). On anonymous ftp there the documentation is available in Postscript, PDF and MIF.

VENDOR

NCSA Software Development Division

Hierarchical Data Format Group

152 Computing Applications Bldg.

605 E. Springfield Ave.

Champaign, IL 61820

VERSION

4.1

LICENSE !!

UNIVERSITY OF ILLINOIS (UI), NATIONAL CENTER FOR SUPERCOMPUTING APPLICATIONS (NCSA), Software Distribution Policy for Public Domain Software

NCSA HDF Version 4.1 source code and documentation are in the public domain, available without fee for education, research, non-commercial and commercial purposes. Users may distribute the binary or source code to third parties provided that this statement appears on all copies and that no charge is made for such copies.

UI MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THE SOFTWARE FOR ANY PURPOSE. IT IS PROVIDED

We ask, but do not require that the following message be include in all derived works:

Portions developed at the National Center for Supercomputing Applications at the University of Illinois at Urbana-Champaign.

By copying this program, you, the user, agree to abide by the conditions and understandings with respect to any software which is marked with a public domain notice.

Acknowledgements: ----------------

Portions of this software were developed by the Unidata Program at the University Corporation for Atmospheric Research, specifically the NETCDF distribution used.

This product also includes software developed by the Independent JPEG Group, specifically the IJPEG library libjpeg.a.

This product also includes software developed by Jean-loup Gailly and Mark Adler , specifically the ZLIB library libz.a.

This product includes software developed by the University of California, Berkeley and its contributors.

CONTACT !!

NCSA Software Deveopment Division

Hierarchical Data Format Group

email: hdfhelp@ncsa.uiuc.edu

FILES

/usr/lib/hdf/{libmfhdf,libdf,libjpeg,libz}.{a,so}

hdf libraries

/usr/bin Location of most hdf utilities

/usr/include/hdf Location of include file hdf.h and others

SEE ALSO

hdfls(1)?, hdfpack(1)?, hdfunpac(1)?, hdp(1)?


This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.