The annotation function, which allows you to programmatically add a wide range of annotations to your figure, requires coordinates to be specified in normalized figure units. I have found that I almost always want to specify my annotations in data space (i.e., based on the values of data displayed in an axes).
This utility function converts coordinates in data space into normalized figure coordinates, for input to annotation. Some annotations require you to specify (x,y) pairs, while others require a 4 element position vector. This function supports both syntaxes.
Here's a simple example:
% Create some data
t = 0:.1:4*pi;
s = sin(t);
% Add an annotation requiring (x,y) coordinate vectors
xa = [1.6 2]*pi; % X-Coordinates in data space
ya = [0 0]; % Y-Coordinates in data space
[xaf,yaf] = ds2nfu(xa,ya); % Convert to normalized figure units
annotation('arrow',xaf,yaf) % Add annotation
Note: I believe annotation was introduced in MATLAB 7.
Thanks for the comment, Ulrich. This utility works with standard zooming - e.g. the zoom command, the zoom toolbar button, etc. It is not designed to work with camera interactions at all.
The program ignores zooming:
camva(camva/2), grid on
[u,v] = ds2nfu(-1,1);
annotation('textarrow',[u u],[v v])
Since this doesn't work with different aspect ratios, I downloaded plotboxpos from:
This file returns the position of the plotted axis region with the aspect ratio included. I changed line 85 from
axpos = get(hAx,'Position');
axpos = plotboxpos(hAx);
Now it works with axis image, equal or square.
Really great 'simple' solution! Thanks very much
works well, thank you
Very useful, thank you. I found that changing the axis (e.g. through axis equal) only after adding annotations avoids any problems with the aspect ratio.
Please consider adding functionality for the case PlotBoxAspectRatio is not [1 1 1] (in case axis image for example)
thanks a lot
Thanks for the inspiration! I've created a version of this file with support for logarithmic axes. Here's the link.
Got what I was looking for a long time.. Thanks.
perfect tool fpr annotation, thank you!
Doesn't work with "axis square".
I am using Matlab R2009b and I used this function but the coordinates that gives me back are flipped. Why?
To manage log scale I have added the following line after line 86:
This works for coordinates but I didn't check for position vector. Other than that it works for me.
Can add text at the tail of the arrow using 'textarrow' ?
working for me. great
Works fine for me. Thanks for sharing.
Your function doesn't work with equal axes. example:
function createfigure(X1, Y1,f)
% X1: vector of x data
% Y1: vector of y data
% Auto-generated by MATLAB on 17-Mar-2008 14:49:27
% Create figure
figure1 = figure('XVisual',...
'0x22 (TrueColor, depth 24, RGB mask 0xff0000 0xff00 0x00ff)');
% Create axes
% Create plot
[vpx,vpy]= ds2nfu(gca,[r r],[0,f(r)]);
[nx,ny] = ds2nfu(gca,[r r-.2*sin(the)],[f(r) f(r)+.2*cos(the)]);
This function does not deal with log axes.
This a nice and useful code, but it do not work if DataAspectRatioMode or PlotBoxAspectRatioMode are set to 'manual'. So it would be even nicer if this code would be improved to managed such case.
Sorry about that! I was using a syntax introduced in R13. Easy enough fix - change '&&' to '&' in line 58 (2 times). I tested in R12, and it works with this fix. This should work for slightly older versions, too. Note that the examples won't work, though, since ANNOTATION was introduced sometime after R12.
Doesn't work in R12a
Easy to use, and seems to work correctly. As soon as I learned of the annotation function, I realized that I needed this coordinate conversion function. Thanks.
Works as advertised. A necessity if you prefer to do your annotations in code rather than editing the plot. Thanks!
very useful util. for purposes of automatic plot annotation. thx++ mr Hirsch.
Moved source to GitHub.
Inspired: coord2norm, Simulating the Ramsey-Cass-Koopmans Model Using MATLAB and Simulink, axescoord2figurecoord, 3D data space to figure space conversion, Normalized Coordinates for Annotations, 3D data space coordinates to normalized figure coordinates conversion