tidy3d.TwoPhotonAbsorption#

class TwoPhotonAbsorption[source]#

Bases: NonlinearModel

Model for two-photon absorption (TPA) nonlinearity which gives an intensity-dependent absorption of the form α=α0+βI. 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 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().

  • 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.

PNL=PTPA+PFCA+PFCPDPTPA=43c02ε02n02β2iω|E|2EPFCA=c0ε0n0σNfiωEdNfdt=83c02ε02n02β8qeω|E|4NfτNe=Nh=NfPFCPD=ε02n0Δn(Nf)EΔn(Nf)=(ceNeee+chNheh)

In these equations, n0 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 E and PNL 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 PNL,x, we approximate |E|2|Ex|2. This approximation is valid when the E field is predominantly polarized along one of the x, y, or z 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

complex_fields

Whether the model uses complex fields.

attrs

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.