【Hackathon 6th No.4】Add ormqr docs API to Paddle

docs/api/paddle/Tensor_cn.rst

@@ -3206,3 +3206,15 @@ signbit(x, name=None)
 返回类型：Tensor
 
 请参考 :ref:`cn_api_paddle_signbit`
+
+ormqr(x, tau, other, left=True, transpose=False)
+:::::::::
+
+计算维度为(m, n)的矩阵 C（由 :attr:`other` 给出）和一个矩阵 Q 的乘积，
+其中 Q 由 Householder 反射系数 (:attr:`x`, :attr:`tau`) 表示。
+
+返回：乘积 Tensor。
+
+返回类型：Tensor
+
+请参考 :ref:`cn_api_paddle_linalg_ormqr`

docs/api/paddle/linalg/Overview_cn.rst

@@ -64,6 +64,7 @@ paddle.linalg 目录下包含飞桨框架支持的线性代数相关 API。具
     " :ref:`paddle.linalg.lu <cn_api_paddle_linalg_lu>` ", "计算矩阵的 LU 分解"
     " :ref:`paddle.linalg.lu_unpack <cn_api_paddle_linalg_lu_unpack>` ", "对矩阵的 LU 分解结果进行展开得到各单独矩阵"
     " :ref:`paddle.linalg.householder_product <cn_api_paddle_linalg_householder_product>` ", "计算 Householder 矩阵乘积的前 n 列(输入矩阵为 `[*,m,n]` )"
+    " :ref:`paddle.linalg.ormqr <cn_api_paddle_linalg_ormqr>` ", "计算一个普通矩阵与 Householder 矩阵的乘积"
 
 .. _about_solvers:
 

docs/api/paddle/linalg/ormqr_cn.rst

@@ -0,0 +1,27 @@
+.. _cn_api_paddle_linalg_ormqr:
+
+ormqr
+-------------------------------
+
+.. py:function:: paddle.linalg.ormqr(x, tau, other, left=True, transpose=False)
+
+计算维度为(m, n)的矩阵 C（由 :attr:`other` 给出）和一个矩阵 Q 的乘积，
+其中 Q 由 Householder 反射系数 (:attr:`x`, :attr:`tau`) 表示。
+
+参数
+::::::::::::
+
+    - **x** (Tensor) - 输入一个或一批矩阵，类型为 Tensor。 ``x`` 的形状应为 ``[*, MN, K]``，其中 ``*`` 为零或更大的批次维度，数据类型支持 float32， float64。
+    - **tau** (Tensor) - 输入一个或一批 Householder 反射系数，类型为 Tensor。 ``tau`` 的形状应为 ``[*, min(MN, K)]``，其中 ``*`` 为零或更大的批次维度，数据类型支持 float32， float64。
+    - **other** (Tensor) - 输入一个或一批矩阵，类型为 Tensor。 ``other`` 的形状应为 ``[*, M, N]``，其中 ``*`` 为零或更大的批次维度，数据类型支持 float32， float64。
+    - **left** (bool， 可选) - 决定了矩阵乘积运算的顺序。如果 left 为 ``True`` ，计算顺序为 op(Q) * other ，否则，计算顺序为 other * op(Q)。默认值： ``True`` 。
+    - **transpose** (bool， 可选) - 如果为 ``True`` ，对矩阵 Q 进行共轭转置变换，否则，不对矩阵 Q 进行共轭转置变换。默认值： ``False`` 。
+返回
+::::::::::::
+
+    ``Tensor``，维度和数据类型都与 :attr:`other` 一致。
+
+代码示例
+::::::::::
+
+COPY-FROM: paddle.linalg.ormqr