#*****************************************************************************
# 
#			  NCSA HDF version 3.10r3
#				Dec 6, 1990
#
# NCSA HDF Version 3.10r3 source code and documentation are in the public
# domain.  Specifically, we give to the public domain all rights for future
# licensing of the source code, all resale rights, and all publishing rights.
# 
# We ask, but do not require, that the following message be included in all
# derived works:
# 
# Portions developed at the National Center for Supercomputing Applications at
# the University of Illinois at Urbana-Champaign.
# 
# THE UNIVERSITY OF ILLINOIS GIVES NO WARRANTY, EXPRESSED OR IMPLIED, FOR THE
# SOFTWARE AND/OR DOCUMENTATION PROVIDED, INCLUDING, WITHOUT LIMITATION,
# WARRANTY OF MERCHANTABILITY AND WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE
# 
#*****************************************************************************

***********************************************************************

			NCSA HDF version 3.10
                           July 1, 1990
***********************************************************************

This is NCSA HDF version 3.10.  Suggestions and bug reports are welcome.

Included in this version are:
	the basic low-level routines to perform I/O to HDF files, 
	routines to process 8-bit Raster Image Sets
	routines to process Scientific Data Sets.
	routines to process 24-bit Raster Image Sets
	routines to extract slabs from Scientific Data Sets
	routines to process Palettes (independently of images)
	routines to process Annotations for data items

NCSA HDF is the Hierarchical Data Format, a standard file format 
developed by NCSA.  For more information about HDF, see the 
January/February 1989 NCSA Data Link article, the document "NCSA HDF", and 
the document "HDF  Specification".

This version of HDF runs on CRAYs running UNICOS, ALLIANTs, SUNs and 
IRIS 4D machines running Unix, MACs running MacOS, VAXen running VMS and 
PCs running MS/DOS.

Compilation of these programs produces a library of HDF routines that 
can be called from either FORTRAN or C programs.

There is an older version of HDF implemented for CRAYs running CTSS, available
from NCSA.  This version only implements the 8-bit Raster Image Set.  If you
are interested in this, please contact Mike Folk (see below).


This document describes how to obtain a version of HDF for your system.   
Other information, including hints on using HDF, descriptions of  the 
files that comprise the distribution, and instructions on how to to 
create a library, can be found in other README files in this directory. 

There are two ways of obtaining HDF, depending on whether you are 
accessing this system by remote login or anonymous ftp.
Accordingly, this document contains the following sections:

	Obtaining HDF using anonymous ftp
	Obtaining HDF documentation 
	Obtaining HDF using remote login

If you have any questions, problems or suggestions, you can contact us 
via Email at mfolk@ncsa.uiuc.edu or likkai@ncsa.uiuc.edu,  or by writing 
to Mike Folk, Software Development, NCSA, 605 East Springfield Ave., 
Champaign, IL 61820, or call 217 244 0647.


************************************************************************
	Obtaining HDF using anonymous ftp
************************************************************************

Login to ftp.ncsa.uiuc.edu (128.174.20.50), with a login name of 
"anonymous". Give your real name as password.  Move to the directory 
"HDF" by issuing the command "cd HDF" to ftp.  Now you are ready to 
transfer files.  There are two ways to do this:

1. You may use the command "get hdf3.10.tar.Z" to download a compressed
"tar" format file.  Be sure to set file transfer mode to binary with the
command "binary".  If the file hdf3.10.tar.Z is too big to transfer, you
can instead transfer the files hdf3.10.tar.Z-part-aa, hdf3.10.tar.Z-part-ab,
..., hdf3.10.tar.Z-part-am, the concatenate them in your directory when
you have all of them.  (NOTE: this tar file is very large, as it contains 
all the source files, plus all of the documentation.  If space is dear, 
consider using the method described in paragraph 2.)

Uncompress and detar this file with the Unix "uncompress" and "tar"
utility on your system.  This produces a tree of subdirectories similar to
the ones in this directory.    

These files are described in the file INSTALL, which you find in the 
subdirectory src.  They must be compiled according to the instructions 
in that section.  

1a) For MacII/MPW users, there is a binhexed stuffit file called
hdf3.10.sit.hqx.  Use ascii mode to get this file, unbinhex it, then
unstuff it.  This will provide you will all the files for the MacII.

