Editor's Note: This file was selected as MATLAB Central Pick of the Week
Finds and activates, or creates, figure with user-specified name.
If no name is provided, creates figure named "untitledn" (where n is incremented to result in a unique name).
SYNTAX:
togglefig('My Figure');
If figure named 'My Figure' exists, it will be activated (brought to the front and shown). Otherwise, it will be created.
h = togglefig('My Figure');
Also returns the handle to the specified or created figure.
togglefig;
Creates and activates new figure named untitled1, untitled2, ...
Note: You can subsequently activate these figures with, for instance, togglefig('untitled1').
OTHER EXAMPLES:
NOTE: This example requires the Image Processing Toolbox
im = imread('cameraman.tif');
for ii = 1:10
thresh = ii/20;
togglefig('Threshold');
imshow(im2bw(im,thresh));
title(sprintf('Threshold = %0.2f',thresh));
pause(1)
end
Motivation:
I've found this to be exceptionally useful in algorith-development
mode, particularly when iterating on cells in the cell-mode editor. (I
use this function in almost every mfile I write these days.)
Brett Shoelson (2021). Create and activate figures by name (https://www.mathworks.com/matlabcentral/fileexchange/18220-create-and-activate-figures-by-name), MATLAB Central File Exchange. Retrieved .
Inspired: Cell Cycle Analysis, Cell Cycle Analysis
Find the treasures in MATLAB Central and discover how the community can help you!
Start Hunting!Create scripts with code, output, and formatted text in a single executable document.
This is so useful. Wish I had found it before.
oh my god thanks before cz very helpful :)
Only just found this function this morning - but it made my day.
Danilo, thanks for finding the bug (and for suggesting a fix). New version addresses this!
Great idea and nice implementation !!!! I've just downloaded and I'm already loving it... :-)
Just a small bug found, when called without any arguments, I get:
>> togglefig
??? Input argument "clearfig" is undefined.
The problem is solved by adding the line
clearfig = 0;
just before
elseif nargin == 1
Cheers!
Thanks for this useful function.
I suggest a couple of extra lines to generate a unique figure number, so that other *.m files still using figure(1), figure(2), etc. do not overwrite the figures created by togglefig. It will pause for 10 ms each time a new figure is created, but this can be modified according to your computer platform (see 'pause' help).
...
if isempty(fig)
pause(.01)
FigNum = round(sum(1000*clock));
fig = figure(FigNum);
set(fig,'numbertitle','off',...
'name',name);shg;
else
...
All fixed.
ALL: To further follow up on John's comment, note that John correctly pointed out (via private email) that suppressing the handle if nargout == 0 does not disallow the reference-by-name functionality I wanted. I'm reposting the file to implement the modest change he suggested.
Thanks for the comment, John. My first thought was to implement your suggestion; it would be trivially easy. But on reflection, I like TOGGLEFIG's forced issuance of a handle. In my workflow, I do things like:
set(togglefig('FigureName'),'color','k');
This gives me painless (by-name) handling of my figures, and frees me from having to use the more unwieldy
set(findobj('type','figure','name','Figurename'),'color','k').
You can still do
togglefig Fred;
(With the semicolon to suppress the display of the handle.)
Alternatively, I leave it to the user to modify the function to delete the function handle if not requested as an output.
Cheers!
Its excellent, as I fully expect from Brett.
I don't know if this is being picky or not, but I'd add a couple of lines to the very end.
if nargout==0
clear fig
end
I think this is the standard for functions like plot or figure. When called as a command or with no output arguments, they do not try to return an output. Thus I'd expect to be able to do
togglefig Fred
and have a figure named "Fred" created, but without the handle itself ever returned. You should only get a handle when you ask for it. As it is now, togglefig now returns
ans
= 1
when I call it as a command.
I'll rate this a 5 anyway.