This directory contains some software and images illustrating the
dissertation research of Johan M. Lammens, "A Computational Model of Color
Perception and Color Naming", SUNY/Buffalo CS department, June 1994. 

All software in this directory, but not the ppm image files, is copyrighted
(C) by Johan M. Lammens 1994. You may copy and redistribute the software
only as determined by the terms of the GNU General Public License, see the
file COPYING in this directory.

The dissertation itself is available online in compressed PostScript form
by anonymous ftp from ftp.cs.buffalo.edu:/pub/tech-reports/94-26.ps.Z, or
via WWW at URL http://www.cs.buffalo.edu/pub/tech-reports, TR 94-26.
WARNING: the file is quite large, about 4 Mb, due to the presence of some
complex color graphics. An HTML version is also available, at URL
http://www.cs.buffalo.edu/pub/colornaming/diss/diss.html

This directory contains:

COPYING	       			GNU General Public License
ColorNaming    			image viewer binary for SunOS 4.1.3
ColorNaming.c			image viewer source code
Makefile			makefile for the viewer program
README				this file
anthropologists_umax.ppm	ppm sample image (Larson cartoon)
anthropologists_umax.ppm.gc	same, but gamma corrected (G ~ 2.0)
bkscan_new_umax_75dpi.ppm	ppm sample image (Berlin and Kay set)
bkscan_umax.ppm			ppm sample image (ditto, different version)
diss				directory containing diss.html etc
dissertation.m			Mathematica 2.2 source code
dissertation.ps.Z		compressed PS source of disseration (4.2 Mb!)
soup.ppm			ppm sample image (Andy Warhol's soup can)
utensils.ppm			ppm sample image (camera frame)


To run the software, you need:

- X11R4 or later, and a *24 bit* TrueColor display. The image
viewer/selector/pointer program will not work on an 8 bit PseudoColor or a
monochrome display.

- Mathematica 2.2, earlier or later versions *may* work.


The procedure for running the demos is:

- Copy the entire contents of this directory into a directory that you have
read and write access for, and cd to that directory.

- Start Mathematica, and load "dissertation.m" thusly:

    $ math
    Mathematica 2.2 for SPARC
    Copyright 1988-93 Wolfram Research, Inc.

    In[1]:= Get["dissertation.m"]

- Evaluate "demo1[]", "demo2[]", or "demo3[]" in Mathematica. That will
load an image, start the viewer, and let you select blobs etc. Some
instructions are printed on stdout:

    In[2]:= demo1[]


Some notes/caveats:

- The dissertation.m file is written automatically and thus contains no
comments and is quite ugly to look at. It's also quite minimalistic,
containing only the bare minimum defnitions needed to run the demo
functions. There are other, more extensive, source files with comments
containing the same definitions, see ...

- The synchronization between the mma code and the viewer program is quite
primitive. In particular, if the viewer fails to start (e.g. for lack of a
TrueColor display), the mma code is blissfully unaware of this and the
function will need to be aborted with ^C.

- There is no warranty expressed or implied. In particular, this software
is not supposed to be useful for any purpose.


The subdirectory diss contains the file diss.html, which is an html-ized
version of the complete dissertation. The URL is

	http://www.cs.buffalo.edu/pub/colornaming/diss/diss.html

If you need help or want to know more, feel free to contact me by email:
lammens@cs.buffalo.edu or lammens@arts.sssup.it

Enjoy,
JL