mindquantum.simulator.mqchem.UCCExcitationGate
===============================================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/master/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindquantum/blob/master/docs/api_python/simulator/mindquantum.simulator.mqchem.UCCExcitationGate.rst
    :alt: 查看源文件


.. py:class:: mindquantum.simulator.mqchem.UCCExcitationGate(fermion_operator: FermionOperator)

    酉耦合簇（UCC）激发门，用于与 :class:`~.simulator.mqchem.MQChemSimulator` 一同使用。

    该门表示酉算符 :math:`e^{G}`，其中 :math:`G` 是一个反厄米生成元，形式为 :math:`G = \theta (T - T^\dagger)`。
    这里，:math:`T` 是一个同时保持自旋和电子数守恒的费米子激发算符。该算符常用于量子化学中变分量子算法的UCC拟设。

    .. note::
        此门专为 `MQChemSimulator` 设计，并依赖其内部的CI空间表示。它与标准的态矢量 `Simulator` 不兼容。

    该门定义为：

    .. math::

        U(\theta) = \exp(\theta(T - T^\dagger))

    其中 :math:`T` 必须是单项的 :class:`~.core.operators.FermionOperator`，
    例如 :math:`a_p^\dagger a_q`。

    参数：
        - **fermion_operator** (FermionOperator) - 费米子激发算符 :math:`T`。
          它必须只包含一项。该项的系数用作旋转角 :math:`\theta`。如果系数是变量，则该门是参数化的。

    .. py:method:: get_cpp_obj(n_qubits: int, n_electrons: int, backend)

        返回用于模拟的C++对象。

        .. note::
            此方法供 :class:`~.simulator.mqchem.MQChemSimulator` 内部使用。

        参数：
            - **n_qubits** (int) - 系统中的总量子比特数（自旋轨道数）。
            - **n_electrons** (int) - 系统中的总电子数。
            - **backend** (``_mq_chem.float`` 或 ``_mq_chem.double``) - C++后端模块。

        返回：
            C++对象，底层绑定类型为 ``CppExcitationOperator``，用于模拟。