tidy3d.TwoPhotonAbsorption#
- class TwoPhotonAbsorption[source]#
Bases:
NonlinearModel
Model for two-photon absorption (TPA) nonlinearity which gives an intensity-dependent absorption of the form
. Also includes free-carrier absorption (FCA) and free-carrier plasma dispersion (FCPD) effects. The expression for the nonlinear polarization is given below.- 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()
.use_complex_fields (bool = False) – Whether to use the old deprecated complex-fields implementation. The default real-field implementation is more physical and is always recommended; this option is only available for backwards compatibility with Tidy3D version < 2.8 and may be removed in a future release.
beta (Union[float, tidycomplex, ComplexNumber] = 0) – [units = um / W]. Coefficient for two-photon absorption (TPA).
tau (NonNegativeFloat = 0) – [units = sec]. Lifetime for the free carriers created by two-photon absorption (TPA).
sigma (NonNegativeFloat = 0) – [units = um^2]. Total cross section for free-carrier absorption (FCA). Contains contributions from electrons and from holes.
e_e (NonNegativeFloat = 1) – Exponent for the free electron refractive index shift in the free-carrier plasma dispersion (FCPD).
e_h (NonNegativeFloat = 1) – Exponent for the free hole refractive index shift in the free-carrier plasma dispersion (FCPD).
c_e (float = 0) – [units = um^(3 e_e)]. Coefficient for the free electron refractive index shift in the free-carrier plasma dispersion (FCPD).
c_h (float = 0) – [units = um^(3 e_h)]. Coefficient for the free hole refractive index shift in the free-carrier plasma dispersion (FCPD).
n0 (Union[tidycomplex, ComplexNumber, NoneType] = None) – Complex linear refractive index of the medium, computed for instance using ‘medium.nk_model’. If not provided, it is calculated automatically using the central frequencies of the simulation sources (as long as these are all equal).
freq0 (Optional[PositiveFloat] = None) – Central frequency, used to calculate the energy of the free-carriers excited by two-photon absorption. If not provided, it is obtained automatically from the simulation sources (as long as these are all equal).
Notes
This model uses real time-domain fields, so
must be real.In these equations,
means the real part of the linear refractive index of the medium.The nonlinear constitutive relation is solved iteratively; it may not converge for strong nonlinearities. Increasing
tidy3d.NonlinearSpec.num_iters
can help with convergence.For complex fields (e.g. when using Bloch boundary conditions), the nonlinearity is applied separately to the real and imaginary parts, so that the above equation holds when both
and are replaced by their real or imaginary parts. The nonlinearity is only applied to the real-valued fields since they are the physical fields.Different field components do not interact nonlinearly. For example, when calculating
, we approximate . This approximation is valid when the field is predominantly polarized along one of thex
,y
, orz
axes.The implementation is described in:
N. Suzuki, "FDTD Analysis of Two-Photon Absorption and Free-Carrier Absorption in Si High-Index-Contrast Waveguides," J. Light. Technol. 25, 9 (2007).
Example
>>> tpa_model = TwoPhotonAbsorption(beta=1)
Attributes
Whether the model uses complex fields.
Methods
Inherited Common Usage
- use_complex_fields#
- beta#
- tau#
- sigma#
- e_e#
- e_h#
- c_e#
- c_h#
- n0#
- freq0#
- property complex_fields#
Whether the model uses complex fields.
- __hash__()#
Hash method.