class_docstr: Widget to facilitate plotting
  
  Parameters
  ----------
  *args : arguments
      Arguments passed to the `ViewBox` super class.
  **kwargs : keywoard arguments
      Keyword arguments passed to the `ViewBox` super class.
  
  Notes
  -----
  This class is typically instantiated implicitly by a `Figure`
  instance, e.g., by doing ``fig[0, 0]``.
class_docstr_tok: ["Widget","to","facilitate","plotting","Parameters","--","--","--","--","--","*","args",":","arguments","Arguments","passed","to","the","`","ViewBox","`","super","class",".","*","*","kwargs",":","keywoard","arguments","Keyword","arguments","passed","to","the","`","ViewBox","`","super","class",".","Notes","--","--","-","This","class","is","typically","instantiated","implicitly","by","a","`","Figure","`","instance",",","e.g.",",","by","doing","``","fig","[","0",",","0","]","``","."]
docstr: Show a 3D volume
  
  Parameters
  ----------
  vol : ndarray
      Volume to render.
  clim : tuple of two floats | None
      The contrast limits. The values in the volume are mapped to
      black and white corresponding to these values. Default maps
      between min and max.
  method : {'mip', 'iso', 'translucent', 'additive'}
      The render style to use. See corresponding docs for details.
      Default 'mip'.
  threshold : float
      The threshold to use for the isosurafce render style. By default
      the mean of the given volume is used.
  cmap : str
      The colormap to use.
  kwargs : keyword arguments.
      More args to pass to :class:`~vispy.visuals.volume.Volume`.
  
  Returns
  -------
  volume : instance of Volume
      The volume visualization.
  
  See also
  --------
  Volume
docstr_tok: ["Show","a","3D","volume","Parameters","--","--","--","--","--","vol",":","ndarray","Volume","to","render",".","clim",":","tuple","of","two","floats","|","None","The","contrast","limits",".","The","values","in","the","volume","are","mapped","to","black","and","white","corresponding","to","these","values",".","Default","maps","between","min","and","max",".","method",":","{","'mip","'",",","'iso","'",",","'translucent","'",",","'additive","'","}","The","render","style","to","use",".","See","corresponding","docs","for","details",".","Default","'mip","'",".","threshold",":","float","The","threshold","to","use","for","the","isosurafce","render","style",".","By","default","the","mean","of","the","given","volume","is","used",".","cmap",":","str","The","colormap","to","use",".","kwargs",":","keyword","arguments",".","More","args","to","pass","to",":","class",":","`","~vispy.visuals.volume.Volume","`",".","Returns","--","--","--","-","volume",":","instance","of","Volume","The","volume","visualization",".","See","also","--","--","--","--","Volume"]
code: def volume(
      self,
      vol,
      clim=None,
      method="mip",
      threshold=None,
      cmap="grays",
      **kwargs,
  ):
      """Show a 3D volume
  
      Parameters
      ----------
      vol : ndarray
          Volume to render.
      clim : tuple of two floats | None
          The contrast limits. The values in the volume are mapped to
          black and white corresponding to these values. Default maps
          between min and max.
      method : {'mip', 'iso', 'translucent', 'additive'}
          The render style to use. See corresponding docs for details.
          Default 'mip'.
      threshold : float
          The threshold to use for the isosurafce render style. By default
          the mean of the given volume is used.
      cmap : str
          The colormap to use.
      kwargs : keyword arguments.
          More args to pass to :class:`~vispy.visuals.volume.Volume`.
  
      Returns
      -------
      volume : instance of Volume
          The volume visualization.
  
      See also
      --------
      Volume
      """
      self._configure_3d()
      volume = scene.Volume(
          vol, clim, method, threshold, cmap=cmap, **kwargs
      )
      self.view.add(volume)
      self.view.camera.set_range()
      return volume
  
file_path: vispy/vispy/plot/plotwidget.py
imports: from ..None import scene
  from ..io import read_mesh
  from ..geometry import MeshData
label_desc: Use image node_id 9 for calling the PlotWidget obj's underlying member method code with example usage: obj.volume(vol, clim, method, threshold, cmap) and returns: volume