tidy3d.SimulationData#

class SimulationData[source]#

Bases: AbstractYeeGridSimulationData

Stores data from a collection of Monitor objects in a Simulation.

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 an attr obj.attrs['foo'] = bar. Also note that Tidy3D` will raise a TypeError if attrs contain objects that can not be serialized. One can check if attrs are serializable by calling obj.json().
simulation (Simulation) – Original Simulation associated with the data.
data (Tuple[Annotated[Union[tidy3d.components.data.monitor_data.FieldData, tidy3d.components.data.monitor_data.FieldTimeData, tidy3d.components.data.monitor_data.PermittivityData, tidy3d.components.data.monitor_data.ModeSolverData, tidy3d.components.data.monitor_data.ModeData, tidy3d.components.data.monitor_data.FluxData, tidy3d.components.data.monitor_data.FluxTimeData, tidy3d.components.data.monitor_data.FieldProjectionKSpaceData, tidy3d.components.data.monitor_data.FieldProjectionCartesianData, tidy3d.components.data.monitor_data.FieldProjectionAngleData, tidy3d.components.data.monitor_data.DiffractionData], FieldInfo(default=PydanticUndefined, discriminator='type', extra={})], ...]) – List of MonitorData instances associated with the monitors of the original Simulation.
log (Optional[str] = None) – A string containing the log information from the simulation run.
diverged (bool = False) – A boolean flag denoting whether the simulation run diverged.

Notes

The SimulationData objects store a copy of the original Simulation:, so it can be recovered if the SimulationData is loaded in a new session and the Simulation is no longer in memory.

More importantly, the SimulationData contains a reference to the data for each of the monitors within the original Simulation. This data can be accessed directly using the name given to the monitors initially.

Examples

Standalone example:

>>> import tidy3d as td
>>> num_modes = 5
>>> x = [-1,1,3]
>>> y = [-2,0,2,4]
>>> z = [-3,-1,1,3,5]
>>> f = [2e14, 3e14]
>>> coords = dict(x=x[:-1], y=y[:-1], z=z[:-1], f=f)
>>> grid = td.Grid(boundaries=td.Coords(x=x, y=y, z=z))
>>> scalar_field = td.ScalarFieldDataArray((1+1j) * np.random.random((2,3,4,2)), coords=coords)
>>> field_monitor = td.FieldMonitor(
...     size=(2,4,6),
...     freqs=[2e14, 3e14],
...     name='field',
...     fields=['Ex'],
...     colocate=True,
... )
>>> sim = td.Simulation(
...     size=(2, 4, 6),
...     grid_spec=td.GridSpec(wavelength=1.0),
...     monitors=[field_monitor],
...     run_time=2e-12,
...     sources=[
...         td.UniformCurrentSource(
...             size=(0, 0, 0),
...             center=(0, 0.5, 0),
...             polarization="Hx",
...             source_time=td.GaussianPulse(
...                 freq0=2e14,
...                 fwidth=4e13,
...             ),
...         )
...     ],
... )
>>> field_data = td.FieldData(monitor=field_monitor, Ex=scalar_field, grid_expanded=grid)
>>> sim_data = td.SimulationData(simulation=sim, data=(field_data,))

To save and load the SimulationData object.

sim_data.to_file(fname='path/to/file.hdf5') # Save a SimulationData object to a HDF5 file
sim_data = SimulationData.from_file(fname='path/to/file.hdf5') # Load a SimulationData object from a HDF5 file.

See also

Notebooks:

Quickstart: Usage in a basic simulation flow.
Performing visualization of simulation data
Advanced monitor data manipulation and visualization

Attributes

`final_decay_value`	Returns value of the field decay at the final time step.
`data`
`log`	Custom logger to avoid the complexities of the logging module
`attrs`

Methods

`get_adjoint_data`(structure_index, data_type)	Grab the field or permittivity data for a given structure index.
`make_adjoint_sim`(data_vjp_paths, ...)	Make the adjoint simulation from the original simulation and the VJP-containing data.
`make_adjoint_sources`(data_vjp_paths)	Generate all of the non-zero sources for the adjoint simulation given the VJP data.
`renormalize`(normalize_index)	Return a copy of the `SimulationData` with a different source used for the normalization.
`source_spectrum`(source_index)	Get a spectrum normalization function for a given source index.

Inherited Common Usage

tidy3d.components.base.Tidy3dBaseModel.from_file(fname)

Loads a Tidy3dBaseModel from .yaml, .json, .hdf5, or .hdf5.gz file.

simulation#

data#

diverged#

property final_decay_value#: Returns value of the field decay at the final time step.

source_spectrum(source_index)[source]#: Get a spectrum normalization function for a given source index.

renormalize(normalize_index)[source]#: Return a copy of the SimulationData with a different source used for the normalization.

make_adjoint_sim(data_vjp_paths, adjoint_monitors)[source]#: Make the adjoint simulation from the original simulation and the VJP-containing data.

make_adjoint_sources(data_vjp_paths)[source]#: Generate all of the non-zero sources for the adjoint simulation given the VJP data.

get_adjoint_data(structure_index, data_type)[source]#: Grab the field or permittivity data for a given structure index.

__hash__()#: Hash method.

tidy3d.SimulationData

Contents

tidy3d.SimulationData#