From 8588ebf3e2fbe1160b09e1c5059212ce523b9d74 Mon Sep 17 00:00:00 2001
From: littletomatodonkey <2120160898@bit.edu.cn>
Date: Sat, 9 May 2020 10:33:02 +0800
Subject: [PATCH] test=develop, add addmm doc (#2047)

* test=develop, add addmm doc

* add addmm doc

* test=develop, add addmm doc
---
 doc/fluid/api_cn/tensor_cn/addmm_cn.rst | 51 ++++++++++++++++++++++++-
 1 file changed, 50 insertions(+), 1 deletion(-)

diff --git a/doc/fluid/api_cn/tensor_cn/addmm_cn.rst b/doc/fluid/api_cn/tensor_cn/addmm_cn.rst
index d26e3a428..7c4b599da 100644
--- a/doc/fluid/api_cn/tensor_cn/addmm_cn.rst
+++ b/doc/fluid/api_cn/tensor_cn/addmm_cn.rst
@@ -1,3 +1,52 @@
+.. _cn_api_tensor_addmm:
+
+
 addmm
 -------------------------------
-**版本升级，文档正在开发中**
+
+.. py:function:: paddle.addmm(input, x, y, alpha=1.0, beta=1.0, name=None)
+
+计算x和y的乘积，将结果乘以标量alpha，再加上input与beta的乘积，得到输出。其中input与x、y乘积的维度必须是可广播的。
+
+计算过程的公式为：
+
+..  math::
+    out = alpha * x * y + beta * input
+
+参数:
+    - **input** (Variable) : 输入Tensor input，数据类型支持float32, float64。
+    - **x** (Variable) : 输入Tensor x，数据类型支持float32, float64。
+    - **y** (Variable) : 输入Tensor y，数据类型支持float32, float64。
+    - **alpha** (float，可选) : 乘以x*y的标量，数据类型支持float32, float64，默认值为1.0。
+    - **beta** (float，可选) : 乘以input的标量，数据类型支持float32, float64，默认值为1.0。
+    - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
+
+返回：计算得到的Tensor。Tensor数据类型与输入input数据类型一致。
+
+返回类型：变量（Variable）
+
+
+**代码示例**:
+
+.. code-block:: python
+
+    import numpy as np
+    import paddle
+    import paddle.fluid as fluid
+
+    input = fluid.data(name='input', shape=[2, 2], dtype='float32')
+    x = fluid.data(name='x', shape=[2, 2], dtype='float32')
+    y = fluid.data(name='y', shape=[2, 2], dtype='float32')
+    out = paddle.addmm( input=input, x=x, y=y, alpha=5.0, beta=0.5 )
+
+    data_x = np.ones((2, 2)).astype(np.float32)
+    data_y = np.ones((2, 2)).astype(np.float32)
+    data_input = np.ones((2, 2)).astype(np.float32)
+
+    place =  fluid.CUDAPlace(0) if fluid.core.is_compiled_with_cuda() else fluid.CPUPlace()
+    exe = fluid.Executor(place)
+    results = exe.run(fluid.default_main_program(), 
+                      fetch_list=[out], feed={"input": data_input, 'x': data_x, "y": data_y})
+    print(np.array(results[0]))
+    # [[10.5 10.5]
+    # [10.5 10.5]]
-- 
GitLab