docstr: ivy.Array instance method variant of ivy.multinomial. This method
  simply wraps the function, and so the docstring for ivy.multinomial
  also applies to this method with minimal changes.
  
  Parameters
  ----------
  self
      The unnormalized probabilities for all elements in population,
      default is uniform *[batch_shape, population_size]*
  population_size
      The size of the population from which to draw samples.
  num_samples
      Number of independent samples to draw from the population.
  batch_size
      Number of tensors to generate. Default is 1.
  replace
      Whether to replace samples once they've been drawn. Default is ``True``.
  device
      device on which to create the array 'cuda:0', 'cuda:1', 'cpu' etc.
      (Default value = None)
  seed
      A python integer. Used to create a random seed distribution
  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 normal distribution.
docstr_tok: ["ivy.Array","instance","method","variant","of","ivy.multinomial",".","This","method","simply","wraps","the","function",",","and","so","the","docstring","for","ivy.multinomial","also","applies","to","this","method","with","minimal","changes",".","Parameters","--","--","--","--","--","self","The","unnormalized","probabilities","for","all","elements","in","population",",","default","is","uniform","*","[","batch_shape",",","population_size","]","*","population_size","The","size","of","the","population","from","which","to","draw","samples",".","num_samples","Number","of","independent","samples","to","draw","from","the","population",".","batch_size","Number","of","tensors","to","generate",".","Default","is","1.","replace","Whether","to","replace","samples","once","they","'ve","been","drawn",".","Default","is","``","True","``",".","device","device","on","which","to","create","the","array","'cuda:0","'",",","'cuda:1","'",",","'cpu","'","etc",".","(","Default","value","=","None",")","seed","A","python","integer",".","Used","to","create","a","random","seed","distribution","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","normal","distribution","."]
code: def multinomial(
      self: ivy.Array,
      population_size: int,
      num_samples: int,
      /,
      *,
      batch_size: int = 1,
      replace: bool = True,
      device: Optional[Union[ivy.Device, ivy.NativeDevice]] = None,
      seed: Optional[int] = None,
      out: Optional[ivy.Array] = None,
  ) -> ivy.Array:
      """ivy.Array instance method variant of ivy.multinomial. This method
      simply wraps the function, and so the docstring for ivy.multinomial
      also applies to this method with minimal changes.
  
      Parameters
      ----------
      self
          The unnormalized probabilities for all elements in population,
          default is uniform *[batch_shape, population_size]*
      population_size
          The size of the population from which to draw samples.
      num_samples
          Number of independent samples to draw from the population.
      batch_size
          Number of tensors to generate. Default is 1.
      replace
          Whether to replace samples once they've been drawn. Default is ``True``.
      device
          device on which to create the array 'cuda:0', 'cuda:1', 'cpu' etc.
          (Default value = None)
      seed
          A python integer. Used to create a random seed distribution
      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 normal distribution.
      """
      return ivy.multinomial(
          population_size,
          num_samples,
          batch_size=batch_size,
          probs=self._data,
          replace=replace,
          device=device,
          seed=seed,
          out=out,
      )
  
file_path: ivy/ivy/data_classes/array/random.py
imports: import abc
  from typing import Optional, Union
  import ivy
label_desc: Use image node_id 3 for calling the _ArrayWithRandom obj's underlying member method code with example usage: obj.multinomial() and returns: ivy