Page History

----
{toc:maxLevel=4}
----
h2. Background
To start EPHUS, one must invoke a _startup_ file at the MATLAB command line. The file is a MATLAB function file (i.e., .m extension), located in the current directory or somewhere on the user's MATLAB path.

Every user/rig requires a customized startup file. The best way to create this file is to modify one of the supplied [example files|Startup Files], which are constantly maintained on this site.

The startup files contain both _configuration_ and _application_ information. The vast majority of users only need to adjust the _configuration_ information, which resides in clearly demarcated sections of the startup file. 

This guide steps through a typical startup file ([^gephus.m]). For completeness, both the _configuration_ and _application_ sections are described. Only power-users, however, should modify the _application_ sections, and limited support can be provided in this case.

h2. The 'Specimen'
h5. {center}[Download the file|^gephus.m]{center}
{center}_It is best to view the file in the MATLAB editor, for helpful syntax coloring_{center}

h3. The Beginning
Here's the beginning of our startup file 'specimen':
{code}
function gephus

%% STARTUP BOILERPLATE 
%Set up a wait bar to show the progress.
wb = waitbarWithCancel(0, 'Starting ephus...', 'Name', 'Loading software...');
pos = get(wb, 'Position');
pos(2) = pos(2) - pos(4);
set(wb, 'Position', pos);
{code}

The 







h3. Device/Channel _Configuration_

h3. _Configuration_ Variables

h3. Program Startup (_Application_)

h3. User Fcns (_Application_)

h3. The End

h2. Final Comments