Editor's Note: This file was selected as MATLAB Central Pick of the Week
Sometimes the exact location of some text annotation doesn't matter. This works just like TEXT (including the property calls) except one does not specify an X,Y location. The subroutine TSCAN (modified from the Matlab LSCAN routine) automatically places the text, with a preference for the bottom/left corner.
Cite As
Peter Mao (2020). textbp: text with legend-style "best" placement (https://www.mathworks.com/matlabcentral/fileexchange/11466-textbp-text-with-legend-style-best-placement), MATLAB Central File Exchange. Retrieved .
Comments and Ratings (25)
Updates
| 1.1.0.0 | Modified TSCAN to properly avoid histogram bars. |
MATLAB Release Compatibility
Platform Compatibility
Windows macOS LinuxTags
Discover Live Editor
Create scripts with code, output, and formatted text in a single executable document.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
Select web siteYou can also select a web site from the following list:
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)
Andrejs Fedjajevs (view profile)
Honigmelone (view profile)
Very nice function, undofrtunately it does not work for multiline strings in subplots.
Lamya (view profile)
André Guerra (view profile)
Rodrigo Duran (view profile)
and the error only happens sometimes, some 2 by 6 subplots worked just fine (each subplot uses textbp)
Rodrigo Duran (view profile)
Very helpful function, however recently showing same error as Mathew Crema and Holger Hoffman have reported. 2 by 6 subplots
Undefined function or variable 'pop'.
Error in textbp>tscan (line 149)
minpop = min(min(pop));
Error in textbp (line 24)
pos = tscan(gca,width,height,TOL);
Richard Sims (view profile)
There seems to be some issue if you use this in conjunction with reversing axis e.g set(gca,'YDir','reverse')
Holger Hoffmann (view profile)
same issue as Matthew Crema
- no subplots
- the problem is "tscan"
"Undefined function or variable "pop".
Error in tscan (line 136)
minpop = min(min(pop));"
Matthew Crema (view profile)
It does not work for me, and the error message is:
Undefined function or variable "pop".
I have a lot of subplots in one figure, which may make the task difficult.
Peter Mao (view profile)
Ian -- legend tends to take the best upper-right position, while textbp looks for the best lower-left position. If your plot is fairly dense with data, they may decide on the same spot. textbp only pays attention to the data, it doesn't know where the legend is placed.
Alireza -- this is hard to debug without the error message. I'm going to guess that you put it somewhere where it's not in your path. Try "which textbp" or "path".
Alireza (view profile)
It doesn't work for me but maybe I'm doing something wrong. I added the folder in the toolbox folder of Matlab and I'm using textbp('some string') after I plot some data. Is that right?
Ian (view profile)
This works well on its own, but it does not seem to play well with the legend command (MATLAB R2013a). Both legend and textbp choose the same overlapping 'best' spot.
Yi (view profile)
Peter Mao (view profile)
Jamal -- As I recall, that's related to a problem that occurs when translating between figure and axis normalized coordinates. I took it up w/ Mathworks years ago, with no satisfactory resolution, so there it stands.
Peter Mao (view profile)
Adrien -- the trick is to rejigger TSCAN so it goes from top-left to bottom-right. I'll do that if I can find some time. It's been a long time since I looked at the code!
James (view profile)
I can't figure out how to use this code. Does this need to be placed in each .m file I wish to use the textbp function in?
Adrien (view profile)
Problem : it does not seem to work with the function "hist". A solution ?
Faiz Mahdi (view profile)
Jamal Said (view profile)
A problem: the repeated using of the function - in its simplest form - causes the overall added texts to be shifted diagonally.
K E (view profile)
Useful. Should be a Matlab builtin.
Alonso (view profile)
chen (view profile)
Scott Foster (view profile)
This is a great bit of code for what it does. Very easy to use, and exactly what I was looking for.
Beautiful! This code does exactly what I want to achieve. A very nice, simple substiture for the MATLAB text command where hands-off annotation is desired!
This is a code that I was looking for. Since a command "legend" has similar functionality I even though that there might be a command already. I have been using "legend" to put all information in the plot, which was pain in the neck. Now I can make a plot with all experimental parameters.