docstr: Construct a new Surface object
  
  Parameters
  ----------
  arg
      dict of properties compatible with this constructor or
      an instance of
      :class:`plotly.graph_objs.volume.Surface`
  count
      Sets the number of iso-surfaces between minimum and
      maximum iso-values. By default this value is 2 meaning
      that only minimum and maximum surfaces would be drawn.
  fill
      Sets the fill ratio of the iso-surface. The default
      fill value of the surface is 1 meaning that they are
      entirely shaded. On the other hand Applying a `fill`
      ratio less than one would allow the creation of
      openings parallel to the edges.
  pattern
      Sets the surface pattern of the iso-surface 3-D
      sections. The default pattern of the surface is `all`
      meaning that the rest of surface elements would be
      shaded. The check options (either 1 or 2) could be used
      to draw half of the squares on the surface. Using
      various combinations of capital `A`, `B`, `C`, `D` and
      `E` may also be used to reduce the number of triangles
      on the iso-surfaces and creating other patterns of
      interest.
  show
      Hides/displays surfaces between minimum and maximum
      iso-values.
  
  Returns
  -------
  Surface
docstr_tok: ["Construct","a","new","Surface","object","Parameters","--","--","--","--","--","arg","dict","of","properties","compatible","with","this","constructor","or","an","instance","of",":","class",":","`","plotly.graph_objs.volume.Surface","`","count","Sets","the","number","of","iso-surfaces","between","minimum","and","maximum","iso-values",".","By","default","this","value","is","2","meaning","that","only","minimum","and","maximum","surfaces","would","be","drawn",".","fill","Sets","the","fill","ratio","of","the","iso-surface",".","The","default","fill","value","of","the","surface","is","1","meaning","that","they","are","entirely","shaded",".","On","the","other","hand","Applying","a","`","fill","`","ratio","less","than","one","would","allow","the","creation","of","openings","parallel","to","the","edges",".","pattern","Sets","the","surface","pattern","of","the","iso-surface","3-D","sections",".","The","default","pattern","of","the","surface","is","`","all","`","meaning","that","the","rest","of","surface","elements","would","be","shaded",".","The","check","options","(","either","1","or","2",")","could","be","used","to","draw","half","of","the","squares","on","the","surface",".","Using","various","combinations","of","capital","`","A","`",",","`","B","`",",","`","C","`",",","`","D","`","and","`","E","`","may","also","be","used","to","reduce","the","number","of","triangles","on","the","iso-surfaces","and","creating","other","patterns","of","interest",".","show","Hides\/displays","surfaces","between","minimum","and","maximum","iso-values",".","Returns","--","--","--","-","Surface"]
code: def __init__(
      self,
      arg=None,
      count=None,
      fill=None,
      pattern=None,
      show=None,
      **kwargs,
  ):
      """
      Construct a new Surface object
  
      Parameters
      ----------
      arg
          dict of properties compatible with this constructor or
          an instance of
          :class:`plotly.graph_objs.volume.Surface`
      count
          Sets the number of iso-surfaces between minimum and
          maximum iso-values. By default this value is 2 meaning
          that only minimum and maximum surfaces would be drawn.
      fill
          Sets the fill ratio of the iso-surface. The default
          fill value of the surface is 1 meaning that they are
          entirely shaded. On the other hand Applying a `fill`
          ratio less than one would allow the creation of
          openings parallel to the edges.
      pattern
          Sets the surface pattern of the iso-surface 3-D
          sections. The default pattern of the surface is `all`
          meaning that the rest of surface elements would be
          shaded. The check options (either 1 or 2) could be used
          to draw half of the squares on the surface. Using
          various combinations of capital `A`, `B`, `C`, `D` and
          `E` may also be used to reduce the number of triangles
          on the iso-surfaces and creating other patterns of
          interest.
      show
          Hides/displays surfaces between minimum and maximum
          iso-values.
  
      Returns
      -------
      Surface
      """
      super(Surface, self).__init__("surface")
  
      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.volume.Surface
  constructor must be a dict or
  an instance of :class:`plotly.graph_objs.volume.Surface`"""
          )
  
      # 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("count", None)
      _v = count if count is not None else _v
      if _v is not None:
          self["count"] = _v
      _v = arg.pop("fill", None)
      _v = fill if fill is not None else _v
      if _v is not None:
          self["fill"] = _v
      _v = arg.pop("pattern", None)
      _v = pattern if pattern is not None else _v
      if _v is not None:
          self["pattern"] = _v
      _v = arg.pop("show", None)
      _v = show if show is not None else _v
      if _v is not None:
          self["show"] = _v
  
      # Process unknown kwargs
      # ----------------------
      self._process_kwargs(**dict(arg, **kwargs))
  
      # Reset skip_invalid
      # ------------------
      self._skip_invalid = False
  
file_path: catboost/contrib/python/plotly/py3/plotly/graph_objs/volume/_surface.py
imports: from plotly.basedatatypes import BaseTraceHierarchyType
  import copy
label_desc: Use image node_id 10 to create a new Surface object from inherited base classes: _BaseTraceHierarchyType with example: obj = Surface(arg, count, fill, pattern, show)