HistogramFixedWidth

public final class HistogramFixedWidth

Return histogram of values.

Given the tensor `values`, this operation returns a rank 1 histogram counting the number of entries in `values` that fall into every bin. The bins are equal width and determined by the arguments `value_range` and `nbins`.

# Bins will be:  (-inf, 1), [1, 2), [2, 3), [3, 4), [4, inf)
 nbins = 5
 value_range = [0.0, 5.0]
 new_values = [-1.0, 0.0, 1.5, 2.0, 5.0, 15]
 
 with tf.get_default_session() as sess:
   hist = tf.histogram_fixed_width(new_values, value_range, nbins=5)
   variables.global_variables_initializer().run()
   sess.run(hist) => [2, 1, 1, 0, 2]
 

Public Methods

Output<U>
asOutput()
Returns the symbolic handle of a tensor.
static <U extends Number, T extends Number> HistogramFixedWidth<U>
create(Scope scope, Operand<T> values, Operand<T> valueRange, Operand<Integer> nbins, Class<U> dtype)
Factory method to create a class wrapping a new HistogramFixedWidth operation.
static <T extends Number> HistogramFixedWidth<Integer>
create(Scope scope, Operand<T> values, Operand<T> valueRange, Operand<Integer> nbins)
Factory method to create a class wrapping a new HistogramFixedWidth operation using default output types.
Output<U>
out()
A 1-D `Tensor` holding histogram of values.

Inherited Methods

Public Methods

public Output<U> asOutput ()

Returns the symbolic handle of a tensor.

Inputs to TensorFlow operations are outputs of another TensorFlow operation. This method is used to obtain a symbolic handle that represents the computation of the input.

public static HistogramFixedWidth<U> create (Scope scope, Operand<T> values, Operand<T> valueRange, Operand<Integer> nbins, Class<U> dtype)

Factory method to create a class wrapping a new HistogramFixedWidth operation.

Parameters
scope current scope
values Numeric `Tensor`.
valueRange Shape [2] `Tensor` of same `dtype` as `values`. values <= value_range[0] will be mapped to hist[0], values >= value_range[1] will be mapped to hist[-1].
nbins Scalar `int32 Tensor`. Number of histogram bins.
Returns
  • a new instance of HistogramFixedWidth

public static HistogramFixedWidth<Integer> create (Scope scope, Operand<T> values, Operand<T> valueRange, Operand<Integer> nbins)

Factory method to create a class wrapping a new HistogramFixedWidth operation using default output types.

Parameters
scope current scope
values Numeric `Tensor`.
valueRange Shape [2] `Tensor` of same `dtype` as `values`. values <= value_range[0] will be mapped to hist[0], values >= value_range[1] will be mapped to hist[-1].
nbins Scalar `int32 Tensor`. Number of histogram bins.
Returns
  • a new instance of HistogramFixedWidth

public Output<U> out ()

A 1-D `Tensor` holding histogram of values.