PoleResidue

A dispersive medium described by the pole-residue pair model. The frequency-dependence of the complex-valued permittivity is described by:

$\epsilon(\omega) = \epsilon_\infty - \sum_i\left[\frac{c_i}{j \omega + a_i} + \frac{c_i^\ast}{j \omega + a_i^\ast}\right]$

Name

name: Optional unique name for medium.

Thermal Properties

This section appears when the task group includes a Heat solver and is omitted from a standalone FDTD task.

Medium Type

type: Selects the thermal model under Medium Type.

Type: string

Options:

• FluidSpec: The Heat solver does not solve for temperature in regions that use this medium.
• SolidSpec: The Heat solver uses the solid thermal model.

Default: SolidSpec for a new medium in a Heat simulation.

Thermal Conductivity

conductivity: Thermal conductivity. This field is shown when Medium Type is SolidSpec.

Type: floating-point number

• Unit: W/(μm·K)
• Constraint: greater than 0
• Required field

NOTE

The editor has no inputs for heat capacity (capacity) or density (density). When you create a medium in a Heat simulation, the editor sets capacity to 1. To set other values, use the Python interface. See Thermal Properties for the API fields.

Optical Properties

Epsilon at Infinity

eps_inf: Relative permittivity at infinite frequency ($\epsilon_\infty$).

Type: floating-point number

• Unit: unitless
• Constraint: greater than 0
• Default: 1

Poles

poles: List of complex-valued ($a_i, c_i$) poles for the model.

a: complex number

• Unit: rad/sec

c: complex number

• Unit: rad/sec

Advanced

frequency_range: Optional lower and upper frequency bounds for the medium.

Type: pair of floating-point numbers

• Unit: Hz for both values
• Constraint: each value greater than 0
• Default: None

Allow gain

allow_gain: Enable gain medium. Caution: simulations with gain medium are unstable and are likely to diverge. Simulations with this option enabled are still charged even if they diverge. Monitor data up to the divergence point is still returned and can be useful in some cases.

Type: boolean

Default: False

Appearance

Appearance settings control the medium’s face color and transparency in the model view. They do not change the optical properties.