bigframes.pandas.DataFrame.line#

DataFrame.line(x: Hashable | None = None, y: Hashable | None = None, **kwargs)[source]#

Plot Series or DataFrame as lines. This function is useful to plot lines using DataFrames values as coordinates.

This function calls pandas.plot to generate a plot with a random sample of items. For consistent results, the random sampling is reproducible. Use the sampling_random_state parameter to modify the sampling seed.

Examples:

>>> import bigframes.pandas as bpd
>>> df = bpd.DataFrame(
...     {
...         'one': [1, 2, 3, 4],
...         'three': [3, 6, 9, 12],
...         'reverse_ten': [40, 30, 20, 10],
...     }
... )
>>> ax = df.plot.line(x='one')

Parameters:

• x (label or position, optional) Allows plotting of one column versus another. If not specified, the index of the DataFrame is used.

• y (label or position, optional) Allows plotting of one column versus another. If not specified, all numerical columns are used.

• color (str, array-like, or dict, optional)

  The color for each of the DataFrames columns. Possible values are:

  • A single color string referred to by name, RGB or RGBA code,

    for instance red or #a98d19.

  • A sequence of color strings referred to by name, RGB or RGBA

    code, which will be used for each column recursively. For instance [green,yellow] each columns %(kind)s will be filled in green or yellow, alternatively. If there is only a single column to be plotted, then only the first color from the color list will be used.

  • A dict of the form {column namecolor}, so that each column will be

    colored accordingly. For example, if your columns are called a and b, then passing {a: green, b: red} will color %(kind)ss for column a in green and %(kind)ss for column b in red.

• sampling_n (int, default 100) Number of random items for plotting.

• sampling_random_state (int, default 0) Seed for random number generator.

• **kwargs Additional keyword arguments are documented in DataFrame.plot().

Returns:

An ndarray is returned with one matplotlib.axes.Axes per column when subplots=True.

Return type:

matplotlib.axes.Axes or np.ndarray of them