plots points corresponding to a list of values, assumed to correspond to x coordinates , , .

plots a list of points with specified x and y coordinates.

plots several lists of points.

Details and OptionsDetails and Options

  • Data values and can be given in the following forms:
  • xia real-valued number
    Quantity[xi,unit]a quantity with a unit
  • Values and that are not of the form above are taken to be missing and are not shown.
  • The have the following forms and interpretations:
  • <|"k1"y1,"k2"y2,|>values
    <|x1y1,x2y2,|>key-value pairs
    SparseArrayvalues as a normal array
    TimeSeries, EventSeriestime-value pairs
    WeightedDataunweighted values
    w[listi]wrapper w for dataset
  • The following wrappers w can be used for the :
  • Annotation[listi,label]provide an annotation
    Button[listi,action]define an action to execute when the curve is clicked
    EventHandler[listi,]define a general event handler for the curve
    Hyperlink[listi,uri]make the curve act as a hyperlink
    Legended[listi,]identify the points in a legend
    PopupWindow[listi,cont]attach a popup window to the points
    StatusArea[listi,label]display in the status area when the points are moused over
    Style[listi,opts]show the points using the specified styles
    Tooltip[listi,label]attach an arbitrary tooltip to the points
  • Tooltip[yi] or Tooltip[{xi,yi}] 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.
  • ListPlot has the same options as Graphics, with the following additions and changes:
  • AspectRatio1/GoldenRatioratio of height to width
    AxesTruewhether to draw axes
    DataRangeAutomaticthe range of x values to assume for data
    FillingNonehow to fill in stems for each point
    FillingStyleAutomaticstyle to use for filling
    JoinedFalsewhether to join points
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
    PlotLegendsNonelegends for datasets
    PlotMarkersNonemarkers to use to indicate each point
    PlotRangeAutomaticrange of values to include
    PlotRangeClippingTruewhether to clip at the plot range
    PlotStyleAutomaticgraphics directives to determine styles of points
    PlotTheme$PlotThemeoverall theme for the plot
    TargetUnitsAutomaticunits to display in the plot
  • ListPlot[{list1,list2,}] by default uses different colors to indicate points from different .
  • Typical settings for PlotLegends include:
  • Noneno legend
    Automaticautomatically determine legend
    {lbl1,lbl2,}use , , as legend labels
    Placed[lspec,]specify placement for legend
  • ListPlot[list,Joined->True] draws a line through the data, just like ListLinePlot[list].
  • ListPlot[{list1,list2,},Joined->{s1,s2,}] gives specifications for whether to join the points in each of the .
  • In the case Joined->True, ListPlot uses the additional options of ListLinePlot.
  • ListPlot[{list1,list2,}] by default takes the x coordinates for successive points in each of the to be successive integers starting at 1.
  • The setting DataRange->{xmin,xmax} specifies other ranges of x coordinates to use, with being associated with the last element in the longest of the .
  • With the default setting DataRange->Automatic, ListPlot[{{a11,a12},,{an1,an2}}] will be taken to give x and y values for n separate points, rather than y values for n separate datasets each containing two points.
  • ListPlot[list,DataRange->All] always takes list to represent a list of separate datasets.
  • With the setting PlotStyle->{style1,style2,}, the are used cyclically to determine the styles of points in each of the .
  • ListPlot returns Graphics[{Point[],}], Graphics[{Inset[],}], etc.
Introduced in 1988
| Updated in 2014
Translate this page: