4.85185

4.9 | 28 ratings Rate this file 302 downloads (last 30 days) File Size: 3.27 KB File ID: #1039

hline and vline

by Brandon Kuczenski

 

08 Nov 2001 (Updated 09 Nov 2001)

Code covered by BSD License  

Draws 'low-impact' horizontal or vertical lines on the current axes

Editor's Notes:

This file was a File Exchange Pick of the Week

Download Now | Watch this File

File Information
Description

These functions draw horizontal or vertical lines at specified places on the current axes. The axes are automatically held for the drawing of the lines, and restored to their previous 'hold' states afterwards. THe HandleVisibility of the new lines is "off" so that they don't appear on legends. (Incidentally, this also makes them invisible to moveplot.m and addplot.m) Objects with HandleVisibility set to off can be "found" by setting the root object's "ShowHiddenHandles" property to "on". Also, if an output argument is specified, the function will return the handle to the otherwise 'hidden' object.

Further arguments allow the user to set the linetype and color of the line (default is 'r:'), and to add labels. For example:

h = vline(42,'g','The Answer')

will return a handle to a vertical line at x=42 on the current axes, colored green, and with a text label "The Answer" on the axes close to the line, and in the same color of the line.

hline and vline both accept vector inputs.

Acknowledgements
This submission has inspired the following:
data_marker, Advanced hline and vline, MRI Brain Segmentation, Thresholding Tool, Demos from Image Processing Webinar 2006
MATLAB release MATLAB 6.0 (R12)
Other requirements Tested on Win 98 and 2K. Functionality is not dependent on Matlab R12.
Zip File Content  
Other Files hline.m,
vline.m
Tags for This File  
Everyone's Tags
Tags I've Applied
Add New Tags Please login to tag files.
Comments and Ratings (29)
16 Nov 2001 Larry Friese

Very nice, but I get two extra data elements in the plot legend? Is there a way around that?

23 Jan 2004 H Z

it's very handy and useful!!! Thanks:)

01 Apr 2004 confidential confidential

fast and easy!

21 Sep 2004 Wolfgang Stiegmaier

Excellent, easy to use, very effective, good work!

20 Oct 2004 Nahur Fonseca

thanks for writing this.
It's amazing how matlab runtime library did not have such a function built-in.

27 Oct 2004 Stephen Sester

This function meets the common need for drawing simple horz and vert lines on plots. Very nice addition to my tools; should be incorporated into future plot revision. Thank you for taking the time to share your work.

17 Nov 2004 Mike Jennings

This is an excellent, easy to use tool to add a reference line in your plot figure. Can also be customized for color and linetypes. Good Job.

14 Jan 2005 Kedar Patel

Thanks!

Handy lil' time saver.

20 Jan 2005 James Tedd

very handy

03 Feb 2005 Min Poh

test

04 Feb 2005 Krishna Pillai

Nice handy function. Good job

11 Apr 2005 Dimitri Shvorob

When I use VLINE, and later resize the axis with AXIS, vertical line's limits remain unadjusted.

14 Jul 2005 Andy N.

Very Handy

03 Oct 2005 Chris H

perfect for what i needed.

20 Nov 2005 carlo murgia  
20 Mar 2006 Felix Totir

Should be Matlab standard functions.

11 Apr 2006 Simon B

Great tool - one enhancement would be to allow for restricting the range of the lines.

06 Jun 2006 John D'Errico

Very nice. My only (minor) comment would be it might be nice to control the location of the annotation text. I do agree that this is functionality that should have always been in matlab.

By the way, if anyone is worried, it works on a mac also. This is not system specific code.

09 May 2007 Josiah Haswell

Awesome! At least sizeof(long) times better than doing it the standard way.

22 Jun 2007 Greg L

Works great for linear axes. The location of the label is off if it has logrithmic axes.

12 Nov 2007 nimat r

Thanks a lot.It's very nice.

21 May 2008 Ben Kang

Very nice.

24 Sep 2008 B K

Great tool, thanks for submitting!

14 Oct 2008 K R

Thanks - this saves a lot of time and trouble!

23 Mar 2009 Storm Zhang

This really saves me a lot of time. Matlab should put these two small programs into the standard library.

21 Apr 2009 Zafrir  
21 Apr 2009 Zafrir

Good job!!! Very good

08 Jul 2009 Matteo  
02 Oct 2009 Kevin

handy little tool

Please login to add a comment or rating.
Tag Activity for this File
Tag Applied By Date/Time
annotation Brandon Kuczenski 22 Oct 2008 06:39:11
customization Brandon Kuczenski 22 Oct 2008 06:39:11
horizontal Brandon Kuczenski 22 Oct 2008 06:39:11
line Brandon Kuczenski 22 Oct 2008 06:39:11
vertical Brandon Kuczenski 22 Oct 2008 06:39:11
axes Brandon Kuczenski 22 Oct 2008 06:39:11
graphics Brandon Kuczenski 22 Oct 2008 06:39:11
 

MATLAB Central Terms of Use

NOTICE: Any content you submit to MATLAB Central, including personal information, is not subject to the protections which may be afforded information collected under other sections of The MathWorks, Inc. Web site. You are entirely responsible for all content that you upload, post, e-mail, transmit or otherwise make available via MATLAB Central. The MathWorks does not control the content posted by visitors to MATLAB Central and, does not guarantee the accuracy, integrity, or quality of such content. Under no circumstances will The MathWorks be liable in any way for any content not authored by The MathWorks, or any loss or damage of any kind incurred as a result of the use of any content posted, e-mailed, transmitted or otherwise made available via MATLAB Central. Read the complete Terms prior to use.

Contact us at files@mathworks.com