tidy3d.rf.MicrowaveModeMonitor

tidy3d.rf.MicrowaveModeMonitor#

class MicrowaveModeMonitor[source]#

Bases: MicrowaveModeMonitorBase, ModeMonitor

Monitor that records amplitudes from modal decomposition of fields on plane.

Parameters:

  • center (Optional[tuple[Union[float, autograd.tracer.Box], Union[float, autograd.tracer.Box], Union[float, autograd.tracer.Box]]] = None) – [units = um]. Center of object in x, y, and z.

  • size (tuple[Union[NonNegativeFloat, autograd.tracer.Box], Union[NonNegativeFloat, autograd.tracer.Box], Union[NonNegativeFloat, autograd.tracer.Box]]) – [units = um]. Size in x, y, and z directions.

  • name (str) – Unique name for monitor.

  • interval_space (tuple[Literal[1], Literal[1], Literal[1]] = (1, 1, 1)) – Number of grid step intervals between monitor recordings. If equal to 1, there will be no downsampling. If greater than 1, the step will be applied, but the first and last point of the monitor grid are always included. Not all monitors support values different from 1.

  • colocate (bool = True) – Toggle whether fields should be colocated to grid cell boundaries (i.e. primal grid nodes).

  • use_colocated_integration (bool = True) – Only takes effect when colocate=False. If True, dot products and overlap integrals still use fields interpolated to grid cell boundaries (colocated), even though the field data is stored at native Yee grid positions. Experimental feature that can give improved accuracy by avoiding interpolation of fields to Yee cell positions for integration.

  • freqs (ArrayLike[dtype=float, ndim=1]) – [units = Hz]. Array or list of frequencies stored by the field monitor.

  • apodization (ApodizationSpec = ApodizationSpec()) – Sets parameters of (optional) apodization. Apodization applies a windowing function to the Fourier transform of the time-domain fields into frequency-domain ones, and can be used to truncate the beginning and/or end of the time signal, for example to eliminate the source pulse when studying the eigenmodes of a system. Note: apodization affects the normalization of the frequency-domain fields.

  • store_fields_direction (Optional[Literal['+', '-']] = None) – Propagation direction for the mode field profiles stored from mode solving.

  • conjugated_dot_product (bool = True) – Use conjugated or non-conjugated dot product for mode decomposition.

  • mode_spec (Union[MicrowaveModeSpec, MicrowaveTerminalModeSpec] = MicrowaveModeSpec()) – Parameters to feed to mode solver which determine modes measured by monitor.

Notes

The fields recorded by frequency monitors (and hence also mode monitors) are automatically normalized by the power amplitude spectrum of the source. For multiple sources, the user can select which source to use for the normalization too.

We can also use the mode amplitudes recorded in the mode monitor to reveal the decomposition of the radiated power into forward- and backward-propagating modes, respectively.

Example

>>> mode_spec = MicrowaveModeSpec(num_modes=3)
>>> monitor = MicrowaveModeMonitor(
...     center=(1,2,3),
...     size=(2,2,0),
...     freqs=[200e12, 210e12],
...     mode_spec=mode_spec,
...     name='mode_monitor')

See also

Notebooks:

Attributes

mode_spec

store_fields_direction

colocate

conjugated_dot_product

use_colocated_integration

freqs

apodization

interval_space

name

size

center