class_docstr: Make plots of Series or DataFrame.
  
  Uses the backend specified by the
  option ``plotting.backend``. By default, matplotlib is used.
  
  Parameters
  ----------
  data : Series or DataFrame
      The object for which the method is called.
  x : label or position, default None
      Only used if data is a DataFrame.
  y : label, position or list of label, positions, default None
      Allows plotting of one column versus another. Only used if data is a
      DataFrame.
  kind : str
      The kind of plot to produce:
  
      - 'line' : line plot (default)
      - 'bar' : vertical bar plot
      - 'barh' : horizontal bar plot
      - 'hist' : histogram
      - 'box' : boxplot
      - 'kde' : Kernel Density Estimation plot
      - 'density' : same as 'kde'
      - 'area' : area plot
      - 'pie' : pie plot
      - 'scatter' : scatter plot (DataFrame only)
      - 'hexbin' : hexbin plot (DataFrame only)
  ax : matplotlib axes object, default None
      An axes of the current figure.
  subplots : bool or sequence of iterables, default False
      Whether to group columns into subplots:
  
      - ``False`` : No subplots will be used
      - ``True`` : Make separate subplots for each column.
      - sequence of iterables of column labels: Create a subplot for each
        group of columns. For example `[('a', 'c'), ('b', 'd')]` will
        create 2 subplots: one with columns 'a' and 'c', and one
        with columns 'b' and 'd'. Remaining columns that aren't specified
        will be plotted in additional subplots (one per column).
  
        .. versionadded:: 1.5.0
  
  sharex : bool, default True if ax is None else False
      In case ``subplots=True``, share x axis and set some x axis labels
      to invisible; defaults to True if ax is None otherwise False if
      an ax is passed in; Be aware, that passing in both an ax and
      ``sharex=True`` will alter all x axis labels for all axis in a figure.
  sharey : bool, default False
      In case ``subplots=True``, share y axis and set some y axis labels to invisible.
  layout : tuple, optional
      (rows, columns) for the layout of subplots.
  figsize : a tuple (width, height) in inches
      Size of a figure object.
  use_index : bool, default True
      Use index as ticks for x axis.
  title : str or list
      Title to use for the plot. If a string is passed, print the string
      at the top of the figure. If a list is passed and `subplots` is
      True, print each item in the list above the corresponding subplot.
  grid : bool, default None (matlab style default)
      Axis grid lines.
  legend : bool or {'reverse'}
      Place legend on axis subplots.
  style : list or dict
      The matplotlib line style per column.
  logx : bool or 'sym', default False
      Use log scaling or symlog scaling on x axis.
  
  logy : bool or 'sym' default False
      Use log scaling or symlog scaling on y axis.
  
  loglog : bool or 'sym', default False
      Use log scaling or symlog scaling on both x and y axes.
  
  xticks : sequence
      Values to use for the xticks.
  yticks : sequence
      Values to use for the yticks.
  xlim : 2-tuple/list
      Set the x limits of the current axes.
  ylim : 2-tuple/list
      Set the y limits of the current axes.
  xlabel : label, optional
      Name to use for the xlabel on x-axis. Default uses index name as xlabel, or the
      x-column name for planar plots.
  
      .. versionadded:: 1.1.0
  
      .. versionchanged:: 1.2.0
  
         Now applicable to planar plots (`scatter`, `hexbin`).
  
      .. versionchanged:: 2.0.0
  
          Now applicable to histograms.
  
  ylabel : label, optional
      Name to use for the ylabel on y-axis. Default will show no ylabel, or the
      y-column name for planar plots.
  
      .. versionadded:: 1.1.0
  
      .. versionchanged:: 1.2.0
  
         Now applicable to planar plots (`scatter`, `hexbin`).
  
      .. versionchanged:: 2.0.0
  
          Now applicable to histograms.
  
  rot : float, default None
      Rotation for ticks (xticks for vertical, yticks for horizontal
      plots).
  fontsize : float, default None
      Font size for xticks and yticks.
  colormap : str or matplotlib colormap object, default None
      Colormap to select colors from. If string, load colormap with that
      name from matplotlib.
  colorbar : bool, optional
      If True, plot colorbar (only relevant for 'scatter' and 'hexbin'
      plots).
  position : float
      Specify relative alignments for bar plot layout.
      From 0 (left/bottom-end) to 1 (right/top-end). Default is 0.5
      (center).
  table : bool, Series or DataFrame, default False
      If True, draw a table using the data in the DataFrame and the data
      will be transposed to meet matplotlib's default layout.
      If a Series or DataFrame is passed, use passed data to draw a
      table.
  yerr : DataFrame, Series, array-like, dict and str
      See :ref:`Plotting with Error Bars <visualization.errorbars>` for
      detail.
  xerr : DataFrame, Series, array-like, dict and str
      Equivalent to yerr.
  stacked : bool, default False in line and bar plots, and True in area plot
      If True, create stacked plot.
  secondary_y : bool or sequence, default False
      Whether to plot on the secondary y-axis if a list/tuple, which
      columns to plot on secondary y-axis.
  mark_right : bool, default True
      When using a secondary_y axis, automatically mark the column
      labels with "(right)" in the legend.
  include_bool : bool, default is False
      If True, boolean values can be plotted.
  backend : str, default None
      Backend to use instead of the backend specified in the option
      ``plotting.backend``. For instance, 'matplotlib'. Alternatively, to
      specify the ``plotting.backend`` for the whole session, set
      ``pd.options.plotting.backend``.
  **kwargs
      Options to pass to matplotlib plotting method.
  
  Returns
  -------
  :class:`matplotlib.axes.Axes` or numpy.ndarray of them
      If the backend is not the default matplotlib one, the return value
      will be the object returned by the backend.
  
  Notes
  -----
  - See matplotlib documentation online for more on this subject
  - If `kind` = 'bar' or 'barh', you can specify relative alignments
    for bar plot layout by `position` keyword.
    From 0 (left/bottom-end) to 1 (right/top-end). Default is 0.5
    (center)
