Difference between revisions of "Mslice"

From LIBISIS
Jump to navigation Jump to search
m
 
m
Line 1: Line 1:
Mslice uses some of the same functions as Libisis. These are all in a subdirectory called libisis_funcs. Mslice therefore contains copies of the functions so that it can be run without Libisis.
+
Mslice is designed to be compiled into a standalone application. Therefore, some matlab functions etc. can not be used
  
  
 +
== Dos and Don'ts ==
  
==Compiling Standalone Mslice==
+
There are a few rules when altering code that ''''MUST'''' be obeyed, these are:
 +
 
 +
* NO feval or eval statements - these do not compile
 +
* 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 for Windows==
 +
 
 +
 
 +
* open matlab. Version 2006b or later is required to use the mslice compile script.
 +
* The '''First''' time you compile:
 +
* Make sure that your '''startup.m''' file either contains conditional isdeployed statements (so that no code executes if isdeployed is true) OR all text is commented out. The presence of code in startup.m stops any compiled applications from working, but compiling will complete. NOTE however, that the paths still have to set up (i.e. startup.m must have run when you opened Matlab, but not be available at compile-time)
 +
* Type >> mslice_compile_win32. This will then take up to 5 minutes to compile,
 +
* Two files now exist in the mslice_standalone folder (newly created on the same level as the mslice_compile file). The zip file and the MCRinstaller.exe file. Distribute both to users, they must run the MCRinstaller.exe file once to setup matlab components on their computer.
 +
* A further text file complete.txt is created, this file indicates that compilation is successfull and contains a date and time stamp of the last successful build. This is for reference only.
 +
 
 +
 
 +
see [[File Locations]] for where to upload these for access from the wiki

Revision as of 10:37, 2 September 2008

Mslice 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
  • 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 for Windows

  • open matlab. Version 2006b or later is required to use the mslice compile script.
  • The First time you compile:
  • Make sure that your startup.m file either contains conditional isdeployed statements (so that no code executes if isdeployed is true) OR all text is commented out. The presence of code in startup.m stops any compiled applications from working, but compiling will complete. NOTE however, that the paths still have to set up (i.e. startup.m must have run when you opened Matlab, but not be available at compile-time)
  • Type >> mslice_compile_win32. This will then take up to 5 minutes to compile,
  • Two files now exist in the mslice_standalone folder (newly created on the same level as the mslice_compile file). The zip file and the MCRinstaller.exe file. Distribute both to users, they must run the MCRinstaller.exe file once to setup matlab components on their computer.
  • A further text file complete.txt is created, this file indicates that compilation is successfull and contains a date and time stamp of the last successful build. This is for reference only.


see File Locations for where to upload these for access from the wiki