docstr: An anchored container with transformed coordinates.
  
  Artists added to the *drawing_area* are scaled according to the
  coordinates of the transformation used. The dimensions of this artist
  will scale to contain the artists added.
  
  Parameters
  ----------
  transform : `~matplotlib.transforms.Transform`
      The transformation object for the coordinate system in use, i.e.,
      :attr:`matplotlib.axes.Axes.transData`.
  loc : str
      Location of this artist.  Valid locations are
      'upper left', 'upper center', 'upper right',
      'center left', 'center', 'center right',
      'lower left', 'lower center', 'lower right'.
      For backward compatibility, numeric values are accepted as well.
      See the parameter *loc* of `.Legend` for details.
  pad : float, default: 0.4
      Padding around the child objects, in fraction of the font size.
  borderpad : float, default: 0.5
      Border padding, in fraction of the font size.
  prop : `~matplotlib.font_manager.FontProperties`, optional
      Font property used as a reference for paddings.
  frameon : bool, default: True
      If True, draw a box around this artist.
  **kwargs
      Keyword arguments forwarded to `.AnchoredOffsetbox`.
  
  Attributes
  ----------
  drawing_area : `~matplotlib.offsetbox.AuxTransformBox`
      A container for artists to display.
  
  Examples
  --------
  To display an ellipse in the upper left, with a width of 0.1 and
  height of 0.4 in data coordinates:
  
  >>> box = AnchoredAuxTransformBox(ax.transData, loc='upper left')
  >>> el = Ellipse((0, 0), width=0.1, height=0.4, angle=30)
  >>> box.drawing_area.add_artist(el)
  >>> ax.add_artist(box)
docstr_tok: ["An","anchored","container","with","transformed","coordinates",".","Artists","added","to","the","*","drawing_area","*","are","scaled","according","to","the","coordinates","of","the","transformation","used",".","The","dimensions","of","this","artist","will","scale","to","contain","the","artists","added",".","Parameters","--","--","--","--","--","transform",":","`","~matplotlib.transforms.Transform","`","The","transformation","object","for","the","coordinate","system","in","use",",","i.e.",",",":","attr",":","`","matplotlib.axes.Axes.transData","`",".","loc",":","str","Location","of","this","artist",".","Valid","locations","are","'upper","left","'",",","'upper","center","'",",","'upper","right","'",",","'center","left","'",",","'center","'",",","'center","right","'",",","'lower","left","'",",","'lower","center","'",",","'lower","right","'",".","For","backward","compatibility",",","numeric","values","are","accepted","as","well",".","See","the","parameter","*","loc","*","of","`",".Legend","`","for","details",".","pad",":","float",",","default",":","0.4","Padding","around","the","child","objects",",","in","fraction","of","the","font","size",".","borderpad",":","float",",","default",":","0.5","Border","padding",",","in","fraction","of","the","font","size",".","prop",":","`","~matplotlib.font_manager.FontProperties","`",",","optional","Font","property","used","as","a","reference","for","paddings",".","frameon",":","bool",",","default",":","True","If","True",",","draw","a","box","around","this","artist",".","*","*","kwargs","Keyword","arguments","forwarded","to","`",".AnchoredOffsetbox","`",".","Attributes","--","--","--","--","--","drawing_area",":","`","~matplotlib.offsetbox.AuxTransformBox","`","A","container","for","artists","to","display",".","Examples","--","--","--","--","To","display","an","ellipse","in","the","upper","left",",","with","a","width","of","0.1","and","height","of","0.4","in","data","coordinates",":",">",">",">","box","=","AnchoredAuxTransformBox","(","ax.transData",",","loc='upper","left","'",")",">",">",">","el","=","Ellipse","(","(","0",",","0",")",",","width=0.1",",","height=0.4",",","angle=30",")",">",">",">","box.drawing_area.add_artist","(","el",")",">",">",">","ax.add_artist","(","box",")"]
code: def __init__(
      self,
      transform,
      loc,
      pad=0.4,
      borderpad=0.5,
      prop=None,
      frameon=True,
      **kwargs,
  ):
      """
      An anchored container with transformed coordinates.
  
      Artists added to the *drawing_area* are scaled according to the
      coordinates of the transformation used. The dimensions of this artist
      will scale to contain the artists added.
  
      Parameters
      ----------
      transform : `~matplotlib.transforms.Transform`
          The transformation object for the coordinate system in use, i.e.,
          :attr:`matplotlib.axes.Axes.transData`.
      loc : str
          Location of this artist.  Valid locations are
          'upper left', 'upper center', 'upper right',
          'center left', 'center', 'center right',
          'lower left', 'lower center', 'lower right'.
          For backward compatibility, numeric values are accepted as well.
          See the parameter *loc* of `.Legend` for details.
      pad : float, default: 0.4
          Padding around the child objects, in fraction of the font size.
      borderpad : float, default: 0.5
          Border padding, in fraction of the font size.
      prop : `~matplotlib.font_manager.FontProperties`, optional
          Font property used as a reference for paddings.
      frameon : bool, default: True
          If True, draw a box around this artist.
      **kwargs
          Keyword arguments forwarded to `.AnchoredOffsetbox`.
  
      Attributes
      ----------
      drawing_area : `~matplotlib.offsetbox.AuxTransformBox`
          A container for artists to display.
  
      Examples
      --------
      To display an ellipse in the upper left, with a width of 0.1 and
      height of 0.4 in data coordinates:
  
      >>> box = AnchoredAuxTransformBox(ax.transData, loc='upper left')
      >>> el = Ellipse((0, 0), width=0.1, height=0.4, angle=30)
      >>> box.drawing_area.add_artist(el)
      >>> ax.add_artist(box)
      """
      self.drawing_area = AuxTransformBox(transform)
  
      super().__init__(
          loc,
          pad=pad,
          borderpad=borderpad,
          child=self.drawing_area,
          prop=prop,
          frameon=frameon,
          **kwargs,
      )
  
file_path: matplotlib/lib/mpl_toolkits/axes_grid1/anchored_artists.py
imports: from matplotlib import _api, transforms
  from matplotlib.offsetbox import AnchoredOffsetbox, AuxTransformBox, DrawingArea, TextArea, VPacker
  from matplotlib.patches import Rectangle, Ellipse, ArrowStyle, FancyArrowPatch, PathPatch
  from matplotlib.text import TextPath
label_desc: Use image node_id 1 to create a new AnchoredAuxTransformBox object from inherited base classes: AnchoredOffsetbox with example: obj = AnchoredAuxTransformBox(transform, loc, pad, borderpad, prop, frameon)