Variable | Type | Description |
---|---|---|
wavelength_data |
Number |
Center wavelength (m) of the band for which all the mode properties are provided. |
mode_data |
Cell |
1 x 1 cell array. Each element of the cell is a struct with fields:
This model only supports a single mode. |
temperature_data |
Number |
Temperature (K) for which the waveguide mode properties below are provided. |
neff_all |
Matrix |
1 x 6 matrix containing the effective index of the different waveguide segments, where the columns contain the effective index of the:
The effective index of the taper regions can be approximate. The effective index should be measured with 0V applied bias. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. |
dneff_dT |
Number |
Thermal sensitivity (1/K) of effective index of all waveguide types with respect to ambient temperature. Thermal effects can be neglected by setting this to 0. |
ng_all |
Matrix |
1 x 6 matrix containing the group index of the different waveguide segments, where the columns contain the group index of the:
The group index of the taper regions can be approximate. The group index should be measured with 0V applied bias. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. |
D_all | Matrix |
1 x 6 matrix containing the dispersion(s/m/m) of the different waveguide segments, where the columns contain the dispersion of the:
The dispersion of the taper regions can be approximate. The dispersion should be measured with 0V applied bias. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. |
loss_all |
Matrix |
1 x 6 matrix containing the loss (dB/m) of the different waveguide segments, where the columns contain the loss of the:
The loss of the taper regions can be approximate. The loss should be measured with 0 V applied bias. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. |
L1_all |
Matrix |
1 x 6 matrix containing the length (m) of the different waveguide segments, where the columns contain the length of the:
For unbalanced MZMs, use the length of the smaller arm for the passive waveguide section. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. Note: If wg_length.visible is set to true within the .lsf file, the electrical_phase_shifter length will be visible to the user. |
L_in |
Number |
Length of waveguide (m) before the splitters. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. |
L_out |
Number |
Length of waveguide (m) after the splitters. See Internal Model Diagram in photonic model page for a diagram showing the role of each section. |
splitter_loss |
Number |
Estimated loss (dB) of the splitter at notch wavelength. This is the loss for a single splitter. The model assumes that both splitters are identical. |
electrical_bandwidth_data |
Matrix |
N x 2 matrix containing the 3-dB cutoff frequency (Hz) of the electrical modulator as a function of bias voltage (V), where N is the number of bias voltages, and the columns contain:
|
phase_shifter_data |
Matrix |
N x 3 matrix containing the effective index change of the electrical phase shifter as a function of bias voltage (V), where N is the number of bias voltages, and the columns contain:
Here, "change" refers to the difference between the effective index at a bias point and the effective index when there is no bias. |
thermal_bandwidth_data |
Number |
A single value containing the 3-dB cutoff frequency of the thermal phase shifter. |
thermal_tuner_data |
Matrix |
N x 2 matrix containing the optical phase shift of the thermal phase shifter as a function of input power (W), where N is the number of power values, and the columns contain:
Here, "shift" refers to the difference between the optical phase at a bias point and the optical phase when there is no bias. |
default_imbalance_length |
Number |
Default value for imbalance length (m). This value is always positive. This parameter should be set to 0 for a balanced MZM. Note: If imbalance_length.visible is set to true within the .lsf file, this will be visible to the user. |
S_parameter |
File |
A text file containing splitter s-parameters in Optical N Port S-Parameter format. The s-parameters must be defined for at least two frequency points. This data must be provided in a separate text file, the name of which must be provided within the parameter LSF file. Note: It's preferable to include group delay, as this allows for accurate modelling of the group delay between the different ports of the element. For more information on providing group delay, see group delay specification in s-parameter elements. |
Electrical behavior of thermal tuner
The electrical behavior of the thermal tuner can either be modeled linearly via a resistance value, or non-linearly by providing an IV characteristic. The IV data are linearly interpolated to obtain the electrical behavior. Either one of the following values must be provided to enable modelling of electrical behavior.
Note: If IV data is provided, it will take preference over R_thermal_tuner data.
Variable | Type | Description |
---|---|---|
IV |
Matrix |
C x 2 matrix containing the current (A) versus bias voltage (V) characteristic of the heater for the default phase shifter length, where C is the number of bias points, and the columns contain:
Note:
|
R_thermal_tuner |
Number |
Resistance (\(\Omega\)) of the heater for the default length of the phase shifter. Using a linear model is suitable for resistive heaters, but for voltage-dependent models an IV characteristic should be used instead. |
Model Tuning & QA Data
This data is required for CML Compiler to run quality-assurance tests on the final model. It is also optionally used by CML Compiler to fine-tune the internal model to provide the expected behavior. For more information, see Tuning Active Compact Models .
Variable | Type | Description |
---|---|---|
notch_wavelength |
Struct |
The resonant wavelength (m) of the MZM at a temperature of 300K with no applied electrical or thermal phase shift provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). This parameter is not required for a balanced MZM |
FSR |
Struct |
The free spectral range (m) of the MZM provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). This parameter is not required for a balanced MZM. |
IL |
Struct |
The overall insertion loss (dB) of the MZM in the off-resonance region (as explained in the Spectrum Data Visualization in photonic model page) provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). |
ER_V1 |
Struct |
The extinction ratio (dB) of the MZM (as explained in the Spectrum Data Visualization in photonic model page) at the voltage given by ER_V1_voltage provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). This parameter is not required for a balanced MZM. |
ER_V1_voltage |
Number |
Electrical phase shifter voltage (V) for which ER_V1 is provided. This parameter is not required for a balanced MZM. |
ER_V2 |
Struct |
The extinction ratio (dB) of the MZM (as explained in the Spectrum Data Visualization in photonic model page) at the voltage given by ER_V2_voltage provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). This parameter is not required for a balanced MZM |
ER_V2_voltage |
Number |
Electrical phase shifter voltage (V) for which ER_V2 is provided. See Spectrum Data Visualization in photonic model page for a visualization of IL and ER data. This parameter is not required for a balanced MZM. |
Vpi_electrical |
Struct |
Vpi (V) of the electrical phase shifter on each arm (as explained in the Vpi Data Visualization in photonic model page) for voltages between Vpi_electrical_voltage1 and Vpi_electrical_voltage2 provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). |
Vpi_electrical_voltage1 |
Number |
Lower limit of the voltage (V) range over which Vpi_electrical is calculated. |
Vpi_electrical_voltage2 |
Number |
Upper limit of the voltage (V) range over which Vpi_electrical is calculated. |
Ppi_thermal |
Struct |
Power (W) for pi phase shift of the thermal tuner (single arm) for input power between Ppi_thermal_power1 and Ppi_thermal_power2 provided as a struct. The struct has the following fields:
Fields "min" and "max" are optional and must be provided only when "visible_to_user" is set to 1 (true). |
Ppi_thermal_power1 |
Number |
Lower limit of the power (W) range over which Ppi_thermal is calculated. |
Ppi_thermal_power2 |
Number |
Upper limit of the power (W) range over which Ppi_thermal is calculated. Ppi_thermal_power1 and Ppi_thermal power2 values must be within the range of I*V values provided. |