docstr: Construct a new Title object
  
  Parameters
  ----------
  arg
      dict of properties compatible with this constructor or
      an instance of :class:`plotly.graph_objs.layout.Title`
  automargin
      Determines whether the title can automatically push the
      figure margins. If `yref='paper'` then the margin will
      expand to ensure that the title doesn’t overlap with
      the edges of the container. If `yref='container'` then
      the margins will ensure that the title doesn’t overlap
      with the plot area, tick labels, and axis titles. If
      `automargin=true` and the margins need to be expanded,
      then y will be set to a default 1 and yanchor will be
      set to an appropriate default to ensure that minimal
      margin space is needed. Note that when `yref='paper'`,
      only 1 or 0 are allowed y values. Invalid values will
      be reset to the default 1.
  font
      Sets the title font. Note that the title's font used to
      be customized by the now deprecated `titlefont`
      attribute.
  pad
      Sets the padding of the title. Each padding value only
      applies when the corresponding `xanchor`/`yanchor`
      value is set accordingly. E.g. for left padding to take
      effect, `xanchor` must be set to "left". The same rule
      applies if `xanchor`/`yanchor` is determined
      automatically. Padding is muted if the respective
      anchor value is "middle*/*center".
  text
      Sets the plot's title. Note that before the existence
      of `title.text`, the title's contents used to be
      defined as the `title` attribute itself. This behavior
      has been deprecated.
  x
      Sets the x position with respect to `xref` in
      normalized coordinates from 0 (left) to 1 (right).
  xanchor
      Sets the title's horizontal alignment with respect to
      its x position. "left" means that the title starts at
      x, "right" means that the title ends at x and "center"
      means that the title's center is at x. "auto" divides
      `xref` by three and calculates the `xanchor` value
      automatically based on the value of `x`.
  xref
      Sets the container `x` refers to. "container" spans the
      entire `width` of the plot. "paper" refers to the width
      of the plotting area only.
  y
      Sets the y position with respect to `yref` in
      normalized coordinates from 0 (bottom) to 1 (top).
      "auto" places the baseline of the title onto the
      vertical center of the top margin.
  yanchor
      Sets the title's vertical alignment with respect to its
      y position. "top" means that the title's cap line is at
      y, "bottom" means that the title's baseline is at y and
      "middle" means that the title's midline is at y. "auto"
      divides `yref` by three and calculates the `yanchor`
      value automatically based on the value of `y`.
  yref
      Sets the container `y` refers to. "container" spans the
      entire `height` of the plot. "paper" refers to the
      height of the plotting area only.
  
  Returns
  -------
  Title
