Package: imutil
Kind: plugin
Version: 0.5.7
Revision: 1
Description: Utilitaries for image manipulation
License: BSD
Author: Francois Rigaut
Maintainer: Francois Rigaut <frigaut@users.sourceforge.net>
OS:
Depends: yorick(>=1.6.02), yutils(>=1.0)
Source: http://www.maumae.net/yorick/packages/%o/tarballs/imutil-%v-%o.tgz
Source-MD5:
Source-Directory: contrib/imutil
DocFiles: README TODO VERSION NEWS LEGAL doc/README:README.doc doc/FILE_FORMATS doc/*.doc doc/*.pdf doc/*.ps doc/*.tex
Homepage: http://www.maumae.net/yorick/doc/plugins.php
DescDetail: <<

Compiled routines for basic but fast image manipulation. Includes 2d
bilinear and spline2 interpolation, clipping, 2d dist generator,
binning, image rotation, cartesian to polar coordinate transform,
gaussian and poisson random generator, fast sort and fast median. All
of these functions, with the exceptions of spline2, exist in yorick or
the yutils package, but these versions are 2 to 10x faster, being
specialized for 2d arrays (hence the name imutil). This plugin is
64bits safe.

1. Content:

This plugin includes the following functions:

func bilinear(image,arg1,arg2,grid=,minus_one=,outside=)
		bilinear interpolation on 2D arrays
func spline2(image,arg1,arg2,grid=,minus_one=,outside=,mask=)
		2D spline interpolation on 2d arrays
func bin2d(in,binfact)
		resampling by neighbor averaging (binning)
func cart2pol(image,&r,&theta,xc=,yc=,ntheta=,nr=,tor=,splin=,outside=)
		cartesian to polar coordinate mapping
func clip(inarray,xmin,xmax)
		set min and max of array to said values
func dist(dim,xc=,yc=)
		generate euclidian distance map
func eclat(image)
		quadrant swap "a la FFT"
func gaussdev(dims)
		generate random array with Gaussian statistic
func poidev(vec)
		compute poisson statistic of input array
func rotate2(image,angle,xc=,yc=,splin=,outside=)
		rotate 2D array using bilinear() or spline2()
func sedgesort(vec)
		sort input vector
func sedgemedian(vec)
		find median of input vector
func cpc(im,fmin,fmax)
		return image clipped at fmin (fraction) and fmax.


<<
DescUsage: <<
Installation from source:

see installation instructions in Makefile.
Basically, you will need a C compiler and make/gnumake.
You need yorick in your executable path.

yorick -batch make.i
make
make check
make install


The install puts imutil.i in Y_SITE/i, the imutil.so library in
Y_HOME/lib and the imutil_start.i in Y_SITE/i-start

See contrib/imutil/check.i for a test suite. Type 
"yorick -batch check.i" (in this directory) in a terminal to run it.

<<
DescPort: <<
This package will compile Yorick only on MacOSX 10.3.4 or later, because
of a bug in the system math library libm (part of /usr/lib/LibSystem.dylib)
in earlier versions of MacOSX 10.3.

History:

2008mar10 v0.5.4: Added support for char, short and int in clip()
2007jun14 v0.5.2: corrected nasty bug in spline2 and bilinear for case 2
                  function(image,dimx,dimy).
2005dec09 v0.5.1: updated the documents, README and info file.
2005dec01 v0.5  : bumped up to v0.5
2005nov08 v0.2.2: fixed local x in sedgesort
2005aug24 v0.2.1: added mask= keyword in spline2 to enable
		  invalid data point in input array.
2005may18 v0.2  : Worked on compatibility with 64 bits. 
		  Check API for int/long mix up. Corrected a few.
21Nov2004	removed a call to img_read to read test image 
		(introduced dependency), replaced by a restore.
Nov2004		creation.


<<
