Skip to Main Content Skip to Search
Product Documentation

LineSpec (Line Specification) - Line specification string syntax

Alternatives

To modify the style, width, and color of lines on a graph, use the Property Editor, one of the plotting tools . For details, see The Property Editor in the MATLAB Graphics documentation.

Description

Plotting functions accept string specifiers as arguments and modify the graph generated accordingly. Three components can be specified in the string specifiers along with the plotting command. They are:

For example:

plot(x,y,'-.or')

plots y versus x using a dash-dot line (-.), places circular markers (o) at the data points, and colors both line and marker red (r). Specify the components (in any order) as a quoted string after the data arguments. Note that linespecs are single strings, not property-value pairs.

Plotting Data Points with No Line

If you specify a marker, but not a line style, only the markers are plotted. For example:

plot(x,y,'d')

Line Style Specifiers

You indicate the line styles, marker types, and colors you want to display using string specifiers, detailed in the following tables:

Specifier

Line Style

'-'

Solid line (default)

'--'

Dashed line

':'

Dotted line

'-.'

Dash-dot line

'none'

No line

Marker Specifiers

Specifier

Marker Type

'+'

Plus sign

'o'

Circle

'*'

Asterisk

'.'

Point

'x'

Cross

'square' or 's'

Square

'diamond' or 'd'

Diamond

'^'

Upward-pointing triangle

'v'

Downward-pointing triangle

'>'

Right-pointing triangle

'<'

Left-pointing triangle

'pentagram' or 'p'

Five-pointed star (pentagram)

'hexagram' or 'h'''

Six-pointed star (hexagram)

'none'

No marker (default)

Color Specifiers

Specifier

Color

r

Red

g

Green

b

Blue

c

Cyan

m

Magenta

y

Yellow

k

Black

w

White

Related Properties

This page also describes how to specify the properties of lines used for plotting. MATLAB graphics give you control over these visual characteristics:

In addition, you can specify the LineStyle, Color, and Marker properties instead of using the symbol string. This is useful if you want to specify a color that is not in the list by using RGB values. See Lineseries Properties for details on these properties and ColorSpec for more information on color.

Examples

Plot the sine function over three different ranges using different line styles, colors, and markers.

figure
t = 0:pi/20:2*pi;
plot(t,sin(t),'-.r*')
hold on
plot(t,sin(t-pi/2),'--mo')
plot(t,sin(t-pi),':bs')
hold off

 

Create a plot illustrating how to set line properties:

figure
plot(t,sin(2*t),'-mo',...
                'LineWidth',2,...
                'MarkerEdgeColor','k',...
                'MarkerFaceColor',[.49 1 .63],...
                'MarkerSize',10)

See Also

axes | ColorSpec | line | Lineseries Properties | patch | plot | set | surface

How To

  


Free MATLAB Interactive Kit

Explore how to use MATLAB to make advancements in engineering and science.


Download free kit

Trials Available

Try the latest version of MATLAB and other MathWorks products.


Get trial software
 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS