Diff for "ScannerSynch" - CBU MRI facility Wiki
location: Diff for "ScannerSynch"
Differences between revisions 29 and 30
Revision 29 as of 2016-02-23 14:49:35
Size: 2874
Editor: TiborAuer
Comment:
Revision 30 as of 2016-02-23 14:58:35
Size: 4263
Editor: TiborAuer
Comment:
Deletions are marked like this. Additions are marked like this.
Line 74: Line 74:

=== Capture button presses ===
 . {{{#!highlight matlab numbers=off
SSO.SetButtonReadoutTime(0.5); % block individual buttons
% SSO.SetButtonBoxReadoutTime(0.5); % block the whole buttonbox
% SSO.Keys = {'f1','f2','f3','f4'}; % emulation Buttons #1-#4 with F1-F4
n = 0;
% SSO.BBoxTimeout = 1.5; % Wait for button press for 1.5s
% SSO.BBoxTimeout = -1.5; % Wait for button press for 1.5s even in case of response
SSO.ResetClock;
while n ~= 10 % polls 10 button presses
    SSO.WaitForButtonPress; % Wait for any button to be pressed
% SSO.WaitForButtonRelease; % Wait for any button to be released
% SSO.WaitForButtonPress([],2); % Wait for Button #2
% SSO.WaitForButtonPress(2); % Wait for any button for 2s (overrides SSO.BBoxTimeout only for this event)
% SSO.WaitForButtonPress(-2); % Wait for any button for 2s even in case of response (overrides SSO.BBoxTimeout only for this event)
% SSO.WaitForButtonPress(2,2); % Wait for Button #2 for 2s (overrides SSO.BBoxTimeout only for this event)
% SSO.WaitForButtonPress(-2,2); % Wait for Button #2 for 2s even in case of response (overrides SSO.BBoxTimeout only for this event)
    n = n + 1;
    fprintf('At %2.3fs, ',SSO.Clock);
    fprintf('Button %d ',SSO.LastButtonPress);
    fprintf('pressed: %2.3fs\n',SSO.TimeOfLastButtonPress);
end
}}}

ScannerSynch

ScannerSynch provides an interface for National Instruments PCI 6503 card used to capture all pulses (scanner synch pulse and button pulses alike).

For more information, type in MATLAB

help ScannerSynchClass

N.B.: National Instruments PCI 6503 card does not monitor pulses in the background, so you have to make sure that you wait for any pulse before it comes!

Any problems, report them to Tibor Auer.

Obtain ScannerSynch

  • ScannerSynch is available on all relevant PCs (StimPCs, "mimic" PC)

  • From your desktop PC (Windows), you can also have a copy from \\cbsu\data\Group\Imaging-Local\cbu\matlab

  • You can also download it from here (right-click and "Save As...")

Using ScannerSynch

Initialise

  • Default. Use only if device (scanner, pulse emulator) is connected (only in StimPCs and mimic PC)!
  • SSO = ScannerSynchClass;
    
  • Emulations:
  • SSO = ScannerSynchClass(1);   % emulate scanner synch pulse
    
  • SSO = ScannerSynchClass(0,1); % emulate button box
    
  • SSO = ScannerSynchClass(1,1); % emulate scanner synch pulse and button box
    

Close

ScannerSynchClass has a destructor, which is automatically triggered if the object is deleted (e.g. clear, returning function). If you use a script, however, it does not perform any auto-clear, so you have to destroy the object manually:

  • SSO.delete;
    

Capture scanner synch pulse

  • Simple case
  • SSO.SetSynchReadoutTime(0.5);  % make sure that you do not detect the same pule twice
    SSO.TR = 2;                % allows detecting missing pulses
    while SSO.SynchCount < 10  % polls 10 pulses
        SSO.WaitForSynch;
        fprintf('Pulse %d: %2.3f. Measured TR = %2.3fs\n',...
            SSO.SynchCount,...
            SSO.TimeOfLastPulse,...
            SSO.MeasuredTR);
    end
    
  • Chance for missing pulse
  • SSO.SetSynchReadoutTime(0.5);  % make sure that you do not detect the same pule twice
    SSO.TR = 2;                    % allows detecting missing pulses
    while SSO.SynchCount < 10      % until 10 pulses
        WaitSecs(Randi(100)/1000); % in every 0-100 ms ...
        if SSO.CheckSynch(0.01)    % ... waits for 10 ms for a pulse
            fprintf('Pulse %d: %2.3f. Measured TR = %2.3fs. %d synch pulses has/have been missed\n',...
                SSO.SynchCount,...
                SSO.TimeOfLastPulse,...
                SSO.MeasuredTR,...
                SSO.MissedSynch);
        end
    end
    

Capture button presses

  • SSO.SetButtonReadoutTime(0.5);      % block individual buttons
    % SSO.SetButtonBoxReadoutTime(0.5); % block the whole buttonbox
    % SSO.Keys = {'f1','f2','f3','f4'}; % emulation Buttons #1-#4 with F1-F4
    n = 0;
    % SSO.BBoxTimeout = 1.5;            % Wait for button press for 1.5s
    % SSO.BBoxTimeout = -1.5;           % Wait for button press for 1.5s even in case of response
    SSO.ResetClock;
    while n ~= 10                       % polls 10 button presses
        SSO.WaitForButtonPress;         % Wait for any button to be pressed
    % SSO.WaitForButtonRelease;       % Wait for any button to be released
    % SSO.WaitForButtonPress([],2); % Wait for Button #2
    % SSO.WaitForButtonPress(2);    % Wait for any button for 2s (overrides SSO.BBoxTimeout only for this event)
    % SSO.WaitForButtonPress(-2);   % Wait for any button for 2s even in case of response (overrides SSO.BBoxTimeout only for this event)
    % SSO.WaitForButtonPress(2,2);  % Wait for Button #2 for 2s (overrides SSO.BBoxTimeout only for this event)
    % SSO.WaitForButtonPress(-2,2); % Wait for Button #2 for 2s even in case of response (overrides SSO.BBoxTimeout only for this event)
        n = n + 1;
        fprintf('At %2.3fs, ',SSO.Clock);
        fprintf('Button %d ',SSO.LastButtonPress);
        fprintf('pressed: %2.3fs\n',SSO.TimeOfLastButtonPress);
    end
    

None: ScannerSynch (last edited 2017-08-08 15:53:15 by JohanCarlin)