
Description of some of the contents of this directory:

  README:  this file

  dna_paper.troff  : copy of a paper which describes the use of
                     some of these programs

subdirectories:

lib/    : directory containing routines for allocating, reading, writing,
          and freeing dynamically allocated 2D and 3D arrays. Used by
          bclean.c, bthin.c, fill_holes.c, flip_quad.c, getobj.c, and hstat.c

man/    : director of man pages for the above programs

new_sources/ : source for simple HIPS filters

New HIPS filters:

   addmask.c   : combines a HIPS image with a binary mask to create a new image

   fill_holes.c : fills in small holes in binary HIPS images

   flip_quad.c  : flips the 4 quadrants of a HIPS image. Can be used
	          for viewing Fourier images.

   getobj.c   : Selects objects out of an image, and sets the  rest
                of the image to a given background value.

   hstat.c   : computes statistics such as size and average intensity
               on  objects  in  a  HIPS  image defined by a binary mask.


Similar to previous HIPS filters

   bthin.c  : similar to thin, but uses a different algorithm, is MUCH
              faster, and has some possibly annoying artifacts ( see the
	      man page )

New versions of previous HIPS filters

   bclean2.c   : about 500 times faster than old version, but uses 3-4 times
                more memory
   histoeq.c  : now handles short and int images, plus fixes a bug in the
                old version when using the -z option on a sequence
   suntohips2.c : now looks and sun raster colormap and converts colors
                 to grayscale.


getobj3d/  : source code for getobj3d program

segal/    : source code for segal 


/***********************************************************************/
/*  COPYRIGHT NOTICE         *******************************************/
/***********************************************************************/

/*   This program is copyright (C) 1990, Regents  of  the
University  of  California.   Anyone may reproduce this software,
in whole or in part, provided that:
(1)  Any copy  or  redistribution  must  show  the
     Regents  of  the  University of California, through its
     Lawrence Berkeley Laboratory, as the source,  and  must
     include this notice;
(2)  Any use of this software must reference this  distribu-
     tion,  state that the software copyright is held by the
     Regents of the University of California, and  that  the
     software is used by their permission.

     It is acknowledged that the U.S. Government has  rights
to this software under  Contract DE-AC03-765F00098 between the U.S.
Department of Energy and the University of California.

     This software is provided as a professional  academic  
contribution for  joint exchange.  Thus it is experimental, is
provided ``as is'', with no warranties of any kind  whatsoever,
no  support,  promise  of updates, or printed documentation.
Bug reports or fixes may be sent to the author, who may or may
not act on them as he desires. 
*/

/*   Author:  Brian L. Tierney
 *            Lawrence Berkeley Laboratory
 *            Imaging and Distributed Computing Group
 *            email: bltierney@lbl.gov
*/

