【Hackathon 6th No.24】paddle.quantile/nanquantile 功能增强 -part

docs/api/paddle/nanquantile_cn.rst

@@ -0,0 +1,26 @@
+.. _cn_api_paddle_nanquantile:
+
+nanquantile
+-------------------------------
+
+.. py:function:: paddle.nanquantile(x, q, axis=None, keepdim=False, interpolatio='linear', name=None)
+
+沿给定的轴 ``axis`` 计算 ``x`` 中元素的分位数, 忽略元素中的 ``NaN`` 。
+
+参数
+::::::::::
+    - **x** (Tensor) - 输入的 Tensor，数据类型为：float32、float64。
+    - **q** (int|float|list|Tensor) - 待计算的分位数，需要在符合取值范围[0, 1]。如果 ``q`` 是 List 或者 1-D Tensor，其中的每一个 q 分位数都会被计算，并且输出的首维大小与列表中元素的数量相同。
+    - **axis** (int|list，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int 或内部元素为 int 类型的 list。``axis`` 值应该在范围[-D, D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 list，对给定的轴上的所有元素计算分位数。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算分位数。默认值为 None。
+    - **keepdim** (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度(减少的维度除外，减少的维度的大小为 1)。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 False。
+    - **interpolation** (str，可选) - 计算分位数的插值方法，可以是 ``linear`` , ``lower`` , ``higher`` , ``nearest`` 或者 ``midpoint`` 。 默认值为 liner。
+    - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
+
+返回
+::::::::::
+    ``Tensor``，沿着 ``axis`` 进行分位数计算的结果。如果 ``x`` 的数据类型为 float64，则返回值的数据类型为 float64，反之返回值数据类型为 float32。
+
+代码示例
+::::::::::
+
+COPY-FROM: paddle.quantile

docs/api/paddle/quantile_cn.rst

@@ -3,16 +3,17 @@
 quantile
 -------------------------------
 
-.. py:function:: paddle.quantile(x, q, axis=None, keepdim=False, name=None)
+.. py:function:: paddle.quantile(x, q, axis=None, keepdim=False, interpolatio='liear', name=None)
 
 沿给定的轴 ``axis`` 计算 ``x`` 中元素的分位数。
 
 参数
 ::::::::::
     - **x** (Tensor) - 输入的 Tensor，数据类型为：float32、float64。
-    - **q** (int|float|list) - 待计算的分位数，需要在符合取值范围[0, 1]。如果 ``q`` 是 List，其中的每一个 q 分位数都会被计算，并且输出的首维大小与列表中元素的数量相同。
+    - **q** (int|float|list|Tensor) - 待计算的分位数，需要在符合取值范围[0, 1]。如果 ``q`` 是 List 或者 1-D Tensor，其中的每一个 q 分位数都会被计算，并且输出的首维大小与列表中元素的数量相同。
     - **axis** (int|list，可选) - 指定对 ``x`` 进行计算的轴。``axis`` 可以是 int 或内部元素为 int 类型的 list。``axis`` 值应该在范围[-D, D)内，D 是 ``x`` 的维度。如果 ``axis`` 或者其中的元素值小于 0，则等价于 :math:`axis + D`。如果 ``axis`` 是 list，对给定的轴上的所有元素计算分位数。如果 ``axis`` 是 None，则对 ``x`` 的全部元素计算分位数。默认值为 None。
     - **keepdim** (bool，可选) - 是否在输出 Tensor 中保留减小的维度。如果 ``keepdim`` 为 True，则输出 Tensor 和 ``x`` 具有相同的维度(减少的维度除外，减少的维度的大小为 1)。否则，输出 Tensor 的形状会在 ``axis`` 上进行 squeeze 操作。默认值为 False。
+    - **interpolation** (str，可选) - 计算分位数的插值方法，可以是 ``linear`` , ``lower`` , ``higher`` , ``nearest`` 或者 ``midpoint`` 。 默认值为 liner。
     - **name** (str，可选) - 具体用法请参见 :ref:`api_guide_Name`，一般无需设置，默认值为 None。
 
 返回

docs/guides/model_convert/convert_from_pytorch/api_difference/ops/torch.nanquantile.md

@@ -30,7 +30,7 @@ Pytorch 相比 Paddle 支持更多其他参数，具体如下：
 |   q   |  q  | 待计算的分位数。  |
 |  dim  | axis| 指定对 x 进行计算的轴，仅参数名不一致。 |
 |keepdim|keepdim| 是否在输出 Tensor 中保留减小的维度。|
-|interpolation|  - | 当所需分位数位于两个数据点之间时使用的插值方法，Paddle 无此参数，Paddle 暂无转写方式。|
+|interpolation|  - | 当所需分位数位于两个数据点之间时使用的插值方法|
 |  out  |  -  | 表示输出的 Tensor，Paddle 无此参数，需要转写。    |