Documenting our software

From BanghamLab
Jump to navigation Jump to search

Return to Software

Maintaining colours when copying Matlab code into the wiki

To produce a wiki page such as this. The simplest is to use

webify_interaction_function(filename)

from the DArT_Toolshed. Change directory into the project then call the function. It will put an HTML copy of the function into the same directory which can be copied and pasted directly into the wiki. (Note - in the wiki, indented text is rendered verbatim, e.g. the function name above.)

Finding toolbox dependencies and collecting everything a toolbox needs into a single directory

This provides a way of distributing a toolbox without providing access to the entire DArT_Toolshed by finding all the dependencies of a toolbox and copying any that are not actually in the toolbox directory into a folder within the toolbox directory.

Use

myDepFun(mfile,toolboxDirectory)

which is in the DArT_Toolshed\ToolBag. myDepFun recursively (slowly) finds all the .m files on which mfile depends. Those that are not in the toolboxDirectory will be copied into a subdirectory of toolboxDirectory so that a zipfile of toolboxDirectory will include all the files needed by the toolbox. (CARE: if the mfile depends on a Matlab class library, i.e. directory name that begins with @, then the class library must be copied intact beforehand - read the help on myDepFun.)

myDepFun('AAMToolbox','ShapeModelToolbox');

took 50 minutes to assemble the files into the current directory