By: Dr. Rosemary Renaut, Dr. Christina Negoita, and Guadalupe Ayala

Please, if you use this page, acknowledge it by referring to its URL address. This page gives requirements, installation, execution instructions, as well as directory descriptions. Please download the manual for information on Application Usage.

Requirements: Linux Operating System and ®MATLAB 7.1 or newer and running service pack 2.

Please download and install the following inputdlg.m ®MATLAB file to make sure application runs appropiately. To download and install follow the following directions:

If you have root access follow these instructions:

1. Back up the existing $MATLAB/toolbox/MATLAB/uitools/inputdlg.m. (where $MATLAB is the MATLAB root directory on your machine, as returned by typing MATLABroot at the MATLAB command prompt.)

2. Download 'inputdlg.m' file to that location by clicking on link below.

inputdlg.m

3. Start ®MATLAB and execute the following statement at the ®MATLAB command prompt before using the new INPUTDLG:

pcode inputdlg -inplace

If you do not have root access follow these instructions:

1. Download 'inputdlg.m' file to the local directory from which you will run the kgicode by clicking on the link below. Make sure that this directory is in your path at all times.

inputdlg.m

2. Start ®MATLAB and execute the following statement at the ®MATLAB command prompt before using the new INPUTDLG: You should find that a copy of inputdlg.p is placed in your local directory.

pcode inputdlg -inplace

Installation: In order to install and run the code, you need to do the following:

1. Click on the Download button below (Temporarily disabled July 14 in order to sort out data directories)
2. Choose Save
3. Browse to the directory where you want to install the application and save the file kgi_code.tar.gz
4. Save file kgi_code.tar.gz, which contains code
5. Uncompress code file by typing gunzip kgi code.tar.gz
6. Extract kgi code folder contents by typing tar -xvf kgi code.tar
7. Now you are ready to execute code to run the application.

Execution: It is required that you add the kgi code directory and subdirectories to the ®MATLAB path. In order to run the application you have to do the following:

Start ®MATLAB from the directory in which you installed the kgi code. startup.m should then immediately initialize your path. If it does not, then

1. Go to the File Menu and Click on Set Path
2. Browse to the kgi code directory and click on Add With SubFolders button.
3. Save path if possible and Close Path Window. Note: You need to set the path every time you restart ®MATLAB unless you save the path.

Browse to the GUI directory under the kgi code directory.
Open main window.m in kgi_code under the GUI directory
Click on Run to start the Application

Directory Descriptions: These are the descriptions of the contents for the kgi_code subdirectories.

1. Computation Files: This directory contains all the core code for the estimation algoritmn GLLS.
2. Documentation: This directory contains documentation on the program flow.
3. GetInputDataFiles: This directory has files used to parse and process the TTAC and PTAC Input data files.
4. GUI: This directory contains all the files and figures for the application user interface, including all the Callbacks.
5. IOFiles: This directory contains all of the printing and formatting code in order to save results.
6. ObsoleteFiles: This directory is not used by application, but has part of the initial code and scripts. It is provided for advanced users who may want to modify and customize the code.

DATA: The data that we used to develop this software is not available for general distribution due to NIH-IRB regulations. Please contact Dr. Rosemary Renaut at renaut@asu.edu. We intend to develop a sample simulation for you to test your installation of the program. The program assumes your data is locally available in ~/Petdata/normal_test.

RESULTS: A new directory for results will be created in your root directory.

®MATLAB is a registered mark of Mathworks Inc.