# tf.keras.initializers.Orthogonal

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/keras-team/keras/tree/v2.7.0/keras/initializers/initializers_v2.py#L545-L629) |

Initializer that generates an orthogonal matrix.

Inherits From: [`Initializer`](https://www.tensorflow.org/versions/r2.7/api_docs/python/tf/keras/initializers/Initializer)

#### View aliases


**Main aliases**

[`tf.initializers.Orthogonal`](https://www.tensorflow.org/api_docs/python/tf/keras/initializers/Orthogonal), [`tf.initializers.orthogonal`](https://www.tensorflow.org/api_docs/python/tf/keras/initializers/Orthogonal), [`tf.keras.initializers.orthogonal`](https://www.tensorflow.org/api_docs/python/tf/keras/initializers/Orthogonal)

<br />

    tf.keras.initializers.Orthogonal(
        gain=1.0, seed=None
    )

Also available via the shortcut function [`tf.keras.initializers.orthogonal`](https://www.tensorflow.org/versions/r2.7/api_docs/python/tf/keras/initializers/Orthogonal).

If the shape of the tensor to initialize is two-dimensional, it is initialized
with an orthogonal matrix obtained from the QR decomposition of a matrix of
random numbers drawn from a normal distribution.
If the matrix has fewer rows than columns then the output will have orthogonal
rows. Otherwise, the output will have orthogonal columns.

If the shape of the tensor to initialize is more than two-dimensional,
a matrix of shape `(shape[0] * ... * shape[n - 2], shape[n - 1])`
is initialized, where `n` is the length of the shape vector.
The matrix is subsequently reshaped to give a tensor of the desired shape.

#### Examples:

    # Standalone usage:
    initializer = tf.keras.initializers.Orthogonal()
    values = initializer(shape=(2, 2))

    # Usage in a Keras layer:
    initializer = tf.keras.initializers.Orthogonal()
    layer = tf.keras.layers.Dense(3, kernel_initializer=initializer)

<br />

<br />

<br />

| ## Args ||
|---|---|
| `gain` | multiplicative factor to apply to the orthogonal matrix |
| `seed` | A Python integer. Used to create random seeds. See [`tf.compat.v1.set_random_seed`](https://www.tensorflow.org/versions/r2.7/api_docs/python/tf/compat/v1/set_random_seed) for behavior. Note that seeded initializer will not produce same random values across multiple calls, but multiple initializers will produce same sequence when constructed with same seed value. |

<br />

<br />

<br />

| ## References ||
|---|---|
| <br /> - [Saxe et al., 2014](https://openreview.net/forum?id=_wzZwKpTDF_9C) ||

<br />

## Methods

### `from_config`

[View source](https://github.com/keras-team/keras/tree/v2.7.0/keras/initializers/initializers_v2.py#L88-L107)

    @classmethod
    from_config(
        config
    )

Instantiates an initializer from a configuration dictionary.

#### Example:

    initializer = RandomUniform(-1, 1)
    config = initializer.get_config()
    initializer = RandomUniform.from_config(config)

<br />

<br />

<br />

| Args ||
|---|---|
| `config` | A Python dictionary, the output of `get_config`. |

<br />

<br />

<br />

<br />

| Returns ||
|---|---|
| A [`tf.keras.initializers.Initializer`](https://www.tensorflow.org/versions/r2.7/api_docs/python/tf/keras/initializers/Initializer) instance. ||

<br />

### `get_config`

[View source](https://github.com/keras-team/keras/tree/v2.7.0/keras/initializers/initializers_v2.py#L628-L629)

    get_config()

Returns the configuration of the initializer as a JSON-serializable dict.

<br />

<br />

<br />

| Returns ||
|---|---|
| A JSON-serializable Python dict. ||

<br />

### `__call__`

[View source](https://github.com/keras-team/keras/tree/v2.7.0/keras/initializers/initializers_v2.py#L591-L626)

    __call__(
        shape, dtype=None, **kwargs
    )

Returns a tensor object initialized to an orthogonal matrix.

<br />

<br />

<br />

| Args ||
|---|---|
| `shape` | Shape of the tensor. |
| `dtype` | Optional dtype of the tensor. Only floating point types are supported. If not specified, [`tf.keras.backend.floatx()`](https://www.tensorflow.org/versions/r2.7/api_docs/python/tf/keras/backend/floatx) is used, which default to `float32` unless you configured it otherwise (via [`tf.keras.backend.set_floatx(float_dtype)`](https://www.tensorflow.org/versions/r2.7/api_docs/python/tf/keras/backend/set_floatx)) |
| `**kwargs` | Additional keyword arguments. |

<br />