databricks.koalas.Series.plot.line

plot.line(x=None, y=None, **kwargs)

Plot DataFrame/Series as lines.

This function is useful to plot lines using Series’s values as coordinates.

Parameters
xint or str, optional

Columns to use for the horizontal axis. Either the location or the label of the columns to be used. By default, it will use the DataFrame indices.

yint, str, or list of them, optional

The values to be plotted. Either the location or the label of the columns to be used. By default, it will use the remaining DataFrame numeric columns.

**kwds

Keyword arguments to pass on to Series.plot() or DataFrame.plot().

Returns
axesmatplotlib.axes.Axes or numpy.ndarray

Return an ndarray when subplots=True. Return an custom object when backend!=matplotlib.

See also

matplotlib.pyplot.plot

Plot y versus x as lines and/or markers.

Examples

Basic plot.

For Series:

>>> s = ks.Series([1, 3, 2])
>>> ax = s.plot.line()
../../_images/databricks-koalas-Series-plot-line-1.png

For DataFrame:

The following example shows the populations for some animals over the years.

>>> df = ks.DataFrame({'pig': [20, 18, 489, 675, 1776],
...                    'horse': [4, 25, 281, 600, 1900]},
...                   index=[1990, 1997, 2003, 2009, 2014])
>>> lines = df.plot.line()
../../_images/databricks-koalas-Series-plot-line-2.png

An example with subplots, so an array of axes is returned.

>>> axes = df.plot.line(subplots=True)
>>> type(axes)
<class 'numpy.ndarray'>
../../_images/databricks-koalas-Series-plot-line-3.png

The following example shows the relationship between both populations.

>>> lines = df.plot.line(x='pig', y='horse')
../../_images/databricks-koalas-Series-plot-line-4.png