mindspore/docs/api/api_python/ops/mindspore.ops.func_dropout.rst

mindspore.ops.dropout
======================

.. py:function:: mindspore.ops.dropout(x, p=0.5, seed0=0, seed1=0)

    在训练期间，以服从伯努利分布的概率 `p` 随机将输入Tensor的某些值归零，起到减少神经元相关性的作用，避免过拟合。此概率与 `ops.dropout` 和 `nn.dropout` 中的含义相反。

    参数：
        - **x** (Tensor) - dropout的输入，任意维度的Tensor，其数据类型为float16或float32。
        - **p** (float，可选) - 输入神经元丢弃概率，数值范围在0到1之间。例如，p=0.1，删除10%的神经元。默认值：0.5。
        - **seed0** (int，可选) - 算子层的随机种子，用于生成随机数。默认值：0。
        - **seed1** (int，可选) - 全局的随机种子，和算子层的随机种子共同决定最终生成的随机数。默认值：0。

    返回：
        - **output** (Tensor) - 归零后的Tensor，shape和数据类型与 `x` 相同。
        - **mask** (Tensor) - 用于归零的掩码，内部会按位压缩与对齐。

    异常：
        - **TypeError** - `p` 不是float。
        - **TypeError** - `seed0` 或 `seed1` 不是int。
        - **TypeError** - `x` 的数据类型既不是float16也不是float32。
        - **TypeError** - `x` 不是Tensor。
-												add dropout api.

											
										
										
											2022-06-15 09:57:01 +08:00
+								mindspore.ops.dropout
 								======================
-.Add MultiMarginLoss and MultiLabelMarginLoss functional api and nn api.
2.Modify the doc of conv2d and conv3d api.
3.Add the doc of ScalarSummary and TensorSummary api.

											
										
										
											2022-09-26 15:17:14 +08:00
+								.. py:function:: mindspore.ops.dropout(x, p=0.5, seed0=0, seed1=0)
-												add dropout api.

											
										
										
											2022-06-15 09:57:01 +08:00
-												fix dropout doc

											
										
										
											2022-11-28 11:30:29 +08:00
+								    在训练期间，以服从伯努利分布的概率 `p` 随机将输入Tensor的某些值归零，起到减少神经元相关性的作用，避免过拟合。此概率与 `ops.dropout` 和 `nn.dropout` 中的含义相反。
-												add dropout api.

											
										
										
											2022-06-15 09:57:01 +08:00
-												modify format

											
										
										
											2022-07-29 15:54:43 +08:00
+								    参数：
-.Add MultiMarginLoss and MultiLabelMarginLoss functional api and nn api.
2.Modify the doc of conv2d and conv3d api.
3.Add the doc of ScalarSummary and TensorSummary api.

											
										
										
											2022-09-26 15:17:14 +08:00
+								        - **x** (Tensor) - dropout的输入，任意维度的Tensor，其数据类型为float16或float32。
-												q3 collective review part3

											
										
										
											2022-11-01 19:52:13 +08:00
+								        - **p** (float，可选) - 输入神经元丢弃概率，数值范围在0到1之间。例如，p=0.1，删除10%的神经元。默认值：0.5。
-.Add MultiMarginLoss and MultiLabelMarginLoss functional api and nn api.
2.Modify the doc of conv2d and conv3d api.
3.Add the doc of ScalarSummary and TensorSummary api.

											
										
										
											2022-09-26 15:17:14 +08:00
+								        - **seed0** (int，可选) - 算子层的随机种子，用于生成随机数。默认值：0。
 								        - **seed1** (int，可选) - 全局的随机种子，和算子层的随机种子共同决定最终生成的随机数。默认值：0。
-												modify format

											
										
										
											2022-07-29 15:54:43 +08:00
 								    返回：
-												fix dropout doc

											
										
										
											2022-11-28 11:30:29 +08:00
+								        - **output** (Tensor) - 归零后的Tensor，shape和数据类型与 `x` 相同。
 								        - **mask** (Tensor) - 用于归零的掩码，内部会按位压缩与对齐。
-												modify format

											
										
										
											2022-07-29 15:54:43 +08:00
 								    异常：
-.Add MultiMarginLoss and MultiLabelMarginLoss functional api and nn api.
2.Modify the doc of conv2d and conv3d api.
3.Add the doc of ScalarSummary and TensorSummary api.

											
										
										
											2022-09-26 15:17:14 +08:00
+								        - **TypeError** - `p` 不是float。
 								        - **TypeError** - `seed0` 或 `seed1` 不是int。
-												modify format

											
										
										
											2022-07-29 15:54:43 +08:00
+								        - **TypeError** - `x` 的数据类型既不是float16也不是float32。
 								        - **TypeError** - `x` 不是Tensor。