GRNmap Testing Report Executable 2015-06-08 TM

Test Conditions

• Date started: 2015-06-03
• Test Performed by: Tessa A. Morris, Electronic Notebook
• Code Version: GRNmap v1.0.8
• MATLAB Version: No Matlab
• Computer on which the model was run: Biology Department Laptop 1

Purpose

• The purpose of this test was to make sure that the executable works on a computer without MATLAB.
• Issue 84

Results

• 4-genes_6-edges_artificial-data_Sigmoidal_estimation_fixb-0_fixP-0_graph
  • Media:4-genes 6-edges artificial-data Sigmoidal estimation fixb-0 fixP-0 graph.xlsx
  • Media:4-genes 6-edges artificial-data Sigmoidal estimation fixb-0 fixP-0 graph output.xlsx
  • Media:4-genes 6-edges artificial-data Sigmoidal estimation fixb-0 fixP-0 graph output.mat
  • Media:4-genes 6-edges artificial-data Sigmoidal estimation fixb-0 fixP-0 graph plots.zip
  • Counter: 12900
• 4-genes_6-edges_artificial-data_Sigmoidal_estimation_fixb-1_fixP-1_no-graph
  • Counter: 200

Methods

1. Open Google Chrome or Firefox and navigate to the GRNmap home page by searching "GRNmap" and "kdahlquist" or follow this link to go to the downloads page directly.
2. You may have to disable the virus software on your computer because the GRNmap website may not be trusted on all computers. On VirusScan Console, disable the all access protection.
3. Click "Download GRNmap Executables", find "GRNmap v1.0.8", and then click the green button that says "Download GRNmap_v1.0.8.zip executable" and save the file to the desktop. The computer settings may automatically save the file to the "Downloads" folder. If this is the case, drag the .zip file to the desktop. (theoretically this should work, but did not on either the Kam Dahlquist, GRNmap, or Student accounts with either Chrome or Firefox)
4. An alternative method of downloading GRNmap is to go to github.com and search "GRNmap" and select "kdahlquist/GRNmap" or follow this link. Select "Releases" and click "GRNmap_v1.0.8.zip". This method should work without changing the security settings of the anti-virus software.
5. While this is working, create a new folder called "GRNmap_testing_report_executable_2015-06-08".
6. Download previously created test input sheets from openwetware and save them to the folder you just created. (It may be easier to have these zipped into the executable). There are sixteen different variations of the input sheet created with artificial data to demonstrate the function of the model.
7. Once "GRNmap_v1.0.8.zip" has been downloaded, extract the zip file by right clicking and selecting the option "Extract All".
8. The extracted file should be named "GRNmap_v1.0.8". Open this folder, open the subfolder "GRNmap_v1.0.8", and double click the program called "MyAppInstaller_mcr." When prompted select "Run". This may take a few minutes to install.
   • To reinstall GRNmap for testing purposes go to the start menu, select "Computer." Double click "Local Disk (C:)" and navigate to the "Program Files" folder. Within this folder you must delete the "GRNmap" and "MATLAB" folders.
9. You will be prompted to an installer window, you must have administrator privileges to install the Matlab compiler library. When the GRNmap Installer window appears, click "Next" to start the installation process. A dialogue box titled "Preparing Files" will appear with a status bar monitoring the process of the program "Assembling product list...". It will then ask you to designate a installation folder. Accept the default location C:\Program Files\GRNmap. It will warn you that this folder does not exist and ask if you would like to create it. Click "Yes" then press "Next." The next window asks where you would like the "MATLAB Compiler Runtime" installed. Accept the default location C:\Program Files\MATLAB\MATLAB Compiler Runtime. It will warn you that this folder does not exist and ask if you would like to create it. Click "Yes" then press "Next."
10. Accept the terms of the license agreement by selecting "Yes" and then pressing "Next." On the next screen press "Install" and a status bar will appear. Once the installation is complete, select "Finish".
11. Navigate to the "GRNmap_v.1.0.8" folder on the desktop and double click the program "GRNmap" and select "Run".
    • For some reason the GRNmap start up screen is in the top right corner of the screen rather than the middle of the screen as it was previously (10:04 am 2015-06-09)
12. While this is working, create a new folder called "GRNmap_testing_report_executable_2015-06-08".
13. Download previously created test input sheets from openwetware and save them to the folder you just created. (It may be easier to have these zipped into the executable). There are sixteen different variations of the input sheet created with artificial data to demonstrate the function of the model. The input 4-genes_6-edges_artificial-data Sigmoidal_estimation_fixb-0_fixP-0_graph will best demonstrate all of the features of GRNmap
14. GRNmap will open a dialogue box called "Select Input Worksheet for Simulation." Navigate to the Desktop and select one of the test input sheets you saved in the "GRNmap_testing_report_executable_2015-06-08" folder.
15. A Matlab dialogue box called "Figure 1" should pop up on the screen. There should be two plots on the screen following the program's progress, and a counter number.
16. If you selected an input sheet with the option to make graphs, you will know the model has finished running when the program chimes (if your sound is on) and plots of the four difference genes appear on the screen. If you selected the option "no-graph" you will know the model has finished running when the counter number stops increasing. The counter image ("figure 1"), plots, output .xlsx file, and output .mat file should be save to the folder where the input sheet was saved, "GRNmap_testing_report_executable_2015-06-08". The plots and output sheets can be compared to those run previously. The LSE and penalty term cannot be calculated using the executable.
17. In order for the program to save the outputs successfully, none of the directories (folder name or administrator name) can have any spaces.
18. The counter image ("figure 1") must be saved manually, but selecting "File" then "Save As..." and changing the file type to .jpeg, the name to "Counter" and moving it into the "GRNmap_testing_report_executable_2015-06-08" folder. The names of the plots will be named figure then 2, 3, 4, or 5. You must also change the name of these manually, by clicking on the file once and then clicking the name. The current name should be highlighted in blue and you can then type in the name of the gene that was plotted.
    • On computers without MATLAB the .mat file will be classified as a "Microsoft Access Table Shortcut"
19. Create a subfolder in "GRNmap_testing_report_executable_2015-06-08" with the name of the input file and then add "_plots" (for example 4-genes_6-edges_artificial-data Sigmoidal_estimation_fixb-0_fixP-0_graph_plots) and move the .jpegs to this folder. Zip the folder by right clicking it and selecting "Send to" and then "Compressed (zipped) folder."
20. To view the file types, go to the start menu, select "Control Panel" and search for "Folder Options" Under the "View" tab uncheck the box next to "Hide extensions for known file types."
21. We saved and uploaded the input .xlsx, output .xlsx, output .mat (classified as a "Microsoft Access Table Shortcut" ), and zipped folder with the plots to openwetware.

Discussion

• The executable works as long as the computer has administrator privileges and none of the directory names (folder name or administrator name) have any spaces. Anti-virus software also prevented the download of GRNmap from the GRNmap website (http://kdahlquist.github.io/GRNmap/index.html) so it must be disabled for the download to work. However, the anti-virus software did allow downloads from github (https://github.com/kdahlquist/GRNmap).
• Later on the GRNmap start up screen shifted to the top right hand corner of the scree instead of the middle as it had previously.
• Each step of the process involving the executable takes a few minutes to work, which may be due to the fact that it was run on an older computer.
• The executable works even after the laptop has been shut off and the program was not reinstalled.