---
name: perceval-photonics
description: 用 Quandela Perceval 在本地计算用户指定 Fock 输入、分束器和相移器网络的光子输出概率，解释模式顺序、HOM 干涉和适用边界。
---

# Perceval 线性光学

适用于无损、不可区分光子的被动线性光学干涉。Agent 经 Harness 调用 `perceval_local` 的 `simulate_perceval_photonics`；Skill 解释输入和结果，Tool 执行真实 Perceval SLOS 计算。

- `inputOccupation[i]` 是模式 i 的非负整数光子数；真空输入允许。`operations` 按时间顺序应用。
- `BS` 接受两个有序、不同模式；可非相邻。`angleRad` 是 θ，采用 `BS.H(θ)`，矩阵为 `[[cos(θ/2),sin(θ/2)],[sin(θ/2),-cos(θ/2)]]`，θ=π/2 为平衡分束器。适配层通过 SDK `PERM` 显式路由并还原模式。
- `PS` 接受一个模式，以 `exp(i*angleRad)` 改变振幅。所有角度是 rad。
- 输出 `outcomes` 包含固定总光子数下每个 Fock 输出；`occupation[i]` 对应输入模式 i。`unitary[row][column]` 是 `[real,imag]`，输入列到输出行。检查 `totalProbability` 接近 1。
- 先用双光子 HOM 或单光子网络检查角度与模式约定，再分析多光子永久式干涉。只有概率，无采样、损耗、探测器噪声或后选择。
- 规模由调用方选择；Fock 空间组合增长，使用独立的 `execution` 设定资源约束。不得用本地理想概率推断设备保真度。
- 固定依赖需显式执行 `node scripts/setup-paper-tools.mjs perceval-photonics`；调用时不安装依赖，可能产生本地数值库缓存。
- 当前 L1，`scientificValidation=not_evaluated`；成功计算或工程回归不构成科学 Acceptance。

[上游与许可说明](references/UPSTREAM.md)。