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

INCLUDED IN THIS ARCHIVE ARE:

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

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

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

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

5. README.txt - this file

DESCRIPTION OF PROGRAM:

BothFourier is a simple program that reads a text file containing theta,h coordinates and calculates the h and phi amplitudes (per GILDNER, 2003. A FOURIER METHOD TO DESCRIBE AND COMPARE SUTURE PATTERNS. Palaeontologia Electronica). 

The input file expected is a text file (extension .txt) containing theta and h coordinates, one line for each point. The initial point is expected to be 0,0. The last point is expected to have theta=pi. An example line would be:
   3, 0.123. 0.456
The first number is the index of the point (first point is at index=0). Second number is the theta-coordinate. The third number is the h-coordinate.

Output 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.

CONTROLS:

BROWSE button: Clicking this button opens the standard dialog for opening files. To select the data file to be transformed, select the file in the manner normal for this dialog. Once a file is selected, the name of the file is displayed in the window.

When the program is launched, this is the default button; pressing the return key is the same as clicking on the button. Once a file has been selected, the default button changes to the TRANSFORM SUTURE button.

TRANSFORM SUTURE button: Clicking this button performs the transform. This button cannot be clicked before a file has been selected. Once a file has been selected, this becomes the default button; ; pressing the return key is the same as clicking on the button. Once the transformation has been run, the default button chages to the Quit button.

Once the transformation is complete, you will be presented with two standard dialogs to save the output files. Use these dialogs as you normally would.

SAVE AS TEXT radio button: This button is selected by default. It will write the output to two text files as described above.

SAVE AS BINARY radio button: Selecting this option will save the output in binary format. Although more compact, the next program, Draw4096, is not designed to use it.

QUIT button: Clicking this button gracefully terminates program execution.