# TerminalComponentModeler

These advanced fields belong to tidy3d.rf.TerminalComponentModeler (opens new window).

# Remove DC Component

remove_dc_component: Toggle whether to remove the DC component in the Gaussian pulse spectrum.

  • Type: Boolean
  • Options:
    • True: Modify the Gaussian pulse at low frequencies to zero out the DC component.
    • False: Keep the unmodified Gaussian pulse spectrum.
  • Default: True

NOTE

  • Set remove_dc_component to True for narrowband or resonant simulations when low-frequency signal content is not important.
  • Set remove_dc_component to False for broadband or signal-integrity simulations when low-frequency signal content is important.

# Assume Ideal Excitation

assume_ideal_excitation: Toggle how incident wave amplitudes are computed for S-parameter calculation.

  • Type: Boolean
  • Options:
    • True: Assume only the excited port has nonzero incident wave amplitude.
    • False: Calculate incident wave amplitudes explicitly at every port.
  • Default: False

Use True when only a selected subset of port simulations is run.

# S-Parameter Definition

s_param_def: Wave definition used to compute scattering parameters.

  • Options:
    • Pseudo: Use the pseudo-wave definition.
    • Power: Use the power-wave definition.
    • Symmetric pseudo: Use the symmetric pseudo-wave definition.
  • Default: Pseudo

When the reference impedance is purely real, all three definitions produce the same S-matrix. The differences matter when Z_ref is complex.

Definition S12=S21S_{12} = S_{21} for reciprocal networks Condition for S11=0S_{11} = 0 Passive S111\lvert S_{11} \rvert \le 1
Pseudo waves No Zin=ZrefZ_\mathrm{in} = Z_\mathrm{ref}, impedance match No
Power waves Yes Zin=ZrefZ_\mathrm{in} = Z_\mathrm{ref}^{*}, conjugate match Yes
Symmetric pseudo waves Yes Zin=ZrefZ_\mathrm{in} = Z_\mathrm{ref}, impedance match No

See S-Parameter Definitions (opens new window).

# Structure Priority Mode

structure_priority_mode: Priority mode used for structures with no explicit priority.

  • Options:
    • conductor: Give conductive structures higher priority.
    • equal: Assign the same priority to structures without an explicit value.
  • Default: conductor

# Run Only

run_only: Optional list of S-matrix indices that define which port simulations to run.

  • Options:
    • None: Run all simulations needed for the full S-matrix.
    • Selected entries: Run only the selected S-matrix entries.
  • Default: None

# S-parameter Symmetry

element_mappings: S-matrix element mappings used to skip simulations whose results can be inferred from another matrix element.

Each mapping relates an input element, output element, and complex coefficient.

# Custom Source Time

custom_source_time: Optional custom source time dependence used for the RF excitations.

  • Default: None

See Custom Source Time for available waveform options, formulas, parameters, and example time-domain and frequency-domain plots.

# Low Frequency Smoothing

low_freq_smoothing: Optional low-frequency smoothing parameters used by the terminal component simulation.

  • Default: None

See Low Frequency Smoothing for the smoothing model and parameters.