# PerturbationMedium
Dispersionless medium with heat or charge perturbations. Use this model when a medium’s permittivity and conductivity depend on a Heat or Charge result. Charge response fields are part of the saved model; the editor offers this model from New Medium while editing a Heat simulation.
The medium panel separates Thermal Properties, Optical Properties, and Optical Perturbation. Additional supported medium settings are under Advanced.
# Name
name: Optional unique name for the medium. The name appears in the Mediums list and is separate from the optical and thermal properties.
# 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
permittivity: Relative permittivity.
- Unit: unitless
- Constraint: greater than or equal to 1
- Default: 1
conductivity: Electric conductivity. The imaginary part of the complex permittivity at angular frequency omega is given by conductivity/omega.
- Unit: S/μm
- Constraint: greater than or equal to 0
- Default: 0
subpixel: If True and the simulation’s subpixel setting is also True, applies subpixel averaging to the perturbed medium.
- Type: boolean
- Default: True
# Optical Perturbation
Enable Optical Perturbation to expose the perturbation controls. Select one of the following representations:
- n/k (
IndexPerturbation): Perturb refractive-index and extinction-coefficient values at a selected wavelength or frequency. - ε/σ (
PermittivityPerturbation): Perturb permittivity and conductivity directly.
perturbation_spec: Selects the n/k or ε/σ representation above.
permittivity_perturbation and conductivity_perturbation: Optional ParameterPerturbation values. Each can contain a heat response, a charge response, or both.
The perturbation controls also provide a reference temperature and a valid temperature range.
# Advanced
Advanced can contain the frequency range, Allow_gain, and Space-Time Modulation. Nonlinearity Specification is not available for perturbation media.
# Appearance
Appearance settings control the medium’s face color and transparency in the model view. They do not change the optical or thermal properties.