docstr_tok: ["Construct","a","new","Title","object","Parameters","--","--","--","--","--","arg","dict","of","properties","compatible","with","this","constructor","or","an","instance","of",":","class",":","`","plotly.graph_objs.layout.Title","`","automargin","Determines","whether","the","title","can","automatically","push","the","figure","margins",".","If","`","yref='paper","'","`","then","the","margin","will","expand","to","ensure","that","the","title","doesn","\u2019","t","overlap","with","the","edges","of","the","container",".","If","`","yref='container","'","`","then","the","margins","will","ensure","that","the","title","doesn","\u2019","t","overlap","with","the","plot","area",",","tick","labels",",","and","axis","titles",".","If","`","automargin=true","`","and","the","margins","need","to","be","expanded",",","then","y","will","be","set","to","a","default","1","and","yanchor","will","be","set","to","an","appropriate","default","to","ensure","that","minimal","margin","space","is","needed",".","Note","that","when","`","yref='paper","'","`",",","only","1","or","0","are","allowed","y","values",".","Invalid","values","will","be","reset","to","the","default","1.","font","Sets","the","title","font",".","Note","that","the","title","'s","font","used","to","be","customized","by","the","now","deprecated","`","titlefont","`","attribute",".","pad","Sets","the","padding","of","the","title",".","Each","padding","value","only","applies","when","the","corresponding","`","xanchor","`","\/","`","yanchor","`","value","is","set","accordingly",".","E.g",".","for","left","padding","to","take","effect",",","`","xanchor","`","must","be","set","to","``","left","''",".","The","same","rule","applies","if","`","xanchor","`","\/","`","yanchor","`","is","determined","automatically",".","Padding","is","muted","if","the","respective","anchor","value","is","``","middle","*","\/","*","center","''",".","text","Sets","the","plot","'s","title",".","Note","that","before","the","existence","of","`","title.text","`",",","the","title","'s","contents","used","to","be","defined","as","the","`","title","`","attribute","itself",".","This","behavior","has","been","deprecated",".","x","Sets","the","x","position","with","respect","to","`","xref","`","in","normalized","coordinates","from","0","(","left",")","to","1","(","right",")",".","xanchor","Sets","the","title","'s","horizontal","alignment","with","respect","to","its","x","position",".","``","left","''","means","that","the","title","starts","at","x",",","``","right","''","means","that","the","title","ends","at","x","and","``","center","''","means","that","the","title","'s","center","is","at","x",".","``","auto","''","divides","`","xref","`","by","three","and","calculates","the","`","xanchor","`","value","automatically","based","on","the","value","of","`","x","`",".","xref","Sets","the","container","`","x","`","refers","to",".","``","container","''","spans","the","entire","`","width","`","of","the","plot",".","``","paper","''","refers","to","the","width","of","the","plotting","area","only",".","y","Sets","the","y","position","with","respect","to","`","yref","`","in","normalized","coordinates","from","0","(","bottom",")","to","1","(","top",")",".","``","auto","''","places","the","baseline","of","the","title","onto","the","vertical","center","of","the","top","margin",".","yanchor","Sets","the","title","'s","vertical","alignment","with","respect","to","its","y","position",".","``","top","''","means","that","the","title","'s","cap","line","is","at","y",",","``","bottom","''","means","that","the","title","'s","baseline","is","at","y","and","``","middle","''","means","that","the","title","'s","midline","is","at","y",".","``","auto","''","divides","`","yref","`","by","three","and","calculates","the","`","yanchor","`","value","automatically","based","on","the","value","of","`","y","`",".","yref","Sets","the","container","`","y","`","refers","to",".","``","container","''","spans","the","entire","`","height","`","of","the","plot",".","``","paper","''","refers","to","the","height","of","the","plotting","area","only",".","Returns","--","--","--","-","Title"]
code: def __init__(
      self,
      arg=None,
      automargin=None,
      font=None,
      pad=None,
      text=None,
      x=None,
      xanchor=None,
      xref=None,
      y=None,
      yanchor=None,
      yref=None,
      **kwargs,
  ):
      """
      Construct a new Title object
  
      Parameters
      ----------
      arg
          dict of properties compatible with this constructor or
          an instance of :class:`plotly.graph_objs.layout.Title`
      automargin
          Determines whether the title can automatically push the
          figure margins. If `yref='paper'` then the margin will
          expand to ensure that the title doesn’t overlap with
          the edges of the container. If `yref='container'` then
          the margins will ensure that the title doesn’t overlap
          with the plot area, tick labels, and axis titles. If
          `automargin=true` and the margins need to be expanded,
          then y will be set to a default 1 and yanchor will be
          set to an appropriate default to ensure that minimal
          margin space is needed. Note that when `yref='paper'`,
          only 1 or 0 are allowed y values. Invalid values will
          be reset to the default 1.
      font
          Sets the title font. Note that the title's font used to
          be customized by the now deprecated `titlefont`
          attribute.
      pad
          Sets the padding of the title. Each padding value only
          applies when the corresponding `xanchor`/`yanchor`
          value is set accordingly. E.g. for left padding to take
          effect, `xanchor` must be set to "left". The same rule
          applies if `xanchor`/`yanchor` is determined
          automatically. Padding is muted if the respective
          anchor value is "middle*/*center".
      text
          Sets the plot's title. Note that before the existence
          of `title.text`, the title's contents used to be
          defined as the `title` attribute itself. This behavior
          has been deprecated.
      x
          Sets the x position with respect to `xref` in
          normalized coordinates from 0 (left) to 1 (right).
      xanchor
          Sets the title's horizontal alignment with respect to
          its x position. "left" means that the title starts at
          x, "right" means that the title ends at x and "center"
          means that the title's center is at x. "auto" divides
          `xref` by three and calculates the `xanchor` value
          automatically based on the value of `x`.
      xref
          Sets the container `x` refers to. "container" spans the
          entire `width` of the plot. "paper" refers to the width
          of the plotting area only.
      y
          Sets the y position with respect to `yref` in
          normalized coordinates from 0 (bottom) to 1 (top).
          "auto" places the baseline of the title onto the
          vertical center of the top margin.
      yanchor
          Sets the title's vertical alignment with respect to its
          y position. "top" means that the title's cap line is at
          y, "bottom" means that the title's baseline is at y and
          "middle" means that the title's midline is at y. "auto"
          divides `yref` by three and calculates the `yanchor`
          value automatically based on the value of `y`.
      yref
          Sets the container `y` refers to. "container" spans the
          entire `height` of the plot. "paper" refers to the
          height of the plotting area only.
  
      Returns
      -------
      Title
      """
      super(Title, self).__init__("title")
  
      if "_parent" in kwargs:
          self._parent = kwargs["_parent"]
          return
  
      # Validate arg
      # ------------
      if arg is None:
          arg = {}
      elif isinstance(arg, self.__class__):
          arg = arg.to_plotly_json()
      elif isinstance(arg, dict):
          arg = _copy.copy(arg)
      else:
          raise ValueError(
              """\
  The first argument to the plotly.graph_objs.layout.Title
  constructor must be a dict or
  an instance of :class:`plotly.graph_objs.layout.Title`"""
          )
  
      # Handle skip_invalid
      # -------------------
      self._skip_invalid = kwargs.pop("skip_invalid", False)
      self._validate = kwargs.pop("_validate", True)
  
      # Populate data dict with properties
      # ----------------------------------
      _v = arg.pop("automargin", None)
      _v = automargin if automargin is not None else _v
      if _v is not None:
          self["automargin"] = _v
      _v = arg.pop("font", None)
      _v = font if font is not None else _v
      if _v is not None:
          self["font"] = _v
      _v = arg.pop("pad", None)
      _v = pad if pad is not None else _v
      if _v is not None:
          self["pad"] = _v
      _v = arg.pop("text", None)
      _v = text if text is not None else _v
      if _v is not None:
          self["text"] = _v
      _v = arg.pop("x", None)
      _v = x if x is not None else _v
      if _v is not None:
          self["x"] = _v
      _v = arg.pop("xanchor", None)
      _v = xanchor if xanchor is not None else _v
      if _v is not None:
          self["xanchor"] = _v
      _v = arg.pop("xref", None)
      _v = xref if xref is not None else _v
      if _v is not None:
          self["xref"] = _v
      _v = arg.pop("y", None)
      _v = y if y is not None else _v
      if _v is not None:
          self["y"] = _v
      _v = arg.pop("yanchor", None)
      _v = yanchor if yanchor is not None else _v
      if _v is not None:
          self["yanchor"] = _v
      _v = arg.pop("yref", None)
      _v = yref if yref is not None else _v
      if _v is not None:
          self["yref"] = _v
  
      # Process unknown kwargs
      # ----------------------
      self._process_kwargs(**dict(arg, **kwargs))
  
      # Reset skip_invalid
      # ------------------
      self._skip_invalid = False
  
imports: from plotly.basedatatypes import BaseLayoutHierarchyType
  import copy
label_desc: Use image node_id 22 to create a new Title object from inherited base classes: _BaseLayoutHierarchyType with example: obj = Title(arg, automargin, font, pad, text, x, xanchor, xref, y, yanchor, yref)