docstr: Draw a stacked area plot.
  
  An area plot displays quantitative data visually.
  This function wraps the matplotlib area function.
  
  Parameters
  ----------
  x : label or position, optional
      Coordinates for the X axis. By default uses the index.
  y : label or position, optional
      Column to plot. By default uses all columns.
  stacked : bool, default True
      Area plots are stacked by default. Set to False to create a
      unstacked plot.
  **kwargs
      Additional keyword arguments are documented in
      :meth:`DataFrame.plot`.
  
  Returns
  -------
  matplotlib.axes.Axes or numpy.ndarray
      Area plot, or array of area plots if subplots is True.
  
  See Also
  --------
  DataFrame.plot : Make plots of DataFrame using matplotlib / pylab.
  
  Examples
  --------
  Draw an area plot based on basic business metrics:
  
  .. plot::
      :context: close-figs
  
      >>> df = pd.DataFrame({
      ...     'sales': [3, 2, 3, 9, 10, 6],
      ...     'signups': [5, 5, 6, 12, 14, 13],
      ...     'visits': [20, 42, 28, 62, 81, 50],
      ... }, index=pd.date_range(start='2018/01/01', end='2018/07/01',
      ...                        freq='M'))
      >>> ax = df.plot.area()
  
  Area plots are stacked by default. To produce an unstacked plot,
  pass ``stacked=False``:
  
  .. plot::
      :context: close-figs
  
      >>> ax = df.plot.area(stacked=False)
  
  Draw an area plot for a single column:
  
  .. plot::
      :context: close-figs
  
      >>> ax = df.plot.area(y='sales')
  
  Draw with a different `x`:
  
  .. plot::
      :context: close-figs
  
      >>> df = pd.DataFrame({
      ...     'sales': [3, 2, 3],
      ...     'visits': [20, 42, 28],
      ...     'day': [1, 2, 3],
      ... })
      >>> ax = df.plot.area(x='day')
