tensorcircuit.cloud.wrapper

higher level wrapper shortcut for submit_task

tensorcircuit.cloud.wrapper.batch_expectation_ps(c: tensorcircuit.circuit.Circuit, pss: List[List[int]], device: Optional[Any] = None, ws: Optional[List[float]] = None, shots: int = 8192, with_rem: bool = True, compile_func: Optional[Callable[[tensorcircuit.circuit.Circuit], Tuple[tensorcircuit.circuit.Circuit, Dict[str, Any]]]] = None, batch_limit: int = 64, batch_submit_func: Optional[Callable[[...], List[Dict[str, int]]]] = None) → Union[Any, List[Any]]

Unified interface to compute the Pauli string expectation lists or sums via simulation or on real qpu. Error mitigation, circuit compilation and Pauli string grouping are all built-in.

One line access to unlock the whole power or real quantum hardware on quantum cloud.

Example

c = tc.Circuit(2)
c.h(0)
c.x(1)
tc.cloud.wrapper.batch_expectation_ps(c, [[1, 0], [0, 3]], device=None)
# array([ 0.99999994, -0.99999994], dtype=float32)
tc.cloud.wrapper.batch_expectation_ps(c, [[1, 0], [0, 3]], device="tencent::9gmon")
# array([ 1.03093477, -1.11715944])

参数

• c (Circuit) -- The target circuit to compute expectation

• pss (List[List[int]]) -- List of Pauli string list, eg. [[0, 1, 0], [2, 3, 3]] represents [X1, Y0Z1Z2].

• device (Any, optional) -- The device str or object for quantum cloud module, defaults to None, None is for analytical exact simulation

• ws (Optional[List[float]], optional) -- List of float to indicate the final return is the weighted sum of Pauli string expectations, e.g. [2., -0.3] represents the final results is 2* pss [0]-0.3* pss [1] defaults to None, None indicate the list of expectations for pss are all returned

• shots (int, optional) -- measurement shots for each expectation estimation, defaults to 8192

• with_rem (bool, optional) -- whether enable readout error mitigation for the result, defaults to True

返回

List of Pauli string expectation or a weighted sum float for Pauli strings, depending on ws

返回类型

Union[Any, List[Any]]

tensorcircuit.cloud.wrapper.batch_submit_template(device: str, batch_limit: int = 64, **kws: Any) → Callable[[...], List[Dict[str, int]]]

tensorcircuit.cloud.wrapper.reduce_and_evaluate(cs: List[tensorcircuit.circuit.Circuit], shots: int, run: Callable[[...], Any]) → List[Dict[str, int]]

tensorcircuit.cloud.wrapper.sample_expectation_ps(c: tensorcircuit.circuit.Circuit, x: Optional[Sequence[int]] = None, y: Optional[Sequence[int]] = None, z: Optional[Sequence[int]] = None, shots: int = 1024, device: Optional[tensorcircuit.cloud.abstraction.Device] = None, **kws: Any) → float

Deprecated, please use tensorcircuit.cloud.wrapper.batch_expectation_ps().