importGS(energydat::AbstractString, tdm_dat::AbstractString)
Export Data
Overview
Misc.
WaveMixings.save_matrix_file — Function
save_matrix_file(matrix::AbstractMatrix{T}, file_out::AbstractString) where {T <: Real}Save commputed Matrix to a file in the current directory. This function will replace (delete) any other file with the same name.
Arguments
matrix: numerical matrix.file_out: output file to be written.
Returns
Safe matrix to file.
WaveMixings.save_vector_file — Function
save_vector_file(vector::AbstractVector{T}, file_out::AbstractString) where {T <: Real}Save commputed Vector to a file in the current directory. This function will replace (delete) any other file with the same name.
Arguments
vector: numerical vector.file_out: output file to be written.
Returns
Safe vector to file.
Misc.
WaveMixings.import_GS — Function
import_GS(energy_dat::AbstractString, tdm_dat::AbstractString)Imports the data (energies and transition dipole moments) from surface-hopping simulations. The output of this function needs to be orientational averaged before being passed to the gs function to calculate the signal. Note: GSB simulations are stable but we filter the time steps for all imported files, just to be sure. THIS IS NOT THE CASE FOR SE.
Arguments
energy_dat: name of the input data containing energies.tdm_dat: name of the input data containing transition dipole moments.
Returns
WaveMixingcomposition (struct) containingenergyandrigh_tdm
parameters(2D array). This is the minimal input data for the pump-probe signal estimation.
WaveMixings.import_SE — Function
import_SE(energy_dat::AbstractString, tdm_dat::AbstractString)Imports the data (energies and transition dipole moments) from surface-hopping simulations. The output of this function needs to be orientational averaged before being passed to the se function to calculate the signal. This function is for importing data of the stimulated emission i.e. Excited State Dynamics. Note: SE simulations might be unstable, thus we filter the time steps to be extra cautious of the results.
Arguments
energy_dat: name of the input data containing energies.tdm_dat: name of the input data containing transition dipole moments.
Returns
WaveMixingcomposition (struct) containingenergyandrigh_tdm
parameters(2D array). This is the minimal input data for the pump-probe signal estimation.
WaveMixings.import_ESA — Function
import_ESA(energy_dat::AbstractString, tdm_dat::AbstractString)Imports the data (energies and transition dipole moments) from surface-hopping simulations. The output of this function needs to be orientational averaged before being passed to the esa function to calculate the signal. i.e. Excited State Absorption. Note: ESA simulations might be unstable, thus we filter the time steps to be extra cautious of the results.
In future the function could be update to be form closures.
Arguments
energy_dat: name of the input data containing energies.tdm_dat: name of the input data containing transition dipole moments.active_states: Array with states.
Returns
WaveMixingcomposition (struct) containingenergyandrigh_tdm
parameters(2D array). This is the minimal input data for the pump-probe signal estimation.
WaveMixings.extract_data_gs — Function
extract_data_gs(input_trajectory::AbstractString)Extract the data (energies and dipoles) from the simulation output, to later estimate the pump probe signal. The output of this function can be past directly to the signal_pp function to calculate the signal. This function also test whether the input file exist.
In future the function could be update to be form closures.
Arguments
input_trajectory: name of the input data, i.e. the output of dynamics.
Returns
WaveMixingcomposition (struct) containingenergyandoscillators
parameters(2D array). This is the minimal input data for the pump-probe signal estimation.
extract_data_gs(energy_dat::AbstractString, oscillator_dat::AbstractString,
hopping_softw::Symbol = :zh)Extract the data (energies and dipoles) from the simulation output folder, to later estimate the pump probe signal. The output of this function can be passed directly to the gs function to calculate the signal. This function test whether the input files exist, and assuming that most files are within the folder where energy_dat is, it tries to load data from dipole_xyz.dat (xyz_dipole), left_dipole.dat (left_tdm), right_dipole.dat (righ_tdm), angmom_xyx.dat (xyz_angmom), left_angmom.dat (left_angmom), and right_angmom.dat (righ_angmom). Note: GSB simulations are stable so we filter the time steps for all imported files. THIS IS NOT THE CASE FOR SE.
Arguments
energy_dat: name of the input data containing energies.oscillator_dat: name of the input data containing oscillators.hopping_softw: keyword decribing the surface hopping software of the
simulations. :zg - ZagHop, :nx - Newton-X, and :sh - SHARC.
Returns
WaveMixingcomposition (struct) containingenergyandoscillators
parameters(2D array). This is the minimal input data for the pump-probe signal estimation. If the more data files are available, WaveMixing might contain xyz_dipole, left_tdm, righ_tdm, xyz_angmom, left_angmom, righ_angmom.
WaveMixings.extract_data_se — Function
extract_data_se(input_trajectory::AbstractString)Extract the data (energies and dipoles) from the simulation output, to later estimate the pump probe signal. The output of this function can be passed directly to the se function to calculate the signal. This function also test whether the input file exist. This function is mainly done for better understanding of the extraction data of the stimulated emission i.e. Excited State Dynamics.
In future the function could be update to be form closures.
Arguments
input_trajectory: name of the input data, i.e. the output of
dynamics.
Returns
WaveMixingcomposition (struct) containingenergyandoscillators
parameters(2D array). This is the minimal input data for the pump-probe signal estimation.
extract_data_se(energy_dat::AbstractString, oscillator_dat::AbstractString,
hopping_softw::Symbol = :zh)Extract the data (energies and dipoles) from the simulation output, to later estimate the pump probe signal. The output of this function can be passed directly to the se function to calculate the signal. This function test whether the input files exist, and assuming that most files are within the folder where energy_dat is, it tries to load data from dipole_xyz.dat (xyz_dipole), left_dipole.dat (left_tdm), right_dipole.dat (righ_tdm), angmom_xyx.dat (xyz_angmom), left_angmom.dat (left_angmom), and right_angmom.dat (righ_angmom). This function is for the extraction data of the stimulated emission i.e. Excited State Dynamics. Note: SE simulations might be unstable so we DO NOT filter the time steps for extra imported files (right..., left..., angmom...). DO THIS LATER AFTER IMPORTING with clean_time_steps
In future the function could be update to be form closures.
Arguments
energy_dat: name of the input data containing energies.oscillator_dat: name of the input data containing oscillators.hopping_softw: keyword decribing the surface hopping software of the
simulations. :zg - ZagHop, :nx - Newton-X, and :sh - SHARC.
Returns
WaveMixingcomposition (struct) containingenergyandoscillators
parameters(2D array). This is the minimal input data for the pump-probe signal estimation. If the more data files are available, WaveMixing might contain xyz_dipole, left_tdm, righ_tdm, xyz_angmom, left_angmom, righ_angmom.
WaveMixings.extract_data_esa — Function
extract_data_esa(energy_dat::AbstractString, oscillator_dat::AbstractString,
active_states::AbstractVector{Real},
hopping_softw::Symbol = :zh)Extract the data (energies and oscillators) from the simulation output, to later estimate the pump probe signal. The output of this function can be passed directly to the esa function to calculate the signal. This function test whether the input files exist, and assuming that most files are within the folder where energy_dat is, it tries to load data from dipole_xyz.dat (xyz_dipole), left_dipole.dat (left_tdm), right_dipole.dat (righ_tdm), angmom_xyx.dat (xyz_angmom), left_angmom.dat (left_angmom), and right_angmom.dat (righ_angmom). This function is for the extraction data of the excited state absorption i.e. Excited State Absorption. Note: ESA simulations might be unstable so we DO NOT filter the time steps for extra imported files (right..., left..., angmom...). DO THIS LATER AFTER IMPORTING with clean_time_steps
In future the function could be update to be form closures.
Arguments
energy_dat: name of the input data containing energies.oscillator_dat: name of the input data containing oscillators.active_states: Array with states.hopping_softw: keyword decribing the surface hopping software of the
simulations. :zg - ZagHop, :nx - Newton-X, and :sh - SHARC.
Returns
WaveMixingcomposition (struct) containingenergyandoscillators
parameters(2D array). This is the minimal input data for the pump-probe signal estimation. If the more data files are available, WaveMixing might contain xyz_dipole, left_tdm, righ_tdm, xyz_angmom, left_angmom, righ_angmom.
extract_data_esa(active_states::Vector{Float64}, input_trajectory::AbstractString)Extract the data (energies and dipoles) from the simulation output, to later estimate the pump probe signal. The output of this function can be passed directly to the esa function to calculate the signal. This function also test whether the input file exist. This function is mainly done for better understanding of the extraction data of the excited state absorption i.e. Excited State Absorption.
In future the function could be update to be form closures.
Arguments
active_states: array (vector) listing the active state in a
determined time step.
input_trajectory: name of the input data, i.e. the output of
dynamics.
Returns
WaveMixingcomposition (struct) containingenergyandoscillators
parameters(2D array). This is the minimal input data for the pump-probe signal estimation.
WaveMixings.read_matrix_file — Function
read_matrix_file(file_in::AbstractString)Read file containing a Matrix. This function is for debug and testing, therefore it makes many assumption. For example only numerical matrix separated by by tabs (`/t).
Arguments
file_in: input file with written matrix.
Returns
Matrix from file.
WaveMixings._compute_integral — Method
_compute_integralnew(self::WaveMixing, Τ::Real)Execute the numerical integration of the integral in the chirp function for values stored in self.
Arguments
WaveMixing: composite containing theχparameter.Τ: pulse length.
Returns
Numerical solution of an integral using the Simmson's method for each value of a given element stored in self.
WaveMixings._compute_integral_lgc — Method
_compute_integral_lgc(self::WaveMixing, Τ::Real)Numerical solution of the integral in the chirp function. This functions needs optimisation.
Arguments
WaveMixing: composite containing theχparameter.Τ: pulse length.
Returns
Chirp contribution to the chirped spectrum energy.
WaveMixings._compute_signal — Method
_compute_signal(energy::AbstractMatrix{T}, self::WaveMixing) where {T <: Real}Internal function. Calculation of the signal from the spectrum energy.
Arguments
energy: spectrum energy.WaveMixing: composite containing theμparameter.μrepresents the
transition dipole moments.
Returns
Spectrum energy.
WaveMixings._coupling_overtime — Method
_coupling_overtime(self::WaveMixing)Internal function. Calculation of the coupling strength as function of time
Arguments
WaveMixing: composite containing theγ_0andχparameter.γ_0
represents the initial coupling strength.
Returns
Coupling strengths.
WaveMixings._spectrum_energy_fourier — Method
_spectrum_energy_fourier(Δω::AbstractMatrix{T}, Τ::T, WaveMixing) where {T <: Real}Internal function. Calculation of the spectrum energy in the frequency domain rather than in the time domain. Implemented methods are: :gaus, :lore, :assh, :chir, and :sech.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.WaveMixing: composite containingmethod,dispersion,D2andD3parameters.
method by default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.
Returns
Spectrum energy.
WaveMixings.asymm_secant_spectral — Method
asymm_secant_spectral(WaveMixing, Τ::Real)
asymm_secant_spectral(Δω::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Asymmetric hyperbolic secant.
Arguments
WaveMixing: composite containing theΔωparameter.Τ: pulse length.Δω: energy difference with the pulse.
Returns
Spectrum energy.
WaveMixings.chirp_spectral — Method
chirp_spectral(self::WaveMixing Τ::Real)Calculation of the spectrum energy in the frequency domain rather than in the time domain. Chirped spectrum energy.
Arguments
WaveMixing: composite containing theχparameter.Τ: pulse length.
Returns
Spectrum energy with chirp function.
WaveMixings.esa — Method
esa(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Absorption Dynamics.
Arguments
probe: probe pulse energies.WaveMixing: composite containingoscillators,methodandenergiesparameters.Τ: pulse length.
Returns
Calculates window and updates the WaveMixing composite (ESA) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Window formula (see Ref. [1] formula 60) of the excited-state absorption (ESA) reads:
\[W_{II}^{int}(\omega_{pr},\boldsymbol{R}_{e},\boldsymbol{P}_{e}) = \sum_{f}^{ } E_{pr}^{2}(\omega_{pr}-U_{fe(T)}(\boldsymbol{R}_{e})) \left| (\boldsymbol{\mu}_{e(T)t}(\boldsymbol{R}_{e}) \right|^{2} \]
Cite
WaveMixings.esa_cavity! — Method
esa_cavity!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Absorption Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.probe: probe pulse energies.Τ: pulse length.
Returns
Calculates window and updates the WaveMixing composite (ESA) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
See also gsb_cavity!, and se_cavity!.
WaveMixings.esa_cavity_lgc! — Method
esa_cavity_lgc!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Absorption Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.probe: probe pulse energies.Τ: pulse length.
Returns
Calculates window and updates the WaveMixing composite (ESA) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
See also gsb_cavity!, and se_cavity_lgc!.
WaveMixings.esa_dispersion — Method
esa_dispersion(probe::T, dispersion::AbstractMatrix{T}, Τ::T,
self::WaveMixing, dephase::T=0.01) where {T <: Real}Calculates the dispersed signal (eq. 64 in Gelin JCTC, 2394. 2021) from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Absorption Dynamics.
Arguments
probe: a probe pulse energy.dispersion: array of dispersion energies.Τ: pulse length.WaveMixing: composite containingoscillators,methodandenergiesparameters.dephase: dephasing parameter. the default gives 66 fs.
Returns
Calculates dispersed window and updates the WaveMixing composite (ESA) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the dispersed Window (window) transient-absorption pump-probe signal, which derives from performing the Fourier transform to the integral pump-probe signal (see esa) with respect to $\tau_{t}$. The dispersed pump-probe signal is sensitive to electronic dephasing ($\lambda$), a parameter of this function.
The corresponding dispersed Window formula (see Ref. [1] formula 64) of the excited-state absorption (ESA) reads:
\[W_{\mathrm{II}}^{dis}(\omega_{pr},\omega,\boldsymbol{R}_{e}(T),\boldsymbol{P}_{e}(T)) = E_{pr}^{2}(\omega-\omega_{pr}) \sum_{f}\frac{\nu}{\nu^{2}+(\omega-\omega_{fe(T)}(\boldsymbol{R}_{e}(T)))^{2}} |\mu_{e(T)f}(\boldsymbol{R}_{e}(T))|^{2}\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also gsb_dispersion and se_dispersion.
WaveMixings.esa_dispersion_lgc — Method
esa_dispersion_lgc(probe::T, dispersion::AbstractMatrix{T}, Τ::T,
self::WaveMixing, dephase::T=0.01) where {T <: Real}Calculates the dispersed signal (eq. 64 in Gelin JCTC, 2394. 2021) from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Absorption Dynamics.
Arguments
probe: a probe pulse energy.dispersion: array of dispersion energies.Τ: pulse length.WaveMixing: composite containingoscillators,methodandenergiesparameters.dephase: dephasing parameter. the default gives 66 fs.
Returns
Calculates dispersed window and updates the WaveMixing composite (ESA) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the dispersed Window (window) transient-absorption pump-probe signal, which derives from performing the Fourier transform to the integral pump-probe signal (see esa) with respect to $\tau_{t}$. The dispersed pump-probe signal is sensitive to electronic dephasing ($\lambda$), a parameter of this function.
The corresponding dispersed Window formula (see Ref. [1] formula 64) of the excited-state absorption (ESA) reads:
\[W_{\mathrm{II}}^{dis}(\omega_{pr},\omega,\boldsymbol{R}_{e}(T),\boldsymbol{P}_{e}(T)) = E_{pr}^{2}(\omega-\omega_{pr}) \sum_{f}\frac{\nu}{\nu^{2}+(\omega-\omega_{fe(T)}(\boldsymbol{R}_{e}(T)))^{2}} |\mu_{e(T)f}(\boldsymbol{R}_{e}(T))|^{2}\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also gsb_dispersion and se_dispersion.
WaveMixings.esa_lgc — Method
esa_lgc(probe:AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}LEGACY Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Absorption Dynamics.
Arguments
probe: probe pulse energies.WaveMixing: composite containingoscillators,methodandenergiesparameters.Τ: pulse length.
Returns
Calculates window and updates the WaveMixing composite (ESA) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Window formula (see Ref. [1] formula 60) of the excited-state absorption (ESA) reads:
\[W_{II}^{int}(\omega_{pr},\boldsymbol{R}_{e},\boldsymbol{P}_{e}) = \sum_{f}^{ } E_{pr}^{2}(\omega_{pr}-U_{fe(T)}(\boldsymbol{R}_{e})) \left| (\boldsymbol{\mu}_{e(T)t}(\boldsymbol{R}_{e}) \right|^{2} \]
Cite
WaveMixings.esa_strong — Method
esa_strong(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the strong field Window from energies, oscillator strengths, and the probe laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Absorption Dynamics.
Arguments
probe: probe pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Strong field ESA Window, matrix.
Description
This function estimates the strong field (window) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the excited state absorption (ESA) reads:
\[\]
Cite
[1] XX et.al. J. Chem. Phys.XXXX, X, XXXX
See also Δgsb_strong, gsb_strong, Δse_strong, and se_strong.
WaveMixings.esa_strong_lgc — Method
esa_strong_lgc(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the strong field Window from energies, oscillator strengths, and the probe laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Absorption Dynamics.
Arguments
probe: probe pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Strong field ESA Window, matrix.
Description
This function estimates the strong field (window) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the excited state absorption (ESA) reads:
\[\]
Cite
[1] XX et.al. J. Chem. Phys.XXXX, X, XXXX
See also Δgsb_strong, gsb_strong, Δse_strong, and se_strong.
WaveMixings.gaussian_spectral — Method
gaussian_spectral(WaveMixing, Τ::Real)
gaussian_spectral(Δω::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain.
Arguments
WaveMixing: composite containing theΔωparameter.Τ: pulse length.Δω: energy difference with the pulse.
Returns
Spectrum energy.
WaveMixings.gaussian_spectral_flex — Method
gaussian_spectral_flex(self::WaveMixing, Τ::T, τ_ν::T=0.05) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Includes spectrum changes by broadening the signal. Use calculating the Window function of the 2D-FLEX signal.
Arguments
WaveMixing: composite containing theΔωparameter.Τ: pulse length.τ_ν: inhomogeneous broadening parameter, the default gives 0.05 eV.
Returns
Spectrum energy 2D-FLEX window function
WaveMixings.gsb — Method
gsb(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Ground State Dynamics.
Arguments
probe: probe pulse energies.Τ: pulse length.WaveMixing: composite containingoscillators,methodandenergiesparameters.
Returns
Calculates window and updates the WaveMixing composite (GS) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Window formula (see Ref. [1] formula 58) of the ground state bleach (GSB) reads:
\[W_{0}^{int}(\omega_{pr},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = \sum_{e}^{ } E_{pr}^{2}(\omega_{pr}-U_{eg}(\boldsymbol{R}_{g})) \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2}\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also gsb, and gsb_strong.
WaveMixings.gsb_dispersion — Method
gsb_dispersion(probe::T, dispersion::AbstractMatrix{T}, Τ::T,
self::WaveMixing, dephase::T=0.01) where {T <: Real}Calculates the dispersed signal (eq. 62 in Gelin JCTC, 2394. 2021) from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Ground State Dynamics.
Arguments
probe: a probe pulse energy.dispersion: array of dispersion energies.Τ: pulse length.WaveMixing: composite containingoscillators,methodandenergiesparameters.dephase: dephasing parameter. the default gives 66 fs.
Returns
Calculates dispersed window and updates the WaveMixing composite (GS) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the dispersed Window (window) transient-absorption pump-probe signal, which derives from performing the Fourier transform to the integral pump-probe signal (see gsb) with respect to $\tau_{t}$. The dispersed pump-probe signal is sensitive to electronic dephasing ($\lambda$), a parameter of this function.
The corresponding dispersed Window formula (see Ref. [1] formula 62) of the ground state bleach (GSB) reads:
\[W_{0}^{dis}(\omega_{pr},\omega,\boldsymbol{R}_{g}(T),\boldsymbol{P}_{g}(T)) = E_{pr}^{2}(\omega-\omega_{pr}) \sum_{e}\frac{\nu}{\nu^{2}+(\omega-\omega_{eg}(\boldsymbol{R}_{g}(T)))^{2}} |\mu_{ge}(\boldsymbol{R}_{g}(T))|^{2}\]
Cite
[1] Gelin et.al. J.Chem. Theory Comput.2021, 17, 2394−2408
See also se_dispersion and esa_dispersion.
WaveMixings.gsb_strong — Method
gsb_strong(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the strong field Window from energies, oscillator strengths, and the probe laser amplitude as input.The inputs must be 1D Array, i.e. vectors. Use with Ground State Dynamics.
Arguments
probe: probe pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Strong field GSB Window, matrix.
Description
This function estimates the strong field (window) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the ground state bleach (GSB) reads:
\[\]
Cite
[1] XX et.al. J. Chem. Phys.XXXX, X, XXXX
See also Δgsb_strong, Δse_strong, se_strong, and esa_strong.
WaveMixings.lorentzian_spectral — Method
lorentzian_spectral(WaveMixing, Τ::Real)
lorentzian_spectral(Δω::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain.
Arguments
WaveMixing: composite containing theΔωparameter.Τ: pulse length.Δω: energy difference with the pulse.
Returns
Spectrum energy.
WaveMixings.oscillator_to_dipole — Method
oscillator_to_dipole(WaveMixing)Converts the oscillator strenght to dipole moment.
Arguments
WaveMixing: composite containingoscillatorsandΔEparameters
Returns
Dipole moments.
WaveMixings.rabi_freq — Method
rabi_freq(probe::AbstractMatrix{T}, self::WaveMixing) where {T <: Real}Calculates the Rabi frequency of the probe pulse.
Arguments
probe: probe pulse energy.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Rabi frequency of the probe laser.
WaveMixings.rectangular_spectral — Method
rectangular_spectral(WaveMixing, Τ::Real)
rectangular_spectral(Δω::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Rectangular.
Arguments
WaveMixing: composite containing theΔωparameter.Τ: pulse length.Δω: energy difference with the pulse.
Returns
Spectrum energy.
WaveMixings.se — Method
se(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
probe: probe pulse energies.Τ: pulse length.WaveMixing: composite containingoscillators,methodandenergiesparameters.
Returns
Calculates window and updates the WaveMixing composite (SE) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Window formula (see Ref. [1] formula 59) of the stimulated emission (SE) reads:
\[W_{I}^{int}(\omega_{pr},\boldsymbol{R}_{e},\boldsymbol{P}_{e}) = E_{pr}^{2}(\omega_{pr}-U_{e(T)g}(\boldsymbol{R}_{e})) \left| (\boldsymbol{\mu}_{ge(T)}(\boldsymbol{R}_{e}) \right|^{2} \]
Cite
WaveMixings.se_dispersion — Method
se_dispersion(probe::T, dispersion::AbstractMatrix{T}, Τ::T,
self::WaveMixing, dephase::T=0.01 ) where {T <: Real}Calculates the dispersed signal (eq. 63 in Gelin JCTC, 2394. 2021) from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
probe: a probe pulse energy.dispersion: array of dispersion energies.WaveMixing: composite containingoscillators,methodandenergiesparameters.Τ: pulse length.dephase: dephasing parameter. the default gives 66 fs.
Returns
Calculates dispersed window and updates the WaveMixing composite (SE) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the dispersed Window (window) transient-absorption pump-probe signal, which derives from performing the Fourier transform to the integral pump-probe signal (see se) with respect to $\tau_{t}$. The dispersed pump-probe signal is sensitive to electronic dephasing ($\lambda$), a parameter of this function.
The corresponding dispersed Window formula (see Ref. [1] formula 63) of the stimulated emission (SE) reads:
\[W_{\mathrm{I}}^{dis}(\omega_{pr},\omega,\boldsymbol{R}_{e}(T),\boldsymbol{P}_{e}(T)) = E_{pr}^{2}(\omega-\omega_{pr})\frac{\nu}{\nu^{2}+(\omega-\omega_{e(T)g}(\boldsymbol{R}_{e}(T)))^{2}} |\mu_{ge(T)}(\boldsymbol{R}_{e}(T))|^{2}\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also gsb_dispersion and esa_dispersion.
WaveMixings.se_dispersion_lgc — Method
se_dispersion_lgc(probe::T, dispersion::AbstractMatrix{T}, Τ::T,
self::WaveMixing, dephase::T=0.01 ) where {T <: Real}LEGACY Calculates the dispersed signal (eq. 63 in Gelin JCTC, 2394. 2021) from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
probe: a probe pulse energy.dispersion: array of dispersion energies.WaveMixing: composite containingoscillators,methodandenergiesparameters.Τ: pulse length.dephase: dephasing parameter. the default gives 66 fs.
Returns
Calculates dispersed window and updates the WaveMixing composite (SE) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the dispersed Window (window) transient-absorption pump-probe signal, which derives from performing the Fourier transform to the integral pump-probe signal (see se) with respect to $\tau_{t}$. The dispersed pump-probe signal is sensitive to electronic dephasing ($\lambda$), a parameter of this function.
The corresponding dispersed Window formula (see Ref. [1] formula 63) of the stimulated emission (SE) reads:
\[W_{\mathrm{I}}^{dis}(\omega_{pr},\omega,\boldsymbol{R}_{e}(T),\boldsymbol{P}_{e}(T)) = E_{pr}^{2}(\omega-\omega_{pr})\frac{\nu}{\nu^{2}+(\omega-\omega_{e(T)g}(\boldsymbol{R}_{e}(T)))^{2}} |\mu_{ge(T)}(\boldsymbol{R}_{e}(T))|^{2}\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also gsb_dispersion and esa_dispersion.
WaveMixings.se_fluorescence! — Method
se_fluorescence!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates the fluorescence signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.probe: probe pulse energies.Τ: pulse length.
Returns
Calculates fluorescence window and updates the WaveMixing composite (SE) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding fluorescence formula (see Ref. [1] formula 22) of the stimulated emission (SE) reads:
\[S_{\alpha}^{TRF}(T,\omega_{t}) \sim \omega_{pu}\omega_{t}^{3} \left\langle D^{TFR}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})W_{\mathrm{I}}^{TFR}(\omega_{t},\boldsymbol{R}(T),\boldsymbol{P}(T))\right\rangle\]
Cite
[1] Xu et.al. J. Chem. Phys.2024, 160, 104109
See also se, and se_strong_fluorescence!.
WaveMixings.se_fluorescence_lgc! — Method
se_fluorescence_lgc!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates the fluorescence signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.probe: probe pulse energies.Τ: pulse length.
Returns
Calculates fluorescence window and updates the WaveMixing composite (SE) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding fluorescence formula (see Ref. [1] formula 22) of the stimulated emission (SE) reads:
\[S_{\alpha}^{TRF}(T,\omega_{t}) \sim \omega_{pu}\omega_{t}^{3} \left\langle D^{TFR}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})W_{\mathrm{I}}^{TFR}(\omega_{t},\boldsymbol{R}(T),\boldsymbol{P}(T))\right\rangle\]
Cite
[1] Xu et.al. J. Chem. Phys.2024, 160, 104109
See also se, and se_strong_fluorescence!.
WaveMixings.se_lgc — Method
se_lgc(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}LEGACY Calculates the signal from energies and oscillator strengths as input. The inputs must be 2D Array, i.e. Matrix. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
probe: probe pulse energies.Τ: pulse length.WaveMixing: composite containingoscillators,methodandenergiesparameters.
Returns
Calculates window and updates the WaveMixing composite (SE) with it. (Matrix with n-probe columns, one column has all sums for one probe pulse energy).
Description
This function estimates the Window (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Window formula (see Ref. [1] formula 59) of the stimulated emission (SE) reads:
\[W_{I}^{int}(\omega_{pr},\boldsymbol{R}_{e},\boldsymbol{P}_{e}) = E_{pr}^{2}(\omega_{pr}-U_{e(T)g}(\boldsymbol{R}_{e})) \left| (\boldsymbol{\mu}_{ge(T)}(\boldsymbol{R}_{e}) \right|^{2} \]
Cite
WaveMixings.se_strong — Method
se_strong(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculates the strong field Window from energies, oscillator strengths, and the probe laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
probe: probe pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Strong field SE Window, matrix.
Description
This function estimates the strong field (window) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the stimulated emission (SE) reads:
\[\]
Cite
[1] XX et.al. J. Chem. Phys.XXXX, X, XXXX
See also Δgsb_strong, gsb_strong, Δse_strong, and esa_strong.
WaveMixings.se_strong_fluorescence! — Method
se_strong_fluorescence!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates the strong field fluorescence from energies, oscillator strengths, and the probe laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containing theλparameter.λis the pump laser amplitude.probe: probe pulse energy.Τ: pulse length.
Returns
Strong field SE fluorescence, matrix.
Description
This function estimates the strong fluorescence (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding fluorescence formula (see Ref. [1] formula 22) of the stimulated emission (SE) reads:
\[S_{\alpha}^{TRF}(T,\omega_{t}) \sim \omega_{pu}\omega_{t}^{3} \left\langle D^{TFR}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})W_{\mathrm{I}}^{TFR}(\omega_{t},\boldsymbol{R}(T),\boldsymbol{P}(T))\right\rangle\]
the strong field Window formula (see Ref. [2] formula XX) of the stimulated emission (SE):
\[\]
Cite
[1] Xu et.al. J. Chem. Phys.2024, 160, 104109 [2] Hefen et.al. XX 2025, XX
See also se, and se_fluorescence!.
WaveMixings.se_strong_fluorescence_lgc! — Method
se_strong_fluorescence_lgc!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}LEGACY Calculates the strong field fluorescence from energies, oscillator strengths, and the probe laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containing theλparameter.λis the pump laser amplitude.probe: probe pulse energy.Τ: pulse length.
Returns
Strong field SE fluorescence, matrix.
Description
This function estimates the strong fluorescence (window) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding fluorescence formula (see Ref. [1] formula 22) of the stimulated emission (SE) reads:
\[S_{\alpha}^{TRF}(T,\omega_{t}) \sim \omega_{pu}\omega_{t}^{3} \left\langle D^{TFR}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})W_{\mathrm{I}}^{TFR}(\omega_{t},\boldsymbol{R}(T),\boldsymbol{P}(T))\right\rangle\]
the strong field Window formula (see Ref. [2] formula XX) of the stimulated emission (SE):
\[\]
Cite
[1] Xu et.al. J. Chem. Phys.2024, 160, 104109 [2] Hefen et.al. XX 2025, XX
See also se, and se_fluorescence!.
WaveMixings.se_strong_lgc — Method
se_strong_lgc(probe::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}LEGACY Calculates the strong field Window from energies, oscillator strengths, and the probe laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
probe: probe pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Strong field SE Window, matrix.
Description
This function estimates the strong field (window) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the stimulated emission (SE) reads:
\[\]
Cite
[1] XX et.al. J. Chem. Phys.XXXX, X, XXXX
See also Δgsb_strong, gsb_strong, Δse_strong, and esa_strong.
WaveMixings.secant_spectral — Method
secant_spectral(WaveMixing, Τ::Real)
secant_spectral(Δω::AbstractMatrix{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Hyperbolic secant.
Arguments
WaveMixing: composite containing theΔωparameter.Τ: pulse length.Δω: energy difference with the pulse.
Returns
Spectrum energy.
WaveMixings.second_order_dispersion — Method
second_order_dispersion(self::WaveMixing)Deprecated. Estimates the effect of the group delay dispersion (GDD, sometimes called 2nd-order dispersion) of an optical element, this is a quantitative measure for chromatic dispersion. It is defined as the derivative of the group delay, or the second derivative of the change in spectral phase, with respect to the angular optical frequency. More at: https://www.rp-photonics.com/groupdelaydispersion.html
Arguments
Δω: energy difference with the pulse.D2: 2nd-order dispersion, fs^2.
Returns
Spectrum energy.
WaveMixings.spectrum_energy_fourier — Method
spectrum_energy_fourier(WaveMixing, Τ::Real)Calculation of the spectrum energy in the frequency domain rather than in the time domain. Implemented methods are: :gaus, :lore, :assh, and :sech.
Arguments
WaveMixing: composite containingD2,D3,D4,D5,Δωandmethodparameters.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available. D# are thenth-order dispersion coefficients.Τ: pulse length.
Returns
Spectrum energy.
WaveMixings.third_order_dispersion — Method
third_order_dispersion(self::WaveMixing)Deprecated. Estimates the total effect of the third order dispersion (TOD) of an optical element, this is a quantitative measure for chromatic dispersion. Third-order dispersion results from the frequency dependence of the group delay dispersion (GDD). It is defined as the second derivative of the group delay, or the third derivative of the change in spectral phase, with respect to the angular optical frequency. In mode-locked lasers for pulse durations below roughly 30 fs, it is necessary to provide dispersion compensation not only for the average group delay dispersion (2nd-order dispersion), but also for the third-order dispersion and possibly for even higher orders.
In many cases, the investigation of the effect of third-order dispersion requires numerical pulse propagation modeling. More at: https://www.rp-photonics.com/thirdorderdispersion.html
Arguments
Δω: energy difference with the pulse.D3: 3rd-order dispersion, fs^3.
Returns
Spectrum energy.
WaveMixings.ΔEnergy_excitations — Method
ΔEnergy_excitations(WaveMixing)Calculates de energy difference between the initial energy and the excited energy. It assumes that the input data is a Matrix, where the initial energy is in the second row of each column.
Arguments
WaveMixing: composite containingenergiesparameter.
Returns
ΔE of each excited energy.
WaveMixings._cavity_eigenenergy! — Method
_cavity_eigenenergy!(σ_e::AbstractVector{T}, V_e::AbstractVector{T},
Ω_e::AbstractVector{T}, self::WaveMixing) where {T <: Real}
_cavity_eigenenergy!(σ_e::AbstractMatrix{T}, V_e::AbstractMatrix{T},
Ω_e::AbstractMatrix{T}, self::WaveMixing) where {T <: Real}Internal function. Calculates cavity eigen values.
Arguments
σ_e: cavity eigen values.V_e: electronic energies.Ω_e: Rabi frequency of the cavity.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Cavity eigen values.
WaveMixings._cavity_eigenenergy — Method
_cavity_eigenenergy(V_e::T, Ω_e::T, self::WaveMixing) where {T <: Real}Internal function. Calculates cavity eigen values.
Arguments
V_e: electronic energies.Ω_e: Rabi frequency of the cavity.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Cavity eigen values.
WaveMixings._compute_integral — Method
_compute_integral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}
_compute_integral(Δω::AbstractVector{T}, Τ::T, self::WaveMixing) where {T <: Real}Execute the numerical integration of the integral in the chirp function for the Array Δω.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.WaveMixing: composite containing theχparameter.
Returns
Numerical solution of an integral using the Simmson's method for each value of the Array Δω.
WaveMixings._compute_integral_lgc — Method
_compute_integral_lgc(Δω::AbstractVector{T}, Τ::T, self::WaveMixing) where {T <: Real}Numerical solution of the integral in the chirp function. This function needs optimisation.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.WaveMixing: composite containing theχparameter.
Returns
Chirp contribution to the chirped spectrum energy.
WaveMixings._compute_signal! — Method
_compute_signal!(electr_energy::AbstractVector{T1}, energy::AbstractVector{T2},
μ::AbstractVector{T3}) where {T1 <: Real, T2 <: Real, T3 <: Real}Internal function. Calculation of the signal from the spectrum energy.
Arguments
signal_energy: signalenergy: spectrum energy.μ: transition dipole moments.
Returns
Spectrum energy.
WaveMixings._integral_chirp_function — Method
integralchirpfunction(intx::T, uniq_Δω::T, Τ::T, self::WaveMixing) where {T <: Real}
Integral to solve numericaly for simulation of chirped pump probe. This function is only used by the chirped construncting functions.
Arguments
int_x: depending symbol for numerical integration.uniq_Δω: single energy difference with the pulse.Τ: pulse length.WaveMixing: composite containing theχparameter.
Returns
Chirp contribution to the chirped spectrum energy.
WaveMixings._lower_elect_energy! — Method
_lower_elect_energy!(electr_energy::AbstractVector{T}, V_e::AbstractVector{T},
Ω_e::AbstractVector{T}, self::WaveMixing) where {T <: Real}
_lower_elect_energy!(electr_energy::AbstractMatrix{T}, V_e::AbstractMatrix{T},
Ω_e::AbstractMatrix{T}, self::WaveMixing) where {T <: Real}Internal function. Calculates absolute electronic energies associated to the lower energy levels.
Arguments
electr_energy: cavity eigen values.V_e: electronic energies.Ω_e: Rabi frequency of the cavity.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Absolute electronic energies.
WaveMixings._lower_elect_energy — Method
_lower_elect_energy(V_e::T, Ω_e::T, self::WaveMixing) where {T <: Real}Internal function. Calculates absolute electronic energies associated to the lower energy levels.
Arguments
V_e: electronic energies.Ω_e: Rabi frequency of the cavity.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Absolute electronic energies.
WaveMixings._lower_sin_cavity! — Method
_lower_sin_cavity!(lower_cavity::AbstractVector{T}, σ_e::AbstractVector{T},
Ω_e::AbstractVector{T}) where {T <: Real}
_lower_sin_cavity!(lower_cavity::AbstractMatrix{T}, σ_e::AbstractMatrix{T},
Ω_e::AbstractMatrix{T}) where {T <: Real}Internal function. Calculates cavity's lower energy levels. While the name is mostly arbitrary, it distinguishes it from the other part of the cavity represented by cos^2.
Arguments
lower_cavity: upper energy levels.σ_e: cavity eigen values.Ω_e: Rabi frequency of the cavity.
Returns
Cavity's lower energy levels
WaveMixings._lower_sin_cavity — Method
_lower_sin_cavity(σ_e::T, Ω_e::T) where {T <: Real}Internal function. Calculates cavity's lower energy levels. While the name is mostly arbitrary, it distinguishes it from the other part of the cavity represented by cos^2.
Arguments
σ_e: cavity eigen values.Ω_e: Rabi frequency of the cavity.
Returns
Cavity's lower energy levels
WaveMixings._rabi_cavity! — Method
_rabi_cavity!(Ω_e::AbstractVector{T1}, V_e::AbstractVector{T1},
μ::AbstractVector{T2},
self::WaveMixing) where {T1 <: Real, T2 <: Real}
_rabi_cavity!(Ω_e::AbstractMatrix{T}, V_e::AbstractMatrix{T},
γ::AbstractVector{T}, self::WaveMixing) where {T <: Real}
_rabi_cavity!(Ω_e::AbstractVector{T1}, V_e::AbstractVector{T1},
γ::AbstractVector{T1},
self::WaveMixing) where {T1 <: Real, T2 <: Real}Internal function. Calculates Rabi frequency of the cavity.
Arguments
Ω_e: Rabi frequency of the cavity.V_e: electronic energies.μ: transition dipole moment.γ: coupling strength.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Rabi frequency.
WaveMixings._rabi_cavity — Method
_rabi_cavity(V_e::T, μ::T, self::WaveMixing) where {T <: Real}Internal function. Calculates Rabi frequency of the cavity.
Arguments
V_e: electronic energies.μ: transition dipole moment.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Rabi frequency.
WaveMixings._simpson_integration — Method
_simpson_integration(integral::Function, Δω::Real)Solves, numericaly, the integral integral using the Simmson's method. In the present implementation, it solves the integral part of the chirp equation.
Arguments
integral: integral to solve.Δω: energy difference with the pulse.
Returns
Numerical solution of an integral using the Simmson's method.
WaveMixings._upper_cos_cavity! — Method
_upper_cos_cavity!(upper_cavity::AbstractVector{T1}, γ::T2, μ::AbstractVector{T2},
Ω_e::AbstractVector{T1}, σ_e::AbstractVector{T1}) where {T1 <: Real,
T2 <: Real}
_upper_cos_cavity!(upper_cavity::AbstractMatrix{T}, γ::AbstractVector{T},
Ω_e::AbstractMatrix{T}, σ_e::AbstractMatrix{T},
self::WaveMixing) where {T <: Real}
_upper_cos_cavity!(upper_cavity::AbstractVector{T1}, γ::AbstractVector{T1},
μ::AbstractVector{T2}, Ω_e::AbstractVector{T1},
σ_e::AbstractVector{T1}) where {T1 <: Real, T2 <: Real}Internal function. Calculates cavity's upper energy levels. While the name is mostly arbitrary, it distinguishes it from the other part of the cavity represented by sin^2.
Arguments
upper_cavity: upper energy levels.γ: coupling strength.μ: transition dipole moment.Ω_e: Rabi frequency of the cavity.σ_e: cavity eigen values.
Returns
Cavity's upper energy levels
WaveMixings._upper_cos_cavity — Method
_upper_cos_cavity(γ::T, μ::T, Ω_e::T, σ_e::T) where {T <: Real}Internal function. Calculates cavity's upper energy levels. While the name is mostly arbitrary, it distinguishes it from the other part of the cavity represented by sin^2.
Arguments
γ: coupling strength.μ: transition dipole moment.Ω_e: Rabi frequency of the cavity.σ_e: cavity eigen values.
Returns
Cavity's upper energy levels
WaveMixings._upper_elect_energy! — Method
_upper_elect_energy!(electr_energy::AbstractVector{T}, V_e::AbstractVector{T},
Ω_e::AbstractVector{T}, self::WaveMixing) where {T <: Real}
_upper_elect_energy!(electr_energy::AbstractMatrix{T}, V_e::AbstractMatrix{T},
Ω_e::AbstractMatrix{T}, self::WaveMixing) where {T <: Real}Internal function. Calculates absolute electronic energies associated to the upper energy levels.
Arguments
electr_energy: cavity eigen values.V_e: electronic energies.Ω_e: Rabi frequency of the cavity.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Absolute electronic energies.
WaveMixings._upper_elect_energy — Method
_upper_elect_energy(V_e::T, Ω_e::T, self::WaveMixing) where {T <: Real}Internal function. Calculates absolute electronic energies associated to the upper energy levels.
Arguments
V_e: electronic energies.Ω_e: Rabi frequency of the cavity.WaveMixing: composite containing the𝛚_cparameter.𝛚_cis the
cavity angular frequency.
Returns
Absolute electronic energies.
WaveMixings.asymm_secant_spectral — Method
asymm_secant_spectral(Δω::AbstractVector{T}, Τ:T, self::WaveMixing) where {T <: Real}
asymm_secant_spectral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Asymmetric hyperbolic secant.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.
Returns
Spectrum energy.
WaveMixings.chirp_spectral — Method
chirp_spectral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}
chirp_spectral(Δω::AbstractVector{T}, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Chirped spectrum energy.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.WaveMixing: composite containing theχparameter.
Returns
Spectrum energy with chirp function.
WaveMixings.gaussian_spectral — Method
gaussian_spectral((Δω::AbstractVector{T}, Τ::T, self::WaveMixing) where {T <: Real}
gaussian_spectral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.WaveMixing: composite containingD2,D3,D4andD5parameters. Those arenth-order dispersion coefficients.
Returns
Spectrum energy.
WaveMixings.gaussian_spectral_flex — Method
gaussian_spectral_flex(Δω::T, Τ::T, τ_ν::T = 0.05) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Modulates peak shape broadening in the 2D-FLEX signal of the Doorway function.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.τ_ν: inhomogeneous broadening parameter, the default gives 0.05 eV.
Returns
Spectrum energy 2D-FLEX doorway function
WaveMixings.gsb — Method
gsb(pump::T, Τ::T, self::WaveMixing, frame::Integer=1) where {T <: Real}Calculates the signal from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Ground State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing themethodparameter.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
GSB door, single value.
Description
This function estimates the Doorway (door) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Doorway formula (see Ref. [1] formula 56) of the ground state bleach (GSB) reads:
\[D_{0}(\omega_{pu},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = \sum_{e}^{ } E_{pu}^{2}(\omega_{pu}-U_{eg}(\boldsymbol{R}_{g})) \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2} \rho_{g}^{\textrm{Wig}}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also gsb, and gsb_strong.
WaveMixings.gsb_cavity! — Method
gsb_cavity!(self::WaveMixing, pump::T, Τ::T, frame::Integer = 1) where {T <: Real}
gsb_cavity!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates the cavity's signal from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Ground State Dynamics.
Arguments
WaveMixing: composite containing themethodparameter.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available. Needed parameters are function of the coupling strength (γ_0), cavity resonance (χ), and cavity mode energy (𝛚_c).pump: pump pulse energy.Τ: pulse length.frame: frame number in the non-adiabatic trajectory. The default gives 1.probe: probe pulse energy.
Returns
GSB door, single value.
See also se_cavity!, and esa_cavity!.
WaveMixings.gsb_strong — Method
gsb_strong(pump::T, Τ::T, self::WaveMixing, frame::Integer=1, ) where {T <: Real}Calculates the strong field signal from energies, oscillator strengths, and the pump laser amplitude as input.The inputs must be 1D Array, i.e. vectors. Use with Ground State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
Strong field GSB door, single value.
Description
This function estimates the strong field (door) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the ground state bleach (GSB) reads:
\[ D_{0,\alpha}^{strong}(\omega_{\tau},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = \sum_{e'}\frac{ \lambda_{\textrm{pu}}^{2} \left| \mu_{\textrm{ge}}(\boldsymbol{R}_{\textrm{g}})\right|^{2}}{ \Omega_{\textrm{eg}}^{2} (\boldsymbol{R}_{g})} \left(1 - \cos\left(\Omega_{\textrm{eg}} \left(\boldsymbol{R}_{g}\right) \tau_{\textrm{pu}}\right) \right) \rho_{\textrm{g}}^{\textrm{Wig}} (\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
See also Δgsb_strong, Δse_strong, se_strong, and esa_strong.
WaveMixings.lorentzian_spectral — Method
lorentzian_spectral(Δω::AbstractVector{T}, Τ::T, self::WaveMixing) where {T <: Real}
lorentzian_spectral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Lorenzian.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.
Returns
Spectrum energy.
WaveMixings.oscillator_to_dipole — Method
oscillator_to_dipole(oscillator::T, ΔE::T) where {T <: Real}
oscillator_to_dipole(oscillator::AbstractVector{T},
ΔE::AbstractVector{T}) where {T <: Real}Converts the oscillator strength* to dipole moment.
Arguments
oscillator: oscillator value of a determined excited state.ΔE: energy difference between the excited energy and the initial energy.
Returns
Dipole moment.
WaveMixings.rabi_freq — Method
rabi_freq(pump::T, ΔE::AbstractVector{T}, μ::AbstractVector{T}, self::WaveMixing) where {T <: Real}
rabi_freq(pump::T, ΔE::T, μ::T, self::WaveMixing) where {T <: Real}Calculates the Rabi frequency of the pump pulse.
Arguments
pump: pump pulse energy.ΔE: energy difference between the excited energy and the initial energy.μ: dipole moment of the energy's difference.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.
Returns
Rabi frequency of the pump laser.
WaveMixings.rectangular_spectral — Method
rectangular_spectral(Δω::AbstractVector{T}, Τ::T, self::WaveMixing) where {T <: Real}
rectangular_spectral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Rectangular.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.
Returns
Spectrum energy.
WaveMixings.se — Method
se(pump::T, Τ::T, self::WaveMixing, frame::Integer=1 ) where {T <: Real}Calculates the SE Doorway from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing themethodparameter.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
SE door. Single value.
Description
This function estimates the Doorway (door) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Doorway formula (see Ref. [1] formula 57) of the stimulated emission (SE) reads:
\[D_{I}(\omega_{pu},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = E_{pu}^{2}(\omega_{pu}-U_{eg}(\boldsymbol{R}_{g})) \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2} \rho_{g}^{\textrm{Wig}}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
WaveMixings.se_cavity! — Method
se_cavity!(self::WaveMixing, pump::T, Τ::T, frame::Integer = 1) where {T <: Real}
se_cavity!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}Calculates cavity's SE Doorway from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containing themethodparameter.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available. Needed parameters are function of the coupling strength (γ_0), cavity resonance (χ), and cavity mode energy (𝛚_c).pump: pump pulse energy.Τ: pulse length.frame: frame number in the non-adiabatic trajectory. The default gives 1.probe: probe pulse energy.
Returns
SE door. Single value.
See also gsb_cavity!, and esa_cavity!.
WaveMixings.se_cavity_lgc! — Method
se_cavity_lgc!(self::WaveMixing, pump::T, Τ::T, frame::Integer = 1) where {T <: Real}
se_cavity_lgc!(self::WaveMixing, probe::AbstractMatrix{T}, Τ::T) where {T <: Real}LEGACY Calculates cavity's SE Doorway from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing themethodparameter.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available. Needed parameters are function of the coupling strength (γ_0), cavity resonance (χ), and cavity mode energy (𝛚_c).frame: frame number in the non-adiabatic trajectory. The default gives 1.probe: probe pulse energy.
Returns
SE door. Single value.
See also gsb_cavity!, and esa_cavity_lgc!.
WaveMixings.se_lgc — Method
se_lgc(se(pump::T, Τ::T, self::WaveMixing, frame::Integer=1 ) where {T <: Real}LEGACY Calculates the SE Doorway from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated from the spectrum energy in the frequency domain. For the available methods check the function spectrum_energy_fourier. Use with Excited State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing themethodparameter.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
SE door. Single value.
Description
This function estimates the Doorway (door) parameter under the following approximations:
- Evolutions of electronic coherences in the DW operators are evaluated within the short-time classical Condon approximation.
- T-evolutions of electronic populations, are replaced by evolutions along trajectories.
- The quantum thermal distribution in the electronic ground state is substituted by the corresponding phase-space Wigner distribution.
- The trace over vibrational degrees of freedom is replaced by stochastic sampling of the initial conditions.
The corresponding Doorway formula (see Ref. [1] formula 57) of the stimulated emission (SE) reads:
\[D_{I}(\omega_{pu},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = E_{pu}^{2}(\omega_{pu}-U_{eg}(\boldsymbol{R}_{g})) \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2} \rho_{g}^{\textrm{Wig}}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
WaveMixings.se_strong — Method
se_strong(pump::T, Τ::T, self::WaveMixing, frame::Integer=1) where {T <: Real}Calculates the strong field signal from energies, oscillator strengths, and the pump laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
Strong field SE door, single value.
Description
This function estimates the strong field (door) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the stimulated emission (SE) reads:
\[ D_{I,\alpha}^{strong}(\omega_{\tau},\boldsymbol{R}_{e},\boldsymbol{P}_{e}) = \frac{ \lambda_{\textrm{pr}}^{2} \left| \mu_{\textrm{ge}}(\boldsymbol{R}_{\textrm{e}})\right|^{2}}{ \Omega_{\textrm{eg}}^{2} (\boldsymbol{R}_{e})} \left(1 - \cos\left(\Omega_{\textrm{eg}} \left(\boldsymbol{R}_{e}\right) \tau_{\textrm{pr}}\right) \right) (\boldsymbol{R}_{e},\boldsymbol{P}_{e})\]
Cite
See also Δgsb_strong, gsb_strong, Δse_strong, and esa_strong.
WaveMixings.se_strong_lgc — Method
se_strong_lgc(pump::T, Τ::T, self::WaveMixing, frame::Integer=1) where {T <: Real}LEGACY Calculates the strong field signal from energies, oscillator strengths, and the pump laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
pump: pump pulse energy.Τ: pulse length.WaveMixing: composite containing theλparameter.λis the pump laser amplitude.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
Strong field SE door, single value.
Description
This function estimates the strong field (door) parameter under the approximations of the Doorway-Window representation. The corresponding formula (see Ref. [1] formula XX) of the stimulated emission (SE) reads:
\[ D_{I,\alpha}^{strong}(\omega_{\tau},\boldsymbol{R}_{e},\boldsymbol{P}_{e}) = \frac{ \lambda_{\textrm{pr}}^{2} \left| \mu_{\textrm{ge}}(\boldsymbol{R}_{\textrm{e}})\right|^{2}}{ \Omega_{\textrm{eg}}^{2} (\boldsymbol{R}_{e})} \left(1 - \cos\left(\Omega_{\textrm{eg}} \left(\boldsymbol{R}_{e}\right) \tau_{\textrm{pr}}\right) \right) (\boldsymbol{R}_{e},\boldsymbol{P}_{e})\]
Cite
See also Δgsb_strong, gsb_strong, Δse_strong, and esa_strong.
WaveMixings.secant_spectral — Method
secant_spectral(Δω::AbstractVector{T}, Τ::T4, self::WaveMixing) where {T <: Real}
secant_spectral(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Hyperbolic secant.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.
Returns
Spectrum energy.
WaveMixings.second_order_dispersion — Method
second_order_dispersion(Δω::AbstractVector{Real}, D2::Real)Deprecated. Estimates the effect of the group delay dispersion (GDD, sometimes called 2nd-order dispersion) of an optical element, this is a quantitative measure for chromatic dispersion. It is defined as the derivative of the group delay, or the second derivative of the change in spectral phase, with respect to the angular optical frequency. More at: https://www.rp-photonics.com/groupdelaydispersion.html
Arguments
Δω: energy difference with the pulse.D2: 2nd-order dispersion, fs^2.
Returns
Spectrum energy.
WaveMixings.second_order_dispersion — Method
second_order_dispersion(Δω::T, D2::T) where {T <: Real}Deprecated. Estimates the effect of the group delay dispersion (GDD, sometimes called 2nd-order dispersion) of an optical element, this is a quantitative measure for chromatic dispersion. It is defined as the derivative of the group delay, or the second derivative of the change in spectral phase, with respect to the angular optical frequency. More at: https://www.rp-photonics.com/groupdelaydispersion.html
Arguments
Δω: energy difference with the pulse.D2: 2nd-order dispersion, fs^2.
Returns
Spectrum energy.
WaveMixings.spectrum_energy_fourier — Method
spectrum_energy_fourier(Δω::AbstractVector{T}, Τ::T, WaveMixing) where {T <: Real}
spectrum_energy_fourier(Δω::T, Τ::T, self::WaveMixing) where {T <: Real}Calculation of the spectrum energy in the frequency domain rather than in the time domain. Implemented methods are: :gaus, :lore, :assh, :chir, and :sech.
Arguments
Δω: energy difference with the pulse.Τ: pulse length.WaveMixing: composite containingmethod,dispersion,D2andD3parameters.methodby default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.
Returns
Spectrum energy.
WaveMixings.third_order_dispersion — Method
third_order_dispersion(Δω::AbstractVector{Real}, D3::Real)Deprecated. Estimates the total effect of the third order dispersion (TOD) of an optical element, this is a quantitative measure for chromatic dispersion. Third-order dispersion results from the frequency dependence of the group delay dispersion (GDD). It is defined as the second derivative of the group delay, or the third derivative of the change in spectral phase, with respect to the angular optical frequency. In mode-locked lasers for pulse durations below roughly 30 fs, it is necessary to provide dispersion compensation not only for the average group delay dispersion (2nd-order dispersion), but also for the third-order dispersion and possibly for even higher orders.
In many cases, the investigation of the effect of third-order dispersion requires numerical pulse propagation modeling. More at: https://www.rp-photonics.com/thirdorderdispersion.html
Arguments
Δω: energy difference with the pulse.D3: 3rd-order dispersion, fs^3.
Returns
Spectrum energy.
WaveMixings.third_order_dispersion — Method
third_order_dispersion(Δω::T, D3::T) where {T <: Real}Deprecated. Estimates the total effect of the third order dispersion (TOD) of an optical element, this is a quantitative measure for chromatic dispersion. Third-order dispersion results from the frequency dependence of the group delay dispersion (GDD). It is defined as the second derivative of the group delay, or the third derivative of the change in spectral phase, with respect to the angular optical frequency. In mode-locked lasers for pulse durations below roughly 30 fs, it is necessary to provide dispersion compensation not only for the average group delay dispersion (2nd-order dispersion), but also for the third-order dispersion and possibly for even higher orders.
In many cases, the investigation of the effect of third-order dispersion requires numerical pulse propagation modeling. More at: https://www.rp-photonics.com/thirdorderdispersion.html
Arguments
Δω: energy difference with the pulse.D3: 3rd-order dispersion, fs^3.
Returns
Spectrum energy.
WaveMixings.ΔEnergy_excitations — Method
ΔEnergy_excitations(energies::AbstractVector{Real})Calculates de energy difference between the initial energy and the excited energy. It assumes that the input data is a Vector, where the initial energy is in the second position.
Arguments
energies: initial energy and excited energies value keep in a Vector.
Returns
ΔE of each excited energy.
WaveMixings.Δgsb — Function
Δgsb(self::WaveMixing, frame::Integer=1, )Calculates the Δ signal from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Ground State Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
GSB delta_door. Single value.
Description
This function estimates the Doorway (delta_door) parameter under the assumsion that the pump and probe pulses are well temporally separated i.e. the time delay (T) between the pulses is longer than the pulse durations, $\tau > T_{a}$ (see Ref. [1] formula 52)
\[D_{0}(\omega_{pu},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = \sum_{e}^{} \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2} \rho_{g}^{\textrm {Wig}}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also Δgsb, and Δgsb_strong.
WaveMixings.Δgsb_strong — Function
Δgsb_strong(self::WaveMixing, frame::Integer=1, )Calculates the Δ strong signal from energies, oscillator strengths, and pump laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments and amplitude. Use with Ground State Dynamics.
Arguments
WaveMixing: composite containing theλparameter.λis the pump laser amplitude.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
Strong field GSB delta_door, single value.
WaveMixings.Δse — Function
Δse(self::WaveMixing, frame::Integer=1, )Calculates the Δ SE from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
SE delta_door, single value.
Description
This function estimates the Doorway (delta_door) parameter under the assumsion that the pump and probe pulses are well temporally separated i.e. the time delay (T) between the pulses is longer than the pulse durations, $\tau > T_{a}$ (see Ref. [1] formula 52)
\[D_{0}(\omega_{pu},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2} \rho_{g}^{\textrm {Wig}}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also Δse, and Δse_strong.
WaveMixings.Δse_lgc — Function
Δse_lgc(self::WaveMixing, frame::Integer=1, )LEGACY Calculates the Δ SE from energies and oscillator strengths as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containingoscillators,methodandenergiesparameters.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
SE delta_door, single value.
Description
This function estimates the Doorway (delta_door) parameter under the assumsion that the pump and probe pulses are well temporally separated i.e. the time delay (T) between the pulses is longer than the pulse durations, $\tau > T_{a}$ (see Ref. [1] formula 52)
\[D_{0}(\omega_{pu},\boldsymbol{R}_{g},\boldsymbol{P}_{g}) = \left| (\boldsymbol{\mu}_{ge}(\boldsymbol{R}_{g}) \right|^{2} \rho_{g}^{\textrm {Wig}}(\boldsymbol{R}_{g},\boldsymbol{P}_{g})\]
Cite
[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408
See also Δse, and Δse_strong.
WaveMixings.Δse_strong — Function
Δse_strong(self::WaveMixing, frame::Integer=1, )Calculates the Δ strong field signal from energies, oscillator strengths, and the pump laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containing theλparameter.λis the pump laser amplitude.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
Strong field SE delta_door, single value.
WaveMixings.Δse_strong_lgc — Function
Δse_strong_lgc(self::WaveMixing, frame::Integer=1)LEGACY Calculates the Δ strong field signal from energies, oscillator strengths, and the pump laser amplitude as input. The inputs must be 1D Array, i.e. vectors. The signal is calculated merely from the dipole moments. Use with Excited State Dynamics.
Arguments
WaveMixing: composite containing theλparameter.λis the pump laser amplitude.frame: frame number in the non-adiabatic trajectory. The default gives 1.
Returns
Strong field SE delta_door, single value.
##importGS(energydat::AbstractString, tdm_dat::AbstractString)