![]() |
Octopus
|
Data Types | |
| type | layer_t |
| Holding parameters characterizing a dielectric layer. More... | |
| type | lpcm_substrate_t |
| Holding parameters characterizing a stack of dielectric layers. More... | |
| type | reflection_t |
| Holding parameters and utilities needed for calculating reflected fields. More... | |
Functions/Subroutines | |
| real(real64) function | layer_get_eps_para (this) |
| real(real64) function | layer_get_eps_perp (this) |
| real(real64) function | substrate_get_eps_solv (this) |
| subroutine | substrate_set_mode (this, mode) |
| class(lpcm_substrate_t) function, pointer | substrate_iset_static (this) |
| Sets substrate mode to static and returns reference the substrate object. More... | |
| class(lpcm_substrate_t) function, pointer | substrate_iset_dynamic (this) |
| Sets substrate mode to dynamic and returns reference the substrate object. More... | |
| subroutine, public | layer_pcm_substrate_init (substrate, namespace) |
| Parses the substrate. More... | |
| subroutine, public | layer_pcm_substrate_reflection_init (substrate, namespace) |
| subroutine | parse_vector_row (block, irow, target_array, ioffset) |
| Parses a three-component vector from a block row. More... | |
| subroutine | parse_layers (substrate) |
| Parses the PCMLayers block. More... | |
| subroutine | substrate_check_if_dynamic (this) |
| Checks whether at least at least 1 dynamic dielectric constant has been provided for the substrate (should also check whether PCMStaticEpsilon != PCMDynamicEpsilon, now that I think of it) More... | |
| integer function | get_nlayers (block) |
| Returns the number of layers in the substrate. More... | |
| subroutine | parse_layer_row (block, ilayer, layer) |
| Parses a row of the PCMLayersBlock. More... | |
| subroutine | parse_wave_vectors (reflection) |
| Parses electric field wave vectors, asserting that they are perpendicular to the corresponding polarization vectors. More... | |
| subroutine | parse_other_reflection_parameters (reflection) |
| Reparses time step and propagation time steps. More... | |
| subroutine, public | layer_pcm_substrate_end (substrate) |
| subroutine, public | layer_pcm_add_image_term (n_tess, tess, substrate, delta, sigma) |
| Adds substrate polarization terms to the IEF-PCM D_e (delta) and S_e (sigma) matrices. More... | |
| real(real64) function, public | layer_pcm_get_image_matrix_element (imatrix, tessi, tessj, substrate) |
| Returns substrate image term M_ij^img to be added to the matrix element M_ij, where M = S_e or D_e. More... | |
| subroutine | substrate_check_distance_to_surface (this, point) |
| Asserts that the PCM cavity and the surface do not intersect. More... | |
| subroutine | assign_epsilons (substrate, eps_solv, eps_1_para, eps_1_perp) |
| Assigns the dielectric constants of the solvent and of the first layer to the arguments. More... | |
| real(real64) function, dimension(3) | get_dr_para (point_i, point_j, substrate) |
| Returns in-plane component of the difference vector dr_ij = r_i - r_j. More... | |
| real(real64) function | get_prefactor (eps_solv, eps_1_para, eps_1_perp, laguerre_abscissa, normalization_factor, substrate) |
| Returns prefactor multiplying the exponential in Eq. (22) More... | |
| real(real64) function | get_sigma_image (laguerre_abscissa, laguerre_weight, len_dr_para, prefactor, normalization_factor) |
| Returns the contribution w_i * f(x_i) of a given abcissa x_i/weight w_i to the numerical S_e integration. More... | |
| real(real64) function | get_delta_image (laguerre_abscissa, laguerre_weight, len_dr_para, prefactor, normalization_factor, dr_para, normalj, substrate) |
| Returns the contribution w_i * f(x_i) of a given abcissa x_i/weight w_i to the numerical D_e integration. More... | |
| real(real64) function | get_gamma_factor (q1, substrate) |
| Returns the factor (T_11 - T_21) / (T_11 + T_21), which is proportional to eps_subs [Eq. (22)]. More... | |
| subroutine | get_reflected (ifield, polarization, substrate, phase_factor, w0, tdf_enve, tdf_phase) |
| Calculates reflected field by forward-FFT-ing incoming field, multiplying it with reflectivity, then backward-FFT-ing. More... | |
| subroutine | write_field_to_array (tdf_enve, tdf_phase, w0, phase_factor, nvals_t, step_t, vals_t) |
| Writes field from envelope (tdf_enve) and phase functions (tdf_phase) to numerical array (vals_t) More... | |
| subroutine | multiply_by_reflectivity (ifield, polarization, substrate, nvals_w, step_w, vals_w) |
| Multiplies frequency-domain array vals_w by reflectivity array r(w), component-wise. More... | |
| subroutine | reflection_fft_init (nvals_t, nvals_w, fft, vals_t, vals_w) |
| Initializes the FFT handler as well as corresponding time and frequency series. More... | |
| subroutine | reflection_fft_end (fft_handler, vals_t, vals_w) |
| Terminates the FFT handler as well as corresponding time and frequency series. More... | |
| subroutine | write_lengths_and_steps (tdf, nvals_t, step_t, nvals_w, step_w) |
| Extracts time and frequency array lengths and steps. More... | |
| subroutine | calculate_polarization_vector (direction, wave_vector_in, polarization, normal, perpendicular, polarization_vector) |
| Calculates polarization vector of impinging or reflected (direction), s- or p-polarized field (polarization) More... | |
| subroutine | check_wave_vector (wave_vector, polarization_vector, normal_vector) |
| This can be removed (together with the line where it is currently used), as the orthogonality is now checked during parsing. More... | |
| subroutine, public | layer_pcm_calculate_reflected_fields (polarizations_tot, frequencies_tot, envelopes_tot, phases_tot, polarizations_imp, frequencies_imp, envelopes_imp, phases_imp, substrate) |
| Calculates parameters of reflected fields from those of the impinging fields, saving them in the corresponding arrays. More... | |
| integer function | get_nlasers (wave_vectors, polarization_vectors, normal) |
| Returns the total number of lasers (incoming and reflected) More... | |
| complex(real64) function, public | layer_pcm_get_reflectivity (ifield, polarization, substrate, frequency) |
| Returns the reflectivity r(w) of the substrate for a given frequency w (differs for s and p polarization) More... | |
| complex(real64) function | get_wave_vector_z (polarization, eps_para, eps_perp, ww, q1) |
| Returns the out-of-plane component of the wave vector in an anisotropic dielectric layer (differs for s and p polarization) More... | |
Variables | |
| integer, parameter, public | lpcm_mode_eq = 0 |
| static More... | |
| integer, parameter, public | lpcm_mode_noneq = 1 |
| dynamic, where provided More... | |
| integer, parameter, public | lpcm_s_polarization = 1 |
| Polarization of a field with respect to the plane of incidence. More... | |
| integer, parameter, public | lpcm_p_polarization = 2 |
| integer, parameter | lpcm_impinging = 1 |
| Propagation direction of a field with respect to the surface. More... | |
| integer, parameter | lpcm_reflected = 2 |
| logical, parameter, public | lpcm_delta = .true. |
| D_e. More... | |
| logical, parameter, public | lpcm_sigma = .false. |
| S_e. More... | |
|
private |
Definition at line 210 of file layer_pcm.F90.
|
private |
Definition at line 222 of file layer_pcm.F90.
|
private |
Definition at line 234 of file layer_pcm.F90.
|
private |
Definition at line 246 of file layer_pcm.F90.
|
private |
Sets substrate mode to static and returns reference the substrate object.
Definition at line 262 of file layer_pcm.F90.
|
private |
Sets substrate mode to dynamic and returns reference the substrate object.
Definition at line 273 of file layer_pcm.F90.
| subroutine, public layer_pcm_oct_m::layer_pcm_substrate_init | ( | type(lpcm_substrate_t), intent(inout) | substrate, |
| type(namespace_t), intent(in) | namespace | ||
| ) |
Parses the substrate.
Without a substrate, only LayerPCMIncludeSubstrate and LayerPCMIncludeReflection are parsed
Definition at line 286 of file layer_pcm.F90.
| subroutine, public layer_pcm_oct_m::layer_pcm_substrate_reflection_init | ( | type(lpcm_substrate_t), intent(inout) | substrate, |
| type(namespace_t), intent(in) | namespace | ||
| ) |
Definition at line 364 of file layer_pcm.F90.
|
private |
Parses a three-component vector from a block row.
Definition at line 378 of file layer_pcm.F90.
|
private |
Parses the PCMLayers block.
Definition at line 397 of file layer_pcm.F90.
|
private |
Checks whether at least at least 1 dynamic dielectric constant has been provided for the substrate (should also check whether PCMStaticEpsilon != PCMDynamicEpsilon, now that I think of it)
Definition at line 436 of file layer_pcm.F90.
|
private |
Returns the number of layers in the substrate.
Definition at line 449 of file layer_pcm.F90.
|
private |
Parses a row of the PCMLayersBlock.
Definition at line 471 of file layer_pcm.F90.
|
private |
Parses electric field wave vectors, asserting that they are perpendicular to the corresponding polarization vectors.
Definition at line 502 of file layer_pcm.F90.
|
private |
Reparses time step and propagation time steps.
Definition at line 550 of file layer_pcm.F90.
| subroutine, public layer_pcm_oct_m::layer_pcm_substrate_end | ( | type(lpcm_substrate_t), intent(inout) | substrate | ) |
Definition at line 572 of file layer_pcm.F90.
| subroutine, public layer_pcm_oct_m::layer_pcm_add_image_term | ( | integer, intent(in) | n_tess, |
| type(pcm_tessera_t), dimension(:), intent(in) | tess, | ||
| type(lpcm_substrate_t), intent(in) | substrate, | ||
| real(real64), dimension(:,:), intent(inout) | delta, | ||
| real(real64), dimension(:,:), intent(inout) | sigma | ||
| ) |
Adds substrate polarization terms to the IEF-PCM D_e (delta) and S_e (sigma) matrices.
Definition at line 586 of file layer_pcm.F90.
| real(real64) function, public layer_pcm_oct_m::layer_pcm_get_image_matrix_element | ( | logical, intent(in) | imatrix, |
| type(pcm_tessera_t), intent(in) | tessi, | ||
| type(pcm_tessera_t), intent(in) | tessj, | ||
| type(lpcm_substrate_t), intent(in) | substrate | ||
| ) |
Returns substrate image term M_ij^img to be added to the matrix element M_ij, where M = S_e or D_e.
imatrix is a flag that toggles between S_e and D_e matrices i, j are tessera indices, corresponding to discretized version of \(r\) and \(r^\prime\), respectively
For S_e [Eq. (10)]:
\[ M_{ij} = G_\mathrm{img}(\textbf{r}_i,\textbf{r}_j) = \frac{1}{2\pi\varepsilon_\mathrm{solv}}\int_0^\infty\text dq_\parallel\,q_\parallel J_0(q_\parallel\Delta r_{\parallel,ij})G_\mathrm{img}(q_\parallel, z_i, z_j) \]
For D_e [Eq. (24)]:
\[ M_{ij} = \hat{\mathbf{r}}_j\cdot\nabla^\prime G_{\text{img}}(\textbf{r}_i,\textbf{r}_j) =-\frac{1}{2\pi}\hat{\textbf{r}}_j\cdot\int_0^\infty\text dq_\parallel\,q_\parallel^2 G_{\text{img}}(q_\parallel, z_i, z_j)\nonumber\left[J_0(q_\parallel\Delta r_{\parallel,ij})\hat{\mathbf{z}}-J_1(q_\parallel\Delta r_{\parallel,ij}){\Delta\hat{\textbf{r}}_{\parallel,ij}}\right] \]
For large \(q_\parallel\) the prefactor of Eq. (22) tends to that of the half-space formed by the first layer, \(\beta_\infty = (\varepsilon_\mathrm{solv}-\bar\varepsilon_1)/(\varepsilon_\mathrm{solv}+\bar\varepsilon_1)\) with \(\bar\varepsilon_1 = \sqrt{\varepsilon_{1,\parallel}\varepsilon_{1,\perp}}\). Its contribution is the image charge of classical electrostatics, with \(h = z_i+z_j-2z_0\) and \(R = \sqrt{\Delta r_\parallel^2+h^2}\):
\[ S_e: \frac{\beta_\infty}{\varepsilon_\mathrm{solv}R}, \qquad D_e: a_j\beta_\infty\frac{\hat{\mathbf{r}}_j\cdot\Delta\mathbf{r}_\parallel-(\hat{\mathbf{r}}_j\cdot\hat{\mathbf{z}})h}{R^3} \]
The remainder of the prefactor decays as \(e^{-2q_\parallel\xi_1d_1}\). Its integrals can be written as \(\int_0^\infty\text dx\,e^{-x}f(x)\) with \(x = q_\parallel(h+2\xi_1d_1)\), allowing for the evaluation through a Gauss-Laguerre quadrature: \(\int_0^\infty\text dx\,e^{-x}f(x)\approx\sum_{i=1}^nw_if(x_i)\), where x_i (abcissas) and w_i (weights) are parameters related to the n-th order Laguerre polynomial (see wikipedia.org/wiki/GaussE2%80%93Laguerre_quadrature for more details) here, n = 20 is adopted
Definition at line 645 of file layer_pcm.F90.
|
private |
Asserts that the PCM cavity and the surface do not intersect.
Definition at line 726 of file layer_pcm.F90.
|
private |
Assigns the dielectric constants of the solvent and of the first layer to the arguments.
Definition at line 737 of file layer_pcm.F90.
|
private |
Returns in-plane component of the difference vector dr_ij = r_i - r_j.
Definition at line 749 of file layer_pcm.F90.
|
private |
Returns prefactor multiplying the exponential in Eq. (22)
\[ \frac{2\pi}{\varepsilon_{\mathrm{solv}}q_\parallel} \frac{\varepsilon_{\mathrm{solv}}-\varepsilon_{\mathrm{subs}}(q_\parallel)} {\varepsilon_{\mathrm{solv}}+\varepsilon_{\mathrm{subs}}(q_\parallel)} \]
The in-plane wavenumber \(q_\parallel\) is a rescaled version of the Laguerre abscissa x, \(q_\parallel = x / (z+z^\prime-2z_0)\) This substitution is done to bring the exponential in Eq. (22) into the form \(e^{-x}\), as required for the quadrature
Definition at line 772 of file layer_pcm.F90.
|
private |
Returns the contribution w_i * f(x_i) of a given abcissa x_i/weight w_i to the numerical S_e integration.
Definition at line 786 of file layer_pcm.F90.
|
private |
Returns the contribution w_i * f(x_i) of a given abcissa x_i/weight w_i to the numerical D_e integration.
Definition at line 796 of file layer_pcm.F90.
|
private |
Returns the factor (T_11 - T_21) / (T_11 + T_21), which is proportional to eps_subs [Eq. (22)].
the transfer matrix T is constructed according to Eqs. (18) and (20)
Definition at line 818 of file layer_pcm.F90.
|
private |
Calculates reflected field by forward-FFT-ing incoming field, multiplying it with reflectivity, then backward-FFT-ing.
This corresponds to the real-time convolution in Eq. (35)
Definition at line 864 of file layer_pcm.F90.
|
private |
Writes field from envelope (tdf_enve) and phase functions (tdf_phase) to numerical array (vals_t)
Definition at line 892 of file layer_pcm.F90.
|
private |
Multiplies frequency-domain array vals_w by reflectivity array r(w), component-wise.
Definition at line 912 of file layer_pcm.F90.
|
private |
Initializes the FFT handler as well as corresponding time and frequency series.
Definition at line 928 of file layer_pcm.F90.
|
private |
Terminates the FFT handler as well as corresponding time and frequency series.
Definition at line 948 of file layer_pcm.F90.
|
private |
Extracts time and frequency array lengths and steps.
Definition at line 961 of file layer_pcm.F90.
|
private |
Calculates polarization vector of impinging or reflected (direction), s- or p-polarized field (polarization)
See Eqs. (36) and (37) of J. Krumland, G. Gil, S. Corni and C. Cocchi, J. Chem. Phys. 154, 224114 (2021)
Definition at line 977 of file layer_pcm.F90.
|
private |
This can be removed (together with the line where it is currently used), as the orthogonality is now checked during parsing.
Definition at line 1012 of file layer_pcm.F90.
| subroutine, public layer_pcm_oct_m::layer_pcm_calculate_reflected_fields | ( | complex(real64), dimension(:,:), intent(out), allocatable | polarizations_tot, |
| real(real64), dimension(:), intent(out), allocatable | frequencies_tot, | ||
| type(tdf_t), dimension(:), intent(out), allocatable | envelopes_tot, | ||
| type(tdf_t), dimension(:), intent(out), allocatable | phases_tot, | ||
| complex(real64), dimension(:,:), intent(in) | polarizations_imp, | ||
| real(real64), dimension(:), intent(in) | frequencies_imp, | ||
| type(tdf_t), dimension(:), intent(in) | envelopes_imp, | ||
| type(tdf_t), dimension(:), intent(in) | phases_imp, | ||
| type(lpcm_substrate_t), intent(in) | substrate | ||
| ) |
Calculates parameters of reflected fields from those of the impinging fields, saving them in the corresponding arrays.
If the impinging wave is polarized perpendicularly to the surface or is purely s- or p-polarized, 1 reflected field is added else 2 (s/p mixture)
The polarization of the impinging fields is projected onto the impinging s- and p-polarization vectors, yielding factors that scale the corresponding outgoing waves [Eq. (38)]
The arrays of all fields, impinging and reflected, are allocated here
Definition at line 1038 of file layer_pcm.F90.
|
private |
Returns the total number of lasers (incoming and reflected)
if the impinging wave is polarized perpendicularly to the surface or is purely s- or p-polarized, 1 is added, else 2
Definition at line 1105 of file layer_pcm.F90.
| complex(real64) function, public layer_pcm_oct_m::layer_pcm_get_reflectivity | ( | integer, intent(in) | ifield, |
| integer, intent(in) | polarization, | ||
| type(lpcm_substrate_t), intent(in) | substrate, | ||
| real(real64), intent(in) | frequency | ||
| ) |
Returns the reflectivity r(w) of the substrate for a given frequency w (differs for s and p polarization)
A transfer matrix T(w) is computed as described in Sec. IIIb1 Then, \(r^{(s)}(\omega)=T^{(s)}_{21}(\omega)/T^{(s)}_{11}(\omega)\) [Eq. (28)] \(r^{(p)}(\omega)=-T^{(p)}_{21}(\omega)/T^{(p)}_{11}(\omega)\) [Eq. (31)]
Definition at line 1138 of file layer_pcm.F90.
|
private |
Returns the out-of-plane component of the wave vector in an anisotropic dielectric layer (differs for s and p polarization)
See Eq. (26) For fields \(\propto e^{i\omega t}\) an evanescent wave decays into the substrate for \(\Im k_z < 0\)
Definition at line 1206 of file layer_pcm.F90.
| integer, parameter, public layer_pcm_oct_m::lpcm_mode_eq = 0 |
static
Definition at line 124 of file layer_pcm.F90.
| integer, parameter, public layer_pcm_oct_m::lpcm_mode_noneq = 1 |
dynamic, where provided
Definition at line 124 of file layer_pcm.F90.
| integer, parameter, public layer_pcm_oct_m::lpcm_s_polarization = 1 |
Polarization of a field with respect to the plane of incidence.
Definition at line 129 of file layer_pcm.F90.
| integer, parameter, public layer_pcm_oct_m::lpcm_p_polarization = 2 |
Definition at line 129 of file layer_pcm.F90.
|
private |
Propagation direction of a field with respect to the surface.
Definition at line 134 of file layer_pcm.F90.
|
private |
Definition at line 134 of file layer_pcm.F90.
| logical, parameter, public layer_pcm_oct_m::lpcm_delta = .true. |
D_e.
Definition at line 139 of file layer_pcm.F90.
| logical, parameter, public layer_pcm_oct_m::lpcm_sigma = .false. |
S_e.
Definition at line 139 of file layer_pcm.F90.