# FluxTimeMonitor

Monitor that records power flux through a plane in the time domain.

If the monitor geometry is a 2D box, the total flux through this plane is returned, with a positive sign corresponding to power flow in the positive direction along the axis normal to the plane.

If the geometry is a 3D box, the total power coming out of the box is returned by integrating the flux over all box surfaces (excpet the ones defined in exclude_surfaces).

Note: For a 2D plane, the flux is summed up over all Yee grid pixels that are touched by the plane, rather than integrated over the exact span of the plane. For a 3D monitor, this is also the case, but care is taken to not over- or under-count the power at the edges. Because of this, there can be small discrepancies between using a 3D FluxMonitor and manually placing six 2D monitors at the surface locations.

# Name

name: Unique name for monitor.

Required field

# Size and Position

Specification of the monitor size and position.

# Center + size

Object definition through a center position and size.

center: Center of the object in x, y, and z-directions.

Type: floating-point number

  • Unit: m, μm (default), or nm
  • Default: (0, 0, 0)

size: Size of the object in x, y, and z-directions.

Use Infinity to define a geometry extending to infinity in both directions along an axis.

Type: floating-point number

  • Unit: m, μm (default), or nm
  • Constraint: greater than or equal to 0
  • Required field

# Bounds

Object definition through minimum and maximum coordinate bounds.

min: Values of the x, y, and z coordinates defining the object lower corner.

Type: floating-point number

  • Unit: m, μm (default), or nm
  • Required field

max: Values of the x, y, and z coordinates defining the object upper corner.

Type: floating-point number

  • Unit: m, μm (default), or nm
  • Required field

# Start Time

start: Time at which to start monitor recording.

Type: floating-point number

  • Unit: s (default), ps, or fs
  • Constraint: greater than or equal to 0
  • Default: 0

# Stop Time

stop: Time at which to stop monitor recording.

If not specified, record until end of simulation.

Type: floating-point number

  • Unit: s (default), ps, or fs
  • Constraint: greater than or equal to 0
  • Default: None, which means end of simulation

# Time Interval

interval: Number of time step intervals between monitor recordings.

Type: integer

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

# Downsampling

interval_space: Number of grid step intervals between monitor recordings.

  • If equal to 1, there will be no downsampling.
  • If greater than 1, fields will be downsampled and automatically colocated.

Type: integer

  • Unit: unitless
  • Constraint: greater than 0
  • Default: (1, 1, 1)

# Normal Vector Orientation

normal_dir: Direction of the surface monitor’s normal vector w.r.t. the positive x, y or z unit vectors. Must be one of + or -. Applies to surface monitors only, and defaults to + if not provided.

Options:

  • +
  • -

Default: None, which means

  • None for volume monitors
  • + for surface monitors

# Excluded Surfaces

exclude_surfaces: Surfaces to exclude in the integration, if a volume monitor.

Options: select one or more of

  • x-
  • x+
  • y-
  • y+
  • z-
  • z+

Default: None

← ModeMonitor →