

USER GUIDE:

    For easy access, all programs are controlled by browser.tcl,
a tcl/tk user interface program.  To execute the browser, simply 
double click browse.tcl or run "wish80 browse.tcl" (not recommend)
A window with 64 (8x8) images on the left and control panel on
the right should appears, otherwise, something is wrong.

-------------------------------Mouse---------------------------------

Clicking the left button of mouse on an image,
the system will go down one level in the similarity pyramid. 
Clicking the right button of mouse on an image,
user can select/de-select an image for later use.

-------------------------------Button--------------------------------


The first button of control panel is program mode: browse and search

The second part of control panel is the semantic class control.
From the semantic class menu, user can create a new class by
selecting "New", or retrieve a saved class. After creating new class
the classname entry will be enable to allow user to keyin a name.
The "Save" button allow user to save the relevance set associated
with the name shown in the classname entry.

To add images to relevance set, simply click the RIGHT button of mouse 
on any image (a second click will de-select it) and the click the
ADD button to add it to the relevance set.
To remove images from relevance set, simply click the RIGHT button of 
mouse on any image (a second click will de-select it) and the click the
REMOVE button to remove it from the relevance set.

The next part is browser control, including zoom out which moves view 
window up one level in the pyramid structure, and pan left, pan right, 
pan up, and pan down which move the view port in corresponding direction
at step 4 images. To zoom in the view window, simply click the 
LEFT button of mouse on any image. There is NO effect when 
clicking on leaf imageof the pyramid. Currently, there is 
NO indication whether the image is leaf in the pyramid. 

The next item is a scale which determines the threshold of pruning.
The threshold is determined by an ordered statistic method.
The scale shows the predicted accuracy, the higher the accuracy,
the larger the pruned database.

The next buttons is "Add images", with which users can add images
by browse through the directory structure.

The next set of buttons are prune, rebuild, optimize, wormhole, and 
full browse. By selecting some example images, user can prune the 
database, and build a subset pyramid. 

The PRUNE button will prune the database to according the threshold
determined by the maximum of nearest neightbor distance among relevance
set and user selected coefficient. 
The result will be shown in the form of a similarity pyramid in 
standard similarity metric.

After PRUNE, browser control will work on the subset database
until user use the FULL DATABASE button to go back the original database.
The FULL BROWSE button will switch the environment to the original database.

The REBUILD button will rebuild the similarity pyramid based
on the standard weighting which weights color, texture, edge equally.

The OPTIMIZE button will rebuild the similarity pyramid based
on the weighting which best discriminates the relevance set from
a set of randomly selected images.

The WORMHOLE button will rebuild the similarity pyramid based
on the WORMHOLE distance described in the paper.

After PRUNE, SEARCH/REBUILD/OPTIMIZE/WORMHOLE will work on the subset 
database until user use the FULL BROWSE button to go back the original 
database.

The last button is exit.

The bottom part is reserved for debugging message.
The first one is the initial size of database.
The second one is message or the filename of selected image.


CONTENTS:
The images subdirectory contains the image database which includes

browser.tcl:     the tcl/tk user interface of the image database system
active.exe:      the real program which accept input from browser.tcl
getfile.tcl:     the tcl/tk subroutine for adding images to database
isimage.exe:     to decide if file is image, used in getfile.tcl

db_folderSIMPLE: the database files automatic generated by browser.tcl
extract.ppm:     temporary file for display.
list_of_images:  temporary file for add images.



