READ ME FOR DRAW4096
R.F. Gildner
6 August 2003

INCLUDED IN THIS ARCHIVE ARE:

1. Draw4096 (X) - a compiled version of the program for Mac OS X

2. Draw4096.rb - a REALbasic project, with all code, ready to be compiled

3. Draw4096.rb.pdf - an Adobe Acrobat PDF file of the program listing

4. Draw4096.txt - an editable text file of the program listing.

5. README.txt - this file

DESCRIPTION OF PROGRAM:

Draw4096 is a program to read h and phi amplitudes from two text files, calculate a few statistcs, draw the suture pattern, and save a file with the x,y coordiates of 512 points equally spaced along the suture. This performs the interpolation needed for normalizing suture patterns (per GILDNER, 2003. A FOURIER METHOD TO DESCRIBE AND COMPARE SUTURE PATTERNS. Palaeontologia Electronica). 

Input files created are two text files, one with extension .ampx and the other with extensions .ampy. These files are formatted such that the program Draw4096 can read them without alteration. The ampx file contains the theta amplitudes, and the ampy file contains the height amplitudes; the two files have the same format. An example of such a file is:
   10, 0.123, 0.987
The first number is the index of the amplitude; the second is the theta-amplitude, and the third is the h-amplitude. In this version of the program, the third value is ignored when reading the .ampx file, and the second value is ignored when reading the .ampy file.

PROGRAM CONTROLS AND EXECUTION

OPEN button: Clicking this button opens the standard dialog for opening files. Two dialogs will be presented in turn. The first is to select the .ampx file, the second to select the .ampy file. To select the data file to be transformed, select the file in the manner normal for this dialog.

Once two files are selected, the files will be read. The values of the statistics Power(h), Power(phi) and Power(All) will be calculated and displayed in the text field below the buttons. This text may be copied to the clipboard.

DRAW button: Clicking this button will draw a reconstruction of the suture patter into the area below. The image will be scaled to fill the area, with a white margin along the top, botton, left and right edges.

This button cannot be clicked until the data files have been read.

SAVE IMAGE button: Clicking this button allows the user to save the suture that has been reconstructed as a .TIF file. It opens the standard file-save dialog, which is used the normal manner.

This button cannot be clicked until the suture has been drawn.

INTERP button: Clicking this button calculates the coordinates of 512 points equally spaced along the suture, by a trigonometric interpolation. The location of the interpolated points is drawn on the image of the suture in the space below the controls.

Once clicked, the value of the statistic S.I. (index of sutural complexity) is displayed in the text field below the buttons.

This button cannot be clicked until the suture has been drawn.

SAVE INTERP button: Clicking this button saves the coordinates of the interpolated points into a text file that can be read by the program BothFourier.

QUIT button: This button terminates the program.