NCSA HDF-UCD release 1.0 beta					March 1992
Nataraj Akkiraju
Ping Fu

Overview:
	HDF-UCD can be used to create HDF Vset files for NCSA Polyview.
	It is a high level user library build on top of the HDF Vset 
	library.  HDF-UCD library contains a rountine that converts
	3D cell connectivity into polygoal connectivity (FEallfaces).
	It also has a rountine that extracts the surface from the finite
	element data (FEhullonly), this is particularly useful when your 
	have very large data set. 

How to install:
	set ftp to binary mode
	get HDF-UCD.tar.Z 
	uncompress HDF-UCD.tar.Z
	tar -xvofp HDF-ucd.tar

	cd to directory src
	modified Makefile to suit your environment
	make	/* this will create libucd.a */

How to run test files:

	look at test1.h test1.c  This test program runs on three set of
	test data: coil, vdyna, and heatpipe.  Modify test1.h to choose
	the desired test file.  (default is vdyna).

	make maketest1  /* this will create a vset file test1.vset */
	cd data		/* data is a subdirectory in src */

	polyview -i test1   /* test1 is a basic polyview input script file */


How to create vset file using libucd:

	1. exam test1.c and test2.c and read the documentation
	2. write your own c code that uses libucd functions
	4. include brick.h in your code
	3. compile you code with library libucd, libvg, and libdf ( you
	   must link the three libraries in this order )

Known bugs:
	1. You must remove the vset file if you create another one with
	   the same name in the same directory.  Otherwise the file will 
	   be appended.  This is due to an error in HDF, it will be fixed 
	   in the future release of NCSA HDF.

	2. The warning message "@VSfdefine warning: predefined field [PZ] 
	   redefined" is misleading.  This is due to an error 
	   in HDF Vset, you can ignore the warning.  This bug will be
	   taken out in the future release of NCSA Vset.

Other tools:

	Some extra tools are included for your convenience.  In bin directory
	there are three tools
	vshow	/* display the structure of your vset files */
	vmake   /* command line utility to add(create) vgroup and vdata */
	polyview /* 3D interactive render */ 

	in directory include, you'll find all the include files that is
	necessary for running your application.

	in directory lib, you'll find libvg.a and libdf.a 

Documentation:
	
	The documentation is on ftp server, directory Documentation
	HDF.UCD
