.. _cn_api_tensor_cn_greater_equal:

greater_equal
-------------------------------
.. py:function:: paddle.greater_equal(x, y, name=None)

:alias_main: paddle.greater_equal
:alias: paddle.greater_equal,paddle.tensor.greater_equal,paddle.tensor.logic.greater_equal

该OP逐元素地返回 :math:`x >= y` 的逻辑值，相同位置前者输入大于等于后者输入则返回True，否则返回False。使用重载算子 `>=` 可以有相同的计算函数效果。

**注：该OP输出的结果不返回梯度。**

参数：
    - **x** (Tensor) - 输入Tensor，支持的数据类型包括 float32， float64，int32， int64。
    - **y** (Tensor) - 输入Tensor，支持的数据类型包括 float32， float64， int32， int64。
    - **name** （str，可选）- 具体用法请参见 :ref:`api_guide_Name` ，一般无需设置，默认值为None。
    

返回：输出结果的Tensor，输出Tensor的shape和输入一致，Tensor数据类型为bool。

返回类型：变量（Tensor）

**代码示例**:

.. code-block:: python

     import numpy as np
     import paddle
     import paddle.imperative as imperative
     paddle.enable_imperative()
     x = imperative.to_variable(np.array([1, 2, 3]))
     y = imperative.to_variable(np.array([1, 3, 2]))
     result1 = paddle.greater_equal(x, y)
     print(result1.numpy())  # result1 = [True False True]


