# KmeansPlusPlusInitialization

public final class **KmeansPlusPlusInitialization** Selects num_to_sample rows of input using the KMeans++ criterion.


Rows of points are assumed to be input points. One row is selected at random.
Subsequent rows are sampled with probability proportional to the squared L2
distance from the nearest row selected thus far till num_to_sample rows have
been sampled.

<br />

### Public Methods

|---|---|
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<Float\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/KmeansPlusPlusInitialization#asOutput())() Returns the symbolic handle of a tensor. |
| static [KmeansPlusPlusInitialization](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/KmeansPlusPlusInitialization) | [create](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/KmeansPlusPlusInitialization#create(org.tensorflow.op.Scope,%20org.tensorflow.Operand<java.lang.Float>,%20org.tensorflow.Operand<java.lang.Long>,%20org.tensorflow.Operand<java.lang.Long>,%20org.tensorflow.Operand<java.lang.Long>))([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Float\> points, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Long\> numToSample, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Long\> seed, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Long\> numRetriesPerSample) Factory method to create a class wrapping a new KmeansPlusPlusInitialization operation. |
| [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<Float\> | [samples](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/KmeansPlusPlusInitialization#samples())() Matrix of shape (num_to_sample, d). |

### Inherited Methods

From class [org.tensorflow.op.PrimitiveOp](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp)

|---|---|
| final boolean | [equals](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#equals(java.lang.Object))(Object obj) |
| final int | [hashCode](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#hashCode())() |
| [Operation](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation) | [op](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#op())() Returns the underlying `https://www.tensorflow.org/api_docs/java/org/tensorflow/Operation` |
| final String | [toString](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/PrimitiveOp#toString())() |

From class java.lang.Object

|---|---|
| boolean | equals(Object arg0) |
| final Class\<?\> | getClass() |
| int | hashCode() |
| final void | notify() |
| final void | notifyAll() |
| String | toString() |
| final void | wait(long arg0, int arg1) |
| final void | wait(long arg0) |
| final void | wait() |

From interface [org.tensorflow.Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)

|---|---|
| abstract [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<Float\> | [asOutput](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand#asOutput())() Returns the symbolic handle of a tensor. |

## Public Methods

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<Float\>
**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.

<br />

#### public static [KmeansPlusPlusInitialization](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/core/KmeansPlusPlusInitialization)
**create**
([Scope](https://www.tensorflow.org/api_docs/java/org/tensorflow/op/Scope) scope, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Float\> points, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Long\> numToSample, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Long\> seed, [Operand](https://www.tensorflow.org/api_docs/java/org/tensorflow/Operand)\<Long\> numRetriesPerSample)

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

##### Parameters

| scope | current scope |
| points | Matrix of shape (n, d). Rows are assumed to be input points. |
| numToSample | Scalar. The number of rows to sample. This value must not be larger than n. |
| seed | Scalar. Seed for initializing the random number generator. |
| numRetriesPerSample | Scalar. For each row that is sampled, this parameter specifies the number of additional points to draw from the current distribution before selecting the best. If a negative value is specified, a heuristic is used to sample O(log(num_to_sample)) additional points. |
|---|---|

##### Returns

- a new instance of KmeansPlusPlusInitialization

#### public [Output](https://www.tensorflow.org/api_docs/java/org/tensorflow/Output)\<Float\>
**samples**
()

Matrix of shape (num_to_sample, d). The sampled rows.