Difference between revisions of "Changing Homer GUI Code"

From LIBISIS
Jump to navigation Jump to search
m
m
Line 1: Line 1:
 +
The homer GUI is designed to be compiled into a standalone application. Therefore, some matlab functions etc. can not be used
  
−
The homer GUI is designed to be compiled into a standalone application. This task is performed by the function
 
−
 
−
* <tt> >> homer_compile </tt>
 
  
 
== dos and don'ts ==
 
== dos and don'ts ==
Line 18: Line 16:
 
== How To Compile ==
 
== How To Compile ==
  
−
* run <tt> homer_compile </tt>
+
 
−
* copy the folder "instrument_setup" to the same folder that the package compiled to (typically c:/stand_alone_homer)
+
* open matlab
−
* insure that mcrinstaller.exe is in the folder that the package compiled to
+
** navigate to the homer_gui folder
 +
** type >> mbuild -setup
 +
** Matlab will ask "do you want mbuild to locate installed compilers, type "y" and press return
 +
** Next, select the same compiler from the same group used to build libisis (usually C++ .NET 2003).
 +
** Comfirm by pressing return
 +
** Type >> deploytool
 +
** In the deployment tool toolbar click "open project" icon
 +
** Open homer.prj located in the homer_gui folder.
 +
** In the deployment tool toolbar click "Open Project Settings Window" icon
 +
** Select the folders you wish the output files to reside (by default c:\homer_gui\distrib. The project name will be the name of the .exe file that the user runs. Click ok and ignore any other options
 +
** In the deployment tool toolbar click the "build project" icon and wait until the compilation is completed (as indicated at the bottom of the matlab window). This may take several minutes
 +
** In the deployment tool toolbar, click the "package project" icon and wait until complete (as indicated by the progress bar).
 +
* Copy the "DLL" directory from the homer_gui director and into the directory that the distribution of Homer is located (e.g. c:\homer\distrib)
 +
* Copy the "Instrument_setup" directory from the homer_gui directory and into the directory that the distribution of homer is located
 +
* Create a Zip File named Homer containing homer_pkg.exe, the "DLL" folder and the "instrument_setup" folder. No other files are required.
 +
* Give this zip file to users.

Revision as of 13:28, 18 August 2008

The homer GUI is designed to be compiled into a standalone application. Therefore, some matlab functions etc. can not be used


dos and don'ts

There are a few rules when altering code that 'MUST' be obeyed, these are: 

 * NO feval or eval statements - these do not compile
 * Folder names MUST be stored without a slash at the end, i.e. '..\libisis\matlab' is ok, but '..\libisis\matlab\' is not. 
 * Use the command filesep to get the folder separator for the current platform instead of using '\' 
 * Do not use script mfiles
 * Use text files for any optional settings etc. so that a user may change them once the suite has been compiled
 * Always include the mcrinstaller with any distribution


How To Compile

  • open matlab
    • navigate to the homer_gui folder
    • type >> mbuild -setup
    • Matlab will ask "do you want mbuild to locate installed compilers, type "y" and press return
    • Next, select the same compiler from the same group used to build libisis (usually C++ .NET 2003).
    • Comfirm by pressing return
    • Type >> deploytool
    • In the deployment tool toolbar click "open project" icon
    • Open homer.prj located in the homer_gui folder.
    • In the deployment tool toolbar click "Open Project Settings Window" icon
    • Select the folders you wish the output files to reside (by default c:\homer_gui\distrib. The project name will be the name of the .exe file that the user runs. Click ok and ignore any other options
    • In the deployment tool toolbar click the "build project" icon and wait until the compilation is completed (as indicated at the bottom of the matlab window). This may take several minutes
    • In the deployment tool toolbar, click the "package project" icon and wait until complete (as indicated by the progress bar).
  • Copy the "DLL" directory from the homer_gui director and into the directory that the distribution of Homer is located (e.g. c:\homer\distrib)
  • Copy the "Instrument_setup" directory from the homer_gui directory and into the directory that the distribution of homer is located
  • Create a Zip File named Homer containing homer_pkg.exe, the "DLL" folder and the "instrument_setup" folder. No other files are required.
  • Give this zip file to users.
Retrieved from "http://libisis.org/index.php?title=Changing_Homer_GUI_Code&oldid=2657"