class_docstr: Divider based on the preexisting axes.
class_docstr_tok: ["Divider","based","on","the","preexisting","axes","."]
docstr: Add a new axes on a given side of the main axes.
  
  Parameters
  ----------
  position : {"left", "right", "bottom", "top"}
      Where the new axes is positioned relative to the main axes.
  size : :mod:`~mpl_toolkits.axes_grid1.axes_size` or float or str
      The axes width or height.  float or str arguments are interpreted
      as ``axes_size.from_any(size, AxesX(<main_axes>))`` for left or
      right axes, and likewise with ``AxesY`` for bottom or top axes.
  pad : :mod:`~mpl_toolkits.axes_grid1.axes_size` or float or str
      Padding between the axes.  float or str arguments are interpreted
      as for *size*.  Defaults to :rc:`figure.subplot.wspace` times the
      main Axes width (left or right axes) or :rc:`figure.subplot.hspace`
      times the main Axes height (bottom or top axes).
  axes_class : subclass type of `~.axes.Axes`, optional
      The type of the new axes.  Defaults to the type of the main axes.
  **kwargs
      All extra keywords arguments are passed to the created axes.
docstr_tok: ["Add","a","new","axes","on","a","given","side","of","the","main","axes",".","Parameters","--","--","--","--","--","position",":","{","``","left","''",",","``","right","''",",","``","bottom","''",",","``","top","''","}","Where","the","new","axes","is","positioned","relative","to","the","main","axes",".","size",":",":","mod",":","`","~mpl_toolkits.axes_grid1.axes_size","`","or","float","or","str","The","axes","width","or","height",".","float","or","str","arguments","are","interpreted","as","``","axes_size.from_any","(","size",",","AxesX","(","<","main_axes",">",")",")","``","for","left","or","right","axes",",","and","likewise","with","``","AxesY","``","for","bottom","or","top","axes",".","pad",":",":","mod",":","`","~mpl_toolkits.axes_grid1.axes_size","`","or","float","or","str","Padding","between","the","axes",".","float","or","str","arguments","are","interpreted","as","for","*","size","*",".","Defaults","to",":","rc",":","`","figure.subplot.wspace","`","times","the","main","Axes","width","(","left","or","right","axes",")","or",":","rc",":","`","figure.subplot.hspace","`","times","the","main","Axes","height","(","bottom","or","top","axes",")",".","axes_class",":","subclass","type","of","`","~.axes.Axes","`",",","optional","The","type","of","the","new","axes",".","Defaults","to","the","type","of","the","main","axes",".","*","*","kwargs","All","extra","keywords","arguments","are","passed","to","the","created","axes","."]
code: def append_axes(
      self, position, size, pad=None, *, axes_class=None, **kwargs
  ):
      """
      Add a new axes on a given side of the main axes.
  
      Parameters
      ----------
      position : {"left", "right", "bottom", "top"}
          Where the new axes is positioned relative to the main axes.
      size : :mod:`~mpl_toolkits.axes_grid1.axes_size` or float or str
          The axes width or height.  float or str arguments are interpreted
          as ``axes_size.from_any(size, AxesX(<main_axes>))`` for left or
          right axes, and likewise with ``AxesY`` for bottom or top axes.
      pad : :mod:`~mpl_toolkits.axes_grid1.axes_size` or float or str
          Padding between the axes.  float or str arguments are interpreted
          as for *size*.  Defaults to :rc:`figure.subplot.wspace` times the
          main Axes width (left or right axes) or :rc:`figure.subplot.hspace`
          times the main Axes height (bottom or top axes).
      axes_class : subclass type of `~.axes.Axes`, optional
          The type of the new axes.  Defaults to the type of the main axes.
      **kwargs
          All extra keywords arguments are passed to the created axes.
      """
      create_axes, pack_start = _api.check_getitem(
          {
              "left": (self.new_horizontal, True),
              "right": (self.new_horizontal, False),
              "bottom": (self.new_vertical, True),
              "top": (self.new_vertical, False),
          },
          position=position,
      )
      ax = create_axes(
          size,
          pad,
          pack_start=pack_start,
          axes_class=axes_class,
          **kwargs,
      )
      self._fig.add_axes(ax)
      return ax
  
imports: import functools
  import numpy
  import matplotlib
  from matplotlib import _api
  from matplotlib.gridspec import SubplotSpec
  import matplotlib.transforms
  from .None import axes_size
label_desc: Use image node_id 5 for calling the AxesDivider obj's underlying member method code with example usage: obj.append_axes(position, size, pad) and returns: ax