docstr: ivy.Array instance method variant of ivy.histogram. This method
  simply wraps the function, and so the docstring for ivy.histogram also
  applies to this method with minimal changes.
  
  Parameters
  ----------
  self
      input array.
  bins
      if ``bins`` is an int, it defines the number of equal-width bins in the
      given range.
      if ``bins`` is an array, it defines a monotonically increasing array of bin
      edges, including the rightmost edge, allowing for non-uniform bin widths.
  axis
      dimension along which maximum values must be computed. By default, the
      maximum value must be computed over the entire array. Default: ``None``.
  extend_lower_interval
      if True, extend the lowest interval I0 to (-inf, c1].
  extend_upper_interval
      ff True, extend the upper interval I_{K-1} to [c_{K-1}, +inf).
  dtype
      the output type.
  range
      the lower and upper range of the bins. The first element of the range must
      be less than or equal to the second.
  weights
      each value in ``a`` only contributes its associated weight towards the bin
      count (instead of 1). Must be of the same shape as a.
  density
      if True, the result is the value of the probability density function at the
      bin, normalized such that the integral over the range of bins is 1.
  out
      optional output array, for writing the result to. It must have a shape that
      the inputs broadcast to.
  
  Returns
  -------
  ret
      a tuple containing the values of the histogram and the bin edges.
  
  Both the description and the type hints above assumes an array input for
  simplicity, but this function is *nestable*, and therefore also accepts
  :class:`ivy.Container` instances in place of any of the arguments.
  
  Examples
  --------
  With :class:`ivy.Array` input:
  
  >>> x = ivy.array([0, 1, 2])
  >>> y = ivy.array([0., 0.5, 1., 1.5, 2.])
  >>> z = ivy.histogram(x, bins=y)
  >>> print(z)
  ivy.array([1., 0., 1., 1.])
docstr_tok: ["ivy.Array","instance","method","variant","of","ivy.histogram",".","This","method","simply","wraps","the","function",",","and","so","the","docstring","for","ivy.histogram","also","applies","to","this","method","with","minimal","changes",".","Parameters","--","--","--","--","--","self","input","array",".","bins","if","``","bins","``","is","an","int",",","it","defines","the","number","of","equal-width","bins","in","the","given","range",".","if","``","bins","``","is","an","array",",","it","defines","a","monotonically","increasing","array","of","bin","edges",",","including","the","rightmost","edge",",","allowing","for","non-uniform","bin","widths",".","axis","dimension","along","which","maximum","values","must","be","computed",".","By","default",",","the","maximum","value","must","be","computed","over","the","entire","array",".","Default",":","``","None","``",".","extend_lower_interval","if","True",",","extend","the","lowest","interval","I0","to","(","-inf",",","c1","]",".","extend_upper_interval","ff","True",",","extend","the","upper","interval","I_","{","K-1","}","to","[","c_","{","K-1","}",",","+inf",")",".","dtype","the","output","type",".","range","the","lower","and","upper","range","of","the","bins",".","The","first","element","of","the","range","must","be","less","than","or","equal","to","the","second",".","weights","each","value","in","``","a","``","only","contributes","its","associated","weight","towards","the","bin","count","(","instead","of","1",")",".","Must","be","of","the","same","shape","as","a.","density","if","True",",","the","result","is","the","value","of","the","probability","density","function","at","the","bin",",","normalized","such","that","the","integral","over","the","range","of","bins","is","1.","out","optional","output","array",",","for","writing","the","result","to",".","It","must","have","a","shape","that","the","inputs","broadcast","to",".","Returns","--","--","--","-","ret","a","tuple","containing","the","values","of","the","histogram","and","the","bin","edges",".","Both","the","description","and","the","type","hints","above","assumes","an","array","input","for","simplicity",",","but","this","function","is","*","nestable","*",",","and","therefore","also","accepts",":","class",":","`","ivy.Container","`","instances","in","place","of","any","of","the","arguments",".","Examples","--","--","--","--","With",":","class",":","`","ivy.Array","`","input",":",">",">",">","x","=","ivy.array","(","[","0",",","1",",","2","]",")",">",">",">","y","=","ivy.array","(","[","0.",",","0.5",",","1.",",","1.5",",","2",".","]",")",">",">",">","z","=","ivy.histogram","(","x",",","bins=y",")",">",">",">","print","(","z",")","ivy.array","(","[","1.",",","0.",",","1.",",","1",".","]",")"]
code: def histogram(
      self: ivy.Array,
      /,
      *,
      bins: Optional[
          Union[int, ivy.Array, ivy.NativeArray, str]
      ] = None,
      axis: Optional[Union[ivy.Array, ivy.NativeArray]] = None,
      extend_lower_interval: Optional[bool] = False,
      extend_upper_interval: Optional[bool] = False,
      dtype: Optional[Union[ivy.Dtype, ivy.NativeDtype]] = None,
      range: Optional[Tuple[float]] = None,
      weights: Optional[Union[ivy.Array, ivy.NativeArray]] = None,
      density: Optional[bool] = False,
      out: Optional[ivy.Array] = None,
  ) -> ivy.Array:
      """ivy.Array instance method variant of ivy.histogram. This method
      simply wraps the function, and so the docstring for ivy.histogram also
      applies to this method with minimal changes.
  
      Parameters
      ----------
      self
          input array.
      bins
          if ``bins`` is an int, it defines the number of equal-width bins in the
          given range.
          if ``bins`` is an array, it defines a monotonically increasing array of bin
          edges, including the rightmost edge, allowing for non-uniform bin widths.
      axis
          dimension along which maximum values must be computed. By default, the
          maximum value must be computed over the entire array. Default: ``None``.
      extend_lower_interval
          if True, extend the lowest interval I0 to (-inf, c1].
      extend_upper_interval
          ff True, extend the upper interval I_{K-1} to [c_{K-1}, +inf).
      dtype
          the output type.
      range
          the lower and upper range of the bins. The first element of the range must
          be less than or equal to the second.
      weights
          each value in ``a`` only contributes its associated weight towards the bin
          count (instead of 1). Must be of the same shape as a.
      density
          if True, the result is the value of the probability density function at the
          bin, normalized such that the integral over the range of bins is 1.
      out
          optional output array, for writing the result to. It must have a shape that
          the inputs broadcast to.
  
      Returns
      -------
      ret
          a tuple containing the values of the histogram and the bin edges.
  
      Both the description and the type hints above assumes an array input for
      simplicity, but this function is *nestable*, and therefore also accepts
      :class:`ivy.Container` instances in place of any of the arguments.
  
      Examples
      --------
      With :class:`ivy.Array` input:
  
      >>> x = ivy.array([0, 1, 2])
      >>> y = ivy.array([0., 0.5, 1., 1.5, 2.])
      >>> z = ivy.histogram(x, bins=y)
      >>> print(z)
      ivy.array([1., 0., 1., 1.])
      """
      return ivy.histogram(
          self._data,
          bins=bins,
          axis=axis,
          extend_lower_interval=extend_lower_interval,
          extend_upper_interval=extend_upper_interval,
          dtype=dtype,
          range=range,
          weights=weights,
          density=density,
          out=out,
      )
  
file_path: ivy/ivy/data_classes/array/experimental/statistical.py
imports: import abc
  from typing import Optional, Union, Tuple, Sequence
  import ivy
label_desc: Use image node_id 1 for calling the _ArrayWithStatisticalExperimental obj's underlying member method code with example usage: obj.histogram() and returns: ivy