
			     IMAGE FILE SOURCES

   For the article
   "A Simple Nonlinear Filter for Edge Detection in Images"
   by Mladen Victor Wickerhauser and Wojciech Czaja.
   SPIE Proceedings 5439(April, 2004), pp.24--31
   http://www.math.wustl.edu/~victor/papers/mpedge.pdf

   Preparer: M.V.Wickerhauser <victor@math.wustl.edu>
   Date: 13 May 2004

CONTENTS:

In this archive are demonstrations of `edginess' computations for a test
pattern and 6 grayscale images.  Unpack it into an empty directory to get:

    File		Comments
    ----		--------
    readme.txt		This documentation file
    makefile		Compilation instructions
    edgemp.c		Program for executable to compute midpoint edginess
    edgegp.c		Program for executable to compute gridpoint edginess
    edginess.c		Library of edginess computation functions
    edginess.h		Header declaring library functions
    figure.c		Program to generate `figure.pgm'
    finger7.c		Program to get 512x512 middle of cmp00007.raw
    cmp00007.raw	Original 512x512 8-bit grayscale fingerprint image
    cone.pgm		Original 256x256 8-bit grayscale ray-traced image
    house.pgm		Original 256x256 8-bit grayscale model house image
    lena.pgm		Original 512x512 8-bit grayscale woman's image
    truck.pgm		Original 256x256 8-bit grayscale captured video image


ACTION:

Modify the makefile to suit your system.  Typically, CC, CFLAGS, and LIBS
need to be altered.

Type `make' or `make all' to compile and run the complete demonstration.
	Then display all the .pgm files in a suitable viewer.

Type `make execs' to compile the executables but not run them.

Type `make clean' (on a Unix system) to remove some derived files.

Type `make spotless' (on a Unix system) to remove all derived files.

You will need a viewer for PGM (Portable Gray Map) files.  These are easily
converted into other formats, however.  See the documentation in `edginess.c'
near the function `writePGM()'.


DETAILS:

Source Files:

  makefile

	This was written on a NeXT machine, OpenStep 4.1, which is a BSD
	Unix-derived system, with cc being derived from GCC.

  edgemp.c

	Compile this into the main executable `edgegp', which reads a PGM
	image file on stdin and writes a normalized grayscale density plot to
	represent its gridpoint edginess.

  edgemp.c

	Compile this into the main executable `edgemp', which reads a PGM
	image file on stdin and writes a normalized grayscale density plot to
	represent its midpoint edginess.

  figure.c finger7.c

	Small utility functions to produce some test images.



Image Files:


lena.pgm

	This is the famous picture of Lena Sjooblom from the
	November, 1972 issue of Playboy Magazine.

	I downloaded the RGB file `lena_std.tif' from a web site citing the
	comp.compression FAQ site at

   http://www.cis.ohio-state.edu/hypertext/faq/usenet/compression-faq/top.html

	I converted it to grayscale with Adobe Photoshop 5.5, saved to `RAW'
	format with no header, and added the PGM header manually with Emacs.

cone.pgm

	I copied RAW file `conesphere' from Craig Kolb, around Sept. 1993,
	and added PGM header manually with Emacs.

figure.pgm

	This is a RAW file, output from running `figure' written by W. Czaja.

house.pgm

	This is the demonstration image `house_gray.pgm' from the XHoughTool
	website, 

	    http://www.lut.fi/dep/tite/XHoughtool

	XhoughTool is an implementation of the Hough transform edge
	parametrization algorithm, written by Petri Hirvonen, Jouni Ikonen,
	Pekka Kultanen, and Heikki Kaalviaainen of Lappeenranta University of
	Technology, Department of Information Technology, Laboratory of
	Information Processing, P.O. Box 20, FIN-53851 Lappeenranta, Finland.
	Tel +358 5 621 62111, Fax +358 5 621 2899, Email: Jouni.Ikonen@lut.fi

truck.pgm

	This is a RAW file obtained from Peng Li, around May, 2000, with
	a PGM header added manually with Emacs.

finger7.pgm

	I downloaded `cmp00007.raw' from NIST WSQ compliance testing site,
		ftp://jedgar.cam.nist.gov/pub/cmp_imgs
		owned by Rem Onyshczak <rjo@jedgar.cam.nist.gov>
	[from the README file:
		File Name      Width   Height
		-------------------------------
		cmp00007	545	638
	]
	Ran `fingerprint.c' to extract 512 rows starting at 63
		and 512 columns starting at 16 (initial indices are 0)
		of the original 638 row by 545 column image.
