Differences

This shows you the differences between two versions of the page.

Link to this comparison view

reference:ft_spike_jpsth [2018/08/23 14:43] (current)
Line 1: Line 1:
 +=====  FT_SPIKE_JPSTH =====
 +
 +Note that this reference documentation is identical to the help that is displayed in MATLAB when you type "help ft_spike_jpsth"​.
 +
 +<​html><​pre>​
 +  <a href=/​reference/​ft_spike_jpsth><​font color=green>​FT_SPIKE_JPSTH</​font></​a>​ computes the joint peristimulus histograms for spiketrains
 +  and a shift predictor (for example see Aertsen et al. 1989).
 + 
 +  The shift predictor is computed in consecutive trials in a symmetric way.
 +  For example, we compute the jpsth for chan 1 in trial 1 versus chan 2 in
 +  trial 2, but also for chan 1 in trial 2 versus chan 2 in trial 1. This
 +  gives (nTrials-1)*2 jpsth matrices for individual trials. Picking
 +  consecutive trials and computing the shift predictor in a symmetric way
 +  ensures that slow changes in the temporal structure do not affect the
 +  shift predictor (as opposed to shuffling the order of all trials for one
 +  of the two channels).
 + 
 +  Use as
 +    [jpsth] = ft_spike_jpsth(cfg,​psth)
 + 
 +  The input PSTH should be organised as the input from <a href=/​reference/​ft_spike_psth><​font color=green>​FT_SPIKE_PSTH</​font></​a>,​
 +  FT_SPIKE_DENSITY or <a href=/​reference/​ft_timelockanalysis><​font color=green>​FT_TIMELOCKANALYSIS</​font></​a>​ containing a field PSTH.trial and
 +  PSTH.time. In any case, one is expected to use cfg.keeptrials = '​yes'​ in
 +  these functions.
 + 
 +  Configurations:​
 +    cfg.method ​          = '​jpsth'​ or '​shiftpredictor'​. If '​jpsth',​ we
 +                            output the normal stat. If '​shiftpredictor',​
 +                            we compute the jpsth after shuffling subsequent
 +                            trials.
 +    cfg.normalization ​   = '​no'​ (default), or '​yes'​. If requested, the joint psth is normalized as in van Aertsen et al. (1989).
 +    cfg.channelcmb ​      ​= ​ Mx2 cell-array with selection of channel pairs (default = {'​all'​ '​all'​}),​ see <a href=/​reference/​ft_channelcombination><​font color=green>​FT_CHANNELCOMBINATION</​font></​a>​ for details
 +    cfg.trials ​          = '​all'​ (default) or numerical or logical array of to be selected trials.
 +    cfg.latency ​         = [begin end] in seconds, '​maxperiod'​ (default), '​prestim'​(t&​lt;​=0),​ or '​poststim'​ (t&​gt;​=0)
 +    cfg.keeptrials ​      = '​yes'​ or '​no'​ (default)
 + 
 +  See also <a href=/​reference/​ft_spike_psth><​font color=green>​FT_SPIKE_PSTH</​font></​a>​
 +</​pre></​html>​