2. As an alternative to "tar", you may download the files you require 
directly.  Use "cd src" to move to the directory containing source 
files.  Then use the command "mget *". If your system is VMS, get the
files in src/fixatr also.  If your system is a MacII and you need to use
fortran, get the fortran files in src/mac.  This will prompt you for each
of the source files, asking if you want to download them. Answer "y" to each.
This will produce the source files for that system in your directory. 
Compile these files according to the instructions in the file INSTALL.


**********************************************************************
                   Obtaining HDF documentation 
**********************************************************************

Hardcopy versions of the documetation can be purchased from NCSA.  To
obtain a catalog, contact:

NCSA Documentation Orders
152 Computing Applications Building
605 E. Springfield Ave.
Champaign, IL 61820

(217) 244-0072  

You may also download the documentation via ftp. On anonymous ftp
there are two forms of the documentation, one ascii, and one in Macintosh
Microsoft Word format.  The ascii version was created by saving the
MS Word version as text, so it is quite crude and has no formatting or
illustrations.

To obtain the ascii documentation enter "cd doc/ascii".  There are two
subdirectories, containing the user documentation (NCSA_HDF) and
the technical specification (HDF_Specs), respectively. The ascii
files may be downloaded in ascii mode.

The Macintosh Microsoft Word files are stored in the same directory
that has this README.FIRST file.  There are two files: HDF3.10doc.sit
and HDF3.10.doc.sit.hqx. Both files have all of the documentation.
The difference between the two files is that the former is a binary
stuffit file and must be transmitted in binary mode.  The latter is a
binhexed stuffit file, which can be transmitted in ascii mode.  Use
ascii mode to get this file, unbinhex it, then unstuff it.

The Microsoft Word files are in Microsoft Word 4.0 format.  This
is the format used to print the hard copy versions distributed by
NCSA.  If you do not have MS Word 4.0, you will probably not be able
to print the documents in these files.  MS Word 3.0, for instance, does not
correctly print these files.




**********************************************************************
		Obtaining HDF using remote login 
**********************************************************************

If you have an account on the NCSA Suns, you may download HDF in this way.
To obtain a copy of HDF for a particular system, login to zaphod.ncsa.uiuc.edu,
cd to the directory /sdg/ftp/HDF and use the "transfer" script.

Usage: transfer systemtype hostname [directory]

where systemtype is "unicos", "sun", "alliant", "iris4", "mac", 
"vms" or "pc", hostname is the ftp name of the host you want to transfer 
the files to, and directory is the directory on the target system in 
which you want the files to be placed.

Transfer will create the source files appropriate for the system type, 
then open an ftp connection to the target machine and ask you to login.  
When you do, it will automatically copy the required files to the target 
system in the directory you specified.  It will also deposit all the 
documentation, in Macintosh Microsoft Word format if transferring to a 
Macintosh, in ascii format otherwise.  It will deposit all the files in 
the same directory, as contrasted to using the "tar" approach outlined 
in the section on anonymous ftp, which will create a tree of 
subdirectories.


*----------------------------------------------------------------------
*  * NCSA HDF Version 3.10 source code and documentation are in the 
* public domain.  Specifically, we give to the public domain all rights 
* for future licensing of the source code, all resale rights, and all 
* publishing rights. 
*  
* We ask, but do not require, that the following message be included in
* all derived works: 
*  
* Portions developed at the National Center for Supercomputing 
* Applications at the University of Illinois at Urbana-Champaign. 
*  
*  
* THE UNIVERSITY OF ILLINOIS GIVES NO WARRANTY, EXPRESSED OR IMPLIED, 
* FOR THE SOFTWARE AND/OR DOCUMENTATION PROVIDED, INCLUDING, WITHOUT 
* LIMITATION, WARRANTY OF MERCHANTABILITY AND WARRANTY OF FITNESS FOR 
* A PARTICULAR PURPOSE. 
*  
* If you want to see more software like NCSA HDF, you need to send us a 
* letter, email or US mail, telling us what you are doing with NCSA HDF. 
* We need to know: 
* 1) What science you are working on (an abstract of your work would be 
* fine); 
* 2) How NCSA HDF has helped you, e.g., whether it has increased your 
* productivity or allowed you to perform operations you were unable to 
* do before. 
*  
* We encourage you to cite the use of NCSA HDF , and any other NCSA 
* software you have used, in your publications.  A bibliography of your 
* work would be extremely helpful. 
*  
* This is a new kind of shareware.  You share your science and successes
* with us, and we attain the resources necessary to share more software 
* like NCSA HDF with you. 
* 
***********************************************************************
