Built-in Mathematica Symbol

ListLinePlot

ListLinePlot[{y₁, y₂, ...}]
plots a line through a list of values, assumed to correspond to x coordinates 1, 2, ....

ListLinePlot[{{x₁, y₁}, {x₂, y₂}, ...}]
plots a line through specific x and y positions.

ListLinePlot[{list₁, list₂, ...}]
plots several lines.

ListLinePlot has the same options as Graphics, with the following additions and changes:

AspectRatio	1/GoldenRatio	ratio of height to width
Axes	True	whether to draw axes
ClippingStyle	None	what to draw when lines are clipped
ColorFunction	Automatic	how to determine the coloring of lines
ColorFunctionScaling	True	whether to scale arguments to ColorFunction
DataRange	Automatic	the range of x values to assume for data
Filling	None	filling under each line
FillingStyle	Automatic	style to use for filling
InterpolationOrder	None	the polynomial degree of curves used in joining data points
MaxPlotPoints	Infinity	the maximum number of points to include
Mesh	None	how many mesh points to draw on each line
MeshFunctions	{#1&}	how to determine the placement of mesh points
MeshShading	None	how to shade regions between mesh points
MeshStyle	Automatic	the style for mesh points
Method	Automatic	the method to use for interpolation and data reduction
PerformanceGoal	$PerformanceGoal	aspects of performance to try to optimize
PlotMarkers	None	markers to use to indicate each point
PlotRange	Automatic	range of values to include
PlotRangeClipping	True	whether to clip at the plot range
PlotStyle	Automatic	graphics directives to determine the style of each line

The setting PlotStyle->Automatic uses a sequence of different plot styles for different lines.

With the setting PlotStyle->{style₁, style₂, ...} the style_i are used cyclically to determine the styles for each line.

The setting PlotMarkers->Automatic explicitly draws markers to indicate each point in each of the list_i.

Interactive labeling can be specified for points or lines using Tooltip, StatusArea or Annotation.

Tooltip[y_i] or Tooltip[{x_i, y_i}] indicates that the coordinates of a point should be displayed in its tooltip.

Tooltip[list] specifies that coordinate tooltips should be displayed for all points in the list.

Tooltip[list, label] gives the specified tooltip label for the line defined by list.

ListLinePlot[{list₁, list₂, ...}] by default takes the x coordinates for successive values in each of the list_i to be successive integers starting at 1.

The setting DataRange->{x_min, x_max} specifies other ranges of x coordinates to use, with x_max being associated with the last element in the longest of the list_i.

With the default setting DataRange->Automatic, ListLinePlot[{{a₁₁, a₁₂}, ..., {a_n1, a_n2}}] will be taken to give x and y values for n points on a single line, rather than the y values for n separate lines each containing just two points.

ListLinePlot[list, DataRange->All] always takes list to represent values in a list of separate lines.

The list_i can be SparseArray objects.

The arguments supplied to functions in MeshFunctions are x, y. Functions in ColorFunction are by default supplied with scaled versions of these arguments.

The functions are evaluated all along each line.

With ClippingStyle->Automatic a line is drawn at the top or bottom of the plotting area wherever a line goes outside the range of the plot.

ListLinePlot normally returns Graphics[{Line[...], ...}].

With a Filling specification given, ListLinePlot returns Graphics[{GraphicsComplex[...], ...}].

EXAMPLES

CLOSE ALL

Basic Examples (4)

Plot a list of

values:

Plot a list of

pairs:

Plot multiple datasets:

Use different styling to emphasize features:

Plot a list of

values:

In[1]:=

Out[1]=

Plot a list of

pairs:

In[1]:=

Out[1]=

Plot multiple datasets:

In[1]:=

Out[1]=

Use different styling to emphasize features:

In[1]:=

Out[1]=

Scope (17)

Lines are drawn through the data points:

Use

pairs:

Show multiple sets of data:

The plot range is selected automatically:

Specify what values the data ranges over:

Ranges where the data is nonreal are excluded:

Use InterpolationOrder to smooth the data:

Use MaxPlotPoints to limit the number of points used:

Use PlotRange to focus in on areas of interest:

Multiple curves are automatically colored to be distinct:

Provide explicit styling to different curves:

Add labels:

Provide an interactive Tooltip for the data:

Create filled plots:

Create an overlay mesh:

Use shapes to distinguish different datasets:

Style the curve segments between mesh points:

Generalizations & Extensions (1)

The data can be self-intersecting:

Options (72)

Use the default aspect ratio:

Use the aspect ratio as derived from data:

The position of the axes is determined automatically:

Specify an explicit origin for the axes:

Omit clipped regions of the plot:

Show the clipped regions like the rest of the curve:

Show clipped regions with red lines:

Show clipped regions as red at the bottom, and thick at the top:

Show clipped regions as red and thick:

Color by scaled

and

coordinates:

Color with a named color scheme:

Fill with the color used for the curve:

ColorFunction has higher priority than PlotStyle for coloring the curve:

Use Automatic in MeshShading to use the ColorFunction:

Color the line based on scaled

value:

Color the line based on unscaled

value:

Lists of height values are displayed against the number of elements:

Rescale to the sampling space:

Each dataset is scaled to the same domain:

Pairs are interpreted as

coordinates:

Specifying DataRange in this case has no effect, since

values are part of the data:

Force interpretation as multiple datasets:

Use symbolic or explicit values:

Fills that overlap by default combine using opacity:

Fill between the first curve and the axis:

Fill between two lines:

Fill between curves 1 and 2 with a specific style:

Fill between curves 1 and

with light orange:

Fill between curves 1 and 2; use yellow when 1 is below 2, and green when 2 is above 1:

Filling between curves applies where the curves overlap:

Use different fill colors:

Fill with opacity 0.5 orange:

Fill with red below the axis, and blue above:

Use a variable filling style obtained from ColorFunction:

Points are normally joined with straight lines:

Use quadratic spline interpolation to fit the data:

Use flat regions with steps at each data point:

All points are included by default:

Uniformly spaced data is downsampled:

In this case, downsampling from

to

points:

Nonuniform data topologically subsampled, to preserve features:

Points on either side of nonreal data are always included:

The initial and final sampling meshes are typically the same:

Interpolated data may introduce points:

Use 20 mesh levels evenly spaced in the

direction:

Use an explicit list of values for the mesh in the

direction:

Specify style and mesh levels in the

direction:

Use a mesh evenly spaced in the

and

directions:

Show five mesh levels in the

direction (red) and ten in the

direction (blue):

Alternate red and blue segments of equal width in the

direction:

Use None to remove segments:

MeshShading can be used with PlotStyle:

MeshShading has higher priority than PlotStyle for styling the curve:

Use the PlotStyle for some segments by setting MeshShading to Automatic:

MeshShading can be used with ColorFunction:

Color the mesh the same color as the plot:

Use a red mesh in the

direction:

Use a red mesh in the

direction and a blue mesh in the

direction:

Use big red mesh points in the

direction:

ListLinePlot normally uses distinct color to distinguish different sets of data:

Automatically use colors and shapes to distinguish sets of data:

Use shapes only:

Change the size of the default plot markers:

Use arbitrary text for plot markers:

Use explicit graphics for plot markers:

Use the same symbol for all the sets of data:

Explicitly use a symbol and size:

PlotRange is automatically calculated:

Show the whole dataset:

Use different style directives:

By default different styles are chosen for multiple curves:

Explicitly specify the style for different curves:

PlotStyle can be combined with ColorFunction:

PlotStyle can be combined with MeshShading:

MeshStyle by default uses the same style as PlotStyle:

Applications (9)

Compare the n

prime to an estimate:

Show a random walk in one dimension:

Show a random walk in two dimensions:

Random walk on a lattice:

Compute and plot the shortest tour through a hundred random points:

Create a stacked line chart:

Show the numbers of graphs with different numbers of nodes available in GraphData:

Show the density at standard temperature and pressure for the elements:

Distribution of Mathematica symbols by length:

Plot the sample behavior for different Mathematica functions:

Plot the sample order in the

,

space used by Plot3D:

Properties & Relations (11)

ListLinePlot is a special case of ListPlot:

Use Plot to visualize functions:

Use ListLogPlot, ListLogLogPlot and ListLogLinearPlot for logarithmic data plots:

Use ListPolarPlot for polar plots:

Use DateListPlot to show data over time:

Use ListPointPlot3D to show three-dimensional data plots:

Use ListPlot3D to create surfaces from data:

Use ListContourPlot to create contours from continuous data:

Use ListDensityPlot to create densities from continuous data:

Use ArrayPlot and MatrixPlot for arrays of discrete values:

Use ParametricPlot for parametric curves:

Possible Issues (2)

Limiting the number of points may introduce artifacts:

Use more points to have fewer artifacts:

Unordered data may display in unexpected ways:

Sort the data to interpret as a function: