/usr/share/psychtoolbox-3/PsychBasic/WaitSecs.m is in psychtoolbox-3-common 3.0.9+svn2579.dfsg1-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 | function r=WaitSecs(s,se)
% wakeup=WaitSecs(s)
%
% Waits "s" seconds with high precision. The timing precision depends on
% the model of your computer, but a well configured system will be accurate
% to about 1 millisecond if your script is executed with realtime-priority
% (See help Priority) and well written.
%
% WaitSecs optionally returns the time at "wakeup" in seconds, just as a
% WaitSecs(s); wakeup = GetSecs; would do, but with less overhead.
%
% WaitSecs(s) is similar to Matlab's built-in PAUSE(s) command. The
% advantage of WaitSecs(s) is that it is much more accurate. However, PAUSE
% can be turned 'ON' and 'OFF', which is useful for scripts.
%
% You can also use WaitSecs to wait until a specific time 'when' is reached,
% instead of waiting for a specific interval. This is a drift-free approach,
% even suitable for waiting a given interval, because errors can't accumulate:
%
% wakeup = WaitSecs('UntilTime', when);
%
% TIMING ADVICE: the first time you access any MEX function or M file,
% Matlab takes several hundred milliseconds to load it from disk.
% Allocating a variable takes time too. Usually you'll want to omit those
% delays from your timing measurements by making sure all the functions you
% use are loaded and that all the variables you use are allocated, before
% you start timing. MEX files stay loaded until you flush the MEX files
% (e.g. by changing directory or calling CLEAR MEX). M files and variables
% stay in memory until you clear them.
%
% OS X: ___________________________________________________________________
%
% WaitSecs always uses the high-precision uptime clock. It sleeps the main
% MATLAB thread for the given wait period, surrendering CPU time to other
% processes while waiting. WaitSecs is now safe to use at any priority
% setting.
%
% WaitSecs ignores the OX MATLAB <ctrl>-C break key sequenece.
%
% WINDOWS:_________________________________________________________________
%
% WaitSecs uses Windows QueryPerformanceCounter() call which, in turn,
% reads a high-performance hardware counter in Pentium and better CPUs.
%
% WaitSecs ignores the Win MATLAB <ctrl>-C break key sequenece.
%
% Linux: __________________________________________________________________
%
% WaitSecs always uses the POSIX realtime high-precision timing facilities
% (clock_nanosleep(CLOCK_RT,...)). It sleeps the main MATLAB thread for the
% given wait period, surrendering CPU time to other processes while waiting.
% WaitSecs is now safe to use at any priority setting.
%
% NB.: Use of a modern 2.6.x kernel is recommended, and many modern
% distros, e.g., Ubuntu 7.1, offer the option of installing a special
% low-latency soft-realtime (preempt) kernel for even higher timing
% precision - or even a hard-realtime kernel like RTLinux or RTAI. This is
% as easy as a few mouse clicks and waiting a few minutes!
% _________________________________________________________________________
%
% See also: GetSecs, GetSecsTick, GetTicks, WaitTicks, PAUSE.
% 1/29/97 dhb Wrote it.
% 3/15/97 dgp Expanded comments.
% 2/22/99 dgp Mention PAUSE.
% 2/4/00 dgp Updated for Mac OS 9.
% 7/2/04 awi Divided into separate sections for OS X, Mac and Windows.
% 7/10/04 awi Edits for clarity.
AssertMex('WaitSecs.m');
|