tidy3d.FieldTimeMonitor#

class tidy3d.FieldTimeMonitor#

Monitor that records electromagnetic fields in the time domain.

Parameters
  • center (Tuple[float, float, float] = (0.0, 0.0, 0.0)) – [units = um]. Center of object in x, y, and z.

  • size (Tuple[NonNegativeFloat, NonNegativeFloat, NonNegativeFloat] = None) – [units = um]. Size in x, y, and z directions.

  • name (ConstrainedStrValue = None) – Unique name for monitor.

  • start (NonNegativeFloat = 0.0) – [units = sec]. Time at which to start monitor recording.

  • stop (Optional[NonNegativeFloat] = None) – [units = sec]. Time at which to stop monitor recording. If not specified, record until end of simulation.

  • interval (PositiveInt = 1) – Number of time step intervals between monitor recordings.

  • fields (List[Literal['Ex', 'Ey', 'Ez', 'Hx', 'Hy', 'Hz']] = ['Ex', 'Ey', 'Ez', 'Hx', 'Hy', 'Hz']) – Collection of field components to store in the monitor.

Example

>>> monitor = FieldTimeMonitor(
...     center=(1,2,3),
...     size=(2,2,2),
...     fields=['Hx'],
...     start=1e-13,
...     stop=5e-13,
...     interval=2,
...     name='movie_monitor')

Show JSON schema
{
   "title": "FieldTimeMonitor",
   "description": ":class:`Monitor` that records electromagnetic fields in the time domain.\n\nParameters\n----------\ncenter : Tuple[float, float, float] = (0.0, 0.0, 0.0)\n    [units = um].  Center of object in x, y, and z.\nsize : Tuple[NonNegativeFloat, NonNegativeFloat, NonNegativeFloat] = None\n    [units = um].  Size in x, y, and z directions.\nname : ConstrainedStrValue = None\n    Unique name for monitor.\nstart : NonNegativeFloat = 0.0\n    [units = sec].  Time at which to start monitor recording.\nstop : Optional[NonNegativeFloat] = None\n    [units = sec].  Time at which to stop monitor recording.  If not specified, record until end of simulation.\ninterval : PositiveInt = 1\n    Number of time step intervals between monitor recordings.\nfields : List[Literal['Ex', 'Ey', 'Ez', 'Hx', 'Hy', 'Hz']] = ['Ex', 'Ey', 'Ez', 'Hx', 'Hy', 'Hz']\n    Collection of field components to store in the monitor.\n\nExample\n-------\n>>> monitor = FieldTimeMonitor(\n...     center=(1,2,3),\n...     size=(2,2,2),\n...     fields=['Hx'],\n...     start=1e-13,\n...     stop=5e-13,\n...     interval=2,\n...     name='movie_monitor')",
   "type": "object",
   "properties": {
      "center": {
         "title": "Center",
         "description": "Center of object in x, y, and z.",
         "default": [
            0.0,
            0.0,
            0.0
         ],
         "units": "um",
         "type": "array",
         "minItems": 3,
         "maxItems": 3,
         "items": [
            {
               "type": "number"
            },
            {
               "type": "number"
            },
            {
               "type": "number"
            }
         ]
      },
      "type": {
         "title": "Type",
         "default": "FieldTimeMonitor",
         "enum": [
            "FieldTimeMonitor"
         ],
         "type": "string"
      },
      "size": {
         "title": "Size",
         "description": "Size in x, y, and z directions.",
         "units": "um",
         "type": "array",
         "minItems": 3,
         "maxItems": 3,
         "items": [
            {
               "type": "number",
               "minimum": 0
            },
            {
               "type": "number",
               "minimum": 0
            },
            {
               "type": "number",
               "minimum": 0
            }
         ]
      },
      "name": {
         "title": "Name",
         "description": "Unique name for monitor.",
         "minLength": 1,
         "type": "string"
      },
      "start": {
         "title": "Start time",
         "description": "Time at which to start monitor recording.",
         "default": 0.0,
         "units": "sec",
         "minimum": 0,
         "type": "number"
      },
      "stop": {
         "title": "Stop time",
         "description": "Time at which to stop monitor recording.  If not specified, record until end of simulation.",
         "units": "sec",
         "minimum": 0,
         "type": "number"
      },
      "interval": {
         "title": "Time interval",
         "description": "Number of time step intervals between monitor recordings.",
         "default": 1,
         "exclusiveMinimum": 0,
         "type": "integer"
      },
      "fields": {
         "title": "Field Components",
         "description": "Collection of field components to store in the monitor.",
         "default": [
            "Ex",
            "Ey",
            "Ez",
            "Hx",
            "Hy",
            "Hz"
         ],
         "type": "array",
         "items": {
            "enum": [
               "Ex",
               "Ey",
               "Ez",
               "Hx",
               "Hy",
               "Hz"
            ],
            "type": "string"
         }
      }
   },
   "required": [
      "size",
      "name"
   ],
   "additionalProperties": false
}

Fields

storage_size(num_cells: int, tmesh: tidy3d.components.types.Array) int#

Size of monitor storage given the number of points after discretization.

Parameters
  • num_cells (int) – Number of grid cells within the monitor after discretization by a Simulation.

  • tmesh (Array) – The discretized time mesh of a Simulation.

Returns

Number of bytes to be stored in monitor.

Return type

int