Doug’s MATLAB Video Tutorials

May 5th, 2008

Advanced MATLAB: Timer objects

Sometimes you want something to update in MATLAB on a regular schedule. Timer objects can do that for you. We first introduced this for test and measurement applications, but it has since been moved into base MATLAB. In this simple example, we will create a timer object and have it fire a callback every second to output a random number to the command line. There are a lot more useful things to do with timer objects, of course. What have you done with them? [Comment here]
iconFiles.jpgiconPod.jpg

25 Responses to “Advanced MATLAB: Timer objects”

  1. Bob replied on :

    I’ve used them for error catching.

    As one gets to more esoteric bits, try…catch doesn’t always work. For example, some things fail by popping up a dialog for the user to asknowledge rather than Matlab’s error command.

    So when I want error trapping for something that won’t run interactively, I guess how long it should take and use a timer to exit out if it takes too long.

    This way if I queue 10 things up for the evening and number 3 stalls waiting for user input, it eventually gets killed and the other 9 finish.

  2. Tal replied on :

    Hello Doug,
    I love your blog and I find it extremely useful.

    I have a question.
    Is it possible to run a timer object in the background and saving data in the background as well?
    for example I was thinking to save some live data to create a time series from the Yahoo finance while running some other codes on the same time.
    Thanks,
    Tal

  3. Administrator replied on :

    Tal,

    That is exactly the kind of thing timers were first introduced for. Rather than pulling data from a datafeed on the web, they were pulling data from instruments and DAQ boards.

    Timers have since been put into the core of MATLAB. You can use them to run any function you want.

    Doug

  4. Dan replied on :

    Doug,
    I discovered timer objects about a month ago as I was looking for a way to automatically query a piece of hardware using UDP. In my application, a timer is used to regularly request system status and parse the reply. It did the trick nicely.

    Dan

  5. Julio Leon replied on :

    Dear Doug,

    Once again I have to say this is blog is great. I would like to use timers for Interrupt Requests. It would be a great way to simulate microcontrollers in Matlab, so students could see what’s going on on a GUI (since most GUI development software won’t work with real IRQ in win xp). The question is: if I create several timers, once I’m doing routine of 1 timer I would like to stop the timers, but after that I would like to resume. Are the values of the timers reset after stop(a)?

    Thanks,

    Julio

  6. Ryan replied on :

    I’ve been enjoying your new “Advanced MATLAB” posts. Keep up the good work!

    I’m using a couple of timers in a GUI application that seems to work pretty well. My application is that I have a set of ODEs that model a process, and a complex control algorithm. The model integrates forward one second, then passes the output to the control algorithm, then back to the model with the results from the controller. This is on a timer that lets me control the frequency with which the model executes, and if the timer has a period of 1s then it runs in real time. At a period of 0.01 it’s 100x real time, etc.

    I have a second timer that reads the state of the simulation and updates the GUI with new graphs and indicators of the status of the simulation. By having two timers I can decouple running the simulation from updating the display (an expensive operation). I can also use the GUI to speed up the simulation to facilitate testing.

    This is my first time using timers, but I’m pretty happy with how it’s working out. I’m not sure if there’s a better way to do it, but it gets the job done. It took me quite a bit of digging to figure out a way to make a GUI that lets me interact with a running process, so hopefully this post will inspire others. Is there a better way to allow users to interact with a running simulation that using timer objects?

    Cheers!
    Ryan

  7. DanK replied on :

    Doug,
    One question about the timers: What determines the workspace that the timerfunction runs in? Is it like creating an anonymous function, where the inputs to the timer function are fixed when it is created, or is there a way to allow the timer function to update its inputs? For example, suppose I want to replace the waitbar with my own one. Instead of calling the Mywaitbar function every time through my for loop, I want to create a timer inside of Mywaitbar whose timer function is to check the calling function every 0.1 seconds and retrieve the value. How would I go about setting something like that up? Do I use an evalin inside of Mywaitbar? Is it even possible?

    Thanks,
    Dan

  8. Doug replied on :

    Julio,

    There are stopFcnCallbacks that are run when you stop a timer. With clever use of these you should be able to accomplish what you are interested in doing. I think you are effectively trying to create a pause(timer) function.

    Doug

  9. Doug replied on :

    Ryan,

    It almost sounds to me like you would be better off using Simulink for the simulation you are running. With all of the time dependencies you are working with Simulink and its constant marching of time would probably be better.

    Doug

  10. Doug replied on :

    Dan,

    Our doc can explain this much better than I can.

    http://www.mathworks.com/access/helpdesk/help/techdoc/matlab_prog/f9-39541.html#f9-42494

    Doug

  11. BJ replied on :

    Doug,

    I posted the following questions below in the user community, but nobody has responded…I then found this discussion…Any ideas?–>

    “I am posting this to see if anybody has had similar problems
    with 2007b or later (when Matlab became multithreaded)…

    I execute this code in the interpretor:

    >>t = timer(’Period’, 1, ‘timerfcn’, ‘disp(”hello”)’,…
    ‘executionmode’, ‘fixeddelay’, ‘busymode’, ‘error’);
    >>start(t);

    The callback occurs a few times (I say “a few” because it
    could be 1, 5 or 10034, there does not seem to be any reason
    to it), and the appears to get “lost”. When I query the
    timer, it claims that is is running, however it has stopped
    callback execution. I do a lot of process control and have
    used timers quite extensively in earlier versions of MATLAB
    and have never had this problem. Any ideas?

    Note: When I change the number of maximum number of computational threads to 1, the timer callback seems to behave just fine…I however need to use the multiple threads in my application.”

    BJ

  12. Doug replied on :

    BJ,

    I think you are best served with technical support:

    http://www.mathworks.com/support

    They should be able to help very quickly.

    Doug

  13. mamun replied on :

    Hi Doug,

    I want to use timer function in real time signal processing application.
    Could you please tell me which documents help me to understand detail variability and different uses of timer function?

    Thanks.
    Mamun

  14. Doug Hull replied on :

    You can just type

    >>doc timer

    At the MATLAB prompt.

    -Doug

  15. med replied on :

    Hello, can you help me on how to do timer objects on matlab 6.1, thanks

  16. Ryan Ollos replied on :

    Hi Doug,

    Do Timer Callbacks and Handle Graphics Object Callbacks execute in the same Event Queue (i.e. same thread)? And if so, what is the Interruptible property behavior of the Timer Callback (since that is not one of its visible properties)?

    I’d like to understand, if I have a Timer Callback that takes a long time to complete, can my Handle Graphics objects be updated during that time period? I’ve been trying to figure this out through an test case, but I’m running into some trouble.

    - Ryan

  17. dhull replied on :

    Ryan,

    MATLAB is single threaded.

    If you want to update graphics, at any time you can call DRAWNOW. This will flush the graphics queue.

    Does this answer the heart of your question?

    -Doug

  18. dhull replied on :

    @Med,

    There were no timer objects in that release of MATLAB. That is why we recommend upgrading to newer versions of MATLAB.

    -Doug

  19. Ryan Ollos replied on :

    Hi Doug,

    That basically answers my question, however I would like to better understand how timer callbacks and user-generated event callbacks (i.e. handle graphics object callbacks) interact.

    If MATLAB is single threaded the events must be processed serially, but can a timer callback interrupt a handle graphics callback with interruptible property = ‘on’ (when it reaches one of the function calls that allow it to be interrupted such as drawnow, pause, etc …)?

    Since the timer callback does not have an interruptible property, can it be interrupted by any other callback in the event queue?

    - Ryan

  20. Bill replied on :

    Hey Doug!

    You blog is a lifesaver. My question for you is, I’m trying to make a GUI with some really accurate timing for events, i.e. moving boxes at certain times, having a running clock, changing colors at certain times, etc. What I want to do is use tic;toc; to give me a running time from the start and save the toc’s return value to the GUI’s handle structure. However, when I seem to do that, it seems to destroy the Handles structue, as I get the “Reference to non-existent field” error for variables that existed just a second ago. Any ideas, or is TIMER not the way to roll?

    function figure1_KeyPressFcn(hObject, eventdata, handles)
    handles.Key = get(gcf, 'CurrentKey')
    
    switch(handles.Key)
    case 'f12'
    
    tic;
    accurateTimer = timer;
    set(accurateTimer, 'Period', .1)
    set(accurateTimer, 'TimerFcn', 'handles.elapsedTime = toc;')
    start(accurateTimer)
    
    handles.workingTime = floor(handles.elapsedTime) %%Where I get my "Reference to Nonexistent Field Error"
    
  21. dhull replied on :

    Bill,

    My first guess is that you are going to want to write an actual subfunction in the code (not defining ‘handles.elapsedTime = toc;’) When you make that subfunction, be sure to actually pas in and take handles out of the function.

    I think you are running into scoping issues.

    -Doug

  22. Tejaprtap replied on :

    dear doug,

    i need the timer function, TimerFcn to work on the handles structure when i’m working in a gui, i’ve tried a ton of things, nothing’s worked, could you help me out?

    i think its a workspace issue, but i dont know how to fix it.

  23. dhull replied on :

    If you want access to the handles structure from outside the GUI, you might want to store a copy of the data you need in the root object (handle = 0) with GETAPPDATA and SETAPPDATA. It really depends on the specifics of what you are trying to do. Without more information, I can not really make a good suggestion.

    Doug

  24. Ryan W replied on :

    Nice blog, Doug.

    I’m trying to use a timer to exit a function that’s taking too long to execute, similar to what Bob (#1 above) says he does. However, since the timer executes in the base workspace, I haven’t been able to figure out how it can tell the function to return (preferably with an error).
    As a simple example, when I run this function the message displays, but the workspace remains paused:

    [] = function test()
    
    t = timer('TimerFcn','disp(''Taking too long''); return','StartDelay',5);
    
    start(t)
    
    pause
    

    Is there a way to set up the timer so that function test will terminate?

    Thanks,
    Ryan

  25. dhull replied on :

    @ryan,

    If the calculation that is taking too long is in a for loop, or anything else where you can force a check from time to time, I would have the timer SETAPPDATA in the root (handle 0) after a certain amount of time. I would then have the calculation check for that data from time to time with GETAPPDATA.

    This appdata shoudl be available from any workspace.

    -Let me know,
    Doug

Leave a Reply

Wrap code fragments inside <pre> tags, like this:

<pre class="code">
a = magic(3);
sum(a)
</pre>

If you have a "<" character in your code, either follow it with a space or replace it with "&lt;" (including the semicolon).


Doug Hull is a proud MathWorker who is on a mission to help you with MATLAB.

Doug's picture

These postings are the author's and don't necessarily represent the opinions of The MathWorks.