.. _cn_api_paddle_view_as_real:

view_as_real
-------------------------------

.. py:function:: paddle.view_as_real(input)


获取复数张量 ``input`` 的一个视图，将其视为一个实数张量。

输入 Tensor 的数据类型是 'complex64' 或者 'complex128'，输出 Tensor 的数据类型相应为 'float32' 或者 'float64'。

输入 Tensor 的形状是 ``(*,)`` (其中 ``*`` 表示任意形状)，输出 Tensor 的形状是 ``(*, 2)``，亦即，输出的形状是在输入形状后附加一个 ``2``，因为一个复数的实部和虚部分别表示为一个实数。

返回的实数张量是输入复数张量的一个视图，这意味着二者共享同一块内存区域。

下图展示了一个 view_as_real 简单的使用情形。一个形状为[2, 3]的复数 Tensor 经过 view_as_real 转换，拆分出一个长度为 2 的维度，形状变为[2, 3, 2]。

.. figure:: ../../images/api_legend/as_real.png
   :alt: view_as_real 图示
   :width: 500
   :align: center

参数
:::::::::
    - **input** (Tensor) - 输入 Tensor，数据类型为：'complex64' 或 'complex128'。

返回
:::::::::
输出 Tensor，数据类型是 'float32' 或 'float64'，与 ``input`` 共享同一块内存区域。

代码示例
:::::::::

COPY-FROM: paddle.view_as_real
