docstr: Parameters
  ----------
  self
      Input Array of rate parameter(s). It must have a shape that is broadcastable
      to the requested shape
  shape
      If the given shape is, e.g '(m, n, k)', then 'm * n * k' samples are drawn.
      (Default value = 'None', where 'ivy.shape(lam)' samples are drawn)
  device
      device on which to create the array 'cuda:0', 'cuda:1', 'cpu' etc.
      (Default value = None).
  dtype
      output array data type. If ``dtype`` is ``None``, the output array data
      type will be the default floating-point data type. Default ``None``
  seed
      A python integer. Used to create a random seed distribution
  fill_value
      if lam is negative, fill the output array with this value
      on that specific dimension.
  out
      optional output array, for writing the result to. It must have a shape that
      the inputs broadcast to.
  
  Returns
  -------
  ret
      Drawn samples from the parameterized poisson distribution.
  
  Examples
  --------
  >>> lam = ivy.array([1.0, 2.0, 3.0])
  >>> lam.poisson()
  ivy.array([1., 4., 4.])
  
  >>> lam = ivy.array([1.0, 2.0, 3.0])
  >>> lam.poisson(shape=(2,3))
  ivy.array([[0., 2., 2.],
             [1., 2., 3.]])
docstr_tok: ["Parameters","--","--","--","--","--","self","Input","Array","of","rate","parameter","(","s",")",".","It","must","have","a","shape","that","is","broadcastable","to","the","requested","shape","shape","If","the","given","shape","is",",","e.g","'","(","m",",","n",",","k",")","'",",","then","'m","*","n","*","k","'","samples","are","drawn",".","(","Default","value","=","'None","'",",","where","'ivy.shape","(","lam",")","'","samples","are","drawn",")","device","device","on","which","to","create","the","array","'cuda:0","'",",","'cuda:1","'",",","'cpu","'","etc",".","(","Default","value","=","None",")",".","dtype","output","array","data","type",".","If","``","dtype","``","is","``","None","``",",","the","output","array","data","type","will","be","the","default","floating-point","data","type",".","Default","``","None","``","seed","A","python","integer",".","Used","to","create","a","random","seed","distribution","fill_value","if","lam","is","negative",",","fill","the","output","array","with","this","value","on","that","specific","dimension",".","out","optional","output","array",",","for","writing","the","result","to",".","It","must","have","a","shape","that","the","inputs","broadcast","to",".","Returns","--","--","--","-","ret","Drawn","samples","from","the","parameterized","poisson","distribution",".","Examples","--","--","--","--",">",">",">","lam","=","ivy.array","(","[","1.0",",","2.0",",","3.0","]",")",">",">",">","lam.poisson","(",")","ivy.array","(","[","1.",",","4.",",","4",".","]",")",">",">",">","lam","=","ivy.array","(","[","1.0",",","2.0",",","3.0","]",")",">",">",">","lam.poisson","(","shape=","(","2,3",")",")","ivy.array","(","[","[","0.",",","2.",",","2",".","]",",","[","1.",",","2.",",","3",".","]","]",")"]
code: def poisson(
      self: ivy.Array,
      *,
      shape: Optional[Union[ivy.Shape, ivy.NativeShape]] = None,
      device: Optional[Union[ivy.Device, ivy.NativeDevice]] = None,
      dtype: Optional[Union[ivy.Dtype, ivy.NativeDtype]] = None,
      seed: Optional[int] = None,
      fill_value: Optional[Union[float, int]] = 0,
      out: Optional[ivy.Array] = None,
  ):
      """
      Parameters
      ----------
      self
          Input Array of rate parameter(s). It must have a shape that is broadcastable
          to the requested shape
      shape
          If the given shape is, e.g '(m, n, k)', then 'm * n * k' samples are drawn.
          (Default value = 'None', where 'ivy.shape(lam)' samples are drawn)
      device
          device on which to create the array 'cuda:0', 'cuda:1', 'cpu' etc.
          (Default value = None).
      dtype
          output array data type. If ``dtype`` is ``None``, the output array data
          type will be the default floating-point data type. Default ``None``
      seed
          A python integer. Used to create a random seed distribution
      fill_value
          if lam is negative, fill the output array with this value
          on that specific dimension.
      out
          optional output array, for writing the result to. It must have a shape that
          the inputs broadcast to.
  
      Returns
      -------
      ret
          Drawn samples from the parameterized poisson distribution.
  
      Examples
      --------
      >>> lam = ivy.array([1.0, 2.0, 3.0])
      >>> lam.poisson()
      ivy.array([1., 4., 4.])
  
      >>> lam = ivy.array([1.0, 2.0, 3.0])
      >>> lam.poisson(shape=(2,3))
      ivy.array([[0., 2., 2.],
                 [1., 2., 3.]])
      """
      return ivy.poisson(
          self,
          shape=shape,
          device=device,
          dtype=dtype,
          seed=seed,
          fill_value=fill_value,
          out=out,
      )
  
file_path: ivy/ivy/data_classes/array/experimental/random.py
imports: import abc
  from typing import Optional, Union
  import ivy
label_desc: Use image node_id 4 for calling the _ArrayWithRandomExperimental obj's underlying member method code with example usage: obj.poisson() and returns: ivy