tidy3d.AuxFieldTimeMonitor#
- class AuxFieldTimeMonitor[source]#
Bases:
AbstractAuxFieldMonitor
,TimeMonitor
Monitor
that records auxiliary fields in the time domain.- Parameters:
attrs (dict = {}) β Dictionary storing arbitrary metadata for a Tidy3D object. This dictionary can be freely used by the user for storing data without affecting the operation of Tidy3D as it is not used internally. Note that, unlike regular Tidy3D fields,
attrs
are mutable. For example, the following is allowed for setting anattr
obj.attrs['foo'] = bar
. Also note that Tidy3D` will raise aTypeError
ifattrs
contain objects that can not be serialized. One can check ifattrs
are serializable by callingobj.json()
.center (Union[tuple[Union[float, autograd.tracer.Box], Union[float, autograd.tracer.Box], Union[float, autograd.tracer.Box]], Box] = (0.0, 0.0, 0.0)) β [units = um]. Center of object in x, y, and z.
size (Union[tuple[Union[pydantic.v1.types.NonNegativeFloat, autograd.tracer.Box], Union[pydantic.v1.types.NonNegativeFloat, autograd.tracer.Box], Union[pydantic.v1.types.NonNegativeFloat, autograd.tracer.Box]], Box]) β [units = um]. Size in x, y, and z directions.
name (ConstrainedStrValue) β Unique name for monitor.
interval_space (Tuple[PositiveInt, PositiveInt, PositiveInt] = (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.
colocate (bool = True) β Toggle whether fields should be colocated to grid cell boundaries (i.e. primal grid nodes).
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 (Optional[PositiveInt] = None) β Sampling rate of the monitor: number of time steps between each measurement. Set
interval
to 1 for the highest possible resolution in time. Higher integer values downsample the data by measuring everyinterval
time steps. This can be useful for reducing data storage as needed by the application.fields (Tuple[Literal['Nfx', 'Nfy', 'Nfz'], ...] = ()) β Collection of auxiliary field components to store in the monitor. Auxiliary fields which are not present in the simulation will be zero.
models. (Auxiliary fields are used in certain nonlinear material)
:param
TwoPhotonAbsorption
uses Nfx: :param Nfy: :param and Nfz for the: :param free-carrier density.:Example
>>> monitor = AuxFieldTimeMonitor( ... center=(1,2,3), ... size=(0,0,0), ... fields=['Nfx'], ... start=1e-13, ... stop=5e-13, ... interval=2, ... colocate=True, ... name='aux_monitor')
Attributes
Methods
storage_size
(num_cells,Β tmesh)Size of monitor storage given the number of points after discretization.
Inherited Common Usage
- storage_size(num_cells, tmesh)[source]#
Size of monitor storage given the number of points after discretization.
- __hash__()#
Hash method.