oracq 包总览¶

根包 oracq 汇总导出公开 API（共 143 个名字）。名字按定义模块分组；模块标题链接到对应 API 页，成员链接到模块页内的完整说明。

基础设施 API¶

Toffoli / U3 / CZ 降低: oracq.infrastructure.backends.basis —— export_toffoli_u3_cz
OriginIR-ext 后端: oracq.infrastructure.backends.originir —— OriginIRArtifact、export_originir、run_originir
PySparQ 后端: oracq.infrastructure.backends.pysparq —— run_pysparq、run_pysparq_rir
Quantikz 线路导出: oracq.infrastructure.backends.quantikz —— quantikz
严格网表导出: oracq.infrastructure.backends.strict —— StrictArtifact、export_strict
模块构造器: oracq.infrastructure.builder —— Builder、Operation
资源估计: oracq.infrastructure.estimate —— ResourceEstimate、estimate_resources、OracleCall、RotationCounts
寄存器参考执行器: oracq.infrastructure.execution —— RegisterState、simulate
RIR 对象: oracq.infrastructure.ir —— VERSION、Adjoint、Bits、Call、Control、Load、Module、Primitive、Program、QRAM、Rational、Ref、Register、RegType、Repeat、Resource、SInt、Span、Store、UInt、ValidationError、fuse
绑定与能力分析: oracq.infrastructure.linking —— Binding、OracleRequirement、bind、capabilities、unresolved、BindingError、BindingReport、BindingResult、bind_with_report
数学函数编译入口: oracq.infrastructure.mathfunc —— compile_function、lower_math_ir
Python 数学函数前端: oracq.infrastructure.mathfunc.frontend —— FunctionCompileError
MIR 对象: oracq.infrastructure.mathfunc.graph —— Index、MathProgram
数学函数降低: oracq.infrastructure.mathfunc.lowering —— CompiledFunction
数学核生成: oracq.infrastructure.mathfunc.numeric —— MathConfig
原生实现注册: oracq.infrastructure.native —— DynamicCppFactory、NativeRegistry
QRAM 指针式读写: oracq.infrastructure.qmem —— QMem、QPtr
QRAM YAML 内存格式: oracq.infrastructure.qram_schema —— dump_qram_yaml、load_qram_yaml、RegisteredQRAM、register_qram
RIR 序列化: oracq.infrastructure.serialization —— dumps、loads
结构验证: oracq.infrastructure.validation —— validate

算法 API¶

可逆算术: oracq.algorithms.common.arithmetic —— FixedFormat、arithmetic_native_registry、fixed_arithmetic
算法契约与报告: oracq.algorithms.input_model.contracts —— AlgorithmContract、ResolvedInputs、ContractError、ContractIssue、ContractReport、InputRequirement、OracleCapabilities、OracleSpec、ProtocolContract、describe_oracle、requires
initial: oracq.algorithms.input_model.initial —— ArrayInput、InitialInput、OracleInput、PreparedInitial、QRAMInput、QRAMInputConfig、UniformInput
QODE 组装接口: oracq.algorithms.input_model.ode —— GeneratorInput、MatrixInput、ODELayout、ODEProblem、OracleGeneratorInput、PreparedGenerator、QRAMMatrixConfig、QRAMMatrixInput
算子包装与基本组合: oracq.algorithms.input_model.operators —— BlockEncoding、Generator、block_encoding、identity、linear_combination、pauli_x、product、scale、zero
Oracle 声明与实现: oracq.algorithms.input_model.oracles —— declare
PDE 模型与适配: oracq.algorithms.input_model.pde —— InitialLayout、PDEGrid、PDEProblem、UniformGrid1D、UnstructuredGrid、UnstructuredGridConfig
量子数据结构（qsample 与 sample-and-query）: oracq.algorithms.input_model.qdata —— QMatrix、QVector
量子线性系统: oracq.algorithms.qlss.qlss —— BlockSystem、LinearSystem、QLSSProtocol、SolveResult、SparseSystem、SpectralPromise、QLSSSolver
KP 量子推荐系统: oracq.algorithms.qml.recommendation —— KPRecommendationConfig、RecommendationResult、kp_recommendation、sigma_from_phase
QODE 组装接口: oracq.algorithms.qode.ode —— QODESolver、QODEProblem、QODEProtocol
solver: oracq.algorithms.qode.solver —— LinearODEMethod、ODECircuit、ODEConfig、ODEMethod、ODEResult、ODESolveInstance、PreparedODE、qode_solve
solver: oracq.algorithms.qpde.solver —— PDECircuit、PDEMethod、PDEResult、PDESolveInstance、PreparedPDE、QHAMConfig、QHAMMethod、qpde_solve