docstr_tok: ["Draw","a","stacked","area","plot",".","An","area","plot","displays","quantitative","data","visually",".","This","function","wraps","the","matplotlib","area","function",".","Parameters","--","--","--","--","--","x",":","label","or","position",",","optional","Coordinates","for","the","X","axis",".","By","default","uses","the","index",".","y",":","label","or","position",",","optional","Column","to","plot",".","By","default","uses","all","columns",".","stacked",":","bool",",","default","True","Area","plots","are","stacked","by","default",".","Set","to","False","to","create","a","unstacked","plot",".","*","*","kwargs","Additional","keyword","arguments","are","documented","in",":","meth",":","`","DataFrame.plot","`",".","Returns","--","--","--","-","matplotlib.axes.Axes","or","numpy.ndarray","Area","plot",",","or","array","of","area","plots","if","subplots","is","True",".","See","Also","--","--","--","--","DataFrame.plot",":","Make","plots","of","DataFrame","using","matplotlib","\/","pylab",".","Examples","--","--","--","--","Draw","an","area","plot","based","on","basic","business","metrics",":","..","plot",":",":",":","context",":","close-figs",">",">",">","df","=","pd.DataFrame","(","{","...","'sales","'",":","[","3",",","2",",","3",",","9",",","10",",","6","]",",","...","'signups","'",":","[","5",",","5",",","6",",","12",",","14",",","13","]",",","...","'visits","'",":","[","20",",","42",",","28",",","62",",","81",",","50","]",",","...","}",",","index=pd.date_range","(","start='2018\/01\/01","'",",","end='2018\/07\/01","'",",","...","freq='M","'",")",")",">",">",">","ax","=","df.plot.area","(",")","Area","plots","are","stacked","by","default",".","To","produce","an","unstacked","plot",",","pass","``","stacked=False","``",":","..","plot",":",":",":","context",":","close-figs",">",">",">","ax","=","df.plot.area","(","stacked=False",")","Draw","an","area","plot","for","a","single","column",":","..","plot",":",":",":","context",":","close-figs",">",">",">","ax","=","df.plot.area","(","y='sales","'",")","Draw","with","a","different","`","x","`",":","..","plot",":",":",":","context",":","close-figs",">",">",">","df","=","pd.DataFrame","(","{","...","'sales","'",":","[","3",",","2",",","3","]",",","...","'visits","'",":","[","20",",","42",",","28","]",",","...","'day","'",":","[","1",",","2",",","3","]",",","...","}",")",">",">",">","ax","=","df.plot.area","(","x='day","'",")"]
code: def area(
      self, x=None, y=None, stacked: bool = True, **kwargs
  ) -> PlotAccessor:
      """
      Draw a stacked area plot.
  
      An area plot displays quantitative data visually.
      This function wraps the matplotlib area function.
  
      Parameters
      ----------
      x : label or position, optional
          Coordinates for the X axis. By default uses the index.
      y : label or position, optional
          Column to plot. By default uses all columns.
      stacked : bool, default True
          Area plots are stacked by default. Set to False to create a
          unstacked plot.
      **kwargs
          Additional keyword arguments are documented in
          :meth:`DataFrame.plot`.
  
      Returns
      -------
      matplotlib.axes.Axes or numpy.ndarray
          Area plot, or array of area plots if subplots is True.
  
      See Also
      --------
      DataFrame.plot : Make plots of DataFrame using matplotlib / pylab.
  
      Examples
      --------
      Draw an area plot based on basic business metrics:
  
      .. plot::
          :context: close-figs
  
          >>> df = pd.DataFrame({
          ...     'sales': [3, 2, 3, 9, 10, 6],
          ...     'signups': [5, 5, 6, 12, 14, 13],
          ...     'visits': [20, 42, 28, 62, 81, 50],
          ... }, index=pd.date_range(start='2018/01/01', end='2018/07/01',
          ...                        freq='M'))
          >>> ax = df.plot.area()
  
      Area plots are stacked by default. To produce an unstacked plot,
      pass ``stacked=False``:
  
      .. plot::
          :context: close-figs
  
          >>> ax = df.plot.area(stacked=False)
  
      Draw an area plot for a single column:
  
      .. plot::
          :context: close-figs
  
          >>> ax = df.plot.area(y='sales')
  
      Draw with a different `x`:
  
      .. plot::
          :context: close-figs
  
          >>> df = pd.DataFrame({
          ...     'sales': [3, 2, 3],
          ...     'visits': [20, 42, 28],
          ...     'day': [1, 2, 3],
          ... })
          >>> ax = df.plot.area(x='day')
      """
      return self(kind="area", x=x, y=y, stacked=stacked, **kwargs)
  
imports: from __future__ import annotations
  import importlib
  import types
  from typing import TYPE_CHECKING, Sequence
  from pandas._config import get_option
  from pandas._typing import IndexLabel
  from pandas.util._decorators import Appender, Substitution
  from pandas.core.dtypes.common import is_integer, is_list_like
  from pandas.core.dtypes.generic import ABCDataFrame, ABCSeries
  from pandas.core.base import PandasObject
label_desc: Use image node_id 10 for calling the PlotAccessor obj's underlying member method code with example usage: obj.area(x, y, stacked) and returns: self