Penguin
Recent Changes
Annotated edit history of hdf(5) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 HDF
2 !!!HDF
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 DOCUMENTATION
7 VENDOR
8 VERSION
9 LICENSE
10 CONTACT
11 FILES
12 SEE ALSO
13 ----
14 !!NAME
15
16
17 hdf - Hierarchical Data Format library
18 !!SYNOPSIS
19
20
21 __-lmfhdf -ldf -ljpeg -lz__
22
23
24 __{HDFLIBDIR}/libmfhdf.a {HDFLIBDIR}/libdf.a
25 {HDFLIBDIR}/libjpeg.a {HDFLIBDIR}/libz.a__
26 !!DESCRIPTION
27
28
29 HDF is a multi-object file format that facilitates the
30 transfer of various types of scientific data between
31 machines and operating systems. Machines currently supported
32 include the Cray, HP, Vax, Sun, IBM RS/6000, Silicon
33 Graphics, Macintosh, and IBM PC computers. HDF allows
34 self-definitions of data content and easy extensibility for
35 future enhancements or compatibility with other standard
36 formats. HDF includes Fortran and C calling interfaces,and
37 utilities to prepare raw image of data files or for use with
38 other NCSA software. The HDF library contains interfaces for
39 storing and retrieving compressed or uncompressed 8-bit and
40 24-bit raster images with palettes, n-Dimensional scientific
41 datasets and binary tables. An interface is also included
42 that allows arbitray grouping of other HDF
43 objects.
44
45
46 __HDF Raster Images__
47
48
49 HDF supports the storing of both 8-bit and 24-bit raster
50 images. As well as storing information about the dimensions
51 and palette of a raster image, HDF supports raster image
52 compression. In previous versions of HDF, Run-length
53 encoding and Imcomp compression were both supported. With
54 HDF
55
56
57 __HDF Scientific Data Sets__
58
59
60 Scientific Data Sets (SDSs) are useful for storing
61 n-Dimensional gridded data. The actual data in the dataset
62 can be of any of the
63
64
65 o The coordinate system to use when interpreting or displaying the data.
66 o Scales to be used for each dimension.
67 o Labels for each dimension and the dataset as a whole.
68 o Units for each dimension and the data.
69 o The valid max and min values for the data.
70 o Calibration information for the data.
71 o Fill or missing value information.
72 o Ability of have more than one file open at a time.
73 o A more general framework for meta-data within the SDS data-model
74 (allowing 'name = value' styel meta-data).
75 o Support for an
76
77
78 __HDF Annotations__
79
80
81 Any object in an HDF file can have annotations associated
82 with it. There are a number of types of
83 annotations:
84
85
86 o Labels are assumed to be short strings giving the
87
88
89 __HDF Vset Interfaces__
90
91
92 The Vset module provides interfaces to two basic HDF
93 building blocks. Vgroups are generic grouping elements
94 allowing a user to associate related objects within an HDF
95 file. As Vgroups can contain other Vgroups, it is possible
96 to build a hierarchical file. Vdatas are data structures
97 made up of fields and records. Data is organized into
98 'fields' within each Vdata. Each field is identified by a
99 unique 'fieldname'. The type of each field may be any of the
100 basic number types that HDF supports. Fields of different
101 types may exist within the same Vdata.
102
103
104 By combining Vdatas in Vgroups it is possible to represent
105 higher level data constructs: mesh data, multi-variate
106 datasets, sparse matrices, finite-element data,
107 spreadsheets, splines, non-Cartesian coordinate data,
108 etc.
109
110
111 __HDF __
112
113
114 HDF
115
116
117 __EXAMPLES__
118
119
120 All HDF routines require the header
121
122
123 To compile a program that makes HDF calls on most Unix
124 platforms.
125
126
127 HDFINC = /usr/include/hdf
128 (FORTRAN):
129 f77 myprog.f -I{HDFINC} -o myprog -lmfhdf -ldf -ljpeg -lz
130 (C):
131 cc myprog.c -I{HDFINC} -o myprog -lmfhdf -ldf -ljpeg -lz
132 !!DOCUMENTATION
133
134
135 The HDF WWW page is located at
136 http://hdf.ncsa.uiuc.edu/
137
138
139 For the vast majority of users, the
140
141
142 You may download the documentation via ftp on NCSA's
143 anonymous ftp server. (ftp.ncsa.uiuc.edu:/HDF). On anonymous
144 ftp there the documentation is available in Postscript, PDF
145 and MIF.
146 !!VENDOR
147
148
149 NCSA Software Development Division
150
151
152 Hierarchical Data Format Group
153
154
155 152 Computing Applications Bldg.
156
157
158 605 E. Springfield Ave.
159
160
161 Champaign, IL 61820
162 !!VERSION
163
164
165 4.1
166 !!LICENSE !!
167
168
169 UNIVERSITY OF ILLINOIS (UI), NATIONAL CENTER FOR
170 SUPERCOMPUTING APPLICATIONS (NCSA), Software Distribution
171 Policy for Public Domain Software
172
173
174 NCSA HDF Version 4.1 source code and documentation are in
175 the public domain, available without fee for education,
176 research, non-commercial and commercial purposes. Users may
177 distribute the binary or source code to third parties
178 provided that this statement appears on all copies and that
179 no charge is made for such copies.
180
181
182 UI MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THE
183 SOFTWARE FOR ANY PURPOSE. IT IS PROVIDED
184
185
186 We ask, but do not require that the following message be
187 include in all derived works:
188
189
190 Portions developed at the National Center for Supercomputing
191 Applications at the University of Illinois at
192 Urbana-Champaign.
193
194
195 By copying this program, you, the user, agree to abide by
196 the conditions and understandings with respect to any
197 software which is marked with a public domain
198 notice.
199
200
201 Acknowledgements: ----------------
202
203
204 Portions of this software were developed by the Unidata
205 Program at the University Corporation for Atmospheric
206 Research, specifically the NETCDF distribution
207 used.
208
209
210 This product also includes software developed by the
211 Independent JPEG Group, specifically the IJPEG library
212 libjpeg.a.
213
214
215 This product also includes software developed by Jean-loup
216 Gailly and Mark Adler , specifically the ZLIB library
217 libz.a.
218
219
220 This product includes software developed by the University
221 of California, Berkeley and its contributors.
222 !!CONTACT !!
223
224
225 NCSA Software Deveopment Division
226
227
228 Hierarchical Data Format Group
229
230
231 email: hdfhelp@ncsa.uiuc.edu
232 !!FILES
233
234
235 __/usr/lib/hdf/{libmfhdf,libdf,libjpeg,libz}.{a,so}__
236
237
238 hdf libraries
239
240
241 __/usr/bin__ Location of most hdf utilities
242
243
244 __/usr/include/hdf__ Location of include file hdf.h and
245 others
246 !!SEE ALSO
247
248
249 hdfls(1), hdfpack(1), hdfunpac(1),
250 hdp(1)
251 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.