📚 课程目录第3章紧凑模型接口与数据契约

3. 紧凑模型接口与数据契约

在硅光器件紧凑模型构建中，接口与数据契约是连接器件物理、仿真引擎与系统级设计的关键层。一个紧凑模型能否被不同仿真器、不同设计流程稳定复用，很大程度上取决于它是否清晰定义了“输入什么、输出什么、以什么形式交换数据”。本节围绕光学端口、电学端口、波长、温度、偏压等自变量与因变量，讨论S参数、传输矩阵、等效电路三类典型模型接口的规范设计方法。

一、自变量与因变量的划分原则

紧凑模型的接口设计首先要回答一个基本问题：哪些量是外部可独立施加或扫描的，哪些量是模型内部计算后输出的。前者称为自变量，后者称为因变量。在硅光器件中，常见的自变量包括：

光学端口状态量：入射光波长 λ、输入光功率 P_in、偏振态（TE/TM 或 Jones 矢量分量）；
电学端口状态量：偏置电压 V_bias、注入电流 I_inj、调制电压摆幅 V_pp；
环境与工艺量：温度 T、工艺角参数（如波导宽度偏差 Δw、掺杂浓度偏差 ΔN）；
频率量：对于小信号交流分析，射频频率 f 或角频率 ω 也是自变量。

因变量则通常包括：输出光功率 P_out、输出相位 φ_out、S参数矩阵元、传输矩阵元、等效电路中的节点电压/电流、以及品质因子 Q、消光比 ER、插入损耗 IL 等派生指标。需要强调的是，自变量与因变量的划分并非绝对，而是取决于分析类型。例如在直流偏压扫描中，V_bias 是自变量；但在等效电路瞬态分析中，V_bias 可能由电路方程求解得到，此时它成为因变量。因此，接口规范中必须明确声明每个量的角色及其适用分析模式。

二、光学端口与电学端口的接口定义

光学端口在紧凑模型中通常以“模式端口”形式出现，每个端口需要定义参考平面、模式编号、偏振基和传播方向。一个规范的接口应包含：端口编号、端口类型（光/电）、参考阻抗或参考模式功率、以及端口间的方向约定。例如，对于波导型器件，可定义端口1为输入、端口2为输出，并约定正向传播为从端口1到端口2，光场用归一化复振幅 a 表示入射波、b 表示出射波。

电学端口则需定义参考节点、端口阻抗和信号类型（电压驱动或电流驱动）。在硅光调制器中，常见的电学端口包括行波电极的射频输入端口和直流偏置端口。接口规范应明确：直流端口与射频端口是否共享同一物理节点、是否允许同时施加、以及小信号与大信号分析时的端口条件差异。

建议在模型接口文档中为每个端口建立一张“端口契约表”，至少包含：端口名、物理量类型、单位、方向、参考条件、适用分析模式。这样可以在不同仿真器之间移植模型时减少歧义。

三、S参数、传输矩阵与等效电路接口

S参数接口适用于频域小信号分析。对于双端口光学器件，S矩阵为2×2复矩阵，每个元素 S_ij 表示从端口 j 入射到端口 i 出射的复振幅传输系数。接口规范需明确：S参数是否包含波长依赖性、是否包含温度与偏压依赖性、以及参考阻抗/参考模式的定义。在硅光中，S参数通常以波长扫描或频率扫描形式给出，并需注明偏振条件。

传输矩阵接口则更适合级联器件的建模。传输矩阵 T 将输入端口场矢量与输出端口场矢量关联，其矩阵元通常包含相位延迟和幅度衰减。与S参数相比，传输矩阵在级联时只需矩阵相乘，便于构建复杂光路。接口规范应说明矩阵的维度、基矢选择（如 [E_TE, E_TM]^T）以及是否包含反射项。

等效电路接口用于光电协同仿真。它将光学行为映射为电路元件（如电阻、电容、电感、受控源），使光电器件可以在SPICE类仿真器中与驱动电路联合分析。接口规范需定义：电路拓扑、元件参数与物理量的映射关系、以及光功率与电流/电压之间的转换系数。例如，光电探测器可等效为电流源 I_pd = R·P_in 并联结电容 C_j 和串联电阻 R_s，其中 R 为响应度。

四、数据契约的字段设计与示例

数据契约是接口规范的具体落地形式。一个可执行的紧凑模型数据契约通常包含以下字段：模型标识、版本号、端口列表、自变量列表、因变量列表、参数表、以及每个量的元数据（单位、默认值、扫描范围、插值方式）。下面给出一个硅光微环调制器紧凑模型的接口契约示例，用于说明字段组织方式。

model_id: SiPh_MRR_Modulator
version: 1.0
ports:
  - id: opt_in
    type: optical
    mode: TE0
    direction: input
    ref_plane: "x=0"
  - id: opt_out
    type: optical
    mode: TE0
    direction: output
    ref_plane: "x=L"
  - id: elec_dc
    type: electrical
    signal: dc_bias
    ref_node: gnd
  - id: elec_rf
    type: electrical
    signal: rf
    impedance: 50 ohm

independent_vars:
  - name: wavelength
    unit: nm
    range: [1520, 1580]
    default: 1550
  - name: temperature
    unit: K
    range: [273, 358]
    default: 300
  - name: v_bias
    unit: V
    range: [-4, 0]
    default: -2

dependent_vars:
  - name: P_out
    unit: mW
  - name: phase_out
    unit: rad
  - name: S21
    unit: complex
  - name: IL
    unit: dB

model_interface:
  type: S_parameter
  matrix_size: 2x2
  wavelength_dependent: true
  temperature_dependent: true
  bias_dependent: true
  interpolation: spline

该契约明确声明了端口、自变量、因变量和接口类型。在实际工程中，这份契约可以以YAML、JSON或XML形式存储，并由模型加载器解析后自动生成仿真器可识别的端口和参数。需要注意的是，示例中的数值范围与默认值属于教学假设，实际使用时必须根据具体器件测试或仿真数据填写。

五、接口一致性检查与常见问题

接口规范设计完成后，必须进行一致性检查。常见问题包括：端口方向约定不统一导致S参数转置错误；温度与偏压的依赖关系未声明，导致仿真器在扫描时忽略耦合效应；等效电路接口中光功率与电流的转换系数未标注单位，造成量纲错误。建议在模型交付前执行以下检查：

所有端口是否都有明确的参考平面和方向定义；
自变量与因变量的角色是否在文档中逐一声明；
S参数、传输矩阵、等效电路三种接口是否共享同一套端口编号；
单位是否统一（如波长用nm、温度用K、偏压用V）；
插值方式是否与数据密度匹配，避免外推产生非物理结果。

当模型同时提供S参数和等效电路两种接口时，必须验证两者在相同偏压和波长下的直流/低频响应是否一致。若不一致，通常说明等效电路中的寄生参数或转换系数需要重新提取。

总结来说，紧凑模型接口与数据契约的核心在于“先定义清楚，再实现模型”。自变量与因变量的划分、光学与电学端口的契约、S参数/传输矩阵/等效电路三类接口的规范，以及可执行的数据契约字段，共同构成了硅光器件紧凑模型可复用、可验证、可协同仿真的基础。在实际项目中，建议将接口契约作为模型交付物的第一页文档，并在版本迭代中保持向后兼容，避免因接口变更导致上层光路仿真失效。