文档版本

PauliZ¶

from cascaqit import PauliZ

PauliZ ¶

PauliZ(
    target: str, *, name: str | None = None
) -> Observable

创建作用于 target 的Pauli Z 算符声明，返回 Observable。target 是逻辑名称字符串，例如 "q0"，不是量子位索引。name 可选；省略时名称为 Z(q0) 这样的形式。

在 0/1 基下，本征值分别为 +1/-1，因此 Z 期望为 P(0) - P(1)。有限计数估计与精确态求值要分别报告。

from cascaqit import PauliZ

observable = PauliZ("q0", name="Z0")
assert observable.targets == ("q0",)
assert observable.bases[0].value == "Z"

目标或名称为空、含首尾空白时构造失败。此函数只创建声明；求值还需确认 target 存在，并根据返回的 estimator_kind 判断是精确计算还是采样估计。见观测量批次。