next up previous contents index
Next: Index Up: Plotting and Analysis for Previous: Bibliography   Contents   Index

Subsections

Appendices


1 Function Reference

See Section 1.6 on how to get online help about the software within MATLAB.

1.1 Class chans_db

1.1.1 Constructor chans_db/chans_db

Summary:
A database of channel activation and kinetics.
Usage:
 
a_chans_db = chans_db(data, col_names, channel_info, id, props)
Description:
This is a subclass of tests_db. Channel tables can be imported from Genesis using the utils/chanTables2DB script.
Parameters:
 
data:
Database contents.
col_names:
The channel variable names.
channel_info:
Structure that holds scalar data elements such as Gbar.
id:
An identifying string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

tests_db, channel_info, props.

See also:
tests_db (p. [*]), chanTables2DB (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/06/26



width

1.1.2 Method chans_db/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.1.3 Method chans_db/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.1.4 Method chans_db/plotInf

Summary:
Plot the product of minf variables and the gmax of the given channel.
Usage:
 
a_plot = plotInf(a_chans_db, chan_name, gate_subnames, title_str, props)
Parameters:
 
a_chans_db:
A chans_db describing channel variables.
chan_name:
Name of channel that make up the stem of variable

names.

gate_subnames:
Gate names of the channel.
title_str:
(Optional) A string to be concatanated to the title.
props:
A structure with any optional properties.

(rest passed to plot_abstract.)

Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), trace/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/07/01



width

1.1.5 Method chans_db/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.1.6 Method chans_db/plotAllInf

Summary:
Plots the steady-state (infinity) response of all channels.
Usage:
 
a_plot = plotAllInf(a_chans_db, title_str, props)
Parameters:
 
a_chans_db:
a chans_db
title_str:
Plot title.
props:
A structure with any optional properties.

(rest passed to matrixPlots.)

Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), trace/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/03/05



width

1.1.7 Method chans_db/plotAllVars

Summary:
Plot all channel variables by grouping activation and time constant curves per channel.
Usage:
 
a_plot = plotAllVars(a_chans_db, title_str, props)
Parameters:
 
a_chans_db:
A chans_db describing channel variables.
id:
String that identify the source of the tables structure.
props:
A structure with any optional properties.

(rest passed to plot_abstract.)

Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), trace/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/03/05



width

1.1.8 Method chans_db/plotGateVars

Summary:
Plot given channel gate variables of the same channel superposed.
Usage:
 
a_plot = plotGateVars(a_chans_db, chan_name, gate_subnames, title_str, props)
Parameters:
 
a_chans_db:
A chans_db describing channel variables.
chan_name:
Name of channel that make up the stem of variable

names.

gate_subnames:
Gate names of the channel.
title_str:
(Optional) A string to be concatanated to the title.
props:
A structure with any optional properties.
usePowers:
Use the gate powers, Luke.

(rest passed to plot_abstract.)

Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), trace/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/07/01



width

1.2 Class cip_trace

1.2.1 Constructor cip_trace/cip_trace

Summary:
A trace with a current injection pulse (CIP).
Usage:
 
obj = cip_trace(datasrc, dt, dy, pulse_time_start, pulse_time_width, id, props)
Parameters:
 
datasrc:
A vector of data points containing the spike shape.
dt:
Time resolution [s].
dy:
y-axis resolution [ISI (V, A, etc.)]
pulse_time_start, pulse_time_width:

Start and width of the pulse [dt]

id:
Identification string.
props:
A structure with any optional properties, such as:
trace_time_start:
Samples in the beginning to discard [dt]

(see trace for more)

Returns a structure object with the following fields:
 

trace, pulse_time_start, pulse_time_width, props.

