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.

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

source

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

  • WaveMixing composition (struct) containing energy and righ_tdm

parameters(2D array). This is the minimal input data for the pump-probe signal estimation.

source
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

  • WaveMixing composition (struct) containing energy and righ_tdm

parameters(2D array). This is the minimal input data for the pump-probe signal estimation.

source
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

  • WaveMixing composition (struct) containing energy and righ_tdm

parameters(2D array). This is the minimal input data for the pump-probe signal estimation.

source
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

  • WaveMixing composition (struct) containing energy and oscillators

parameters(2D array). This is the minimal input data for the pump-probe signal estimation.

source
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

  • WaveMixing composition (struct) containing energy and oscillators

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.

source
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

  • WaveMixing composition (struct) containing energy and oscillators

parameters(2D array). This is the minimal input data for the pump-probe signal estimation.

source
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

  • WaveMixing composition (struct) containing energy and oscillators

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.

source
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

  • WaveMixing composition (struct) containing energy and oscillators

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.

source
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

  • WaveMixing composition (struct) containing energy and oscillators

parameters(2D array). This is the minimal input data for the pump-probe signal estimation.

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

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

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

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

source
WaveMixings._coupling_overtime — Method
_coupling_overtime(self::WaveMixing)

Internal function. Calculation of the coupling strength as function of time

Arguments

  • WaveMixing: composite containing the γ_0 and χ parameter. γ_0

represents the initial coupling strength.

Returns

Coupling strengths.

source
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 containing method, dispersion, D2 and D3 parameters.

method by default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.

Returns

Spectrum energy.

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

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

source
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 containing oscillators, method and energies parameters.
  • Τ: 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

[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408

See also se, and se_strong.

source
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 containing oscillators, method and energies parameters.
  • 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!.

source
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 containing oscillators, method and energies parameters.
  • 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!.

source
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 containing oscillators, method and energies parameters.
  • 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.

source
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 containing oscillators, method and energies parameters.
  • 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.

source
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 containing oscillators, method and energies parameters.
  • Τ: 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

[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408

See also se, and se_strong.

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

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

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

source
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

source
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 containing oscillators, method and energies parameters.

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.

source
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 containing oscillators, method and energies parameters.
  • 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.

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

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

source
WaveMixings.oscillator_to_dipole — Method
oscillator_to_dipole(WaveMixing)

Converts the oscillator strenght to dipole moment.

Arguments

  • WaveMixing: composite containing oscillators and ΔE parameters

Returns

Dipole moments.

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

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

source
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 containing oscillators, method and energies parameters.

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

[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408

See also se, and se_strong.

source
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 containing oscillators, method and energies parameters.
  • Τ: 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.

source
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 containing oscillators, method and energies parameters.
  • Τ: 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.

source
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 containing oscillators, method and energies parameters.
  • 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!.

source
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 containing oscillators, method and energies parameters.
  • 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!.

source
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 containing oscillators, method and energies parameters.

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

[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408

See also se, and se_strong.

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

source
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!.

source
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!.

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

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

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

source
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 containing D2, D3, D4, D5, Δω and method parameters. method by default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available. D# are the nth-order dispersion coefficients.
  • Τ: pulse length.

Returns

Spectrum energy.

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

source
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 containing energies parameter.

Returns

ΔE of each excited energy.

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Cavity eigen values.

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Cavity eigen values.

source
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 Δω.

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

source
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: signal
  • energy: spectrum energy.
  • μ: transition dipole moments.

Returns

Spectrum energy.

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

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Absolute electronic energies.

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Absolute electronic energies.

source
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

source
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

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Rabi frequency.

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Rabi frequency.

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

source
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

source
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

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Absolute electronic energies.

source
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 𝛚_c parameter. 𝛚_c is the

cavity angular frequency.

Returns

Absolute electronic energies.

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

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

source
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 containing D2, D3, D4 and D5 parameters. Those are nth-order dispersion coefficients.

Returns

Spectrum energy.

source
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

source
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 the method parameter. method by 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.

source
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 the method parameter. method by 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!.

source
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

[1] Hefen et.al. XX 2025, XX

See also Δgsb_strong, Δse_strong, se_strong, and esa_strong.

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

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

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

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

source
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 the method parameter. method by 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

[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408

See also se, and se_strong.

source
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 the method parameter. method by 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!.

source
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 the method parameter. method by 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!.

source
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 the method parameter. method by 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

[1] Gelin et.al. J.Chem.TheoryComput.2021, 17, 2394−2408

See also se, and se_strong.

source
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

[1] Hefen et.al. XX 2025, XX

See also Δgsb_strong, gsb_strong, Δse_strong, and esa_strong.

source
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

[1] Hefen et.al. XX 2025, XX

See also Δgsb_strong, gsb_strong, Δse_strong, and esa_strong.

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

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

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

source
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 containing method, dispersion, D2 and D3 parameters. method by default is Gaussian (:gaus). Lorentzian (:lore), chirp (:chir), hyperbolic secant (:sech), and asymmetric hyperbolic secant (:assh) are available.

Returns

Spectrum energy.

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

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

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

source
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 containing oscillators, method and energies parameters.
  • 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.

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

source
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 containing oscillators, method and energies parameters.
  • 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.

source
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 containing oscillators, method and energies parameters.
  • 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.

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

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

source

##importGS(energydat::AbstractString, tdm_dat::AbstractString)