Starting EPHUS - Anatomy of a Startup File

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, 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), following the most current conventions. 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 for such uses.

The 'Specimen'

The Head

Here's the beginning of our startup file 'specimen':

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);

This section contains the function declaration, with the name of the startup file – in this case, 'gephus'.

The next section (%%Startup Boilerplate) should not be modified, as the name implies. This section is common to all startup files.

The double-parenthesis(%%) signifies a MATLAB M-file cell. It helps to clearly demarcate the different file sections, when viewed in the MATLAB editor.

Device/Channel Configuration

This section contains the configuration information for each of the devices & channels connected to this installation of EPHUS:

%% DEVICE/CHANNEL CONFIGURATION

%Amplifier objects for ephys
patch{1} = multi_clamp('text_file_location', 'C:\MATLAB6p1\work\Physiology\MClamp700BChannel1.txt', 'scaledOutputBoardID', 1, 'scaledOutputChannelID', 0, ...
    'vComBoardID', 1, 'vComChannelID', 0, 'channel', 1, 'name', '700B-1');

patch{2} = multi_clamp('text_file_location', 'C:\MATLAB6p1\work\Physiology\MClamp700BChannel2.txt', 'scaledOutputBoardID', 1, 'scaledOutputChannelID', 4, ...
    'vComBoardID', 1, 'vComChannelID', 1, 'channel', 2, 'name', '700B-2');

%Acquirer channels 
acqChannelNames = {'photodiode1'};
acqBoardIDs =   [2];
acqChanIDs =    [0];

%Stimulator channels 
stimChannelNames = {'pockelsCell' 'shutter0' 'xMirror' 'yMirror' 'shutter1' 'ao5' 'ao6' 'ao7'};
stimBoardIDs = [3 3 3 3 3 3 3 3];
stimChanIDs =  [0 1 2 3 4 5 6 7];

EPHUS programs sometimes employ specialized devices, which are implemented as MATLAB objects. In this case, for instance, the ephys program employs amplifier objects. All objects require a constructor in order to be created – this is a function which must be called and typically consists of several arguments specifying the particular object's properties. The Device Constructor page documents the syntax for the various devices presently supported by EPHUS. In this case, the multi_clamp function calls create a particular type of amplifier ( multi_clamp is a subclass of amplifier; an axopatch200B amplifier class is also defined, for instance).

In addition to devices, EPHUS contains two programs – acquirer and stimulator – which are employed in virtually every EPHUS deployment.

Configuration Variables

Program Startup (Application)

User Fcns (Application)

The Tail

Final Comments