See also:
trace (p. [*]), spikes (p. [*]), spike_shape (p. [*]), period (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/07/30



width

1.2.2 Method cip_trace/getPulseSpike

Summary:
Convert a spike in the CIP period to a spike_shape object.
Usage:
 
obj = getPulseSpike(trace, spikes, spike_num, props)
Description:
Creates a spike_shape object from desired spike. Calls trace/getSpike method.
Parameters:
 
trace:
A trace object.
spikes:
(Optional) A spikes object obtained from trace,

calculated automatically if given as [].

spike_num:
The index of spike to extract.
props:
A structure with any optional properties passed to getSpike.
Example:
 
Get 2nd pulse spike and plot it:
» plotFigure(plotResults(getPulseSpike(t, [], 2)))
See also:
spike_shape (p. [*]), trace/getSpike (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/19



width

1.2.3 Method cip_trace/plotData

Summary:
Plots a trace by calling trace/plotData but also adds optionaldecorations.
Usage:
 
a_plot = plotData(t, title_str, props)
Description:
If t is a vector of traces, returns a vector of plot objects.
Parameters:
 
t:
A trace object.
title_str:
(Optional) String to append to plot title.
props:
A structure with any optional properties.
stimBar:
If true, put a bar indicating the CIP duration.

(rest passed to trace/plotData)

Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), trace/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/17



width

1.2.4 Method cip_trace/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.2.5 Method cip_trace/periodRecSpont2

Summary:
Returns the second half of the recovery spontaneous activity period of cip_trace, t.
Usage:
 
the_period = periodRecSpont2(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.6 Method cip_trace/periodRecSpontRestPeriod

Usage:
 
the_period = periodRecSpont(t)
Parameters:
 
t:
A trace object.
iniPeriod:
the time following pulse offset that is ignored. The rest of

the time is kept

Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>,Tom Sangrey 2006/01/26



width

1.2.7 Method cip_trace/periodPulse

Summary:
Returns the CIP period of cip_trace, t.
Usage:
 
the_period = periodPulse(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.8 Method cip_trace/getResults

Summary:
Calculate test results given a_spikes object.
Usage:
 
results = getResults(a_cip_trace, a_spikes)
Parameters:
 
a_cip_trace:
A cip_trace object.
a_spikes:
A spikes object.
Returns:
 

results: A structure associating test names with result values.

See also:
cip_trace (p. [*]), spikes (p. [*]), spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.2.9 Method cip_trace/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.2.10 Method cip_trace/periodPulseIni100msRest1

Usage:
 
the_period = periodPulseIni50msRest1(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.11 Method cip_trace/periodIniSpont

Summary:
Returns the initial spontaneous activity period of cip_trace, t.
Usage:
 
the_period = periodIniSpont(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.12 Method cip_trace/periodPulseIni100ms

Summary:
Returns the first 100ms of the CIP period of cip_trace, t.
Usage:
 
the_period = periodPulseIni100ms(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.13 Method cip_trace/getCIPResults

Summary:
Calculate test results about CIP protocol.
Usage:
 
results = getCIPResults(a_cip_trace, a_spikes)
Parameters:
 
a_cip_trace:
A cip_trace object.
a_spikes:
A spikes object.
Returns:
 

results: A structure associating test names with result values.

See also:
cip_trace (p. [*]), spikes (p. [*]), spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/30



width

1.2.14 Method cip_trace/periodPulseHalf1

Summary:
Returns the first half of the CIP period of cip_trace, t.
Usage:
 
the_period = periodPulseHalf1(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.15 Method cip_trace/periodRecSpont1

Summary:
Returns the first half of the recovery spontaneous activity period of cip_trace, t.
Usage:
 
the_period = periodRecSpont1(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.16 Method cip_trace/subsref

Summary:
Defines generic indexing for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.2.17 Method cip_trace/getBurstResults

Summary:
Calculate test results related to Burst behavior.
Usage:
 
results = getRateResults(a_cip_trace, a_spikes)
Parameters:
 
a_cip_trace:
A cip_trace object.
a_spikes:
A spikes object.
Returns:
 

results: A structure associating test names with result values.

See also:
cip_trace (p. [*]), spikes (p. [*]), spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/30, Tom Sangrey



width

1.2.18 Method cip_trace/periodPulseIni50msRest1

Summary:
Returns the first half of the rest after the first 50ms of the CIP period of cip_trace, t.
Usage:
 
the_period = periodPulseIni50msRest1(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.19 Method cip_trace/measureNames

Summary:
Returns taxonomy of measurements collected by cip_trace.
Usage:
 
measures = measureNames(a_cip_trace)
Description:
This is a static method, in the sense that it does not need the object passed as argument. Therefore it can be called directly by using the default constructor; e.g., measureNames(cip_trace). The measure names are required for merging columns of a database generated by profiling these objects.
Parameters:
 
a_cip_trace:
A cip_trace object. It can be created by the the default constructor 'cip_trace'.
Returns:
 

measures: A structure with cell arrays of types of measures, and measure names inside.

See also:
getResults (p. [*]), getProfileAllSpikes (p. [*]), mergeMultipleCIPsInOne (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/07/30



width

1.2.20 Method cip_trace/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.2.21 Method cip_trace/calcRecSpontPotAvg

Summary:
Calculates the average potential value of the recovery period of the cip_trace, t.
Usage:
 
avg_val = calcRecSpontPotAvg(t)
Parameters:
 
t:
A cip_trace object.
Returns:
 

avg_val: The avg value [dy].

See also:
period (p. [*]), trace (p. [*]), trace/calcAvg (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.22 Method cip_trace/getRateResults

Summary:
Calculate test results related to spike rate.
Usage:
 
results = getRateResults(a_cip_trace, a_spikes)
Parameters:
 
a_cip_trace:
A cip_trace object.
a_spikes:
A spikes object.
Returns:
 

results: A structure associating test names with result values.

See also:
cip_trace (p. [*]), spikes (p. [*]), spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/30



width

1.2.23 Method cip_trace/calcPulsePotAvg

Summary:
Calculates the average potential value of the CIP period of the cip_trace, t.
Usage:
 
avg_val = calcPulsePotAvg(t)
Parameters:
 
t:
A cip_trace object.
Returns:
 

avg_val: The avg value [dy].

See also:
period (p. [*]), trace (p. [*]), trace/calcAvg (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.24 Method cip_trace/periodRecSpontIniPeriod

Usage:
 
the_period = periodRecSpont(t)
Parameters:
 
t:
A trace object.
iniPeriod:
the time following pulse offset that is kept, the rest of

the time is ignored.

Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>,Tom Sangrey 2006/01/26



width

1.2.25 Method cip_trace/periodPulseIni100msRest2

Usage:
 
the_period = periodPulseIni50msRest2(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.26 Method cip_trace/getRecSpontSpike

Summary:
Convert a spike in the CIP period to a spike_shape object.
Usage:
 
obj = getRecSpontSpike(trace, spikes, spike_num, props)
Description:
Creates a spike_shape object from desired spike.
Parameters:
 
trace:
A trace object.
spikes:
A spikes object on trace.
spike_num:
The index of spike to extract.
See also:
spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/05/08



width

1.2.27 Method cip_trace/spikes

Summary:
Convert cip_trace to spikes object for spike timing calculations.
Usage:
 
obj = spikes(trace, plotit)
Description:
Creates a spikes object by finding the spikes in the three separate periods, initial spontaneous activity period, CIP period, and final recovery period.
Parameters:
 
trace:
A trace object.
plotit:
If non-zero, a plot is generated for showing spikes found

(optional).

See also:
spikes (p. [*]), period (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.28 Method cip_trace/periodPulseIni50msRest2

Summary:
Returns the second half of the rest after the first 50ms of the CIP period of cip_trace, t.
Usage:
 
the_period = periodPulseIni50msRest2(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.29 Method cip_trace/periodRecSpont

Summary:
Returns the recovery spontaneous activity period of cip_trace, t.
Usage:
 
the_period = periodRecSpont(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.30 Method cip_trace/calcPulsePotSag

Summary:
Calculates the minimal sag and sag amount of the CIP period of the cip_trace, t.
Usage:
 
[min_val, min_idx, sag_val] = calcPulsePotSag(t)
Description:
The minimal sag is the minimal potential value of the first half of the CIP period. The sag amount is calculated by comparing this to the steady-state value at the end of the CIP period.
Parameters:
 
t:
A cip_trace object.
Returns:
 

min_val: The min value [dy]. min_idx: The index of the min value [dt]. sag_val: The sag amount [dy].

See also:
period (p. [*]), trace (p. [*]), trace/calcMin (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.31 Method cip_trace/periodPulseIni50ms

Summary:
Returns the first 50ms of the CIP period of cip_trace, t.
Usage:
 
the_period = periodPulseIni50ms(t)
Parameters:
 
t:
A trace object.
Returns:
 

the_period: A period object.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.2.32 Method cip_trace/plot_abstract

Summary:
Plots a trace by calling plotData.
Usage:
 
a_plot = plot_abstract(t, title_str, props)
Description:
If t is a vector of traces, returns a vector of plot objects.
Parameters:
 
t:
A trace object.
title_str:
(Optional) String to append to plot title.
props:
A structure with any optional properties.
timeScale:
's' for seconds, or 'ms' for milliseconds.

(rest passed to plot_abstract.)

Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), trace/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/17



width

1.2.33 Method cip_trace/getProfileAllSpikes

Summary:
Creates a cip_trace_allspikes_profile object by collecting test results of a cip_trace, analyzing each individual spike.
Usage:
 
profile_obj = getProfileAllSpikes(a_cip_trace)
Description:
Analyzes the spontaneous (periodIniSpont), pulse (periodPulse) and the recovery (periodRecSpont) periods separately and produces spike shape distribution results. Rate and CIP measurements are added to these.
Parameters:
 
a_cip_trace:
A cip_trace object.
Returns:
 

profile_obj: A cip_trace_allspikes_profile object.

See also:
cip_trace (p. [*]), cip_trace_allspikes_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/26



width

1.3 Class cip_trace_allspikes_profile

1.3.1 Constructor cip_trace_allspikes_profile/cip_trace_allspikes_profile

Summary:
Creates and collects test results of a cip_trace.
Usage:
 
obj = cip_trace_allspikes_profile(a_cip_trace, a_spikes, a_spont_spike_shape, results, id, props)
Description:
This is a subclass of results_profile. It is made to be used from subclass constructors.
Parameters:
 
a_cip_trace:
A cip_trace object.
a_spikes:
A spikes object.
spont_spikes_db, pulse_spikes_db, recov_spikes_db:

tests_dbs with spontaneous, pulse and recovery period spike info.

results_obj:
A results_profile object with test results.
id:
Identification string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

trace, spikes, spont_spikes_db, pulse_spikes_db, recov_spikes_db, props

See also:
cip_trace (p. [*]), spikes (p. [*]), tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/05/04



width

1.3.2 Method cip_trace_allspikes_profile/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.3.3 Method cip_trace_allspikes_profile/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.3.4 Method cip_trace_allspikes_profile/plotRowSpontSpikeAnal

Summary:
Creates a row of plots that show spontaneous spikes, starting from the whole trace, zooming into the individual spike.
Usage:
 
a_plot = plotRowSpontSpikeAnal(prof, title_str)
Parameters:
 
prof:
A cip_trace_allspikes_profile object.
title_str:
(Optional) String to append to plot title.
Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
trace (p. [*]), cip_trace (p. [*]), spike_shape/plotCompareMethodsSimple (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/05/23



width

1.3.5 Method cip_trace_allspikes_profile/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.4 Class cip_trace_profile

1.4.1 Constructor cip_trace_profile/cip_trace_profile

Summary:
Creates and collects test results of a cip_trace.
Description:
The first usage is fully customizable to be used from subclass constructors. The second usage generates the spikes and spont_spike_shape objects, and collects some generic test results from them.
Parameters:
 
data_src:
The trace column OR the filename.
dt:
Time resolution [s]
dy:
y-axis resolution [ISI (V, A, etc.)]
pulse_time_start, pulse_time_width:

Start and width of the pulse [dt]

id:
Identification string.
props:
See trace object.
Returns a structure object with the following fields:
 

trace, spikes, spont_spike_shape, results, id, props.

See also:
cip_trace (p. [*]), spikes (p. [*]), spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/25



width

1.4.2 Method cip_trace_profile/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.4.3 Method cip_trace_profile/plot

Summary:
Plots a cip_trace_profile object.
Usage:
 
h = plot(t)
Description:
Plots contents of this object.
Parameters:
 
t:
A cip_trace_profile object.
Returns:
 

h: Plot handle(s).

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/15



width

1.4.4 Method cip_trace_profile/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.4.5 Method cip_trace_profile/subsref

Summary:
Defines generic indexing for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.4.6 Method cip_trace_profile/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.5 Class cip_traces_dataset

1.5.1 Constructor cip_traces_dataset/cip_traces_dataset

Summary:
Dataset of cip_traces objects, each with varying cip magnitudes.
Usage:
 
obj = cip_traces_dataset(ts, cipmag, id, props)
Description:
This is a subclass of params_tests_fileset.
Parameters:
 
ts:
A cell array of cip_traces objects.
cipmag:
A single cip magnitude to trace take from objects.
id:
An identification string for the whole dataset.
props:
A structure with any optional properties passed to cip_trace_profile.
Returns a structure object with the following fields:
 

params_tests_dataset, cipmag, props (see above).

See also:
cip_traces (p. [*]), params_tests_fileset (p. [*]), params_tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/30



width

1.5.2 Method cip_traces_dataset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.5.3 Method cip_traces_dataset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.5.4 Method cip_traces_dataset/getItemParams

Usage:
 
params_row = getParams(dataset, index)
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
Returns:
 

params_row: Parameter values in the same order of paramNames

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/06



width

1.5.5 Method cip_traces_dataset/cip_trace_profile

Summary:
Loads a raw cip_trace_profile given a index to this dataset.
Usage:
 
a_cip_trace_profile = cip_trace_profile(dataset, index)
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of file in dataset.
Returns:
 

a_cip_trace_profile: A cip_trace_profile object.

See also:
cip_trace_profile (p. [*]), params_tests_dataset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.5.6 Method cip_traces_dataset/subsref

Summary:
Defines generic indexing for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.5.7 Method cip_traces_dataset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.5.8 Method cip_traces_dataset/loadItemProfile

Summary:
Loads a profile object from a raw data item in the dataset.
Usage:
 
a_profile = loadItemProfile(dataset, index)
Description:
Subclasses should overload this function to load the specific profile object they desire. The profile class should define a getResults method which is used in the itemResultsRow method.
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.5.9 Method cip_traces_dataset/paramNames

Summary:
Returns the only parameter, 'pAcip,' for this fileset.
Usage:
 
param_names = paramNames(fileset)
Description:
Looks at the filename of the first file to find the parameter names.
Parameters:
 
fileset:
A params_tests_fileset.
Returns:
 

params_names: Cell array with ordered parameter names.

See also:
params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/06



width

1.6 Class cip_traceset

1.6.1 Constructor cip_traceset/cip_traceset

Summary:
A traceset with varying cip magnitudes from a single cip_traces object.
Usage:
 
obj = cip_traceset(ct, cip_mags, dy, props)
Description:
This is a subclass of params_tests_fileset. This traceset can create a mini-database form a single cip_traces object. The list contains cip_mags. cip_traceset_dataset should be used to load multiple cip_traceset objects.
Parameters:
 
ct:
A cip_traces object.
cip_mags:
An array of cip magnitudes to select from the object.
dy:
y-axis resolution, [V] or [A] (default=1e-3).
props:
A structure with any optional properties.
offsetPotential:
Add this to physiology trace as compensation.
Returns a structure object with the following fields:
 

params_tests_dataset, ct, props (see above).

See also:
cip_traces (p. [*]), params_tests_fileset (p. [*]), params_tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/30



width

1.6.2 Method cip_traceset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.6.3 Method cip_traceset/getItemParams

Usage:
 
params_row = getParams(dataset, index)
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
a_profile:
A profile object for the item (optional).
Returns:
 

params_row: Parameter values in the same order of paramNames

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/06



width

1.6.4 Method cip_traceset/cip_trace_profile

Summary:
Loads a raw cip_trace_profile given an index in this traceset.
Usage:
 
a_cip_trace_profile = cip_trace_profile(traceset, index)
Parameters:
 
traceset:
A cip_traceset.
index:
Index of item in traceset.
Returns:
 

a_cip_trace_profile: A cip_trace_profile object.

See also:
cip_trace_profile (p. [*]), params_tests_dataset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.6.5 Method cip_traceset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.6.6 Method cip_traceset/loadItemProfile

Summary:
Loads a profile object from a raw data item in the dataset.
Usage:
 
a_profile = loadItemProfile(dataset, index)
Description:
Subclasses should overload this function to load the specific profile object they desire. The profile class should define a getResults method which is used in the itemResultsRow method.
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.6.7 Method cip_traceset/paramNames

Summary:
Returns the only parameter, 'pAcip,' for this traceset.
Usage:
 
param_names = paramNames(traceset)
Description:
Looks at the filename of the first file to find the parameter names.
Parameters:
 
traceset:
A cip_traceset.
Returns:
 

params_names: Cell array with ordered parameter names.

See also:
params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/06



width

1.7 Class cip_traceset_dataset

1.7.1 Constructor cip_traceset_dataset/cip_traceset_dataset

Summary:
Dataset of multiple cip magnitudes from cip_traces objects .
Usage:
 
obj = cip_traceset_dataset(cts, cip_mags, dy, id, props)
Description:
This is a subclass of params_tests_dataset. Designed to extract a trace for each cip magnitude from the cip_traceset objects contained. Uses cip_traceset objects to extract multiple traces from each cip_traces object.
Parameters:
 
cts:
Array or cell array of cip_traces objects.
cip_mags:
An array of cip magnitudes to select from each cip_traces object.
dy:
y-axis resolution, [V] or [A] (default = 1e-3).
id:
An identification string.
props:
A structure with any optional properties passed to cip_traceset.
Returns a structure object with the following fields:
 

params_tests_dataset, cip_mags

See also:
physiol_cip_traceset (p. [*]), params_tests_dataset (p. [*]), params_tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/28



width

1.7.2 Method cip_traceset_dataset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.7.3 Method cip_traceset_dataset/readDBItems

Summary:
Reads all items to generate a params_tests_db object.
Usage:
 
[params, param_names, tests, test_names] = readDBItems(obj)
Description:
This is a specific method to convert from cip_traceset_dataset to a params_tests_db, or a subclass. Output of this function can be directly fed to the constructor of a params_tests_db or a subclass.
Parameters:
 
obj:
A physiol_cip_traceset_fileset
Returns:
 

params, param_names, tests, test_names: See params_tests_db.

See also:
params_tests_db (p. [*]), params_tests_fileset (p. [*]), itemResultsRow testNames (p. [*]), paramNames (p. [*]), physiol_cip_traceset_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/28



width

1.7.4 Method cip_traceset_dataset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.7.5 Method cip_traceset_dataset/loadItemProfile

Summary:
Loads a cip_trace_profile object from a raw data file in the fileset.
Usage:
 
a_profile = loadItemProfile(fileset, neuron_id, trace_index)
Parameters:
 
fileset:
A physiol_cip_traceset object.
neuron_id :
tells which item in fileset (corresponds to cells_filename) to use grab the cell information
trace_index:
Index of file in traceset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14 and Tom Sangrey



width

1.8 Class cluster_db

1.8.1 Constructor cluster_db/cluster_db

Summary:
A database of cluster centroids generated by a clustering algorithm from a rows of orig_db.
Usage:
 
a_cluster_db = cluster_db(data, col_names, orig_db, cluster_idx, id, props)
Description:
This is a subclass of tests_db. Use one of the clustering methods in tests_db, such as kmeansCluster, to get an instance of this class.
Parameters:
 
data:
Database contents.
col_names:
The column names.
orig_db:
DB whose rows are clustered.
cluster_idx:
Array of cluster numbers that correspond to each row in orig_db.
id:
An identifying string.
props:
A structure with any optional properties.
sumDistances:
Total distance of elements within each cluster.
distanceMeasure:
Measure used to find clusters (Default='correlation')
Returns a structure object with the following fields:
 

tests_db, orig_db: original DB from which clusters were obtained, cluster_idx: Array associating rows of orig_db to each cluster here. props.

See also:
tests_db (p. [*]), tests_db/kmeansCluster (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/08



width

1.8.2 Method cluster_db/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.8.3 Method cluster_db/plotHist

Summary:
Creates a histogram plot showing the clustering memberships.
Usage:
 
a_plot = plotHist(a_cluster_db, title_str)
Parameters:
 
a_cluster_db:
A cluster_db object.
title_str:
(Optional) String to append to plot title.
Returns:
 

a_plot: A plot_abstract object that can be plotted.

See also:
plot_abstract (p. [*]), plotFigure (p. [*]), histogram_db (p. [*]), histogram_db/plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/08



width

1.8.4 Method cluster_db/plotQuality

Summary:
Creates a plot_abstract of the silhouette plot showing the clustering quality.
Usage:
 
a_plot = plotQuality(a_cluster_db, title_str)
Parameters:
 
a_cluster_db:
A cluster_db object.
title_str:
(Optional) String to append to plot title.
Returns:
 

a_plot: A plot_abstract object that can be plotted.

See also:
plot_abstract (p. [*]), plotFigure (p. [*]), silhouette (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/08



width

1.8.5 Method cluster_db/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.8.6 Method cluster_db/plot_abstract

Summary:
Creates a vertical plot_stack of silhouette and membership histograms for the clusters.
Usage:
 
a_plot = plot_abstract(a_cluster_db, title_str)
Parameters:
 
a_cluster_db:
A cluster_db object.
title_str:
(Optional) String to append to plot title.
Returns:
 

a_plot: A plot_abstract object that can be plotted.

See also:
cluster_db/plotQuality (p. [*]), cluster_db/plotHist (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/08



width

1.9 Class corrcoefs_db

1.9.1 Constructor corrcoefs_db/corrcoefs_db

Summary:
A database of correlation coefficients generated from a column of another database.
Usage:
 
a_coef_db = corrcoefs_db(col_name, coefs, coef_names, pages, id, props)
Description:
This is a subclass of tests_3d_db. Allows generating a plot, etc.
Parameters:
 
col_name:
The column with which the others are correlated.
coefs:
Matrix where each column has another coefficient.
coef_names:
Cell array of column names corresponding to coefficients.
pages:
Column vector of page indices pointing to the tests_3d_db.
id:
An identifying string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

tests_db.

See also:
tests_db (p. [*]), plot_simple (p. [*]), tests_db/histogram (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/06



width

1.10 Class dataset_db_bundle

1.10.1 Constructor dataset_db_bundle/dataset_db_bundle

Summary:
The dataset and the DB created from it bundled together.
Usage:
 
a_bundle = dataset_db_bundle(a_dataset, a_db, a_joined_db, props)
Description:
This class is made to enable operations that require seamless connection between the high-level DB and the raw data. The raw DB is only required to bridge the gap between the high-level DB and the dataset. Therefore it only needs to contain columns necessary to make this connection. It is not required to include all raw DB columns, which is inefficient.
Parameters:
 
a_dataset:
A params_tests_dataset object or a subclass.
a_db:
The raw tests_db object (or a subclass) created from the dataset.
a_joined_db:
The processed DB created from the raw DB.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

dataset, db, joined_db, props.

See also:
tests_db (p. [*]), params_tests_dataset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/13



width

1.10.2 Method dataset_db_bundle/matchingRow

Summary:
Creates a criterion database for matching the tests of a row.
Usage:
 
crit_db = matchingRow(a_bundle, row, props)
Description:
Copies selected test values from row as the first row into the criterion db. Adds a second row for the STD of each column in the db.
Parameters:
 
a_bundle:
A tests_db object.
row:
A row index to match.
props:
A structure with any optional properties.
distDB:
Take the standard deviation from this db instead.
Returns:
 

crit_db: A tests_db with two rows for values and STDs.

Example:
 
physiol_bundle has an overloaded matchingRow method that
takes the TracesetIndex as argument:
» crit_db = matchingRow(pbundle, 61)
See also:
rankMatching (p. [*]), tests_db (p. [*]), tests2cols (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/21



width

1.10.3 Method dataset_db_bundle/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.10.4 Method dataset_db_bundle/getNeuronRowIndex

Summary:
Returns the neuron index from bundle.
Usage:
 
a_row_index = getNeuronRowIndex(a_bundle, an_index, props)
Description:
This is a polymorphic method. Therefor it is not defined for this class, but see subclasses of dataset_db_bundle for its more meaningful implementations.
Parameters:
 
a_bundle:
A dataset_db_bundle subclass object.
an_index:
An index number of neuron, or a DB row containing this.
props:
A structure with any optional properties.
Returns:
 

a_row_index: A row index of neuron in a_bundle.joined_db.

Example:
 
» displayRows(mbundle.joined_db(getNeuronRowIndex(mbundle, 98364), :))
See also:
dataset_db_bundle (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/09



width

1.10.5 Method dataset_db_bundle/ctFromRows

Summary:
Loads a cip_trace object from a raw data file in the a_bundle.
Usage:
 
a_cip_trace = ctFromRows(a_bundle, a_db, cip_levels, props)
Description:
This method is not implemented for the generic dataset_db_bundle class. See subclass implementations.
Parameters:
 
a_bundle:
A dataset_db_bundle object.
a_db:
A DB created by the dataset in the a_bundle to read the neuron index numbers from.
cip_levels:
A column vector of CIP-levels to be loaded.
props:
A structure with any optional properties.

(passed to a_bundle.dataset/cip_trace)

Returns:
 

a_cip_trace: One or more cip_trace objects that hold the raw data.

See also:
model_ct_bundle/ctFromRows (p. [*]), physiol_bundle/ctFromRows (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/10/11



width

1.10.6 Method dataset_db_bundle/reportNeuron

Summary:
Generates a report of neuron at given an_index of a_bundle.
Usage:
 
a_doc = reportNeuron(a_bundle, an_index, props)
Description:
Generates a report document with preset layouts of annotated plots of the selected neuron. See reportLayout below for presets.
Parameters:
 
a_bundle:
a dataset_db_bundle object which contains the neuron
an_index:
The index to pass to ctFromRows method of a_bundle.
props:
A structure with any optional properties.
reportLayout:
Allows choosing one of predefined report types (strings):
1:
Only +/- 100 pA traces in one plot (default).

1a/b: Either one of the +/- 100 pA traces in one plot.

2:
Only +/- 100 pA traces and spike shapes in one horiz. plot.
2a:
+/- 100 pA traces, f-I curve and spike shapes in one horiz. plot.
3:
+100 pA raw trace and rate profile stacked vertically.
3b:
-100 pA raw trace and rate profile stacked vertically.
4:
Horiz stack of +/- 100 pA raw trace with rate profiles underneath.
5:
5-piece trace, spike shape, f-I curve, f-t curve quad-plot.
numTraces:
Limit number of traces to show in plot (>=1).
traces:
List of acceptable traces to load.
traceAxisLimits:
If given, use these limits for trace plots.
rateAxisLimits:
If given, use these limits for rate plots.
fIAxisLimits:
If given, use these limits for fIcurve plots.
fIstats:
Add a fI-stats plot in addition to the curve.
sshapeAxisLimits:
If given, use these limits for spike shape plots.
sshapeResults:
If 1, plot measures on the spike shape (default=1).
Returns:
 

a_doc: A doc_generate object, or a subclass, that can be plotted, or printed as a PS or PDF file.

Example:
 
» printTeXFile(reportNeuron(mbundle, 2222), 'a.tex')
or:
» plotFigure(get(reportNeuron(mbundle, 2222), 'plot'))
or if the result is one or many doc_plot objects:
» plot(reportNeuron(mbundle, 2222:2224, struct('reportLayout', '5')))
See also:
doc_multi (p. [*]), doc_generate (p. [*]), doc_generate/printTeXFile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/24



width

1.10.7 Method dataset_db_bundle/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.10.8 Method dataset_db_bundle/constrainedMeasuresPreset

Summary:
Returns a dataset_db_bundle with constrained measures according to chosen preset.
Usage:
 
[a_bundle test_names] = constrainedMeasuresPreset(a_bundle, preset, props)
Parameters:
 
a_bundle:
A dataset_db_bundle object.
preset:
Choose preset measure list (default=1).
props:
A structure with any optional properties.
Returns:
 

a_bundle: Modified bundle.

See also:
physiol_bundle/constrainedMeasuresPreset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/13



width

1.10.9 Method dataset_db_bundle/subsref

Summary:
Defines indexing for tests_db objects for () and . operations.
Usage:
 
obj = obj(rows, tests) obj = obj.attribute
Description:
Returns attributes or selects the given test columns and rows and returns in a new tests_db object.
Parameters:
 
obj:
A tests_db object.
rows:
A logical or index vector of rows. If ':', all rows.
tests:
Cell array of test names or column indices. If ':', all tests.
attribute:
A tests_db class attribute.
Returns:
 

obj: The new tests_db object.

See also:
subsref (p. [*]), tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/17



width

1.10.10 Method dataset_db_bundle/subsasgn

Summary:
Defines generic index-based assignment for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.10.11 Method dataset_db_bundle/plotfICurve

Summary:
Generates a f-I curve doc_plot for neuron at given an_index in a_bundle.
Usage:
 
a_plot = plotfICurve(a_bundle, trial_num, props)
Parameters:
 
a_bundle:
A dataset_db_bundle object.
an_index:
An index with which to address the a_bundle.
props:
A structure with any optional properties.
shortCaption:
This appears in the figure caption.
plotMStats:
If set, add the a_bundle stats plot.
captionToStats:
Use this as its legend label.
quiet:
if given, no title is produced

(passed to plot_superpose)

Returns:
 

a_plot: A plot_superpose that contains a f-I curve plot.

Example:
 
» a_p = plotfICurve(r, 1);
» plotFigure(a_p, 'The f-I curve of best matching model');
See also:
plot_abstract (p. [*]), plot_superpose (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/16



width

1.10.12 Method dataset_db_bundle/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.10.13 Method dataset_db_bundle/rankingReportTeX

Summary:
Generates a report by comparing a_bundle with the given match criteria, crit_db from crit_bundle.
Usage:
 
tex_string = rankingReportTeX(a_bundle, crit_bundle, crit_db, props)
Description:
Generates a LaTeX document with: - (optional) Raw traces compared with some best matches at different distances - Values of some top matching a_db rows and match errors in a floating table. - colored-plot of measure errors for some top matches. - Parameter distributions of 50 best matches as a bar graph.
Parameters:
 
a_bundle:
A dataset_db_bundle object that contains the DB to compare rows from.
crit_bundle:
A dataset_db_bundle object that contains the criterion dataset.
crit_db:
A tests_db object holding the match criterion tests and STDs

which can be created with matchingRow.

props:
A structure with any optional properties.
caption:
Identification of the criterion db (not needed/used?).
num_matches:
Number of best matches to display (default=10).
rotate:
Rotation angle for best matches table (default=90).
Returns:
 

tex_string: LaTeX document string.

See also:
displayRowsTeX (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/13



width

1.11 Class doc_generate

1.11.1 Constructor doc_generate/doc_generate

Summary:
Generic class to help generate printed or annotated documents with results.
Usage:
 
a_doc = doc_generate(text_string, id, props)
Description:
This constitutes the base class for other doc_ classes. For convenience, this class holds a text_string to be printed when the document is generated with the printTeXFile option.
Parameters:
 
text_string:
Contents of this document.
id:
An identifying string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

text, id, props.

See also:
doc_plot (p. [*]), doc_multi (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.11.2 Method doc_generate/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.11.3 Method doc_generate/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.11.4 Method doc_generate/printTeXFile

Summary:
Creates a TeX file with the contents of this document.
Usage:
 
printTeXFile(a_doc, filename, props)
Description:
Calls getTeXString to generate the contents. The filename is adjusted with a call to properFilename to generate an acceptable TeX filename. TeX-specific should only be added at this point or at getTeXString, because before we want the object to be a generic document container.
Parameters:
 
a_doc:
A tests_db object.
filename:
To write the TeX string.
props:
A structure with any optional properties.
Returns:
 

tex_string: A string that contains TeX commands, which upon writing to a file, can be interpreted by the TeX engine to produce a document.

Example:
 
» a_doc = doc_plot(a_plot, 'Results from cell.', 'Results.', struct, '');
» printTeXFile(a_doc, 'my_doc.tex')
then my_doc.tex can be used by including from a valid LaTeX document.
See also:
doc_generate (p. [*]), doc_plot (p. [*]), string2File (p. [*]), properFilename (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.11.5 Method doc_generate/subsref

Summary:
Defines generic indexing for objects.



width

1.11.6 Method doc_generate/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.11.7 Method doc_generate/getTeXString

Summary:
Returns the TeX representation for the document.
Usage:
 
tex_string = getTeXString(a_doc, props)
Description:
This is an abstract placeholder for this method. It specifies what this method should do in the subclasses that implement it. This method should create all the auxiliary files needed by the document. The generated tex_string should be ready to be visualized.
Parameters:
 
a_doc:
A tests_db object.
props:
A structure with any optional properties.
Returns:
 

tex_string: A string that contains TeX commands, which upon writing to a file, can be interpreted by the TeX engine to produce a document.

Example:
 
doc_plot has an overloaded getTeXString method:
» tex_string = getTeXString(a_doc_plot)
» string2File(tex_string, 'my_doc.tex')
then my_doc.tex can be used by including from a valid LaTeX document.
See also:
doc_generate (p. [*]), doc_plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.12 Class doc_multi

1.12.1 Constructor doc_multi/doc_multi

Summary:
A document that is composed of multiple other doc_generate objects.
Usage:
 
a_doc = doc_multi(docs, id, props)
Parameters:
 
docs:
A vector of doc_generate objects.
id:
An identifying string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

docs, doc_generate.

Example:
 
» mydoc = doc_multi([doc_plot(a_plot1), doc_plot(a_plot2)], 'Two plots')
» printTeXFile(mydoc, 'two_plots.tex')
See also:
doc_generate (p. [*]), getTeXString (p. [*]), doc_generate/printTeXFile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.12.2 Method doc_multi/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.12.3 Method doc_multi/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.12.4 Method doc_multi/getTeXString

Summary:
Returns the TeX representation for the document.
Usage:
 
tex_string = getTeXString(a_doc, props)
Description:
Concatenates TeX representations of doc_generate, or subclass, objects it contains.
Parameters:
 
a_doc:
A tests_db object.
props:
A structure with any optional properties.
Returns:
 

tex_string: A string that contains TeX commands, which upon writing to a file, can be interpreted by the TeX engine to produce a document.

Example:
 
doc_plot has an overloaded getTeXString method:
» tex_string = getTeXString(a_doc_plot)
» string2File(tex_string, 'my_doc.tex')
then my_doc.tex can be used by including from a valid LaTeX document.
See also:
doc_generate (p. [*]), doc_plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.13 Class doc_plot

1.13.1 Constructor doc_plot/doc_plot

Summary:
Generates a formatted plot for printing, annotated with captions.
Usage:
 
a_doc = doc_plot(a_plot, caption, plot_filename, float_props, id, props)
Description:
The generated file may take an extension according to chosen format.
Parameters:
 
a_plot:
A plot_abstract ready to be visualized.
caption:
Long caption to appear under the figure.
plot_filename:
Filename to be generated from the plot.
float_props:
Formatting instructions passed to TeXtable.
id:
An identifying string.
props:
A structure with any optional properties.
orient:
Passed to the orient command before printing to figure file.
Returns a structure object with the following fields:
 

plot, caption, plot_filename, float_props, doc_generate.

Example:
 
» a_doc = doc_plot(plotData(my_cip_trace), 'My CIP trace. Very interesting.', ...
'trace1', struct, 'first doc');
» printTeXFile(a_doc, 'my_doc.tex');
See also:
doc_generate (p. [*]), TeXtable (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.13.2 Method doc_plot/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.13.3 Method doc_plot/plot

Summary:
Default plot method to preview the contained plot in a new figure.
Usage:
 
figure_handle = plot(a_doc, props)
Description:
Only generate the contained plot for previewing. Opens a new figure.
Parameters:
 
a_doc:
A doc_plot object.
props:
A structure with any optional properties.
Returns:
 

figure_handle: Handle of newly opened figure.

Example:
 
» figure_handle = plot(a_doc_plot)
See also:
plot_abstract/plotFigure (p. [*]), doc_generate (p. [*]), doc_plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.13.4 Method doc_plot/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.13.5 Method doc_plot/plot_abstract

Summary:
Returns the plot_abstract object within the doc_plot.
Usage:
 
a_plot = plot_abstract(a_doc, title_str, props)
Description:
If a_doc is a vector, returns a vector of plot_abstract objects.
Parameters:
 
a_doc:
A doc_plot object.
title_str:
(Optional) String to replace plot title.
props:
A structure with any optional properties.

(rest passed to plot_abstract.)

Returns:
 

a_plot: A plot_abstract object or vector that can be visualized.

See also:
doc_plot/plot (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/17



width

1.13.6 Method doc_plot/getTeXString

Summary:
Returns the TeX representation for the plot document.
Usage:
 
tex_string = getTeXString(a_doc, props)
Description:
Plots, prints EPS files and generates the necessary LaTeX code.
Parameters:
 
a_doc:
A doc_plot object.
props:
A structure with any optional properties.
Returns:
 

tex_string: A string that contains TeX commands, which upon writing to a file, can be interpreted by the TeX engine to produce a document.

Example:
 
doc_plot has an overloaded getTeXString method:
» tex_string = getTeXString(a_doc_plot)
» string2File(tex_string, 'my_doc.tex')
then my_doc.tex can be used by including from a valid LaTeX document.
See also:
doc_generate (p. [*]), doc_plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.14 Class histogram_db

1.14.1 Constructor histogram_db/histogram_db

Summary:
A database of histogram values generated for a column of another database.
Usage:
 
a_hist_db = histogram_db(col_name, bins, hist_results, id, props)
Description:
This is a subclass of tests_db. Allows generating a histogram plot, etc. The histogram count is entered as a column named histVal.
Parameters:
 
col_name:
The column name of the histogrammed value.
bins:
The values for which the histogram values are calculated.
hist_results:
A column vector of histogram values.
id:
An identifying string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

tests_db, props.

Example:
 
» [hist_results, bins] = hist(my_data);
» a_hist_db = histogram_db('firing_rate', bins, hist_results, 'rate histogram db');
» plot(a_hist_db);
See also:
tests_db (p. [*]), plot_simple (p. [*]), tests_db/histogram (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/20



width

1.14.2 Method histogram_db/plotEqSpaced

Summary:
Generates a histogram plot where the values are equally spaced on the x-axis. For use with non-linear parameter values.
Usage:
 
a_plot = plotEqSpaced(a_hist_db, title_str, props)
Description:
Generates a plot_simple object from this histogram.
Parameters:
 
a_hist_db:
A histogram_db object.
title_str:
Optional title string.
props:
Optional properties passed to plot_abstract.
quiet:
If 1, don't include database name on title.
Returns:
 

a_plot: A object of plot_abstract or one of its subclasses.

See also:
plot_abstract (p. [*]), plot_simple (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.14.3 Method histogram_db/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.14.4 Method histogram_db/calcMode

Summary:
Finds the mode of the distribution, that is, the bin with the highest value.
Usage:
 
[mode_val, mode_mag] = calcMode(a_hist_db)
Parameters:
 
a_hist_db:
A histogram_db object.
Returns:
 

mode_val: The center of the bin that has most members. mode_mag: The value of the histogram bin.

See also:
histogram_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/27



width

1.14.5 Method histogram_db/plotRowMatrix

Summary:
Generates a subplot matrix of measure columns versus rows of databases.
Usage:
 
a_plot = plotRowMatrix(hist_dbs, title_str, props)
Description:
Each row in the hist_dbs is assumed to come from a different DB. Columns represent histograms of different measurements. The plot is made such that histograms in each row have the same maximal count, and histograms in each column have the same axis limits.
Parameters:
 
hist_dbs:
A matrix of histogram_db objects.
title_str:
Title to go at the top.
props:
A structure with any optional properties.
rowLabels:
Cell array of y-axis labels for each row.

(rest passed to histogram_db/plot_abstract)

Returns:
 

a_plot: A object of plot_abstract or one of its subclasses.

See also:
plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/11/22



width

1.14.6 Method histogram_db/subsref

Summary:
Defines generic indexing for objects.



width

1.14.7 Method histogram_db/plotPages

Summary:
Generates a plot containing subplots from each page of histograms.
Usage:
 
a_plot = plotPages(a_hist_db, title_str, props)
Description:
For each page of the histogram, a histogram is placed in a subplot.
Parameters:
 
a_hist_db:
A histogram_db object.
title_str:
(Optional) String to append to plot title.
props:
A structure with any optional properties, passed to plot_stack.
an_orient:
Stack orientation. One of 'x', or 'y' (Default='y'; vertical).
quiet:
If 1, only display given title_str.
Returns:
 

a_plot: A object of plot_abstract or one of its subclasses.

See also:
plotPages (p. [*]), plot_simple (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/04



width

1.14.8 Method histogram_db/plot_abstract

Summary:
Creates a bar plot from the histogram.
Usage:
 
a_plot = plot_abstract(a_hist_db, title_str, props)
Description:
Generates a plot_simple object from this histogram.
Parameters:
 
a_hist_db:
A histogram_db object.
props:
Optional properties passed to plot_abstract.
command:
Plot command (Optional, default='bar')
lineSpec:
Line specification passed to bar command.
logScale:
If 1, use logarithmic y-scale.
shading:
'faceted' (default) or 'flat'.
quiet:
If 1, don't include database name on title.
Returns:
 

a_plot: A object of plot_abstract or one of its subclasses.

See also:
plot_abstract (p. [*]), plot_simple (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.15 Class model_ct_bundle

1.15.1 Constructor model_ct_bundle/model_ct_bundle

Summary:
The model cip_trace dataset and the DB created from it bundled together.
Usage:
 
a_bundle = model_ct_bundle(a_dataset, a_db, a_joined_db, props)
Description:
This is a subclass of dataset_db_bundle, specialized for model datasets.
Parameters:
 
a_dataset:
A params_cip_trace_fileset object.
a_db:
The raw params_tests_db object created from the dataset. It only needs

to have the pAcip, trial, and ItemIndex columns.

a_joined_db:
The one-model-per-line DB created from the raw DB.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

dataset_db_bundle.

Example:
 
» a_joined_db = mergeMultipleCIPsInOne(a_db, ...)
» a_bundle = model_ct_bundle(a_params_cip_trace_fileset, a_db, a_joined_db)
See also:
dataset_db_bundle (p. [*]), tests_db (p. [*]), params_tests_dataset (p. [*]), params_tests_db/mergeMultipleCIPsInOne (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/13



width

1.15.2 Method model_ct_bundle/reportRankingToPhysiolNeuronsTeXFile

Summary:
Compare model DB to given physiol criterion and create a report.
Usage:
 
tex_filename = reportRankingToPhysiolNeuronsTeXFile(m_bundle, p_bundle, a_crit_db, props)
Description:
A LaTeX report is generated following the example in physiol_bundle/matchingRow. The filename contains the neuron name, followed by the traceset index as an identifier of pharmacological applications, as in gpd0421c_s34.
Parameters:
 
m_bundle:
A model_ct_bundle object.
p_bundle:
A physiol_bundle object.
a_crit_db:
The criterion neuron chosen with a matchingRow method.
props:
A structure with any optional properties.
filenameSuffix:
Append this identifier to the TeX filename.

(others passed to rankMatching)

Returns:
 

tex_filename: Name of LaTeX file generated.

See also:
tests_db/rankMatching (p. [*]), physiol_cip_traceset/cip_trace (p. [*]), physiol_bundle/matchingRow (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/18



width

1.15.3 Method model_ct_bundle/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.15.4 Method model_ct_bundle/plotComparefICurve

Summary:
Generates a f-I curve doc_plot comparing m_trial and to_index.
Usage:
 
a_plot = plotComparefICurve(m_bundle, m_trial, to_bundle, to_index, props)
Description:
Note that this is not a general method. to_bundle should have been able to accept any type of bundle. Most probably this method is redundant and deprecated.
Parameters:
 
m_bundle:
A model_ct_bundle object.
m_trial:
Trial number of model.
to_bundle:
A physiol_bundle object.
to_index:
TracesetIndex of neuron.
props:
A structure with any optional properties.
shortCaption:
This appears in the figure caption.
plotMStats:
If set, add the m_bundle stats plot.
plotToStats:
If set, add the to_bundle stats plot.
captionToStats:
Use this as its legend label.
quiet:
if given, no title is produced

(passed to plot_superpose)

Returns:
 

a_plot: A plot_superpose that contains a f-I curve plot.

Example:
 
» a_p = plotComparefICurve(r, 1);
» plotFigure(a_p, 'The f-I curve of best matching model');
See also:
plot_abstract (p. [*]), plot_superpose (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/16



width

1.15.5 Method model_ct_bundle/getNeuronRowIndex

Summary:
Returns the neuron index from bundle.
Usage:
 
a_row_index = getNeuronRowIndex(a_bundle, trial_num, props)
Parameters:
 
a_bundle:
A model_ct_bundle object.
trial_num:
The trial number of model neuron, or a DB row containing this.
props:
A structure with any optional properties.
Returns:
 

a_row_index: A row index of neuron in a_bundle.joined_db.

See also:
dataset_db_bundle (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/09



width

1.15.6 Method model_ct_bundle/ctFromRows

Summary:
Loads a cip_trace object from a raw data file in the a_mbundle.
Usage:
 
a_cip_trace = ctFromRows(a_mbundle, a_db|trials, cip_levels, props)
Description:
This is an overloaded method.
Parameters:
 
a_mbundle:
A model_ct_bundle object.
a_db:
A DB created by the dataset in the a_mbundle to read the trial numbers from.
trials:
A column vector with trial numbers.
cip_levels:
A column vector of CIP-levels to be loaded.
props:
A structure with any optional properties.

(passed to a_mbundle.dataset/cip_trace)

Returns:
 

a_cip_trace: One or more cip_trace objects that hold the raw data.

See also:
dataset_db_bundle/ctFromRows (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/07/13



width

1.15.7 Method model_ct_bundle/getNeuronLabel

Summary:
Constructs the neuron label from bundle.
Usage:
 
a_label = getNeuronLabel(a_bundle, trial_num, props)
Parameters:
 
a_bundle:
A physiol_cip_traceset_fileset object.
trial_num:
The trial number of model neuron.
props:
A structure with any optional properties.
Returns:
 

a_label: A string label identifying selected neuron in bundle.

See also:
dataset_db_bundle (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/05/26



width

1.15.8 Method model_ct_bundle/addToDB

Summary:
Concatenate to existing DB in the bundle.
Usage:
 
a_mbundle = addToDB(a_mbundle, a_raw_db, props)
Description:
If joinedDb is not given in props, calls treatSimDB to get the joined_db from this raw DB. Then concats to both db and joined_db in bundle.
Parameters:
 
a_mbundle:
A model_ct_bundle object.
a_crit_bundle:
A physiol_bundle having a crit_db as its joined_db.
props:
A structure with any optional properties.
joinedDb:
The joined version of a_raw_db.
dataset:
If given, this one is used to replace the fileset in the bundle.
Returns:
 

a_mbundle: a model_ct_bundle object containing the added DB.

Example:
 
» mbundle = addToDB(mbundle, params_tests_db(mfileset, [19684:59956]))
See also:
params_tests_fileset/addFiles (p. [*]), multi_fileset_gpsim_cns2005/addFileDir (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.15.9 Method model_ct_bundle/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.15.10 Method model_ct_bundle/reportCompareModelToPhysiolNeuron

Summary:
Generates a report by comparing given model neuron to given physiol neuron.
Usage:
 
a_doc_multi = reportCompareModelToPhysiolNeuron(m_bundle, trial_num, p_bundle, traceset_index, props)
Description:
Generates a report document with: - Figure displaying raw traces of the physiol neuron compared with the model neuron - Figure comparing f-I curves of the two neurons. - Figure comparing spont and pulse spike shapes of the two neurons.
Parameters:
 
m_bundle, p_bundle:
dataset_db_bundle objects of the model and physiology neurons.
trial_num:
Trial number of desired model neuron in m_bundle.
traceset_index:
TracesetIndex of desired neuron in p_bundle.
props:
A structure with any optional properties.
horizRow:
If defined, create a row-figure with all plots.
numPhysTraces:
Number of physiology traces to show in plot (>=1).
Returns:
 

a_doc_multi: A doc_multi object that can be printed as a PS or PDF file.

Example:
 
» printTeXFile(reportCompareModelToPhysiolNeuron(mbundle, 2222, pbundle, 34), 'a.tex')
See also:
doc_multi (p. [*]), doc_generate (p. [*]), doc_generate/printTeXFile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/24



width

1.15.11 Method model_ct_bundle/rankMatching

Summary:
Create a ranked_db from given criterion db.
Usage:
 
a_ranked_db = rankMatching(a_mbundle, a_crit_db, props)
Parameters:
 
a_mbundle:
A model_ct_bundle object.
a_crit_db:
A crit_db created by a matchingRow method.
props:
A structure with any optional properties.

(passed to tests_db/rankMatching)

Returns:
 

a_ranked_db: a ranked_db object containing the rankings.

See also:
tests_db/rankMatching (p. [*]), ranked_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/18



width

1.15.12 Method model_ct_bundle/collectPhysiolMatches

Summary:
Compare model DB to given physiol criteria and return some top matches.
Usage:
 
row_index = collectPhysiolMatches(a_mbundle, a_crit_bundle, props)
Parameters:
 
a_mbundle:
A model_ct_bundle object.
a_crit_bundle:
A physiol_bundle object that holds the criterion neuron.
props:
A structure with any optional properties.
showTopmost:
Number of top matching models to return (default=50)
Returns:
 

row_index: Row indices of best matching models.

See also:
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/18



width

1.15.13 Method model_ct_bundle/getTrialNum

Summary:
Extracts identifying neuron trial number from DB.
Usage:
 
trial_num = getTrialNum(a_bundle, a_db|trial_num, props)
Parameters:
 
a_bundle:
A physiol_cip_traceset_fileset object.
a_db:
DB rows representing deisred model neuron(s).
trial_num:
Trial numbers. If specified, this function does nothing but return them.
props:
A structure with any optional properties.
Returns:
 

trial_num: The trial number(s) identifying selected neuron(s) in bundle.

See also:
dataset_db_bundle (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/05/26



width

1.15.14 Method model_ct_bundle/plotCompareRanks

Summary:
Generates a plots of given ranks from the ranked_bundle.
Usage:
 
plots = plotCompareRanks(m_bundle, p_bundle, a_ranked_db, ranks, props)
Parameters:
 
m_bundle:
A model_ct_bundle object.
p_bundle:
A dataset_db_bundle object that originated the criterion.
a_ranked_db:
A ranked_db generated from ranking m_bundle.
ranks:
Vector of rank indices for which to generate the plots.
props:
A structure with any optional properties.
Returns:
 

plots: A structure that contains the joined_db, and the plot vectors trace_d100_plots and trace_h100_plots.

Example:
 
» plots = plotCompareRanks(r, 1:10);
» plotFigure(plots.trace_d100_plots(1), 'The best matching +100 pA CIP trace');
See also:
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/16



width

1.16 Class model_ranked_to_physiol_bundle

1.16.1 Constructor model_ranked_to_physiol_bundle/model_ranked_to_physiol_bundle

Summary:
A DB bundled with its dataset, ranked to a physiology DB bundle.
Usage:
 
r_bundle = model_ranked_to_physiol_bundle(a_dataset, a_db, a_ranked_db, a_crit_bundle, props)
Description:
This is a subclass of model_ct_bundle, specialized for model datasets.
Parameters:
 
a_dataset:
A params_cip_trace_fileset object.
a_db:
The raw params_tests_db object created from the dataset. It only needs

to have the pAcip, trial, and ItemIndex columns.

a_ranked_db:
The one-model-per-line DB created from the raw DB.
a_crit_bundle:
The bundle object associated with crit_db that caused the ranking in a_ranked_db.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

crit_bundle, model_ct_bundle.

See also:
model_ct_bundle (p. [*]), ranked_db (p. [*]), params_tests_dataset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/13



width

1.16.2 Method model_ranked_to_physiol_bundle/plotfICurve

Usage:
 
a_doc = docfICurve(r_bundle, crit_bundle, crit_db, props)
Parameters:
 
r_bundle:
A ranked_bundle object.
rank_num:
Rank index for which to generate the a_doc.
props:
A structure with any optional properties.
Returns:
 

a_doc: A doc_plot that contains a f-I curve plot and associated captions.

Example:
 
» a_d = docfICurve(r, 1);
» plot(a_d, 'The f-I curve of best matching model');
See also:
doc_generate (p. [*]), doc_plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/16



width

1.16.3 Method model_ranked_to_physiol_bundle/plotCompareRanks

Summary:
OBSOLETE - Generates a plots of given ranks from the ranked_bundle.
Usage:
 
plots = plotCompareRanks(r_bundle, crit_bundle, crit_db, props)
Parameters:
 
r_bundle:
A ranked_bundle object.
ranks:
Vector of rank indices for which to generate the plots.
props:
A structure with any optional properties.
Returns:
 

plots: A structure that contains the joined_db, and the plot vectors trace_d100_plots and trace_h100_plots.

Example:
 
» plots = plotCompareRanks(r, 1:10);
» plotFigure(plots.trace_d100_plots(1), 'The best matching +100 pA CIP trace');
See also:
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/16



width

1.16.4 Method model_ranked_to_physiol_bundle/comparisonReport

Summary:
OBSOLETE - Generates a report by comparing r_bundle with the given match criteria, crit_db from crit_bundle.
Usage:
 
a_doc_multi = comparisonReport(r_bundle, crit_bundle, crit_db, props)
Description:
Generates a LaTeX document with: - (optional) Raw traces compared with some best matches at different distances - Values of some top matching a_db rows and match errors in a floating table. - colored-plot of measure errors for some top matches. - Parameter distributions of 50 best matches as a bar graph.
Parameters:
 
r_bundle:
A dataset_db_bundle object that contains the DB to compare rows from.
crit_bundle:
A dataset_db_bundle object that contains the criterion dataset.
crit_db:
A tests_db object holding the match criterion tests and STDs

which can be created with matchingRow.

props:
A structure with any optional properties.
caption:
Identification of the criterion db (not needed/used?).
num_matches:
Number of best matches to display (default=10).
rotate:
Rotation angle for best matches table (default=90).
Returns:
 

tex_string: LaTeX document string.

See also:
displayRowsTeX (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/17



width

1.17 Class params_cip_trace_fileset

1.17.1 Constructor params_cip_trace_fileset/params_cip_trace_fileset

Summary:
Description of a raw dataset consisting of cip_trace files varying with parameter values.
Usage:
 
obj = params_cip_trace_fileset(file_pattern, dt, dy, pulse_time_start, pulse_time_width, id, props)
Description:
This is a subclass of params_tests_fileset.
Parameters:
 
file_pattern:
File pattern mathing all files to be loaded.
dt:
Time resolution [s]
dy:
y-axis resolution [ISI (V, A, etc.)]
pulse_time_start, pulse_time_width:

Start and width of the pulse [dt]

id:
An identification string
props:
A structure with any optional properties.
profile_class_name:
Use this profile class (Default: 'cip_trace_profile').

(All other props are passed to cip_trace objects)

Returns a structure object with the following fields:
 

params_tests_fileset, pulse_time_start, pulse_time_width.

Example:
 
» fileset = params_cip_trace_fileset('/home/abc/data/*.bin', 1e-4, 1e-3, 20001, 10000, 'sim dataset gpsc0501', struct('trace_time_start', 10001, 'type', 'sim', 'scale_y', 1e3))
See also:
params_tests_fileset (p. [*]), params_tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.17.2 Method params_cip_trace_fileset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.17.3 Method params_cip_trace_fileset/ctFromRows

Summary:
Loads a cip_trace object from raw data files in the fileset.
Usage:
 
a_cip_trace = ctFromRows(m_fileset, m_dball, a_db|itemIndices, cip_levels, props)
Parameters:
 
m_fileset:
A physiol_cip_traceset_fileset object.
m_dball:
A DB created by this fileset that contains the trial, pAcip, and ItemIndex cols.
a_db:
A DB that has one trial for each cip_trace to be loaded.
itemIndices:
A column vector with ItemIndex numbers.
cip_levels:
A column vector of CIP-levels to be loaded.
props:
A structure with any optional properties.
neuronLabel:
appropriate unique neuron label generated by the bundle.

(passed to params_cip_trace_fileset/cip_trace)

Returns:
 

a_cip_trace: One or more cip_trace objects that hold the raw data.

See also:
loadItemProfile (p. [*]), physiol_cip_traceset/cip_trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/07/13



width

1.17.4 Method params_cip_trace_fileset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.17.5 Method params_cip_trace_fileset/cip_trace_profile

Summary:
Loads a raw cip_trace_profile given a file_index to this fileset.
Usage:
 
a_cip_trace_profile = cip_trace_profile(fileset, file_index)
Parameters:
 
fileset:
A params_tests_fileset.
file_index:
Index of file in fileset.
Returns:
 

a_cip_trace_profile: A cip_trace_profile object.

See also:
cip_trace_profile (p. [*]), params_tests_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.17.6 Method params_cip_trace_fileset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.17.7 Method params_cip_trace_fileset/cip_trace

Summary:
Loads raw cip_traces for each given file_index in this fileset.
Usage:
 
a_cip_trace = cip_trace(fileset, file_index|a_db, props)
Parameters:
 
fileset:
A params_tests_fileset.
file_index:
A single or array of indices of files in fileset.
a_db:
A DB created by this fileset to read the item indices from.
props:
A structure with any optional properties.
neuronLabel:
Used for annotation purposes.
Returns:
 

a_cip_trace: A cip_trace object.

See also:
cip_trace (p. [*]), params_tests_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/13



width

1.17.8 Method params_cip_trace_fileset/loadItemProfile

Summary:
Loads a cip_trace_profile object from a raw data file in the fileset.
Usage:
 
[params_row, tests_row] = loadItemProfile(fileset, file_index)
Parameters:
 
fileset:
A params_tests_fileset.
file_index:
Index of file in fileset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.18 Class params_tests_dataset

1.18.1 Constructor params_tests_dataset/params_tests_dataset

Summary:
Contains a set of data objects or files of raw data varying with parameter values.
Usage:
 
obj = params_tests_dataset(list, dt, dy, id, props)
Description:
This is an abstract base class for keeping dataset information separate from the parameters-results database (params_tests_db). The list contents can be filenames or objects (such as cip_traces) from which to get the raw data. The dataset should have all the necessary information to create a db when needed. This is an abstract class, thet it it cannot act on its own. Only fully implemented subclasses can actually hold datasets. See methods below.
Parameters:
 
list:
Array of dataset items (filenames, objects, etc.).
dt:
Time resolution [s]
dy:
y-axis resolution [integral V, A, etc.]
id:
An identification string.
props:
A structure with any optional properties.
type:
type of file (default = '')
Returns a structure object with the following fields:
 

list, dt, dy, id, props (see above).

See also:
params_tests_db (p. [*]), params_tests_fileset (p. [*]), cip_traces_dataset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/02



width

1.18.2 Method params_tests_dataset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.18.3 Method params_tests_dataset/addItem

Summary:
Returns the new dataset with the added item.
Usage:
 
dataset = addItem(dataset, item)
Description:
Note that, this is NOT the way to create a dataset. It is only intended for small additions to an existing dataset. This method is too slow for creating large datasets. The normal method for creating datasets is providing the full list of items to the class constructor.
Parameters:
 
dataset:
A params_tests_dataset.
item:
New item to add in dataset.
Returns:
 

dataset: With the added item.

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/25



width

1.18.4 Method params_tests_dataset/readDBItems

Summary:
Reads all items to generate a params_tests_db object.
Usage:
 
[params, param_names, tests, test_names] = readDBItems(obj, items)
Description:
This is a generic method to convert from params_tests_fileset to a params_tests_db, or a subclass. This method depends on the paramNames, testNames, and itemResultsRow functions. Outputs of this function can be directly fed to the constructor of a params_tests_db or a subclass.
Parameters:
 
obj:
A params_tests_fileset object.
items:
(Optional) List of item indices to use to create the db.
Returns:
 

params, param_names, tests, test_names: See params_tests_db.

See also:
params_tests_db (p. [*]), params_tests_fileset (p. [*]), itemResultsRow testNames (p. [*]), paramNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/24



width

1.18.5 Method params_tests_dataset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.18.6 Method params_tests_dataset/getItemParams

Summary:
Get the parameter values of a dataset item.
Usage:
 
params_row = getItemParams(dataset, index, a_profile)
Description:
This method can retrieve the item parameters by using either the dataset and the index to find the item or simply by using the item profile, a_profile.
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
a_profile:
An item profile.
Returns:
 

params_row: Parameter values in the same order of paramNames

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/10



width

1.18.7 Method params_tests_dataset/testNames

Summary:
Returns the ordered names of tests for this dataset.
Usage:
 
test_names = testNames(dataset, item)
Description:
Looks at the results of the first file to find the test names.
Parameters:
 
dataset:
A params_tests_dataset.
Returns:
 

params_names: Cell array with ordered parameter names. item: (Optional) If given, read names by loading item at this index.

See also:
params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/10



width

1.18.8 Method params_tests_dataset/subsref

Summary:
Defines generic indexing for objects.



width

1.18.9 Method params_tests_dataset/subsasgn

Summary:
Defines generic index-based assignment for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.18.10 Method params_tests_dataset/params_tests_db

Summary:
Generates a params_tests_db object from the dataset.
Usage:
 
db_obj = params_tests_db(obj, items, props)
Description:
This is a converter method to convert from params_tests_dataset to params_tests_db. Uses readDBItems to read the files. A customized subclass should provide the correct paramNames, testNames, and itemResultsRow functions. Adds a ItemIndex column to the DB to keep track of raw data files after shuffling.
Parameters:
 
obj:
A params_tests_dataset object.
items:
(Optional) List of item indices to use to create the db.
props:
Any optional params to pass to params_tests_db.
Returns:
 

db_obj: A params_tests_db object.

See also:
readDBItems (p. [*]), params_tests_db (p. [*]), params_tests_dataset (p. [*]), itemResultsRow testNames (p. [*]), paramNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/09



width

1.18.11 Method params_tests_dataset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.18.12 Method params_tests_dataset/itemResultsRow

Summary:
Processes a raw data file from the dataset and return its parameter and test values.
Usage:
 
[params_row, tests_row] = itemResultsRow(dataset, index)
Description:
This method is designed to be reused from subclasses as long as the loadItemProfile method is properly overloaded. Adds an Index column to the DB to keep track of raw data items after shuffling.
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of file in dataset.
Returns:
 

params_row: Parameter values in the same order of paramNames tests_row: Test values in the same order with testNames

See also:
loadItemProfile (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/10



width

1.18.13 Method params_tests_dataset/getItem

Summary:
Returns the dataset item at given index.
Usage:
 
item = getItem(dataset, index)
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
Returns:
 

item: Object, filename, etc.

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/03



width

1.19 Class params_tests_db

1.19.1 Constructor params_tests_db/params_tests_db

Summary:
A generic database of test results varying with parameter values, organized in a matrix format.
Description:
This is a subclass of tests_db. Defines all operations on this structure so that subclasses can use them.
Parameters:
 
num_params:
Number of parameters.
a_tests_db:
A tests_db upon which to build the params_tests_db.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

tests_db num_params: Number of variable parameters in simulations.

See also:
tests_db (p. [*]), test_variable_db (N/I) (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/08



width

1.19.2 Method params_tests_db/getParamNames

Summary:
Gets parameter column names.
Usage:
 
col_names = getParamNames(db)
Description:
Convenience function that delegates to getColNames.
Parameters:
 
db:
A params_tests_db object.
Returns:
 

col_names: A cell array of strings.

See also:
tests_db/getColNames (p. [*]), tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2008/04/03



width

1.19.3 Method params_tests_db/matchingRow

Summary:
Creates a criterion database for matching the tests of a row.
Usage:
 
crit_db = matchingRow(a_db, row, props)
Description:
Overloaded method for skipping parameter values. STD for param values will be NaNs.
Parameters:
 
a_db:
A tests_db object.
row:
A row index to match.
props:
A structure with any optional properties.
distDB:
Take the standard deviation from this db instead.
Returns:
 

crit_db: A tests_db with two rows for values and STDs.

See also:
tests_db/matchingRow (p. [*]), rankMatching (p. [*]), tests_db (p. [*]), tests2cols (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/13



width

1.19.4 Method params_tests_db/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.19.5 Method params_tests_db/joinRows

Summary:
Joins the rows of the given db with rows of with_db with matching RowIndex values.
Usage:
 
a_db = joinRows(db, with_db, props)
Description:
Takes the desired columns in with_db with rows having a row index and joins them next to dedired columns from the current db. Assumes each row index only appears once in with_db. The created db preserves the ordering of with_db.
Parameters:
 
db:
A param_tests_db object.
with_db:
A tests_db object with a RowIndex column.
props:
A structure with any optional properties.
indexColName:
(Optional) Name of row index column (default='RowIndex').
Returns:
 

a_db: A params_tests_db object.

See also:
tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/16



width

1.19.6 Method params_tests_db/rankVsDB

Summary:
Generates a ranking DB by comparing rows of this db with the given test criteria.
Usage:
 
a_ranked_db = rankVsDB(a_db, crit_db)
Description:
Distance is each measure difference divided by the STD in to_db, squared and summed. Returned DB contains only the selected tests from crit_db and the parameters from initial a_db.
Parameters:
 
a_db:
A params_tests_db object to compare rows from.
crit_db:
A tests_db object holding the match criterion tests and STDs

which can be created with matchingRow.

Returns:
 

a_ranked_db: The created DB with original rows and a distance measure, in ascending order.

See also:
matchingRow (p. [*]), rankMatching (p. [*]), joinRows (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/20



width

1.19.7 Method params_tests_db/plotParamsHists

Summary:
Create a horizontal plot_stack of parameter histograms.
Usage:
 
a_ps = plotParamsHists(a_db, title_str, props)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
A params_tests_db object.
title_str:
(Optional) A string to be concatanated to the title.
props:
A structure with any optional properties.
quiet:
Do not display the DB id on the plot title.
barAxisProps:
passed to plotEqSpaced for each bar axis.
Returns:
 

a_ps: A horizontal plot_stack of plots

See also:
plot_stack (p. [*]), paramsHists (p. [*]), plotEqSpaced (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/07



width

1.19.8 Method params_tests_db/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.19.9 Method params_tests_db/scanParamAllRows

Summary:
Scans given parameter range for each row in DB.
Usage:
 
a_params_db = scanParamAllRows(a_db, param, min_val, max_val, num_levels, props)
Description:
Produces rows by replacing the desired parameter value, in all rows of DB, with num_levels values between the given boundaries, min_val and max_val. This results in a DB with num_levels times more rows than the original DB. Then, makeGenesisParFile can be used to generate a parameter file from this DB to drive new simulations.
Parameters:
 
a_db:
A params_tests_db object whose first row is subject to modifications.
param:
The parameter to be varied (see tests2cols for param description).
min_val, max_val:
The low and high boundaries for the parameter value.
num_levels:
Number of levels to produce, including the boundaries.
props:
A structure with any optional properties.
renameTrial:
If given, the 'trial' column is renamed to this name.
levelFunc:
Use this function to get the parameter range with

feval(levelFunc, min_val, max_val, num_levels). Example: 'logLevels'

Returns:
 

a_params_db: A db only with params.

Example:
 
Sets NaF to given range with 100 levels:
» naf_rows_db = scanParamAllRows(a_db(desired_rows, :), 'NaF', 0, 1000, 100);
See also:
makeGenesisParFile (p. [*]), scaleParamsOneRow (p. [*]), ranked_db/blockedDistances (p. [*]), getParamRowIndices (p. [*]), logLevels (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/16



width

1.19.10 Method params_tests_db/plotVarBoxMatrix

Summary:
Create a stack of parameter-test variation plots organized in a matrix.
Usage:
 
a_plot_stack = plotVarBoxMatrix(a_db, p_t3ds)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
A tests_db object.
p_t3ds:
Cell array of invariant parameter databases.
Returns:
 

a_plot_stack: A plot_stack with the plots organized in matrix form

See also:
params_tests_profile (p. [*]), plotVar (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/17



width

1.19.11 Method params_tests_db/meanDuplicateParams

Summary:
Takes the mean of all measures for rows that have the same parameter columns.
Usage:
 
a_params_tests_db = meanDuplicateParams(db, props)
Description:
Calls tests_db/meanDuplicateRows with params as main_cols and tests as rest_cols.
Parameters:
 
db:
A params_tests_db object.
props:
Structure with optional parameters.
Returns:
 

a_params_tests_db: The db object of with the means on page 1 and standard deviations on page 2.

See also:
tests_db/meanDuplicateRows (p. [*]), tests_db/mean (p. [*]), tests_db/std (p. [*]), sortedUniqueValues (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/12/20



width

1.19.12 Method params_tests_db/onlyRowsTests

Summary:
Returns a tests_db that only contains the desired tests and rows (and pages).
Usage:
 
obj = onlyRowsTests(obj, rows, tests, pages)
Description:
Selects the given dimensions and returns in a new tests_db object. Makes sure num_params remains correct.
Parameters:
 
obj:
A tests_db object.
rows, tests:
A logical or index vector of rows, or cell array of

names of rows. If ':', all rows. For names, regular expressions are supported if quoted with slashes (e.g., '/a.*/'). See tests2idx.

pages:
(Optional) A logical or index vector of pages. ':' for all pages.
Returns:
 

obj: The new tests_db object.

See also:
subsref (p. [*]), tests_db (p. [*]), test2idx (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/17



width

1.19.13 Method params_tests_db/paramsCoefs

Summary:
Calculates a corrcoefs_db for each param and collects them in a cell array.
Usage:
 
p_coefs = paramsCoefs(a_db, p_t3ds)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
A tests_db object.
p_t3ds:
Cell array of invariant parameter databases.
Returns:
 

p_coefs: A cell array of corrcoefs_dbs for each param in a_db.

See also:
params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/17



width

1.19.14 Method params_tests_db/unionCat

Summary:
Vertically concatenate two databases with different parameters or tests.
Description:
The parameters and tests in the result are a union of both. Adds 0 for parameter and NaN for tests in the rows which didn't have the additional columns before.
Author:
Li Su



width

1.19.15 Method params_tests_db/subsref

Summary:
Defines generic indexing for objects.



width

1.19.16 Method params_tests_db/displayRankingsTeX

Summary:
Generates and displays a ranking DB by comparing rows of a_db with the given match criteria.
Usage:
 
tex_string = displayRankingsTeX(a_db, crit_db, props)
Description:
Generates a LaTeX document with: - Values of 10 best matching a_db rows in a floating table. - (optional) Raw traces compared with some best matches at different distances - Parameter distributions of 50 best matches as a bar graph.
Parameters:
 
a_db:
A params_tests_db object to compare rows from.
crit_db:
A tests_db object holding the match criterion tests and STDs

which can be created with matchingRow.

props:
A structure with any optional properties.
caption:
Identification of the criterion db (not needed/used?).
a_dataset:
Dataset for a_db.
a_dball:
The non-joined DB for for a_db.
crit_dataset:
Dataset for crit_db.
crit_dball:
Dataset for crit_db.
num_matches:
Number of best matches to display (default=10).
rotate:
Rotation angle for best matches table (default=90).
Returns:
 

tex_string: LaTeX document string.

See also:
rankVsDB (p. [*]), displayRowsTeX (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/20



width

1.19.17 Method params_tests_db/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.19.18 Method params_tests_db/addParams

Summary:
Inserts new parameter columns to tests_db.
Usage:
 
obj = addParams(obj, param_names, param_columns)
Description:
Adds new columns to the database and returns the new DB. This operation is expensive in the sense that the whole database matrix needs to be enlarged just to add a single new column. The method of allocating a matrix, filling it up, and then providing it to the tests_db constructor is the preferred method of creating tests_db objects. This method may be used for measures obtained by operating on raw measures.
Parameters:
 
obj:
A tests_db object.
param_names:
A cell array of param names to be added.
param_columns:
Data matrix of columns to be added.
Returns:
 

obj: The tests_db object that includes the new columns.

See also:
allocateRows (p. [*]), tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/10/11



width

1.19.19 Method params_tests_db/makeGenesisParFile

Summary:
Creates a Genesis parameter file with all the parameter values in a_db.
Usage:
 
makeGenesisParFile(a_db, filename, props)
Description:
For each a_db row, print the parameter names in a file formatted for Genesis.
Parameters:
 
a_db:
A params_tests_db object.
filename:
Genesis parameter file to be created.
props:
A structure with any optional properties.
trialStart:
If given, adds/replaces the trial parameter and counts forward.
makeParamDesc:
If 1, put the parameter names in a parameter description file with

with a .txt extension.

Returns:
 

nothing.

Example:
 
» blocked_rows_db = makeModifiedParamDB(ranked_for_gps0501a_db, 1, [1, 2], 10, [-100 100]);
» makeGenesisParFile(blocked_rows_db, 'blocked_gps0501-03.par')
See also:
makeModifiedParamDB (p. [*]), scanParamAllRows (p. [*]), scaleParamsOneRow (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/03/13



width

1.19.20 Method params_tests_db/reIndexNeurons

Summary:
Re-index neurons with accending numbers.
Usage:
 
new_db = reIndexNeurons(a_db, startNum, colName)
Description:
This is useful for avoiding NeuronId conflicts when concatenating two databases. It can also remove the unused number 'hole' (e.g. after deleting rows) and make the indices continuous.
Parameters:
 
a_db:
a tests_db object
startNum:
the starting index number (default = 1)
colName:
the column name or number of neuron index. (default = 'NeuronId')
Returns:
 

new_db: a new database with new neuron index.

See also:
physiol_bundle (p. [*]), tests_db/physiol_bundle (p. [*])
Author:
Li Su. 03/21/2008



width

1.19.21 Method params_tests_db/rankVsAllDB

Summary:
Generates ranking DBs by comparing rows of a_db with each row of to_db.
Usage:
 
tex_string = rankVsAllDB(a_db, to_db, a_dataset, to_dataset)
Description:
Distance is each measure difference divided by the STD in to_db, squared and summed. Returned DB contains only the selected to_tests and the parameters from initial DB.
Parameters:
 
a_db:
A params_tests_db object to compare rows from.
to_db:
A tests_db object to compare it with.
a_dataset:
Dataset for a_db.
to_dataset:
Dataset for crit_db.
Returns:
 

ranked_dbs: Array of created DBs with original rows and a distance measure, in ascending order. tex_string: A LaTeX string for all tables created.

See also:
rankVsDB (p. [*]), matchingRow (p. [*]), rankMatching (p. [*]), joinRows (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/10



width

1.19.22 Method params_tests_db/paramsParamsCoefs

Summary:
Calculates a corrcoefs_db for each param from correlations of variant params and invariant param coefs and collects them in a cell array.
Usage:
 
pp_coefs = paramsParamsCoefs(a_db, p_t3ds, p_coefs)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
A tests_db object.
p_t3ds:
Cell array of invariant parameter databases.
p_coefs:
Cell array of tests coefficients for each parameter.
Returns:
 

pp_coefs: A cell array of corrcoefs_dbs for each param combination in a_db.

See also:
params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/17



width

1.19.23 Method params_tests_db/mergeMultipleCIPsInOne

Summary:
Merges multiple rows with different CIP data into one, generating a database of one row per neuron.
Usage:
 
a_db = mergeMultipleCIPsInOne(db, names_tests_cell, index_col_name, props)
Description:
It calls invarParam to separate DB into pages with different CIP level data. Then uses the names_tests_cell to choose tests from each page to be merged into the final database row. The tests will be suffixed with the field name so that they can be distinguished. RowIndex columns will be automatically included, and one of them can be chosen with index_col_name that has values for all cells. The suffixed for needs to be used to choose index_col_name, such as 'RowIndex_H100pA', assuming 'H100pA' was the field name in names_tests_cell that corresponds to page -100 pA.
Parameters:
 
db:
A params_tests_db object.
names_tests_cell:
A cell array alternating suffix names and test column vectors.

The order of names correspond to each unique CIP level in db, with increasing order.

index_col_name:
(Optional) Name of row index column

(default is 'RowIndex' suffixed with the first field name).

props:
A structure with any optional properties.
cipLevels:
In case db is missing some levels, provides a list of

cip levels that correspond to names_tests_cell db. Missing levels are replaced with NaN values. DB is filtered to remove other CIP levels.

Returns:
 

a_db: A params_tests_db object of organized values.

Example:
 
» control_phys_sdb =
mergeMultipleCIPsInOne(control_phys_db,
struct('_H100pA', [1:10], '_D100pA', [1:10 16:18]),
'RowIndex_H100pA')
See also:
invarValues (p. [*]), tests_3D_db (p. [*]), corrCoefs (p. [*]), tests_3D_db/plotVarBox (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/13



width

1.19.24 Method params_tests_db/getParamRowIndices

Summary:
Returns indices of rows with matching parameter values from rows of this db.
Usage:
 
row_indices = getParamRowIndices(a_db, rows, to_db)
Parameters:
 
a_db:
A params_tests_db object.
rows:
rows to find indices for.
to_db:
Where to find the matching rows.
Returns:
 

row_indices: Array of row indices.

See also:
makeModifiedParamDB (p. [*]), scanParamAllRows (p. [*]), scaleParamsOneRow (p. [*]), makeGenesisParFile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/14



width

1.19.25 Method params_tests_db/testsHists

Summary:
Calculates histograms for all tests and returns them in a cell array.
Usage:
 
t_hists = testsHists(a_db, num_bins)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
One or more tests_db objects in an array.
num_bins:
Number of histogram bins (Optional, default=100), or

vector of histogram bin centers.

Returns:
 

t_hists: An array of histograms for each test in a_db.

See also:
params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/17



width

1.19.26 Method params_tests_db/getDualCIPdb

Summary:
Generates a database by merging selected tests of depolarizing and hyperpolarizing cip results.
Usage:
 
a_db = getDualCIPdb(db, depol_tests, hyper_tests, depol_suffix, hyper_suffix)
Description:
depol_tests need to have the RowIndex column in it.
Parameters:
 
db:
A params_tests_db object.
Returns:
 

a_db: A params_tests_db object of organized values.

Example:
 
» control_phys_sdb = getDualCIPdb(control_phys_db, depol_tests, hyper_tests, '', 'Hyp100pA')
where depol_tests and hyper_tests are cell arrays of selected tests.
See also:
invarValues (p. [*]), tests_3D_db (p. [*]), corrCoefs (p. [*]), tests_3D_db/plotPair (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/13



width

1.19.27 Method params_tests_db/invarParam

Summary:
Generates a 3D database of invariant values of a parameter and all test columns.
Usage:
 
a_3D_db = invarParam(db, param)
Description:
Finds all combinations when the rest of the parameters are fixed, and saves the variation of the selected parameter and all tests in a new database.
Parameters:
 
db:
A tests_db object.
param:
A parameter name/column number
Returns:
 

a_3D_db: A tests_3D_db object of organized values.

See also:
invarValues (p. [*]), tests_3D_db (p. [*]), corrCoefs (p. [*]), tests_3D_db/plotPair (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/07



width

1.19.28 Method params_tests_db/getProfile

Summary:
Create a profile object from a params_tests_db by collecting statistics.
Usage:
 
a_pt_profile = getProfile(a_db, props)
Description:
Calculates the following results items: idx: Name-index pairs for accessing results arrays. t_hists: Cell array of histograms of each test. p_t3ds: Cell array of invariant relations of each parameter with all tests. pt_hists: Cell array of separate test value histograms for uniques value of each parameter. p_stats: Cell array of test stats for each param. p_coefs: Cell array of correlation coefficients for each parameter with all tests. pt_coefs_hists: Cell matrix of histograms of coefficients from correlations of each parameter with each test. pp_coefs: Cell 3D matrix of mean coefficients from correlations of each parameter with correlation coefficients of each parameter with each test.
Parameters:
 
a_db:
A params_tests_db object.
props:
A structure with any optional properties.
Returns a params_tests_profile object.
 

See also:
params_tests_profile (p. [*]), results_profile (p. [*]), params_tests_db (p. [*]), params_tests_fileset (p. [*]), tests_db (p. [*]), tests_3D_db (p. [*]), histogram_db (p. [*]), stats_db (p. [*]), corrcoefs_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/13



width

1.19.29 Method params_tests_db/delColumns

Summary:
Deletes columns from tests_db.
Usage:
 
index = delColumns(obj, tests)
Description:
Overloaded function that maintains correct number of parameters. See original tests_db/delColumns.
Parameters:
 
obj:
A tests_db object.
tests:
Numbers or names of tests (see tests2cols)
Returns:
 

obj: The tests_db object that is missing the columns.

See also:
tests_db/delColumns (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/10/11



width

1.19.30 Method params_tests_db/scaleParamsOneRow

Summary:
Scales chosen parameters in a row by multiplying with levels to create a new parameter db with as many rows as values in levels.
Usage:
 
a_params_db = scaleParamsOneRow(a_db, params, levels)
Description:
Produces rows by multiplying desired params, in the first row of DB, with each value in levels. Then, makeGenesisParFile can be used to generate a parameter file from this DB to drive new simulations.
Parameters:
 
a_db:
A params_tests_db object whose first row is subject to modifications.
params:
Parameters to be varied (see tests2cols for param description).
levels:
Column vector of parameter value multipliers (1=unity).
Returns:
 

a_params_db: A db only with params.

Example:
 
Blocks NaF from 0» naf_rows_db = scanOneParam(a_db(desired_row, :), 'NaF', 0:0.1:1);
See also:
ranked_db/blockedDistances (p. [*]), getParamRowIndices (p. [*]), makeGenesisParFile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/16



width

1.19.31 Method params_tests_db/paramsHists

Summary:
Calculates histograms for all parameters and returns in a cell array.
Usage:
 
p_hists = paramsHists(a_db)
Description:
Skips the 'ItemIndex' test. Useful for looking at subset databases and find out what parameter values are used most.
Parameters:
 
a_db:
A tests_db object.
Returns:
 

p_hists: An array of histograms for each parameter in a_db.

See also:
params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/20



width

1.19.32 Method params_tests_db/paramsTestsCoefsHists

Summary:
Calculates histograms for all pairs of params and tests coefficients and returns in a cell array.
Usage:
 
pt_coefs_hists = paramsTestsCoefsHists(a_db, p_coefs)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
A tests_db object.
p_coefs:
Cell array of tests coefficients for each parameter.
Returns:
 

pt_coefs_hists: A cell array of corrcoefs_dbs for each param in a_db.

See also:
params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/17



width

1.19.33 Method params_tests_db/crossProd

Summary:
Create a DB by taking the cross product of two database row sets.
Usage:
 
cross_db = crossProd(a_db, b_db)
Description:
Overloaded function to maintain correct number of parameters after cross product operation. See original in tests_db/crossProd.
Parameters:
 
a_db, b_db:
A tests_db object.
Returns:
 

cross_db: The tests_db object with all combinations of rows.

See also:
tests_db/crossProd (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/10/11



width

1.19.34 Method params_tests_db/invarParams

Summary:
Calculates invariant param dbs for all parameters and returns in an array.
Usage:
 
p_t3ds = invarParams(a_db)
Description:
Skips the 'ItemIndex' test.
Parameters:
 
a_db:
A tests_db object.
Returns:
 

p_t3ds: An array of tests_3D_dbs for each param in a_db.

See also:
params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/17



width

1.20 Class params_tests_fileset

1.20.1 Constructor params_tests_fileset/params_tests_fileset

Summary:
Description of a set of data files of raw data varying with parameter values.
Usage:
 
obj = params_tests_fileset(file_pattern, dt, dy, id, props)
Description:
This is a subclass of params_tests_dataset. This class is used to generate params_tests_db objects and keep a connection to the raw data files. This class only keeps names of files and loads raw data files whenever it's requested. A database object can easily be generated using the convertion methods. Most methods defined here can be used as-is, however some should be overloaded in subclasses. The specific methods are loadItemProfile.
Parameters:
 
file_pattern:
File pattern, or cell array of patterns, matching all

files to be loaded.

dt:
Time resolution [s]
dy:
y-axis resolution [ISI (V, A, etc.)]
id:
An identification string
props:
A structure with any optional properties.
num_params:
Number of parameters that appear in filenames.
param_trial_name:
Use this name on the filename as the 'trial' parameter.
param_row_filename:
If given, the 'trial' parameter will be used

to address rows from this file and acquire parameters.

param_desc_filename:
Contains the parameter range descriptions one per

each row. The parameter names are acquired from this file.

param_names:
Cell array of parameter names corresponding to the

param_row_filename columns can be specified as an alternative to specifying param_desc_filename. These names are not for the parameters present in the data filename.

profile_method_name:
It can be one of the profile-creating methods in this

class. E.g., 'trace_profile', 'srp_trace_profile', etc. (See parent classes and cip_trace object for more props)

Returns a structure object with the following fields:
 

params_tests_dataset, path: The pathname to files.

See also:
params_tests_db (p. [*]), tests_db (p. [*]), test_variable_db (N/I) (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/09



width

1.20.2 Method params_tests_fileset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.20.3 Method params_tests_fileset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.20.4 Method params_tests_fileset/trace_profile

Summary:
Loads a raw trace_profile given a file_index to this fileset.
Usage:
 
a_trace_profile = trace_profile(fileset, file_index)
Parameters:
 
fileset:
A params_tests_fileset.
file_index:
Index of file in fileset.
Returns:
 

a_trace_profile: A trace_profile object.

See also:
trace_profile (p. [*]), params_tests_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/13



width

1.20.5 Method params_tests_fileset/getItemParams

Summary:
Get the parameter values of a dataset item.
Usage:
 
params_row = getItemParams(dataset, index)
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
Returns:
 

params_row: Parameter values in the same order of paramNames

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/03



width

1.20.6 Method params_tests_fileset/addFiles

Summary:
Adds to existing list of files in set.
Usage:
 
[a_fileset, index_list] = addFiles(a_fileset, file_pattern, props)
Parameters:
 
a_fileset:
A params_tests_fileset object.
file_pattern:
File pattern, or cell array of patterns, matching additional files.
props:
A structure with any optional properties.
param_row_filename:
Update parameters from here. The 'trial' parameter is used

to address rows from this file and acquire parameters.

Returns:
 

a_fileset: The augmented fileset object. index_list: The vector of index numbers of the new files added. Can be used to selectively load the new files into a DB using params_test_db.

See also:
params_tests_fileset (p. [*]), params_tests_dataset/params_test_db. (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/01



width

1.20.7 Method params_tests_fileset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.20.8 Method params_tests_fileset/loadItemProfile

Summary:
Loads a profile object from a raw data file in the fileset.
Usage:
 
a_profile = loadItemProfile(fileset, file_index)
Description:
Subclasses should overload this function to load the specific profile object they desire. The profile class should define a getResults method which is used in the itemResultsRow method.
Parameters:
 
fileset:
A params_tests_fileset.
file_index:
Index of file in fileset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.20.9 Method params_tests_fileset/paramNames

Summary:
Returns the ordered names of parameters for this fileset.
Usage:
 
param_names = paramNames(fileset, item)
Description:
Looks at the filename of the first file to find the parameter names.
Parameters:
 
fileset:
A params_tests_fileset.
item:
(Optional) If given, read param names by loading item at this index.
Returns:
 

params_names: Cell array with ordered parameter names.

See also:
params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/10



width

1.20.10 Method params_tests_fileset/trace

Summary:
Loads a raw trace given a file_index to this fileset.
Usage:
 
a_trace = trace(fileset, file_index)
Parameters:
 
fileset:
A params_tests_fileset.
file_index:
Index of file in fileset.
Returns:
 

a_trace: A trace object.

See also:
trace (p. [*]), params_tests_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/13



width

1.21 Class params_tests_profile

1.21.1 Constructor params_tests_profile/params_tests_profile

Summary:
Holds the results profile from a params_tests_db.
Usage:
 
a_pt_profile = params_tests_profile(results, a_db, props)
Parameters:
 
a_db:
A params_tests_db object.
results:
A structure containing test results.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

results_profile: Contains results of tests. db: The params_tests_db. props.

See also:
results_profile (p. [*]), params_tests_db/params_tests_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/13



width

1.21.2 Method params_tests_profile/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.22 Class period

1.22.1 Constructor period/period

Summary:
Start and end times of a period in terms of the dt of the trace to which belongs.
Usage:
 
obj = period(start_time, end_time)
Parameters:
 

(see below for the rest)

Returns a structure object with the following fields:
 

start_time, end_time: Inclusive period [dt].

See also:
trace (p. [*]), spikes (p. [*]), spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/07/30



width

1.22.2 Method period/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.22.3 Method period/SpikeTimesinPeriod

Usage:
 
SpkTimes=Interval(times, period)
Parameters:
 
times:
an array of spike times.
period:
A period object
Returns:
 

the_period: The cropped set of spike times that fall within a period.

See also:
period (p. [*]), cip_trace (p. [*]), trace (p. [*]), spikes (p. [*])
Author:
Tom Sangrey, 2006/01/26



width

1.22.4 Method period/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.22.5 Method period/subsref

Summary:
Defines generic indexing for objects.



width

1.22.6 Method period/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.23 Class physiol_bundle

1.23.1 Constructor physiol_bundle/physiol_bundle

Summary:
The physiology dataset and the DB created from it bundled together.
Usage:
 
a_bundle = physiol_bundle(a_cell, props)
Description:
This is a subclass of dataset_db_bundle, specialized for physiology datasets.
Parameters:
 
a_cell:
A cell array that contains the following elements:
a_dataset:
A cell-enclosed physiol_cip_traceset_fileset object.
a_db:
The raw params_tests_db object created from the dataset.

It only needs to have the pAcip, pAbias, TracesetIndex, and ItemIndex columns.

a_joined_db:
The one-treatment-per-line DB created from the raw DB.
props:
A structure with any optional properties.
controlDB:
Use this as the ontrol DB rather than computing.
Returns a structure object with the following fields:
 

dataset_db_bundle, joined_control_db: DB of control neurons (no pharmacological applications).

See also:
dataset_db_bundle (p. [*]), tests_db (p. [*]), params_tests_dataset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/13



width

1.23.2 Method physiol_bundle/matchingControlNeuron

Summary:
Creates a criterion database for matching the neuron at traceset_index.
Usage:
 
a_crit_bundle = matchingControlNeuron(a_bundle, neuron_id, props)
Description:
Copies selected test values from row as the first row into the criterion db. Adds a second row for the STD of each column in the db.
Parameters:
 
a_bundle:
A physiol_bundle object.
neuron_id:
A NeuronId of the neuron to match.
props:
A structure with any optional properties.
Returns:
 

a_crit_bundle: A tests_db with two rows for values and STDs.

Example:
 
Matches gpd0421c from cip_traces_all_axoclamp.txt:
» a_crit_bundle = matchingControlNeuron(pbundle, 33)
(see example in matchingRow)
See also:
rankMatching (p. [*]), tests_db (p. [*]), tests2cols (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/21



width

1.23.3 Method physiol_bundle/matchingRow

Summary:
Creates a criterion database for matching the neuron at traceset_index.
Usage:
 
a_crit_db = matchingRow(p_bundle, traceset_index, props)
Description:
Copies selected test values from row as the first row into the criterion db. Adds a second row for the STD of each column in the db.
Parameters:
 
p_bundle:
A physiol_bundle object.
traceset_index:
A TracesetIndex of the neuron and treatments to match.
props:
A structure with any optional properties.
Returns:
 

a_crit_db: A tests_db with two rows for values and STDs.

Example:
 
physiol_bundle has an overloaded matchingRow method that
takes the TracesetIndex as argument:
» a_crit_bundle = matchingRow(pbundle, 61)
» a_ranked_bundle = rankMatching(mbundle, a_crit_bundle);
» printTeXFile(comparisonReport(a_ranked_bundle), 'my_report.tex')
See also:
rankMatching (p. [*]), tests_db/matchingRow (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/21



width

1.23.4 Method physiol_bundle/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.23.5 Method physiol_bundle/getNeuronRowIndex

Summary:
Returns the neuron index from bundle.
Usage:
 
a_row_index = getNeuronRowIndex(a_bundle, traceset_index, props)
Parameters:
 
a_bundle:
A physiol_bundle object.
traceset_index:
The TracesetIndex number of neuron, or a DB row containing this.
props:
A structure with any optional properties.
Returns:
 

a_row_index: A row index of neuron in a_bundle.joined_db.

See also:
dataset_db_bundle/getNeuronRowIndex (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/09



width

1.23.6 Method physiol_bundle/ctFromRows

Summary:
Loads a cip_trace object from a raw data file in the a_pbundle.
Usage:
 
a_cip_trace = ctFromRows(a_pbundle, a_db|traceset_idx, cip_levels, props)
Parameters:
 
a_pbundle:
A physiol_cip_traceset_fileset object.
a_db:
A DB created by this fileset to read the traceset indices from.
traceset_idx:
A column vector with traceset indices.
cip_levels:
A column vector of CIP-levels to be loaded.
props:
A structure with any optional properties.
traces:
column vector of trace indices to load.
showParamsList:
Cell array of params or treatments to include in the id field.
Returns:
 

a_cip_trace: One or more cip_trace object that holds the raw data.

See also:
loadItemProfile (p. [*]), physiol_cip_traceset/cip_trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/07/13



width

1.23.7 Method physiol_bundle/getNeuronLabel

Summary:
Constructs the neuron label from dataset.
Usage:
 
a_label = getNeuronLabel(a_bundle, traceset_index, props)
Parameters:
 
a_bundle:
A physiol_cip_traceset_fileset object.
traceset_index:
The traceset index of neuron.
props:
A structure with any optional properties.
Returns:
 

a_label: A string label identifying selected neuron in bundle.

See also:
dataset_db_bundle (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/05/05



width

1.23.8 Method physiol_bundle/plotfICurveStats

Summary:
Generates a f-I curve mean-std plot of physiology DB.
Usage:
 
a_plot = plotfICurveStats(p_bundle, title_str, props)
Parameters:
 
p_bundle:
A physiol_bundle object.
title_str:
(Optional) String to append to plot title.
props:
A structure with any optional properties.
quiet:
if given, no title is produced

(passed to plot_superpose)

Returns:
 

a_plot: An f-I curve plot.

Example:
 
» plotFigure(plotfICurveStats(pbundle));
See also:
dataset_db_bundle/plotfICurve (p. [*]), plot_abstract (p. [*]), plot_superpose (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/16



width

1.23.9 Method physiol_bundle/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.23.10 Method physiol_bundle/constrainedMeasuresPreset

Summary:
Returns a physiol_bundle with constrained measures according to chosen preset.
Usage:
 
[a_pbundle test_names] = constrainedMeasuresPreset(a_pbundle, preset, props)
Parameters:
 
a_pbundle:
A physiol_cip_traceset_fileset object.
preset:
Choose preset measure list (default=1).
props:
A structure with any optional properties.
Returns:
 

a_pbundle: One or more cip_trace object that holds the raw data.

See also:
loadItemProfile (p. [*]), physiol_cip_traceset/cip_trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/01/19



width

1.23.11 Method physiol_bundle/bestMatchAllNeurons

Summary:
Finds the best match among given database for each physiology neuron.
Usage:
 
all_ranks_db = bestMatchAllNeurons(p_bundle, joined_db, props)
Description:
Returns a database of best matching entries from joined_db for each entry in p_bundle.joined_control_db.
Parameters:
 
p_bundle:
A physiol_bundle object.
joined_db:
A database with neuron representations to rank against

neurons.

props:
A structure with any optional properties.

(passed to rankMatching)

Returns:
 

all_ranks_db: DB of best matching from joined_db. Each row corresponds to p_bundle.joined_control_db rows.

Example:
 
» all_ranks_db = ...
bestMatchAllNeurons(constrainedMeasuresPreset(pbundle2, 6), mbundle_maxcond.joined_db)
» plotXRows(all_ranks_db, 'Distance', 'maxcond DB distance per neuron', 'maxcond', ...
struct('LineStyle', '-', 'quiet', 1, 'PaperPosition', [0 0 4 3]))
See also:
tests_db/rankMatching (p. [*]), tests_db/matchingRow (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/05/24



width

1.24 Class physiol_cip_traceset

1.24.1 Constructor physiol_cip_traceset/physiol_cip_traceset

Summary:
Dataset of cip traces from same PCDX file.
Usage:
 
obj = physiol_cip_traceset(trace_str, data_src, chaninfo, dt, dy, treatments, neuron_id, props);
Description:
This is a subclass of params_tests_dataset. Each trace varies in bias, pulse times and cip magnitude.
Parameters:
 
trace_str:
Trace list in the format for loadtraces or just a Matlab vector.
data_src:
Absolute path of PCDX data source.
chaninfo:
4-element array containing vchan, ichan, vgain, igain
vchan, ichan:
Current and voltage channels.
vgain, igain:
External gain factors for voltage channel and current

channel (vgain does NOT include the 10X amplification from the Axoclamp, so vgain = 1 would mean no additional amplification beyond the 10X.)

dt:
Time resolution [s].
dy:
Y-axis resolution [V] or [A].
treatments:
Structure containing the names and concentrations

of compounds.

neuron_id:
Neuron name.
props:
A structure with any optional properties.
nsHDF5:
For NeuroSAGE HDF5 files, processing is faster if the output

of ns_open_file is given here. Must be defined to allow special NeuroSAGE processing.

profile_class_name:
Use this cip_trace function to return a

profile (Default: 'getProfileAllSpikes').

cip_list:
Vector of cip levels to which the current trace will be matched.

(All other props are passed to cip_trace objects)

Returns a structure object with the following fields:
 

params_tests_dataset, data_src, ichan, vchan, vgain, igain, treatments.

See also:
cip_traces (p. [*]), params_tests_dataset (p. [*]), params_tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu> and Thomas Sangrey, 2005/01/17



width

1.24.2 Method physiol_cip_traceset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.24.3 Method physiol_cip_traceset/setProp

Summary:
Generic method for setting optional object properties.
Usage:
 
obj = setProp(obj, prop1, val1, prop2, val2, ...)
Description:
Modifies or adds property values. As many property name-value pairs can be specified.
Parameters:
 
obj:
Any object that has a props field.
attr:
Property name
val:
Property value.
Returns:
 

obj: The new object with the updated properties.

See also:
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/22



width

1.24.4 Method physiol_cip_traceset/CIPform

Summary:
Extracts current bias and pulse information from the current channel.
Usage:
 
[ciptype, on, off, finish, bias, pulse] = ns_CIPform(traceset,trace_index)
Parameters:
 
traceset:
A physiol_cip_traceset object.
trace_index:
Index of item in traceset
See also:
cip_traces (p. [*]), params_tests_dataset (p. [*]), params_tests_db (p. [*])
Author:
Thomas Sangrey, 2005



width

1.24.5 Method physiol_cip_traceset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.24.6 Method physiol_cip_traceset/getItemParams

Summary:
Get the parameter values of a dataset item.
Usage:
 
params_row = getItemParams(dataset, index, a_profile)
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of item in dataset.
a_profile:
cip_trace_profile object
Returns:
 

params_row: Parameter values in the same order of paramNames

See also:
itemResultsRow (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/06



width

1.24.7 Method physiol_cip_traceset/cip_trace_profile

Summary:
Loads a cip_trace_profile object from a raw data file in the traceset.
Usage:
 
a_profile = cip_trace_profile(traceset, trace_index)
Parameters:
 
traceset:
A physiol_cip_traceset object.
trace_index:
Index of file in traceset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu> and Thomas Sangrey, 2005/01/18



width

1.24.8 Method physiol_cip_traceset/cip_trace

Summary:
Loads a cip_trace object from a raw data file in the traceset.
Usage:
 
a_cip_trace = cip_trace(traceset, trace_index, props)
Parameters:
 
traceset:
A physiol_cip_traceset object.
trace_index:
Index of file in traceset.
props:
A structure with any optional properties.
showParamsList:
Cell array of params to add to id field.
showName:
Show the name of the cell in the id field (default=1).
TracesetIndex:
Indicates in the id field.
Returns:
 

a_cip_trace: A cip_trace object that holds the raw data.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/07/13



width

1.24.9 Method physiol_cip_traceset/loadItemProfile

Summary:
Loads a cip_trace_profile object from a raw data file in the traceset.
Usage:
 
a_profile = loadItemProfile(traceset, trace_index)
Parameters:
 
traceset:
A physiol_cip_traceset object.
trace_index:
Index of file in traceset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.24.10 Method physiol_cip_traceset/itemResultsRow

Summary:
Processes a raw data file from the dataset and return its parameter and test values.
Usage:
 
[params_row, tests_row] = itemResultsRow(dataset, index)
Description:
This method is designed to be reused from subclasses as long as the loadItemProfile method is properly overloaded. Adds an Index column to the DB to keep track of raw data items after shuffling.
Parameters:
 
dataset:
A params_tests_dataset.
index:
Index of file in dataset.
Returns:
 

params_row: Parameter values in the same order of paramNames tests_row: Test values in the same order with testNames

See also:
loadItemProfile (p. [*]), params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/10



width

1.24.11 Method physiol_cip_traceset/paramNames

Summary:
Returns the parameter names for this traceset.
Usage:
 
param_names = paramNames(traceset)
Description:
Looks at the filename of the first file to find the parameter names.
Parameters:
 
traceset:
A params_tests_dataset.
Returns:
 

param_names: Cell array with ordered parameter names.

See also:
params_tests_dataset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/06



width

1.25 Class physiol_cip_traceset_fileset

1.25.1 Constructor physiol_cip_traceset_fileset/physiol_cip_traceset_fileset

Summary:
Physiological fileset of traceset objects (concatenated).
Usage:
 
obj = physiol_cip_traceset_fileset(traceset_items, dt, dy, props)
Description:
This is a subclass of params_tests_dataset. It contains a set of physiol_cip_traceset items that are tied to physical data sources. Each traceset can load a set of traces for an experimental recording. Most flexible usage is obtained when the input traceset_items is given as a cell array of physiol_cip_traceset objects. These objects can each link to PCDX or NeuroSAGE HDF5 files independent of each other. A regular Matlab script can be used to create such a cell array. If a function is defined to return such an array, it can be passed as traceset_items. Alternatively, the cell array can be constructed from an ASCII file as described below, such as for deprecated PCDX data files.
Parameters:
 
traceset_items:
It can be a function handle, cell array or filename

string. Function should return a cell array of physiol_cip_traceset items. Alternatively a preconstructed cell array can be provided directly. If it is an ASCII filename, then it should contain the following tab-delimited items: 1. Neuron ID (name to associate with the neuron). If left blank, use the filename with the '.all' extension removed. 2. The absolute path of the data file 3. The trace numbers to load, space-delimited (e.g. 1-21 24 26 27) 4. Vchan: voltage channel number 5. Ichan: current channel number 6. Vgain: external gain on voltage channel IN ADDITION to the 10X that automatically comes from the Axoclamp 2B. 7. Igain: external gain on current channel. 8. Pairs of condition names and molar concentrations in any order e.g.: TTX 1e-8 apamin 2e-7 picrotoxin 1e-4

Returns a structure object with the following fields:
 

neuron_idx: A structure that points from neuron names to NeuronId numbers. params_tests_dataset

See also:
physiol_cip_traceset (p. [*]), params_tests_dataset (p. [*]), params_tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu> and Thomas Sangrey, 2005/01/17



width

1.25.2 Method physiol_cip_traceset_fileset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.25.3 Method physiol_cip_traceset_fileset/setProp

Summary:
Generic method for setting optional object properties.
Usage:
 
obj = setProp(obj, prop1, val1, prop2, val2, ...)
Description:
Modifies or adds property values. As many property name-value pairs can be specified.
Parameters:
 
obj:
Any object that has a props field.
attr:
Property name
val:
Property value.
Returns:
 

obj: The new object with the updated properties.

See also:
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/22



width

1.25.4 Method physiol_cip_traceset_fileset/physiol_bundle

Summary:
Loads the database and then creates the physiol_bundle object.
Usage:
 
a_pbundle = physiol_bundle(fileset, props)
Description:
Calls params_tests_db to get the db, and then calls tests_db/physiol_bundle to do transformations.
Parameters:
 
fileset:
A physiol_cip_traceset_fileset object.
props:
A structure with any optional properties.

(Passed to tests_db/physiol_bundle)

Returns:
 

a_physiol_bundle: One or more physiol_bundle object that holds the raw data.

See also:
tests_db/physiol_bundle (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/12/21



width

1.25.5 Method physiol_cip_traceset_fileset/readDBItems

Summary:
Reads all items to generate a params_tests_db object.
Usage:
 
[params, param_names, tests, test_names] = readDBItems(obj, items)
Description:
This is a specific method to convert from physiol_cip_traceset_fileset to a params_tests_db, or a subclass. Outputs of this function can be directly fed to the constructor of a params_tests_db or a subclass.
Parameters:
 
obj:
A physiol_cip_traceset_fileset
items:
(Optional) List of item indices to use to create the db.
Returns:
 

params, param_names, tests, test_names: See params_tests_db.

See also:
params_tests_db (p. [*]), params_tests_fileset (p. [*]), itemResultsRow (p. [*])



width

1.25.6 Method physiol_cip_traceset_fileset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.25.7 Method physiol_cip_traceset_fileset/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.25.8 Method physiol_cip_traceset_fileset/vertcat

Summary:
Concatenates multiple physiol_cip_traceset_fileset objects.
Usage:
 
obj = vertcat(obj, obj2)
Description:
Concatenates the list contents, and combines the neuron_idx structures. The properties such as dt, dy and props are retained from first object.
Parameters:
 
obj, obj2:
Two physiol_cip_traceset_fileset objects without

overlapping neuron_id items.

Returns:
 

obj: The new object with combined contents.

See also:
physiol_cip_traceset_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2008/01/13



width

1.25.9 Method physiol_cip_traceset_fileset/cip_trace

Summary:
Loads a cip_trace object from a raw data file in the fileset.
Parameters:
 
fileset:
A physiol_cip_traceset_fileset object.
traceset_index:
Index of traceset item in this fileset (corresponds

to row in cells_filename) to find the cell information.

trace_index:
Index of item in the traceset.
a_db:
A DB created by this fileset to read the traceset and item indices from.
props:
A structure with any optional properties, passed to physiol_cip_traceset/cip_trace.
Returns:
 

a_cip_trace: One or more cip_trace object that holds the raw data.

See also:
loadItemProfile (p. [*]), physiol_cip_traceset/cip_trace (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/07/13



width

1.25.10 Method physiol_cip_traceset_fileset/loadItemProfile

Summary:
Loads a cip_trace_profile object from a raw data file in the fileset.
Usage:
 
a_profile = loadItemProfile(fileset, traceset_index, trace_index)
Parameters:
 
fileset:
A physiol_cip_traceset object.
traceset_index :
Index of traceset item in this fileset (corresponds

to row in cells_filename) to use grab the cell information.

trace_index:
Index of item in the traceset.
Returns:
 

a_profile: A profile object that implements the getResults method.

See also:
itemResultsRow (p. [*]), params_tests_fileset (p. [*]), paramNames (p. [*]), testNames (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14 and Tom Sangrey



width

1.25.11 Method physiol_cip_traceset_fileset/neuronNameFromId

Summary:
Returns string neuron names from a list of neuron ids.
Usage:
 
name_strs = neuronNameFromId(fileset, neuron_ids)
Parameters:
 
fileset:
A physiol_cip_traceset_fileset object.
neuron_ids:
One or more neuron ids in a vector.
Returns:
 

name_strs: Cell array of neuron names corresponding to the ids given.

See also:
physiol_cip_traceset_fileset (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/11/16



width

1.26 Class plot_abstract

1.26.1 Constructor plot_abstract/plot_abstract

Summary:
A plot that can be directly visualized or included in subplots.
Usage:
 
obj = plot_abstract(data, axis_labels, title, legend, command, props)
Description:
Base class that holds the necessary data to draw a plot. This data can then be used to generate different plots. Subclasses define specific plots with additional data. Subclasses should conform to the standard that the series of commands found in plotFigure should produce a valid figure.
Parameters:
 
data:
A cell array of data arrays (x, y, z, etc.) that can be

fed to plot commands.

axis_labels:
Cell array of axis label strings.
title:
Plot description string.
legend:
Cell array of descriptions for each item plotted.
command:
Plotting command to use (Optional, default='plot')
props:
A structure with any optional properties.
axisLimits:
Sets axis limits of non-NaN values in vector.
tightLimits:
If 1, issues an "axis tight" command (default=0)
border:
Relative size of border spacing around axis, between 0 - 1. (default=0)

If a scalar, equal border on all sides, give a four-element vector [left bottom right top] to define borders for each side.

colormap:
Figure colormap passed to the colormap function. If

function handle, its output is passed instead.

grid:
Display dashed grid in background.
noXLabel:
No X-axis label.
noYLabel:
No Y-axis label.
noTitle:
No title.
rotateXLabel:
Rotates the X-axis label for smaller width.
rotateYLabel:
Rotates the Y-axis label for smaller width.
numXTicks:
Number of ticks on X-axis.
formatXTickLabels:
The sprintf format string for tick labels.
XTick, YTick:
Point locations for axis ticks.
XTickLabel, YTickLabel:
Axis tick labels.
ColorOrder:
Set the ColorOrder of the axis.
LineStyleOrder:
Set the LineStyleOrder of the axis.
legendLocation:
Passed to legend(..., 'location', legendLocation).
legendOrientation:
Passed to legend(..., 'orientation', legendLocation).
noLegends:
If exists, no legends are displayed.
axisProps:
Passed to set properties of the axis drawn.
plotProps:
Passed to set properties of the plot drawn.
figureProps:
Passed to set properties of the figure drawn.
PaperPosition:
Sets the figure property for printing at this size.
resizeControl:
If 0, drawing after resize is disabled and prints at screen

size, if 1 (default), redraws figure after each resize event and prints at PaperPosition size.

fixedSize:
Vector of width and height in inches passed to

PaperPosition property. Implies resizeControl=0.

Returns a structure object with the following fields:
 

data, axis_labels, title, legend, command, props

See also:
plot_abstract/plot (p. [*]), plot_abstract/plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.26.2 Method plot_abstract/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.26.3 Method plot_abstract/plot

Summary:
Draws this plot in the current axis.
Usage:
 
handles = plot(a_plot, layout_axis)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
layout_axis:
The axis position to layout this plot (Optional).

If NaN, doesn't open a new axis.

Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.26.4 Method plot_abstract/setProp

Summary:
Generic method for setting optional object properties.
Usage:
 
obj = setProp(obj, prop1, val1, prop2, val2, ...)
Description:
Modifies or adds property values. As many property name-value pairs can be specified.
Parameters:
 
obj:
Any object that has a props field.
attr:
Property name
val:
Property value.
Returns:
 

obj: The new object with the updated properties.

See also:
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/22



width

1.26.5 Method plot_abstract/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.26.6 Method plot_abstract/subsref

Summary:
Defines generic indexing for objects.



width

1.26.7 Method plot_abstract/subsasgn

Summary:
Defines generic index-based assignment for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.26.8 Method plot_abstract/axis

Summary:
Returns the estimated axis ranges of this plot according to its data.
Usage:
 
ranges = axis(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
Returns:
 

ranges: The ranges as a vector in the same way 'axis' would return.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/13



width

1.26.9 Method plot_abstract/matrixPlots

Summary:
Superpose multiple plots with common command onto a single axis.
Usage:
 
a_plot = matrixPlots(plots, axis_labels, title_str, props)
Parameters:
 
plots:
Array of plot_abstract or subclass objects.
axis_labels:
Cell array of axis label strings (optional, taken from plots).
title_str:
Plot description string (optional, taken from plots).
props:
A structure with any optional properties passed to the Y stack_plot.
titlesPos, yLabelsPos, yTicksPos:
if specified, passed to the X stack_plots.
rotateYLabel:
if specified, passed to the X stack_plots.
axisLimits:
if specified, passed to the X stack_plots.
goldratio:
try to make the figure in this aspect ratio.
width, height:
if specified, make the figure have this many plots in

corresponding dimension.

Returns:
 

a_plot: A plot_abstract object.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*]), plot_abstract/plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/07



width

1.26.10 Method plot_abstract/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.26.11 Method plot_abstract/superposePlots

Summary:
Superpose multiple plots with common command onto a single axis.
Usage:
 
a_plot = superposePlots(plots, axis_labels, title_str, command, props)
Description:
The plot decoration will be taken from the last plot in the list, with the exception of legend labels.
Parameters:
 
plots:
Array of plot_abstract or subclass objects.
axis_labels:
Cell array of axis label strings (optional, taken from plots).
title_str:
Plot description string (optional, taken from plots).
command:
Plotting command to use (optional, taken from plots)
props:
A structure with any optional properties.
noLegends:
If exists, no legends are created.
Returns:
 

a_plot: A plot_abstract object.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*]), plot_abstract/plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/23



width

1.26.12 Method plot_abstract/decorate

Summary:
Places decorations (titles, labels, ticks, etc.) on the plot.
Usage:
 
handles = decorate(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.26.13 Method plot_abstract/plotFigure

Summary:
Draws this plot alone in a new figure window.
Usage:
 
handle = plotFigure(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
title_str:
(Optional) String to append to plot title.
Returns:
 

handle: Handle of new figure.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*]), plot_abstract/decorate (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.26.14 Method plot_abstract/openAxis

Summary:
Calculates the extents for the axis of this plot and opens it.
Usage:
 
[axis_handle, layout_axis] = openAxis(a_plot, layout_axis)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
layout_axis:
The axis position to layout this plot (Optional).

If NaN, doesn't open a new axis.

Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.27 Class plot_bars

1.27.1 Constructor plot_bars/plot_bars

Summary:
Bar plot with error lines in individual axes for each variable.
Usage:
 
a_plot = plot_bars(mid_vals, lo_vals, hi_vals, n_vals, x_labels, y_labels, ... title, axis_limits, props)
Description:
Subclass of plot_stack. The plot_abstract/plot command can be used to plot this data. Rows of *_vals will create grouped bars, columns will create new axes.
Parameters:
 
mid_vals:
Middle points of error bars.
lo_vals:
Low points of error bars.
hi_vals:
High points of error bars.
n_vals:
Number of samples used for the statistic (Optional).
x_labels, y_labels:
Axis labels for each bar group. Must match with data columns.
title:
Plot description.
axis_limits:
If given, all plots contained will have these axis limits.
props:
A structure with any optional properties.
dispBarsLines:
Choose between using 'bars' or 'lines' to connect the errorbars.
dispErrorbars:
If 1, display errorbars for lo_vals and hi_vals deviation from mid_vals

(default=1).

dispNvals:
If 1, display n_vals on top of each bar (default=1).
groupValues:
List of within-group labels passed to XTickLabels,

instead of just a sequence of numbers.

truncateDecDigits:
Truncate labels to this many decimal digits.
barAxisProps:
props passed to plot_abstract objects with bar commands
Returns a structure object with the following fields:
 

plot_abstract

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/07



width

1.27.2 Method plot_bars/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.28 Class plot_errorbar

1.28.1 Constructor plot_errorbar/plot_errorbar

Summary:
Generic errorbar plot.
Usage:
 
a_plot = plot_errorbar(x_vals, mid_vals, lo_vals, hi_vals, line_spec, axis_labels, title, legend, props)
Description:
Subclass of plot_abstract. The plot_abstract/plot command can be used to plot this data. Needed to create this as a separate class to have the axis ranges method to measure the errorbars.
Parameters:
 
x_vals:
X coordinates of errorbars.
mid_vals:
Middle points of error bars.
lo_vals:
Low points of error bars.
hi_vals:
High points of error bars.
line_spec:
Plot line spec to be passed to errorbar
axis_labels:
Cell array for X, Y axis labels.
title:
Plot description.
legend:
For multiple errorbar plots (matrix form), description of each plot.
props:
A structure with any optional properties to be passed to plot_abstract.
Returns a structure object with the following fields:
 

plot_abstract.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/07



width

1.28.2 Method plot_errorbar/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.28.3 Method plot_errorbar/axis

Summary:
Returns the estimated axis ranges of this plot according to its data.
Usage:
 
ranges = axis(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
Returns:
 

ranges: The ranges as a vector in the same way 'axis' would return.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/13



width

1.29 Class plot_errorbars

1.29.1 Constructor plot_errorbars/plot_errorbars

Summary:
Plots distributions of variables with errorbars in separate axes.
Usage:
 
a_plot = plot_errorbars(labels, mid_vals, lo_vals, hi_vals, labels, title, axis_limits, props)
Description:
Subclass of plot_stack. The plot_abstract/plot command can be used to plot this data. Each of mid_vals, lo_vals, and hi_vals plot its rows in the same axis and columns in different axes.
Parameters:
 
labels:
Labels of parameters to appear at bottom of each errorbar.
mid_vals:
Middle points of error bars.
lo_vals:
Low points of error bars.
hi_vals:
High points of error bars.
title:
Plot description.
axis_limits:
If given, all plots contained will have these axis limits.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

plot_abstract, labels.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/07



width

1.30 Class plot_image

1.30.1 Constructor plot_image/plot_image

Summary:
Generic image plot.
Usage:
 
a_plot = plot_image(image_data, axis_labels, colorbar_label, title_str, props)
Description:
Subclass of plot_abstract. The plot_abstract/plot command can be used to plot this data. Needed to create this as a separate class to have the axis ranges method implemented and take advantage of plot_abstract props.
Parameters:
 
image_data:
2D matrix with image data.
axis_labels:
Cell array for X, Y axis labels.
colorbar_label:
String to appear next to colorbar.
title_str:
Plot description.
props:
A structure with any optional properties.
colorbar:
If defined, show colorbar next to plot.
numGrads:
Number of poles in the colormap gradient. If 1 (default),

it will be a monocolor gradient (e.g., gray-level); if 2, it will be a dual-color gradient (e.g., blue to red) with a black crossing point. This point is determined by the minValue (below). Default numGrads=2, if negative values exist in image_data after scaling.

minValue,maxValue:
Use these value to scale the data by

(image_data - minValue) / (maxValue - minValue). Otherwise, its min and max is used.

colormap:
Colormap vector, function name or handle to colormap (e.g., 'jet').
numColors:
Number of colors in colormap.

(Rest passed to plotImage.)

Returns a structure object with the following fields:
 

plot_abstract.

Example:
 
» plotFigure(plot_image(rand(5), 'r1', 'r2', 'rand', 'random matrix'))
See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2008/04/15



width

1.30.2 Method plot_image/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.30.3 Method plot_image/axis

Summary:
Returns the estimated axis ranges of this plot according to its data.
Usage:
 
ranges = axis(a_plot)
Parameters:
 
a_plot:
A plot_abstract, or subclass, object.
Returns:
 

ranges: The ranges as a vector in the same way 'axis' would return.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*]), axis (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/13



width

1.31 Class plot_inset

1.31.1 Constructor plot_inset/plot_inset

Summary:
Superpose multiple plots with individual axis at arbitrary locations.
Usage:
 
a_plot = plot_inset(plots, axis_locations, title_str, props)
Description:
Subclass of plot_abstract. Contains other plot_abstract objects or subclasses thereof to be layout in arbitaray format. Allows overlapping and therefore good for insets and special plots.
Parameters:
 
plots:
Cell array of plot_abstract or subclass objects.
axis_locations:
Matrix of four-element vectors for each given plot.
title_str:
Title to go on top of the stack
props:
A structure with any optional properties.
positioning:
axis_locations interpreted as 'absolute' values or

'relative' to the 1st plot (default='absolute'). Relative positioning doesn't work well.

Returns a structure object with the following fields:
 

plot_abstract, plots, axis_locations.

See also:
plot_abstract (p. [*]), plot_abstract/plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/06/05



width

1.31.2 Method plot_inset/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.31.3 Method plot_inset/plot

Summary:
Superposes contained plots in their own axes.
Usage:
 
handles = plot(a_plot, layout_axis)
Parameters:
 
a_plot:
A plot_superpose object.
layout_axis:
The axis position to layout this plot (Optional).
Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2007/06/08



width

1.31.4 Method plot_inset/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.32 Class plot_simple

1.32.1 Constructor plot_simple/plot_simple

Summary:
Abstract description of a single plot.
Usage:
 
a_plot = plot_simple(data_x, data_y, title, label_x, label_y, legend, command, props)
Description:
Subclass of plot_abstract. The plot_abstract/plot command can be used to plot this data.
Parameters:
 
data_x:
X-axis values for the plot.
data_y:
Y-axis values for the plot.
title:
Plot description.
label_x:
X-axis label string.
label_y:
Y-axis label string.
legend:
Short description of data points.
command:
Plotting command to use (Optional, default='plot')
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

plot_abstract.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.32.2 Method plot_simple/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.32.3 Method plot_simple/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.33 Class plot_stack

1.33.1 Constructor plot_stack/plot_stack

Summary:
A horizontal or vertical stack of plots.
Usage:
 
a_plot = plot_stack(plots, axis_limits, orientation, title_str, props)
Description:
Subclass of plot_abstract. Contains other plot_abstract objects or subclasses thereof to be layout in stack format.
Parameters:
 
plots:
Cell array of plot_abstract or subclass objects.
axis_limits:
If given, all plots contained will have these axis

limits. In this vector, NaNs are untouched, Infs are replaced by minimal and maximal ranges of the stacked plots.

orientation:
Stack orientation 'x' for horizontal, 'y' for vertical, etc.
title_str:
Title to go on top of the stack
props:
A structure with any optional properties.
yLabelsPos:
'left' means only put y-axis label to leftmost plot.
yTicksPos:
'left' means only put y-axis ticks to leftmost plot.
xLabelsPos:
'bottom' means only put x-axis label to lowest plot.
xTicksPos:
'bottom' means only put x-axis ticks to lowest plot.
titlesPos:
'top' means only put title to top plot.
relaxedLimits:
Add 10
relativeSizes:
An array specifying relative size of each plot with one value.

(Example: relativeSizes=[1 2] makes second plot twice wider than first.)

Returns a structure object with the following fields:
 

plot_abstract, plots, axis_limits, orient.

See also:
plot_abstract (p. [*]), plot_abstract/plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/04



width

1.33.2 Method plot_stack/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.33.3 Method plot_stack/plot

Summary:
Draws this plot in the current axis or at the position in layout_axis.
Usage:
 
handles = plot(a_plot, layout_axis)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
layout_axis:
The axis position to layout this plot (Optional).
Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_stack (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/04



width

1.33.4 Method plot_stack/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.33.5 Method plot_stack/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.33.6 Method plot_stack/superposePlots

Summary:
Superpose multiple plot_stack objects that contain exact same contents.
Usage:
 
a_plot = superposePlots(plots, axis_labels, title_str, command, props)
Description:
The plot decoration will be taken from the last plot in the list, with the exception of legend labels.
Parameters:
 
plots:
Array of plot_stack objects.
axis_labels:
Cell array of axis label strings (optional, taken from plots).
title_str:
Plot description string (optional, taken from plots).
command:
Plotting command to use (optional, taken from plots)
props:
A structure with any optional properties.
noLegends:
If exists, no legends are created.
Returns:
 

a_plot: A plot_stack object.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*]), plot_abstract/plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/14



width

1.33.7 Method plot_stack/decorate

Summary:
No additional decorations for stacked plots.
Usage:
 
a_histogram_db = decorate(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/04



width

1.34 Class plot_superpose

1.34.1 Constructor plot_superpose/plot_superpose

Summary:
Multiple plot_abstract objects superposed on the same axis.
Usage:
 
obj = plot_superpose(plots, axis_labels, title_str, props)
Description:
Subclass of plot_abstract. Contains multiple plot_abstract objects to be plotted on the same axis. This is different than the plot_abstract/superpose, where only using the same plot command is allowed. Here, each plot_abstract can have its own special plotting command. Subclasses of plot_abstract is also allowed here. The decorations comes from this object and not children plots. This behavior is different than plot_stack, where each plot has its own decorations. If you want each plot to have its own axis (e.g. an inset, or plot with multiple axis labels) then you should use plot_inset.
Parameters:
 
plots:
Cell array of plot_abstract or subclass objects.
axis_labels:
Cell array of axis label strings.
title_str:
Plot description string.
props:
A structure with any optional properties (passed to plot_abstract).
Returns a structure object with the following fields:
 

plot_abstract, plots

See also:
plot_abstract/superpose (p. [*]), plot_superpose/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/22



width

1.34.2 Method plot_superpose/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.34.3 Method plot_superpose/plot

Summary:
Draws this plot in the current axis.
Usage:
 
handles = plot(a_plot, layout_axis)
Parameters:
 
a_plot:
A plot_superpose object.
layout_axis:
The axis position to layout this plot (Optional).
Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/08



width

1.34.4 Method plot_superpose/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.34.5 Method plot_superpose/axis

Summary:
Returns the maximal axis ranges according to superposed subplots.
Usage:
 
ranges = axis(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
Returns:
 

ranges: The ranges as a vector in the same way 'axis' would return.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/05/22



width

1.34.6 Method plot_superpose/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.34.7 Method plot_superpose/superposePlots

Summary:
Superpose multiple plot_superpose objects by merging them into one.
Usage:
 
a_plot = superposePlots(plots, axis_labels, title_str, command, props)
Parameters:
 
plots:
Array of plot_superpose objects.
axis_labels:
Cell array of axis label strings (optional, taken from plots).
title_str:
Plot description string (optional, taken from plots).
command:
Plotting command to use (optional, taken from plots)
props:
A structure with any optional properties.
noLegends:
If exists, no legends are created.
Returns:
 

a_plot: A plot_superpose object.

See also:
plot_abstract/superposePlots (p. [*]), plot_stack/superposePlots (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/14



width

1.34.8 Method plot_superpose/decorate

Summary:
Places decorations using the first plot of the superposed plots.
Usage:
 
handles = decorate(a_plot)
Parameters:
 
a_plot:
A plot_abstract object, or a subclass object.
Returns:
 

handles: Handles of graphical objects drawn.

See also:
plot_abstract (p. [*]), plot_abstract/plot (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/11



width

1.35 Class ranked_db

1.35.1 Constructor ranked_db/ranked_db

Summary:
A database of distance values generated by ranking rows of orig_db with the criterion in crit_db.
Usage:
 
a_ranked_db = ranked_db(data, col_names, orig_db, crit_db, id, props)
Description:
This is a subclass of tests_db. It should contain a Distance column. A more general ranked db class may be needed later. Use the rankMatching method to get an instance of this class.
Parameters:
 
data:
Database contents.
col_names:
The column names.
orig_db:
DB whose rows are ranked.
crit_db:
The criterion DB used for generating the ranking scores.
id:
An identifying string.
props:
A structure with any optional properties.
tolerateNaNs:
If 0, rows with any NaN values are skipped (default=1).
Returns a structure object with the following fields:
 

tests_db, orig_db, crit_db, props.

See also:
tests_db (p. [*]), tests_db/rankMatching (p. [*]), tests_db/matchingRow (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/21



width

1.35.2 Method ranked_db/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.35.3 Method ranked_db/plotRowErrors

Summary:
Create plot of rankings with errors associated with each measure color-coded.
Usage:
 
a_plot = plotRowErrors(a_ranked_db, rows, props)
Parameters:
 
a_ranked_db:
A ranked_db object.
rows:
Indices of rows in a_ranked_db.
title_str:
(Optional) String to append to plot title.
props:
A structure with any optional properties.
sortMeasures:
If specified, measure order is determined with increasing

overall distance.

RowName:
Label to show on X-axis (default='Ranks')
rowSteps:
Steps to jump in labeling rows on the x-axis.
superposeDistances:
Superpose a white-colored distance line plot.

(rest passed to plot_abstract)

Returns:
 

a_plot: A plot_abstract object.

See also:
ranked_db (p. [*]), tests_db/rankMatching (p. [*]), plot_abstract (p. [*]), plotImage (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/12



width

1.35.4 Method ranked_db/joinOriginal

Summary:
Joins the distance values to the original db rows with matching row indices.
Usage:
 
a_db = joinOriginal(a_ranked_db, rows)
Description:
Takes the parameter columns from orig_db and all tests from crit_db.
Parameters:
 
a_ranked_db:
A ranked_db object.
rows:
Join only the given rows.
Returns:
 

a_db: A params_tests_db object (same type as a_ranked_db.orig_db) containing the desired rows in ascending order of distance.

See also:
tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/12/21



width

1.35.5 Method ranked_db/plotDistMatrix

Summary:
Create a color-coded matrix plot of with total errors from the ranked DB.
Usage:
 
a_plot = plotDistMatrix(db, rows, col_size, col_name, num_col_labels, row_name, num_row_labels, title_str, props)
Description:
The col_size parameter is used to find the number of rows that make up the x-dimension of the color matrix plot.
Parameters:
 
db:
A ranked_db object.
rows:
Indices of rows in db after joining (and sorting).
col_size:
Number of rows to take from DB to form the columns of matrix plot.
col_name, row_name:
DB column to use for the figure column and row, respectively.
num_col_labels, num_row_labels:
Number of labels to put on each axis.
title_str:
If non-empty, replaces generic title with db name.
props:
A structure with any optional properties.
sortBy:
If specified, db is sorted after being joined with original using this column.
colorbar:
Put a colorbar on the figure.

(also passed to plot_abstract)

Returns:
 

a_plot: A plot_abstract object.

Example:
 
» plotFigure(plotDistMatrix(scored_blocked_sk_gps0503b_control_db, ':', 10, 'SK', 10, 'trial', 10, 'gps0503b (control), preset 6 - top 50 matches', struct('sortBy', 'trial', 'colorbar', 1, 'PaperPosition', [0 0 5 3])));
See also:
ranked_db (p. [*]), plot_abstract (p. [*]), getDistMatrix (p. [*]), plotCompareDistMatx (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/12



width

1.35.6 Method ranked_db/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.35.7 Method ranked_db/renameColumns

Summary:
Rename an existing column or columns.
Usage:
 
a_db = renameColumns(a_db, test_names, new_names)
Description:
This method is an overloaded method for ranked_db that keeps consistent the column names of the ranked, criterion and original DBs. The other DBs are not renamed for the Distance and RowIndex columns.
Parameters:
 
a_db:
A ranked_db object.
test_names:
A cell array of existing test names.
new_names:
New names to replace existing ones.
Returns:
 

a_db: The ranked_db object that includes the new columns.

See also:
tests_db/renameColumns (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/06/07



width

1.35.8 Method ranked_db/subsref

Summary:
Defines generic indexing for objects.



width

1.35.9 Method ranked_db/plotCompareDistMatx

Summary:
Compare differences and correlations of distance matrices from two ranked DBs.
Usage:
 
a_plot = plotCompareDistMatx(db, rows, col_size, col_name, num_col_labels, row_name, num_row_labels, title_str, props)
Description:
Produces three plots: (1) distance difference matrix, (2) 2D cross-correlogram, and (3) repeated 1D cross-correlogram for each row.
Parameters:
 
db, w_db:
The ranked_db objects to be compared.
rows:
Indices of rows in db after joining (and sorting) for both DBs.
col_size:
Number of rows to take from DB to form the columns of matrix plot.
col_name, row_name:
DB column to use fot the figure column and row, respectively.
num_col_labels, num_row_labels:
Number of labels to put on each axis.
title_str:
If non-empty, replaces generic title with db name.
props:
A structure with any optional properties.
sortBy:
If specified, db is sorted after being joined with original using this column.
colorbar:
Put a colorbar on the figure.

(also passed to plot_abstract)

Returns:
 

a_plot: A plot_abstract object.

See also:
tests_db (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/12



width

1.35.10 Method ranked_db/displayRows

Summary:
Displays rows of rankings together with errors associated with each measure.
Usage:
 
s = displayRows(db, rows)
Parameters:
 
db:
A tests_db object.
rows:
Indices of rows in db.
Returns:
 

s: A structure of column name and value pairs.

See also:
tests_db (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/15



width

1.35.11 Method ranked_db/getDistMatrix

Summary:
Create a matrix of total errors from the ranked DB.
Usage:
 
distmatx = getDistMatrix(db, rows, col_size, props)
Description:
The col_size parameter is used to find the number of rows that make up the x-dimension of the matrix.
Parameters:
 
db:
A tests_db object.
rows:
Indices of rows in db after joining (and sorting).
col_size:
Number of rows to take from DB to form the columns of matrix plot.
props:
A structure with any optional properties.
sortBy:
If specified, db is sorted after being joined with original using this column.
Returns:
 

a_plot: A plot_abstract object.

See also:
tests_db (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/12/12



width

1.35.12 Method ranked_db/blockedDistances

Summary:
Creates a db of distances to blocked versions of top ranks.
Usage:
 
[a_db, ranked_dbs] = blockedDistances(a_ranked_db, rows, blocked_db, blocked_param_indices, block_levels, crit_db)
Parameters:
 
a_ranked_db:
A ranked_db object.
rows:
Use the given row rankings.
blocked_db:
db with blocked versions of original ranks.
blocked_param_indices:
Indices of parameters to be blocked.
block_levels:
Number of parameter levels for blocking.
crit_db:
Calculate distance from this criterion.
Returns:
 

a_db: A tests_db object with the matrix of distances. ranked_dbs: A cell array of ranked_dbs for each row.

Example:
 
» dist_matx_db = blockedDistances(rankMatching(super_db, matchingRow(rsuper_phys_db, 20)), 1:5, super_blocker_db, [1 2], 10, matchingRow(rsuper_phys_db, 21))
See also:
makeModifiedParamDB (p. [*]), getParamRowIndices (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/01/14



width

1.36 Class results_profile

1.36.1 Constructor results_profile/results_profile

Summary:
Creates and collects result profiles for data objects.
Usage:
 
obj = results_profile(results, id, props)
Description:
This is the base class for all profile classes.
Parameters:
 
results:
A structure containing test results.
id:
Identification string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

results, id, props.

See also:
trace_profile (p. [*]), cip_trace_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.36.2 Method results_profile/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.36.3 Method results_profile/plot

Summary:
Generic method to plot a tests_db or a subclass. Requires a plot_abstract method to be defined for this object.
Usage:
 
h = plot(a_tests_db, title_str)
Parameters:
 
a_tests_db:
A histogram_db object.
title_str:
(Optional) String to append to plot title.
Returns:
 

h: The figure handle created.

See also:
plot_abstract (p. [*]), plotFigure (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/06



width

1.36.4 Method results_profile/getResults

Summary:
Return the results profile structure.
Usage:
 
results = getResults(p)
Parameters:
 
p:
A result_profile object.
Returns:
 

results: A structure associating test names to values.

See also:
results_profile (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.36.5 Method results_profile/subsref

Summary:
Defines generic indexing for objects.



width

1.36.6 Method results_profile/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.37 Class script_array

1.37.1 Constructor script_array/script_array

Summary:
Generic class that provides the scripts for a repetitive array job.
Usage:
 
obj = script_array(num_runs, id, props)
Description:
This is the base class for all script_array classes. Runs the runJob method as num_runs many times.
Parameters:
 
num_runs:
The number of times the runJob script should be evoked.
id:
Identification string.
props:
A structure with any optional properties.
runJobFunc:
A function name or handle to be used instead of default runJob.
Returns a structure object with the following fields:
 

num_runs, id, props.

Example:
 
» func1 = inline('x^2')
» runFirst(script_array(10, 'squares numbers up to 10'), struct('runJobFunc', func1))
ans = [ 1] [ 4] [ 9] [ 16] [ 25] [ 36] [ 49] [ 64] [ 81] [100]
See also:
runFirst (p. [*]), runLast (p. [*]), runJob (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/01



width

1.37.2 Method script_array/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.37.3 Method script_array/runJob

Summary:
Method to be called for each of the script_array jobs.
Usage:
 
job_result = runJob(a_script_array, vector_index)
Description:
This method is provided as a placeholder and does nothing. If the run_job_func property is defined, it will call that function.
Parameters:
 
a_script_array:
A script_array object.
vector_index:
The index within the vector job.
Returns:
 

job_result: Any output produced by the job.

Example:
 
See real example in script_array. Call the 5th job:
» runJob(script_array(10, 'this one does nothing for 10 times'), 5);
See also:
runLast (p. [*]), runFirst (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/01



width

1.37.4 Method script_array/runLast

Summary:
Method to be called last after the script_array jobs.
Usage:
 
job_results = runLast(a_script_array, job_results)
Description:
This method is provided as a placeholder and does nothing. It can filter-out the results returned from the jobs run. Normally it is invoked internally by the runFirst method, after running and collecting results from the vector jobs with the runJob method.
Parameters:
 
a_script_array:
A script_array object.
job_results:
The index within the vector job.
Returns:
 

job_results: Any output produced by the job.

Example:
 
Call it directly:
» runLast(script_array(10, 'this one does nothing for 10 times'), );
See also:
runJob (p. [*]), runFirst (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/01



width

1.37.5 Method script_array/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.37.6 Method script_array/subsref

Summary:
Defines generic indexing for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.37.7 Method script_array/subsasgn

Summary:
Defines generic index-based assignment for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.37.8 Method script_array/runFirst

Summary:
Method to be called at beginning of script_array jobs.
Usage:
 
job_results = runFirst(a_script_array)
Description:
This method initiates the script_array jobs. It loops and calls runJob and finally calls runLast.
Parameters:
 
a_script_array:
A script_array object.
Returns:
 

job_results: A cell array of results collected from each item of the vector jobs.

Example:
 
» runFirst(script_array(10, 'this one does nothing for 10 times'));
See also:
runLast (p. [*]), runJob (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/01



width

1.38 Class script_array_for_cluster

1.38.1 Constructor script_array_for_cluster/script_array_for_cluster

Summary:
Generic class defining a repetitive vector job to be run on a Sun Grid Engine (SGE) computing cluster.
Usage:
 
a_script_cluster = script_array_for_cluster(num_runs, sge_wrapper_script, id, props)
Description:
This is a subclass of the script_array class. The runFirst method spawns num_runs copies of the runJob method in parallel on the cluster, followed by the invocation of the runLast method.
Parameters:
 
num_runs:
The number of times the runJob script should be evoked.
sge_wrapper_script:
A script that can be submitted with qsub and can execute arbitrary

Matlab commands on the cluster nodes. It can have qsub options prepended to it such as '-p -100 -q all.q <abs_path_to>/sge_matlab.sh'.

id:
Identification string.
props:
A structure with any optional properties.
notifyByMail:
An SGE notification email is sent to this address after lastJob.

(others passed to script_array)

Returns a structure object with the following fields:
 

num_runs, id, props.

See also:
runFirst (p. [*]), runLast (p. [*]), runJob (p. [*]), script_array (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/02



width

1.38.2 Method script_array_for_cluster/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.38.3 Method script_array_for_cluster/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/06



width

1.38.4 Method script_array_for_cluster/runFirst

Summary:
Method to be called at beginning of script_array_for_cluster jobs.
Usage:
 
job_results = runFirst(a_script_cluster)
Description:
This method initiates the script_array_for_cluster jobs. It submits an SGE vector job for running each runJob and finally runLast. There is no way of collecting outputs from individual runJob calls.
Parameters:
 
a_script_cluster:
A script_array_for_cluster object.
Returns:
 

job_results: A cell array of results collected from each item of the vector jobs.

Example:
 
» runFirst(script_array_for_cluster(10, 'this one does nothing for 10 times'));
See also:
script_array_for_cluster (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2006/02/01



width

1.39 Class script_factory

1.39.1 Constructor script_factory/script_factory

Summary:
Generic class to automatically create a set of scripts.
Usage:
 
obj = script_factory(num_scripts, out_name, id, props)
Description:
This is the base class for all script_factory classes.
Parameters:
 
num_scripts:
Number of scripts to create.
out_name:
The file name for the output scripts. A '

filename corresponds to the script number.

id:
Identification string.
props:
A structure with any optional properties.
Returns a structure object with the following fields:
 

num_scripts, out_name, id, props.

See also:
script_factory/writeScripts (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/11/28



width

1.39.2 Method script_factory/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.40 Class spike_shape

1.40.1 Constructor spike_shape/spike_shape

Summary:
An action potential shape trace.
Usage:
 
obj = spike_shape(data, dt, dy, id)
Parameters:
 
data:
A vector of data points containing the spike shape.
dt:
Time resolution [s].
dy:
y-axis resolution [ISI (V, A, etc.)]
id:
Identification string.
props:
A structure with any optional properties.
baseline:
Resting potential.
threshold:
Spike threshold.
init_Vm_method:
Method to obtain spike initiation voltage.

1- maximum acceleration point 2- threshold crossing of acceleration (needs threshold) 3- threshold crossing of slope (needs threshold) 4- maximum acceleration in phase space (optionally specify maximal threshold as init_threshold) 5- point of maximum curvature, when slope is between init_lo_thr and init_hi_thr 6- local maximum of second derivative in the phase space nearest slope crossing init_threshold 7- threshold crossing of interpolated slope (needs threshold) 8- maximum curvature in phase-plane 9- Combined curvature and inflection method in time-domain.

init_threshold:
Spike initiation threshold (deriv or accel).

(see above methods and implementation in calcInitVm)

init_lo_thr, init_hi_thr:
Low and high thresholds for slope.
Returns a structure object with the following fields:
 

trace, props.

See also:
trace/spike_shape (p. [*]), trace/analyzeSpikesInPeriod (p. [*]), trace (p. [*]), spikes (p. [*]), period (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/07/30



width

1.40.2 Method spike_shape/calcInitVmV2PPLocal

Summary:
Calculates the action potential threshold by finding the local second derivative maximum in voltage-time slope versus voltage phase plane, nearest a slope threshold crossing.
Usage:
 
[init_idx, a_plot] = calcInitVmV2PPLocal(s, max_idx, min_idx, lo_thr, plotit)
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
lo_thr:
Lower threshold for time voltage slope.
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: Its index in the spike_shape [dt]. a_plot: plot_abstract, if requested.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/18



width

1.40.3 Method spike_shape/get

Summary:
Defines generic attribute retrieval for objects.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/09/14



width

1.40.4 Method spike_shape/calcMinVm

Summary:
Calculates the minimal value of the spike_shape, s.
Usage:
 
[min_val, min_idx, max_min_time] = calcMinVm(s, max_idx)
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
Returns:
 

min_val: The min value [dy]. min_idx: Its index in the spike_shape [dt]. max_min_time: Time from max to min [dt].

See also:
period (p. [*]), spike_shape (p. [*]), trace/calcMin (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/02



width

1.40.5 Method spike_shape/calcInitVmSekerliV2

Summary:
Calculates the action potential threshold using the maximum second derivative of the phase space of voltage-time slope versus voltage.
Usage:
 
[init_idx, a_plot] = calcInitVmSekerliV2(s, max_idx, min_idx, plotit)
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: Its index in the spike_shape [dt]. a_plot: plot_abstract, if requested.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/18



width

1.40.6 Method spike_shape/calcInitVmMaxCurvature

Summary:
Calculates the action potential threshold using the maximum of the curvature equation.
Usage:
 
[init_idx, a_plot] = calcInitVmMaxCurvature(s, max_idx, min_idx, plotit)
Description:
Point of maximum curvature: Kp = V''[1 + (V')^2]^(-3/2) Taken from Sekerli, Del Negro, Lee and Butera. IEEE Trans. Biomed. Eng., 51(9): 1665-71, 2004.
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: AP threshold index in the spike_shape [dt]. a_plot: plot_abstract, if requested.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/19



width

1.40.7 Method spike_shape/calcMaxVm

Summary:
Calculates the maximal value of the spike_shape, s.
Usage:
 
[max_val, max_idx] = calcMaxVm(s)
Parameters:
 
s:
A spike_shape object.
Returns:
 

max_val: The max value. max_idx: Its index in the spike_shape [dt].

See also:
period (p. [*]), spike_shape (p. [*]), trace/calcMax (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/02



width

1.40.8 Method spike_shape/getResults

Summary:
Runs all tests defined by this class and return them in a structure.
Usage:
 
[results, a_plot] = getResults(s, plotit)
Parameters:
 
s:
A spike_shape object.
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

results: A structure associating test names to values in ms and mV. a_plot: plot_abstract, if requested.

See also:
spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/02



width

1.40.9 Method spike_shape/plotCompareMethodsSimple

Summary:
Creates a multi-plot comparing different action potential threshold finding methods.
Usage:
 
a_plot = plotCompareMethodsSimple(s, title_str)
Parameters:
 
s:
A spike_shape object.
title_str:
Title suffix (optional).
Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
spike_shape (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/19



width

1.40.10 Method spike_shape/set

Summary:
Generic method for setting object attributes.
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/10/08



width

1.40.11 Method spike_shape/plotPP

Summary:
Plots the dV/dt vs. V phase-plane representation of the spike shape.
Usage:
 
a_plot = plotPP(s)
Parameters:
 
s:
A spike_shape object.
Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
spike_shape (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/16



width

1.40.12 Method spike_shape/calcInitVmSlopeThresholdSupsample

Summary:
Estimates the AP threshold as the first slope threshold crossing by first supersampling the data using cubic spline interpolation.
Usage:
 
[init_idx, a_plot] = calcInitVmSlopeThresholdSupsample(s, max_idx, min_idx, thr, plotit)
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
thr:
Threshold for time derivative of voltage.
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: AP threshold index in the spike_shape [dt]. a_plot: plot_abstract, if requested.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/03/23



width

1.40.13 Method spike_shape/calcInitVmV3hKpTinterp

Summary:
Calculates candidates for action potential threshold using the first three time-domain derivatives.
Usage:
 
[init_idx, a_plot] = calcInitVmV3hKpTinterp(s, max_idx, min_idx, lo_thr, hi_thr, plotit)
Description:
First uses interpolation to increase time points. Calculates h, the second derivative of phase-plane (d^2 v'/dv^2), in terms of time-domain derivatives. Also calculates Kp = V''[1 + (V')^2]^(-3/2), the curvature. The maxima of these functions are used as candidates for AP thresholds.
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
lo_thr, hi_thr:
Lower and higher thresholds for time derivative of voltage.
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: Indices of threshold candidates in the spike_shape [dt]. a_plot: plot_abstract, if requested.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/18



width

1.40.14 Method spike_shape/plotCompareMethods

Summary:
Creates a multi-plot comparing different action potential threshold finding methods.
Usage:
 
a_plot = plotCompareMethods(s, title_str)
Parameters:
 
s:
A spike_shape object.
title_str:
Title suffix (optional).
Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
spike_shape (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/19



width

1.40.15 Method spike_shape/plotResults

Summary:
Plots the spike shape annotated with result characteristics.
Usage:
 
a_plot = plotResults(s, title_str, props)
Parameters:
 
s:
A spike_shape object.
Returns:
 

a_plot: A plot_abstract object that can be visualized. title_str: (Optional) String to append to plot title. props: A structure with any optional properties, passed to trace/plotData.

See also:
spike_shape (p. [*]), plot_abstract (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/17



width

1.40.16 Method spike_shape/display

Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/04



width

1.40.17 Method spike_shape/calcInitVmLtdMaxCurv

Summary:
Calculates the action potential threshold using the maximum of the curvature equation only in the limited range given with two voltage slope thresholds.
Usage:
 
[init_idx, a_plot] = calcInitVmLtdMaxCurv(s, max_idx, min_idx, lo_thr, hi_thr, plotit)
Description:
Point of maximum curvature: Kp = V''[1 + (V')^2]^(-3/2) Taken from Sekerli, Del Negro, Lee and Butera. IEEE Trans. Biomed. Eng., 51(9): 1665-71, 2004.
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
lo_thr, hi_thr:
Lower and higher thresholds for time derivative of voltage.
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: AP threshold index in the spike_shape [dt]. a_plot: plot_abstract, if requested.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/19



width

1.40.18 Method spike_shape/calcInitVmMaxCurvPhasePlane

Summary:
Calculates the voltage at the maximum curvature in the phase plane as action potential threshold.
Usage:
 
[init_idx, max_d1o, a_plot, fail_cond] = calcInitVmMaxCurvPhasePlane(s, max_idx, min_idx, plotit)
Description:
First take the phase-plane v'-v from the beginning to max(v'). Then regulate intervals by interpolation. Point of maximum curvature: Kp = V''[1 + (V')^2]^(-3/2) Taken from Sekerli, Del Negro, Lee and Butera. IEEE Trans. Biomed. Eng., 51(9): 1665-71, 2004.
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_idx: AP threshold index in the spike_shape [dt]. max_d1o: Maximal value of first voltage derivative [dy]. a_plot: plot_abstract, if requested. fail_cond: True if this algorithm fails to be trustable.

See also:
calcInitVm (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2005/04/12



width

1.40.19 Method spike_shape/plotTPP

Summary:
Plots the dV/dt vs. V phase-plane representation of the spike shape.
Usage:
 
a_plot = plotTPP(s)
Description:
Uses the Taylor series estimation for finding the derivative dV/dt.
Parameters:
 
s:
A spike_shape object.
Returns:
 

a_plot: A plot_abstract object that can be visualized.

See also:
spike_shape (p. [*]), plot_abstract (p. [*]), diffT (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/11/16



width

1.40.20 Method spike_shape/calcInitVm

Summary:
Calculates spike threshold related measures of the spike_shape, s.
Usage:
 
[init_val, init_idx, rise_time, amplitude, peak_mag, peak_idx, max_d1o, a_plot] = calcInitVm(s, max_idx, min_idx)
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point of the spike_shape [dt].
min_idx:
The index of the minimal point of the spike_shape [dt].
plotit:
If non-zero, plot a graph annotating the test results

(optional).

Returns:
 

init_val: The potential value [dy]. init_idx: Its index in the spike_shape [dt]. rise_time: Time from initiation to maximum [dt]. amplitude: Magnitude from initiation to max [dy]. peak_mag: Peak value [dy]. peak_idx: Extrapolated spike peak index [dt]. max_d1o: Maximal value of first voltage derivative [dy]. a_plot: plot_abstract, if requested.

See also:
spike_shape (p. [*])
Author:
Cengiz Gunay <cgunay@emory.edu>, 2004/08/02



width

1.40.21 Method spike_shape/calcWidthFall

Summary:
Calculates the spike width and fall information of the spike_shape, s.
Usage:
 
[base_width, half_width, half_Vm, fall_time, min_idx, min_val, max_ahp, ahp_decay_constant, dahp_mag, dahp_idx] = ... calcWidthFall(s, max_idx, max_val, init_idx, init_val)
Description:
max_* can be the peak_* from calcInitVm.
Parameters:
 
s:
A spike_shape object.
max_idx:
The index of the maximal point [dt].
max_val:
The value of the maximal point [dy].
init_idx:
The index of spike initiation point [dt].
init_val:
The value of spike initiation point [dy].
fixed_Vm:
The desired height for