mindspore.nn.probability.bijector.Invert
============================================

.. py:class:: mindspore.nn.probability.bijector.Invert(bijector, name='')

    逆映射Bijector（Invert Bijector）。
    计算输入Bijector的逆映射。如果正向映射（下面的 `bijector` 输入）对应的映射函数为 :math:`Y = g(X)` ，那么对应的逆映射Bijector的映射函数为 :math:`Y = h(X) = g^{-1}(X)` 。

    **参数：**

    - **bijector** (Bijector) - 基础Bijector（Base Bijector）。
    - **name** (str) - Bijector名称。默认值：""。当name设置为""时，它实际上是'Invert' + Bijector.name。

    .. py:method:: bijector
        :property:

        Bijector类，返回基础Bijector。

    .. py:method:: forward(x)

        计算基础Bijector的逆映射，即 :math:`Y = h(X) = g^{-1}(X)` 。

        **参数：**

        - **x** (Tensor) - 基础Bijector的输出随机变量的值。

        **返回：**

        Tensor，基础Bijector的输入随机变量的值。

    .. py:method:: forward_log_jacobian(x)

        计算基础Bijector的逆映射导数的对数值，即 :math:`\log dg^{-1}(x) / dx` 。

        **参数：**

        - **x** (Tensor) - 基础Bijector的输出随机变量的值。

        **返回：**

        Tensor，基类逆映射导数的对数值。

    .. py:method:: inverse(y)

        计算基础Bijector的正映射，即 :math:`Y = g(X)` 。

        **参数：**

        - **y** (Tensor) - 基础Bijector的输入随机变量的值。

        **返回：**

        Tensor，基础Bijector的输出随机变量的值。

    .. py:method:: inverse_log_jacobian(y)

        计算基础Bijector的正映射导数的对数，即 :math:`Y = \log dg(x) / dx` 。

        **参数：**

        - **y** (Tensor) - 基础Bijector的输入随机变量的值。

        **返回：**

        Tensor，基类正映射导数的对数值。