docstr: Sets the reference to a legend to show new shape in. References
  to these legends are "legend", "legend2", "legend3", etc.
  Settings for these legends are set in the layout, under
  `layout.legend`, `layout.legend2`, etc.
  
  The 'legend' property is an identifier of a particular
  subplot, of type 'legend', that may be specified as the string 'legend'
  optionally followed by an integer >= 1
  (e.g. 'legend', 'legend1', 'legend2', 'legend3', etc.)
  
  Returns
  -------
  str
docstr_tok: ["Sets","the","reference","to","a","legend","to","show","new","shape","in",".","References","to","these","legends","are","``","legend","''",",","``","legend2","''",",","``","legend3","''",",","etc",".","Settings","for","these","legends","are","set","in","the","layout",",","under","`","layout.legend","`",",","`","layout.legend2","`",",","etc",".","The","'legend","'","property","is","an","identifier","of","a","particular","subplot",",","of","type","'legend","'",",","that","may","be","specified","as","the","string","'legend'","optionally","followed","by","an","integer",">","=","1","(","e.g",".","'legend","'",",","'legend1","'",",","'legend2","'",",","'legend3","'",",","etc",".",")","Returns","--","--","--","-","str"]
code: def legend(self):
      """
      Sets the reference to a legend to show new shape in. References
      to these legends are "legend", "legend2", "legend3", etc.
      Settings for these legends are set in the layout, under
      `layout.legend`, `layout.legend2`, etc.
  
      The 'legend' property is an identifier of a particular
      subplot, of type 'legend', that may be specified as the string 'legend'
      optionally followed by an integer >= 1
      (e.g. 'legend', 'legend1', 'legend2', 'legend3', etc.)
  
      Returns
      -------
      str
      """
      return self["legend"]
  
imports: from plotly.basedatatypes import BaseLayoutHierarchyType
  import copy
label_desc: Use image node_id 11 for calling the Newshape obj's underlying member method code with example usage: obj.legend() and returns: self