{"id":1277,"date":"2015-12-14T09:06:26","date_gmt":"2015-12-14T14:06:26","guid":{"rendered":"https:\/\/blogs.mathworks.com\/loren\/?p=1277"},"modified":"2021-04-16T10:08:41","modified_gmt":"2021-04-16T14:08:41","slug":"axes-limits-scream-louder-i-cant-hear-you","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/loren\/2015\/12\/14\/axes-limits-scream-louder-i-cant-hear-you\/","title":{"rendered":"Axes Limits – Scream Louder, I Can’t Hear You!"},"content":{"rendered":"

NOTE: <\/span>This functionality was added as the <\/span>LimitsChangedFcn<\/span><\/a> in R2021a.<\/span><\/p>\r\n\r\n

Today's guest post comes from Sean de Wolski<\/a>, one of Loren's fellow Application Engineers. You might recognize him from MATLAB answers<\/a> and the pick of the week<\/a> blog!<\/i><\/p>

I arrived at work early one day and immediately got a call from Brett<\/a>, who doesn't face the same commute I do, wondering why his listeners<\/a> were not working on axes' 'XLim'<\/i>, 'YLim'<\/i> and 'ZLim'<\/i>.<\/p>

This seemed a little surprising, surely a listener pointed at the wrong property? Here's a minimal working example<\/p>

% Plot something<\/span>\r\nax = gca;\r\nplot(humps);\r\n<\/pre>\"\" 
% Add listener to axes' 'XLim' 'PostSet' event (so it fires after axes<\/span>\r\n% change).  Update the title so it's a visible change.<\/span>\r\naddlistener(ax,'XLim'<\/span>,'PostSet'<\/span>,@(~,~)title('Listener Fired'<\/span>));\r\n\r\n% Change Plot<\/span>\r\nplot(sin(1:0.1:100))\r\n<\/pre>\"\" 
Huh?  No Title!  What happened?<\/p>
What's interesting is that it allowed me to set the listener on the 'XLim'<\/i>.  Usually, if a property is not 'SetObservable'<\/i><\/a>, it would error.<\/p>
try<\/span>\r\n    % Add listener to non-SetObservable property.<\/span>\r\n    addlistener(ax,'TightInset'<\/span>,'PostSet'<\/span>,@(~,~)disp('hello world'<\/span>))\r\ncatch<\/span> ME\r\n    fprintf(2,'\\n%s\\n'<\/span>,ME.message);\r\nend<\/span>\r\n<\/pre>
\r\nWhile adding a PostSet listener, property 'TightInset' in class 'matlab.graphics.axis.Axes' is not defined to be SetObservable.\r\n<\/pre>
So what's happening?<\/p>
When MATLAB versions R2014b and newer are automatically calculating the limits, the limits frequently change several times as MATLAB inspects each member of the axes and updates the limits.  Allowing listeners to be triggered during the automatic calculation (even if no listener was attached) would have caused performance degradation for all plot updates even if there are no listeners.  Thus the ability to trigger listeners with automatically calculated property value changes was disabled for performance reasons.<\/p>
So how do we listen for limit changes?<\/p>
The answer I provided to Brett was to write my own events class that has events for each of the limits changing.<\/p>
\r\nclassdef<\/span> LimitsChangedNotifier < handle\r\n% This class has events of limits changes to be used for updating when axes<\/span>\r\n% limits change.<\/span>\r\n\r\n    events<\/span>\r\n        % Events for each axes limit property<\/span>\r\n        XLimChanged;\r\n        YLimChanged;\r\n        ZLimChanged;\r\n    end<\/span>\r\nend<\/span>\r\n\r\n\r\n<\/pre>
Now every time I update the plot, or call x\/y\/zlim('auto')<\/tt>, I would notify afterward.<\/p>
% Build the events class<\/span>\r\nlimnotifier = LimitsChangedNotifier;\r\n\r\n% Attach a listener to it<\/span>\r\naddlistener(limnotifier,'XLimChanged'<\/span>,@(~,~)title('Listener Fired'<\/span>));\r\n\r\n% Draw a new plot and let any listeners know you did<\/span>\r\nplot(sin(linspace(-2*pi,2*pi,100)));\r\nnotify(limnotifier,'XLimChanged'<\/span>)\r\n<\/pre>\"\" 
For a more detailed and advanced explanation of events and listeners, please see this documentation page<\/a>.<\/p>
Note:<\/b> By doing this, I retain control of letting the listeners know the limits changed.  This wouldn't work if the user did this on their own, say within plottools<\/tt><\/a>.<\/p>