Octopus
tdtdm.F90
Go to the documentation of this file.
1!! Copyright (C) 2019-2021 N. Tancogne-Dejean
2!!
3!! This program is free software; you can redistribute it and/or modify
4!! it under the terms of the GNU General Public License as published by
5!! the Free Software Foundation; either version 2, or (at your option)
6!! any later version.
7!!
8!! This program is distributed in the hope that it will be useful,
9!! but WITHOUT ANY WARRANTY; without even the implied warranty of
10!! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11!! GNU General Public License for more details.
12!!
13!! You should have received a copy of the GNU General Public License
14!! along with this program; if not, write to the Free Software
15!! Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
16!! 02110-1301, USA.
17!!
18
19#include "global.h"
20
21program tdtdm
22 use batch_oct_m
24 use comm_oct_m
25 use debug_oct_m
28 use fft_oct_m
29 use global_oct_m
30 use grid_oct_m
32 use io_oct_m
37 use mesh_oct_m
39 use mpi_oct_m
42 use parser_oct_m
51 use types_oct_m
52 use unit_oct_m
54 use xc_oct_m
55
56 implicit none
57
58 integer :: in_file, ii, jj, kk, ierr, ip_h, irow, ifreq, nrow, it
59 integer :: ik, ist, uist, istep, ikpoint, irep, out_file, iop, idim
60 integer :: time_steps, energy_steps, istart, iend, ntiter, Nreplica, Ntrans
61 real(real64) :: dt, tt, weight, kpoint(3), kpoint_sym(3), kred(3), kred_sym(3)
62 real(real64) :: xx_h_sym(3)
63 integer :: irep_h, ip_h_sym, rankmin
64 real(real64) :: start_time, dmin
65 real(real64), allocatable :: Et(:), ftreal(:, :, :), ftimag(:, :, :), tmp(:), omega(:)
66 complex(real64), allocatable :: Xiak(:,:,:), Yiak(:,:,:)
67 real(real64), allocatable :: proj_r(:,:,:,:), proj_i(:,:,:,:)
68 real(real64), allocatable :: proj_r_corr(:,:), proj_i_corr(:,:), centers(:,:)
69 complex(real64), allocatable :: tdm(:,:), tdm_1D(:,:,:,:)
70 complex(real64), allocatable, target :: psi(:,:), upsi(:,:)
71 complex(real64), allocatable :: phase(:,:,:), ftcmplx(:,:)
72 complex(real64), pointer :: psi_sym(:,:), upsi_sym(:,:)
73 type(spectrum_t) :: spectrum
74 type(electrons_t), pointer :: sys
75 type(batch_t) :: projb_r, projb_i, ftrealb, ftimagb
76 character(len=MAX_PATH_LEN) :: fname
77 type(states_elec_t), pointer :: st
78 type(states_elec_t) :: gs_st
79 type(restart_t) :: restart
80 type(unit_t) :: fn_unit
81 integer :: kpt_start, kpt_end, supercell(3), nomega, ncols
82 type(block_t) :: blk
83 real(real64) :: pos_h(3), norm
84
85 ! Initializion
86 call global_init()
87 call parser_init()
88
89 call messages_init()
90 call io_init()
91
93
94 call messages_experimental("oct-tdtdm utility")
97
98 call calc_mode_par%set_parallelization(p_strategy_states, default = .false.)
100 call sys%init_parallelization(mpi_world)
101
102 call spectrum_init(spectrum, global_namespace)
103
104 st => sys%st
105
106 if(sys%st%d%ispin == spinors) then
107 call messages_not_implemented('oct-tdtdm with spinors')
108 end if
109
110 if(st%parallel_in_states) then
111 call messages_not_implemented("oct-tdtdm with states parallelization")
112 end if
113
114 if(sys%gr%parallel_in_domains) then
115 call messages_not_implemented("oct-tdtdm with domain parallelization")
116 end if
117
118 !%Variable TDTDMFrequencies
119 !%Type block
120 !%Section Utilities::oct-tdtdm
121 !%Description
122 !% This block defines for which frequencies the analysis is performed.
123 !%
124 !% Each row of the block indicates a frequency.
125 !%End
126 if (parse_block(global_namespace, 'TDTDMFrequencies', blk) == 0) then
127
128 nrow = parse_block_n(blk)
129 nomega = nrow
130
131 safe_allocate(omega(1:nrow))
132 !read frequencies
133 do irow = 0, nrow-1
134 call parse_block_float(blk, irow, 0, omega(irow+1))
135 end do
136
137 call parse_block_end(blk)
138 else
139 message(1) = "oct-tdtdm: TDTDMFrequencies must be defined."
140 call messages_fatal(1)
141 end if
142
143 ! We check that the resonant and antiresonant transitions are contained in the
144 ! energy range of the Fourier transforms
145 if(any(omega > spectrum%max_energy)) then
146 message(1) = "One requested frequecy is larger than PropagationSpectrumMaxEnergy."
147 message(2) = "Please increase the value of PropagationSpectrumMaxEnergy."
148 call messages_fatal(2)
149 end if
150 if(any(omega > -spectrum%min_energy)) then
151 message(1) = "One requested frequency is larger than -PropagationSpectrumMinEnergy."
152 message(2) = "Please decrease the value of PropagationSpectrumMinEnergy."
153 call messages_fatal(2)
154 end if
155
156
157 call states_elec_copy(gs_st, st, exclude_wfns = .true., exclude_eigenval = .true.)
158
159 safe_deallocate_a(gs_st%node)
160
161 call restart%init(global_namespace, restart_proj, restart_type_load, sys%mc, ierr, mesh=sys%gr)
162 if(ierr == 0) call states_elec_look(restart, ii, jj, gs_st%nst, ierr)
163 if(ierr /= 0) then
164 message(1) = "oct-tdtdm: Unable to read states information."
165 call messages_fatal(1)
166 end if
167
168 ! allocate memory
169 safe_allocate(gs_st%occ(1:gs_st%nst, 1:gs_st%nik))
170 safe_allocate(gs_st%eigenval(1:gs_st%nst, 1:gs_st%nik))
171
172 ! We want all the task to have all the states
173 ! States can be distibuted for the states we propagate.
174 safe_allocate(gs_st%node(1:gs_st%nst))
175 gs_st%node(:) = 0
176 call kpoints_distribute(gs_st, sys%mc)
178
179 kpt_start = gs_st%d%kpt%start
180 kpt_end = gs_st%d%kpt%end
181
182 kpoint = m_zero
183
184 gs_st%eigenval = huge(gs_st%eigenval)
185 gs_st%occ = m_zero
186 if(gs_st%d%ispin == spinors) then
187 safe_deallocate_a(gs_st%spin)
188 safe_allocate(gs_st%spin(1:3, 1:gs_st%nst, 1:gs_st%nik))
189 end if
190
191 call states_elec_allocate_wfns(gs_st, sys%gr, type_cmplx)
192 call states_elec_load(restart, global_namespace, sys%space, gs_st, sys%gr, sys%kpoints, ierr)
193 if(ierr /= 0 .and. ierr /= (gs_st%st_end-gs_st%st_start+1)*(kpt_end-kpt_start+1)*gs_st%d%dim) then
194 message(1) = "oct-tdtdm: Unable to read wavefunctions for TDOutput."
195 call messages_fatal(1)
196 end if
197 call restart%end()
198
199
200 in_file = io_open('td.general/projections', action='read', status='old')
201 call io_skip_header(in_file)
202 call spectrum_count_time_steps(global_namespace, in_file, time_steps, dt)
203 dt = units_to_atomic(units_out%time, dt)
204
205
206 safe_allocate(tmp(1:st%nst*gs_st%nst*st%nik*2))
207 safe_allocate(proj_r(1:time_steps, 1:gs_st%nst, 1:st%nst, 1:st%nik))
208 safe_allocate(proj_i(1:time_steps, 1:gs_st%nst, 1:st%nst, 1:st%nik))
209
210
211 call io_skip_header(in_file)
212
213 do ii = 1, time_steps
214 read(in_file, *) jj, tt, (tmp(kk), kk = 1, st%nst*gs_st%nst*st%nik*2)
215 do ik = 1, st%nik
216 do ist = 1, st%nst
217 do uist = 1, gs_st%nst
218 jj = (ik-1)*st%nst*gs_st%nst + (ist-1)*gs_st%nst + uist
219 proj_r(ii, uist, ist, ik) = tmp((jj-1)*2+1)
220 ! Here we add a minus sign, as we want to get <\phi_0 | \psi(t)>
221 ! and td_occup computes the complex conjugaute of this
222 proj_i(ii, uist, ist, ik) = -tmp((jj-1)*2+2)
223 end do
224 end do
225 end do
226 end do
227 safe_deallocate_a(tmp)
228
229 call io_close(in_file)
230
231 write(message(1), '(a, i7, a)') "oct-tdtdm: Read ", time_steps, " steps from file '"// &
232 trim(io_workpath('td.general/projections'))//"'"
233 call messages_info(1)
234
235 start_time = spectrum%start_time
236
237 ! Phase correction of the projections before doing the Fourier transforms
238 ! See Eq. (5) of Williams et al., JCTC 17, 1795 (2021)
239 ! We need to multiply C_ik(t)e^{-ie_kt} (the projection of \phi_i(t) on \phi_k^GS)
240 ! by e^{ie_it}, which is obtained by the cc of the projection of \phi_i(t) on \phi_i^GS
241 ! Here we only care about optical transitions (so TD occupied to GS unocc)
242 safe_allocate(proj_r_corr(1:time_steps, 1:gs_st%nst*st%nst*(kpt_end-kpt_start+1)))
243 safe_allocate(proj_i_corr(1:time_steps, 1:gs_st%nst*st%nst*(kpt_end-kpt_start+1)))
244 proj_r_corr = m_zero
245 proj_i_corr = m_zero
246 do ik = kpt_start, kpt_end
247 do ist = 1, st%nst
248 do uist = ist+1, gs_st%nst
249 jj = (ik-kpt_start)*st%nst*gs_st%nst+(ist-1)*gs_st%nst+uist
250 do ii = 1, time_steps
251 norm = hypot(proj_r(ii, ist, ist, ik),proj_i(ii, ist, ist, ik))
252 if (norm > m_epsilon) then
253 proj_r_corr(ii, jj) = (proj_r(ii, uist, ist, ik) * proj_r(ii, ist, ist, ik) &
254 + proj_i(ii, uist, ist, ik) * proj_i(ii, ist, ist, ik))/norm
255 proj_i_corr(ii, jj) =(-proj_r(ii, uist, ist, ik) * proj_i(ii, ist, ist, ik) &
256 + proj_i(ii, uist, ist, ik) * proj_r(ii, ist, ist, ik))/norm
257 else
258 proj_r_corr(ii, jj) = m_zero
259 proj_i_corr(ii, jj) = m_zero
260 end if
261 end do
262 end do
263 end do
264 end do
265
266 safe_deallocate_a(proj_r)
267 safe_deallocate_a(proj_i)
268
269 ! Find out the iteration numbers corresponding to the time limits.
270 call spectrum_fix_time_limits(spectrum, time_steps, dt, istart, iend, ntiter)
271 istart = max(1, istart)
272 energy_steps = spectrum_nenergy_steps(spectrum)
273
274 safe_allocate(ftreal(1:energy_steps, 1:st%nst*gs_st%nst*(kpt_end-kpt_start+1), 1:2))
275 safe_allocate(ftimag(1:energy_steps, 1:st%nst*gs_st%nst*(kpt_end-kpt_start+1), 1:2))
276
277 call batch_init(projb_r, 1, 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1), proj_r_corr)
278 call batch_init(projb_i, 1, 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1), proj_i_corr)
279 call batch_init(ftrealb, 1, 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1), ftreal(:,:,1))
280 call batch_init(ftimagb, 1, 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1), ftimag(:,:,1))
281
282 write(message(1), '(a)') "oct-tdtdm: Fourier transforming real part of the projections"
283 call messages_info(1)
284
285 call spectrum_fourier_transform(spectrum%method, spectrum_transform_cos, spectrum%noise, &
286 istart, iend, spectrum%start_time, dt, projb_r, spectrum%min_energy, spectrum%max_energy, spectrum%energy_step, ftrealb)
287
288 call spectrum_fourier_transform(spectrum%method, spectrum_transform_sin, spectrum%noise, &
289 istart, iend, spectrum%start_time, dt, projb_r, spectrum%min_energy, spectrum%max_energy, spectrum%energy_step, ftimagb)
290
291 call ftrealb%end()
292 call ftimagb%end()
293
294 safe_allocate(ftcmplx(1:energy_steps, 1:st%nst*gs_st%nst*(kpt_end-kpt_start+1)))
295 do ii = 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1)
296 ftcmplx(1:energy_steps,ii) = cmplx(ftreal(1:energy_steps,ii,1), ftimag(1:energy_steps,ii,1), real64)
297 end do
298
299 write(message(1), '(a)') "oct-tdtdm: Fourier transforming imaginary part of the projections"
300 call messages_info(1)
301
302 call batch_init(ftrealb, 1, 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1), ftreal(:,:,2))
303 call batch_init(ftimagb, 1, 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1), ftimag(:,:,2))
304
305 call spectrum_fourier_transform(spectrum%method, spectrum_transform_cos, spectrum%noise, &
306 istart, iend, spectrum%start_time, dt, projb_i, spectrum%min_energy, spectrum%max_energy, spectrum%energy_step, ftrealb)
307
308 call spectrum_fourier_transform(spectrum%method, spectrum_transform_sin, spectrum%noise, &
309 istart, iend, spectrum%start_time, dt, projb_i, spectrum%min_energy, spectrum%max_energy, spectrum%energy_step, ftimagb)
310
311 call projb_i%end()
312 call projb_r%end()
313 call ftrealb%end()
314 call ftimagb%end()
315 safe_deallocate_a(proj_r_corr)
316 safe_deallocate_a(proj_i_corr)
317
318 do ii = 1, st%nst*gs_st%nst*(kpt_end-kpt_start+1)
319 ftcmplx(1:energy_steps,ii) = ftcmplx(1:energy_steps,ii) + m_zi*ftreal(1:energy_steps,ii,2) - ftimag(1:energy_steps,ii,2)
320 end do
321
322 safe_deallocate_a(ftreal)
323 safe_deallocate_a(ftimag)
324
325 write(message(1), '(a)') "oct-tdtdm: Constructing the two-particle wavefunctions."
326 call messages_info(1)
327
328 !%Variable SupercellDimensions
329 !%Type block
330 !%Default KPointsGrid
331 !%Section Utilities::oct-tdtdm
332 !%Description
333 !% This block allows to specify the size of the supercell used to plot excitonic wavefunctions.
334 !% If not specified, the code uses the number of k-points for defining the size of the supercell.
335 !%End
336 if (parse_is_defined(sys%namespace, 'SupercellDimensions')) then
337 if (parse_block(sys%namespace, 'SupercellDimensions', blk) == 0) then
338 ncols = parse_block_cols(blk, 0)
339 if (ncols /= sys%space%dim) then
340 write(message(1),'(a,i3,a,i3)') 'SupercellDimensions has ', ncols, ' columns but must have ', sys%space%dim
341 call messages_fatal(1, namespace=sys%namespace)
342 end if
343 do ii = 1, sys%space%dim
344 call parse_block_integer(blk, 0, ii - 1, supercell(ii))
345 end do
346
347 call parse_block_end(blk)
348 end if
349 else
350 supercell(1:sys%space%dim) = sys%kpoints%nik_axis(1:sys%space%dim)
351 end if
352
353 nreplica = product(supercell(1:sys%space%dim))
354
355 ! The center of each replica of the unit cell
356 safe_allocate(centers(1:sys%space%dim, 1:nreplica))
357 irep = 1
358 do ii = 0, supercell(1)-1
359 do jj = 0, supercell(2)-1
360 do kk = 0, supercell(3)-1
361 centers(1, irep) = -floor((supercell(1)-1)/m_two)+ii
362 centers(2, irep) = -floor((supercell(2)-1)/m_two)+jj
363 centers(3, irep) = -floor((supercell(3)-1)/m_two)+kk
364 centers(:, irep) = matmul(sys%ions%latt%rlattice, centers(:, irep))
365 irep = irep + 1
366 end do
367 end do
368 end do
369
370 ! The phase for each center
371 irep = 0
372 do ik = kpt_start, kpt_end
373 ikpoint = gs_st%d%get_kpoint_index(ik)
374 irep = max(irep, kpoints_get_num_symmetry_ops(sys%kpoints, ikpoint))
375 end do
376 safe_allocate(phase(kpt_start:kpt_end, 1:irep, 1:nreplica))
377 do irep = 1, nreplica
378 do ik = kpt_start, kpt_end
379 ikpoint = gs_st%d%get_kpoint_index(ik)
380 kpoint(1:sys%space%dim) = sys%kpoints%get_point(ikpoint)
381 do ii = 1, kpoints_get_num_symmetry_ops(sys%kpoints, ikpoint)
382 iop = kpoints_get_symmetry_ops(sys%kpoints, ikpoint, ii)
383
384 if (sys%kpoints%use_symmetries) then !We apply the symmetry
385 call kpoints_to_reduced(sys%kpoints%latt, kpoint, kred)
386 call symmetries_apply_kpoint_red(sys%kpoints%symm, iop, kred, kred_sym)
387 call kpoints_to_absolute(sys%kpoints%latt, kred_sym, kpoint_sym)
388 else
389 kpoint_sym = kpoint
390 end if
391 phase(ik, ii, irep) = exp(-m_zi*sum(kpoint_sym(1:sys%space%dim)*centers(:, irep)))
392 end do
393 end do
394 end do
395
396 ! Position of the hole, here assumed to be on top of the first atom
397 ! To be obtained from the input file
398 if(sys%space%dim > 1) then
399 call tdtdm_get_hole_position(pos_h, ip_h)
400 end if
401
402 ntrans = 0
403 ! Here we assume that there is a clear gap, so the information at Gamma is enough
404 do ist = 1, gs_st%nst
405 if(abs(gs_st%occ(ist, 1)) < m_min_occ) cycle
406
407 do uist = 1, gs_st%nst
408 if(abs(gs_st%occ(uist, 1)) > m_min_occ) cycle
409 weight = gs_st%kweights(1) * (gs_st%occ(ist, 1)-gs_st%occ(uist, 1))
410 if(abs(weight) < m_min_occ) cycle
411 ntrans = ntrans + 1
412 end do
413 end do
414 if(ntrans == 0) then
415 write(message(1), '(a)') "oct-tdtdm: No transition found."
416 write(message(2), '(a)') "Please check that unoccupied states are included in the ground state calculation."
417 call messages_fatal(2)
418 end if
419
420 safe_allocate(xiak(1:st%nst, 1:gs_st%nst, 1:st%nik))
421 safe_allocate(yiak(1:st%nst, 1:gs_st%nst, 1:st%nik))
422 safe_allocate(et(1:ntrans*st%nik))
423 safe_allocate(psi(1:sys%gr%np, 1:gs_st%d%dim))
424 safe_allocate(upsi(1:sys%gr%np, 1:gs_st%d%dim))
425
426 if(sys%kpoints%use_symmetries) then
427 safe_allocate(psi_sym(1:sys%gr%np, 1:st%d%dim))
428 safe_allocate(upsi_sym(1:sys%gr%np, 1:st%d%dim))
429 end if
430
431 select case(sys%space%dim)
432 case(2,3)
433 safe_allocate(tdm(1:sys%gr%np, 1:nreplica))
434 case(1)
435 safe_allocate(tdm_1d(1:sys%gr%np, 1:sys%gr%np, 1:nreplica, 1:nreplica))
436 end select
437
438 do ifreq = 1, nomega
439
440 write(message(1), '(a, f6.4, a)') "oct-tdtdm: Constructing the two-particle wavefunction at ", omega(ifreq), " Ha."
441 call messages_info(1)
442
443 select case(sys%space%dim)
444 case(2,3)
445 tdm = m_z0
446 case(1)
447 tdm_1d = m_z0
448 end select
449
450 et = m_zero
451 xiak = m_z0
452 yiak = m_z0
453
454 ! Local transition index
455 it = (kpt_start-1)*ntrans + 1
456
457 do ik = kpt_start, kpt_end
458 ikpoint = st%d%get_kpoint_index(ik)
459
460 do ist = 1, st%nst
461 if(abs(gs_st%occ(ist, ik)) < m_min_occ) cycle
462
463 call states_elec_get_state(gs_st, sys%gr, ist, ik, psi)
464 if (sys%hm%phase%is_allocated()) then
465 call sys%hm%phase%apply_to_single(psi, sys%gr%np, gs_st%d%dim, ik, .false.)
466 end if
467
468 do uist = 1, gs_st%nst
469 if(abs(gs_st%occ(uist, ik)) > m_min_occ) cycle
470
471 ! For a given requested frequency, we get the corresponding values of Xia and Yia
472 ! One correspond to the +\Omega frequency, the other one to the -\Omega frequency
473 ! For Xiak, we use the fact that TF[f*](\Omega) = (TF[f](-\Omega))^*
474 jj = (ik-kpt_start)*st%nst*gs_st%nst+(ist-1)*gs_st%nst+uist
475 istep = int((+omega(ifreq)-spectrum%min_energy)/spectrum%energy_step)
476 xiak(ist, uist, ik) = conjg(ftcmplx(istep, jj))
477 istep = int((+omega(ifreq)-spectrum%min_energy)/spectrum%energy_step)
478 yiak(ist, uist, ik) = ftcmplx(istep, jj)
479
480
481 weight = gs_st%kweights(ik) * (gs_st%occ(ist, ik)-gs_st%occ(uist, ik)) &
482 / kpoints_get_num_symmetry_ops(sys%kpoints, ikpoint)
483 if(abs(weight) < m_epsilon) cycle
484
485 call states_elec_get_state(gs_st, sys%gr, uist, ik, upsi)
486 if(sys%hm%phase%is_allocated()) then
487 call sys%hm%phase%apply_to_single(upsi, sys%gr%np, st%d%dim, ik, .false.)
488 end if
489
490 do ii = 1, kpoints_get_num_symmetry_ops(sys%kpoints, ikpoint)
491 iop = kpoints_get_symmetry_ops(sys%kpoints, ikpoint, ii)
492
493 if(sys%kpoints%use_symmetries) then
494 do idim = 1, st%d%dim
495 call zgrid_symmetrize_single(sys%gr, iop, psi(:,idim), psi_sym(:,idim))
496 call zgrid_symmetrize_single(sys%gr, iop, upsi(:,idim), upsi_sym(:,idim))
497 end do
498
499 ! We need to get the position of the hole after applying the symmetry operation too
500 xx_h_sym = symm_op_apply_cart(sys%kpoints%symm%ops(iop), pos_h)
501 xx_h_sym = sys%ions%latt%fold_into_cell(xx_h_sym)
502 ! At the moment, we ignore rankmin
503 assert(.not.sys%gr%parallel_in_domains)
504 ip_h_sym = mesh_nearest_point(sys%gr, xx_h_sym, dmin, rankmin)
505 else
506 psi_sym => psi
507 upsi_sym => upsi
508 ip_h_sym = ip_h
509 end if
510
511 ! We now compute the single mode TDTDM
512 ! See Eq. (5) of Williams et al., JCTC 17, 1795 (2021)
513 ! We take here the complex conjugate of the 2-body wavefunction
514 select case(sys%space%dim)
515 case(2,3)
516 do irep = 1, nreplica
517 call lalg_axpy(sys%gr%np, phase(ik, ii, irep) * weight &
518 * conjg(xiak(ist,uist,ik))*conjg(psi_sym(ip_h_sym,1)), upsi_sym(:, 1), tdm(:,irep))
519 call lalg_axpy(sys%gr%np, phase(ik, ii, irep) * weight &
520 * yiak(ist,uist,ik)*conjg(upsi_sym(ip_h_sym,1)), psi_sym(:, 1), tdm(:,irep))
521 end do
522 case(1)
523 ! In the 1D case, we contruct the full TDTDM of r_e, r_h
524 do irep_h = 1, nreplica
525 do irep = 1, nreplica
526 do ip_h = 1, sys%gr%np
527 call lalg_axpy(sys%gr%np, phase(ik, ii, irep) * conjg(phase(ik, ii, irep_h)) &
528 * weight * conjg(xiak(ist,uist,ik)) * conjg(psi_sym(ip_h,1)), &
529 upsi_sym(:, 1), tdm_1d(:, ip_h, irep, irep_h))
530 call lalg_axpy(sys%gr%np, phase(ik, ii, irep) * conjg(phase(ik, ii, irep_h)) &
531 * weight * conjg(yiak(ist,uist,ik)) * conjg(upsi_sym(ip_h,1)), &
532 psi_sym(:, 1), tdm_1d(:, ip_h, irep, irep_h))
533 end do
534 end do
535 end do
536 end select
537
538 end do ! ii
539
540 et(it) = gs_st%eigenval(uist, ik) - gs_st%eigenval(ist, ik)
541 it = it + 1
542 end do
543 end do
544 end do
545
546 if(gs_st%d%kpt%parallel) then
547 if(sys%space%dim > 1) then
548 call comm_allreduce(gs_st%d%kpt%mpi_grp, tdm)
549 else
550 call comm_allreduce(gs_st%d%kpt%mpi_grp, tdm_1d)
551 end if
552 call comm_allreduce(gs_st%d%kpt%mpi_grp, et)
553 call comm_allreduce(gs_st%d%kpt%mpi_grp, xiak)
554 call comm_allreduce(gs_st%d%kpt%mpi_grp, yiak)
555 end if
556
558
560
561 end do ! ifreq
562
563 safe_deallocate_a(et)
564 safe_deallocate_a(xiak)
565 safe_deallocate_a(yiak)
566 safe_deallocate_a(tdm)
567 safe_deallocate_a(tdm_1d)
568
569 safe_deallocate_a(psi)
570 safe_deallocate_a(upsi)
571 if(sys%kpoints%use_symmetries) then
572 safe_deallocate_p(psi_sym)
573 safe_deallocate_p(upsi_sym)
574 end if
575 safe_deallocate_a(ftcmplx)
576 safe_deallocate_a(centers)
577 safe_deallocate_a(phase)
578 safe_deallocate_a(omega)
579
580 safe_deallocate_p(sys)
581 call states_elec_end(gs_st)
582 call fft_all_end()
583 call io_end()
585 call messages_end()
586 call parser_end()
587 call global_end()
588
589contains
590
591 ! -----------------------------------------------------------------
592 ! Determines the position of the hole, either from the input or using the
593 ! first atom in the cell.
594 ! This returns the index of the point in the mesh closest to the position.
595 subroutine tdtdm_get_hole_position(xx_h, ip_h)
596 real(real64), intent(out) :: xx_h(1:sys%space%dim)
597 integer, intent(out) :: ip_h
598
599 real(real64) :: dmin
600 integer :: idir, rankmin
601
603
604 !%Variable TDTDMHoleCoordinates
605 !%Type float
606 !%Section Utilities::oct-tdtdm
607 !%Description
608 !% The position of the hole used to compute the TDTDM,
609 !% in Cartesian coordinates.
610 !% Note that the code will use the closest grid point.
611 !%
612 !% The coordinates of the hole are specified in the following way
613 !% <tt>%TDTDMHoleCoordinates
614 !% <br>&nbsp;&nbsp;hole_x | hole_y | hole_z
615 !% <br>%</tt>
616 !%
617 !% If TDTDMHoleCoordinates or TDTDMHoleReducedCoordinates are not specified,
618 !% the code will use the coordinate of the first atom in the cell.
619 !%End
620
621 if(parse_block(global_namespace, 'TDTDMHoleCoordinates', blk) == 0) then
622 if(parse_block_cols(blk,0) < sys%space%dim) then
623 call messages_input_error(global_namespace, 'TDTDMHoleCoordinates')
624 end if
625 do idir = 1, sys%space%dim
626 call parse_block_float(blk, 0, idir - 1, xx_h(idir), units_inp%length)
627 end do
628 call parse_block_end(blk)
629 else
630 !%Variable TDTDMHoleReducedCoordinates
631 !%Type float
632 !%Section Utilities::oct-tdtdm
633 !%Description
634 !% Same as TDTDMHoleCoordinates, except that coordinates are given in reduced coordinates
635 !%End
636
637 if(parse_block(global_namespace, 'TDTDMHoleReducedCoordinates', blk) == 0) then
638 if(parse_block_cols(blk,0) < sys%space%dim) then
639 call messages_input_error(global_namespace, 'TDTDMHoleReducedCoordinates')
640 end if
641 do idir = 1, sys%space%dim
642 call parse_block_float(blk, 0, idir - 1, xx_h(idir))
643 end do
644 call parse_block_end(blk)
645 xx_h = sys%ions%latt%red_to_cart(xx_h)
646 else
647 xx_h(1:sys%space%dim) = sys%ions%pos(1:sys%space%dim, 1)
648 end if
649 end if
650
651 ! We bring back the hole into the cell
652 xx_h = sys%ions%latt%fold_into_cell(xx_h)
653
654 ! At the moment, we ignore rankmin
655 assert(.not.sys%gr%parallel_in_domains)
656 ip_h = mesh_nearest_point(sys%gr, xx_h, dmin, rankmin)
657 write(message(1), '(a, 3(1x,f7.4,a))') "oct-tdtdm: Requesting the hole at (", xx_h(1), &
658 ",", xx_h(2), ",", xx_h(3), ")."
659 call mesh_r(sys%gr, ip_h, dmin, coords=xx_h)
660 write(message(2), '(a, 3(1x,f7.4,a))') "oct-tdtdm: Setting the hole at (", xx_h(1), &
661 ",", xx_h(2), ",", xx_h(3), ")."
662
663 call messages_info(2)
664
666 end subroutine tdtdm_get_hole_position
667
668 subroutine tdtdm_output_density()
669 real(real64), allocatable :: den(:,:), den_1d(:,:,:,:)
670 real(real64) :: norm, xx(3), xx_h(3)
671 integer :: iunit
672
673 push_sub(tdtdm_output_density)
674
675 ! We compute the TDM density
676 select case(sys%space%dim)
677 case(2,3)
678 safe_allocate(den(1:sys%gr%np, 1:nreplica))
679 do irep = 1, nreplica
680 do ii = 1, sys%gr%np
681 den(ii, irep) = real(tdm(ii, irep)*conjg(tdm(ii, irep)), real64)
682 end do
683 end do
684
685 ! Here we renormalize to avoid too small numbers in the outputs
686 norm = maxval(den)
687 call lalg_scal(sys%gr%np, nreplica, m_one/norm, den)
688
689 case(1)
690 safe_allocate(den_1d(1:sys%gr%np, 1:sys%gr%np, 1:nreplica, 1:nreplica))
691 do irep_h = 1, nreplica
692 do irep = 1, nreplica
693 do ip_h = 1, sys%gr%np
694 do ii = 1, sys%gr%np
695 tdm_1d(ii, ip_h, irep, irep_h) = conjg(tdm_1d(ii, ip_h, irep, irep_h))
696 den_1d(ii, ip_h, irep, irep_h) = real(tdm_1d(ii, ip_h, irep, irep_h)*conjg(tdm_1d(ii,ip_h, irep, irep_h)), real64)
697 end do
698 end do
699 end do
700 end do
701 end select
702
703 fn_unit = units_out%length**(-sys%space%dim)
704
705 select case(sys%space%dim)
706 case(2,3)
707 write(fname, '(a, f0.4)') 'tdm_density-0', omega(ifreq)
708 call io_function_output_supercell(io_function_fill_how("XCrySDen"), "td.general", fname, &
709 sys%gr, sys%space, sys%ions%latt, den, centers, supercell, fn_unit, &
710 ierr, global_namespace, pos=sys%ions%pos, atoms=sys%ions%atom, grp = st%dom_st_kpt_mpi_grp, extra_atom=pos_h)
711
712 call io_function_output_supercell(io_function_fill_how("PlaneZ"), "td.general", fname, &
713 sys%gr, sys%space, sys%ions%latt, den, centers, supercell, fn_unit, &
714 ierr, global_namespace, grp = st%dom_st_kpt_mpi_grp)
715
716 safe_deallocate_a(den)
717
718 case(1)
719
720 call tdtdm_get_hole_position(pos_h, ip_h)
721 irep_h = floor(supercell(1)/m_two)
722
723 write(fname, '(a, f0.4)') 'tdm_density-0', omega(ifreq)
724 call io_function_output_supercell(io_function_fill_how("AxisX"), "td.general", fname, &
725 sys%gr, sys%space, sys%ions%latt, &
726 den_1d(:,ip_h,:,irep_h), centers, supercell, fn_unit, ierr, global_namespace, &
727 grp = st%dom_st_kpt_mpi_grp)
728
729 write(fname, '(a, f0.4)') 'tdm_wfn-0', omega(ifreq)
730 call io_function_output_supercell(io_function_fill_how("AxisX"), "td.general", fname, &
731 sys%gr, sys%space, sys%ions%latt, &
732 tdm_1d(:,ip_h,:,irep_h), centers, supercell, fn_unit, ierr, global_namespace, &
733 grp = st%dom_st_kpt_mpi_grp)
734
735 assert(.not.sys%gr%parallel_in_domains)
736 if (mpi_world%is_root()) then
737 write(fname, '(a, f0.4)') 'td.general/tdm_density-0', omega(ifreq)
738 iunit = io_open(fname, action='write')
739 write(iunit, '(a)', iostat=ierr) '# r_e r_h Re(\Psi(r_e,r_h)) Im(\Psi(r_e,r_h)) |\Psi(r_e,r_h)|^2'
740
741 do irep_h = 1, nreplica
742 do ip_h = 1, sys%gr%np
743 xx_h = units_from_atomic(units_out%length, mesh_x_global(sys%gr, i4_to_i8(ip_h)) &
744 + centers(1:sys%space%dim, irep_h))
745
746 do irep = 1, nreplica
747 do ii = 1, sys%gr%np
748 xx = units_from_atomic(units_out%length, mesh_x_global(sys%gr, i4_to_i8(ii)) &
749 + centers(1:sys%space%dim, irep))
750 write(iunit, '(5es23.14E3)', iostat=ierr) xx(1), xx_h(1), &
751 real(units_from_atomic(fn_unit, tdm_1D(ii, ip_h, irep, irep_h)), real64) ,&
752 aimag(units_from_atomic(fn_unit, tdm_1D(ii, ip_h, irep, irep_h))), &
753 units_from_atomic(fn_unit, den_1D(ii, ip_h, irep, irep_h))
754 end do
755 end do
756 end do
757 end do
758 end if
759
760 safe_deallocate_a(den_1d)
761 end select
762
764 pop_sub(tdtdm_output_density)
765 end subroutine tdtdm_output_density
766
767 subroutine tdtdm_excitonic_weight()
768 real(real64), allocatable :: weight(:,:)
769
770 if (.not. mpi_world%is_root()) return
771
772 push_sub(tdtdm_excitonic_weight)
773
774 safe_allocate(weight(1:st%nik, 1:gs_st%nst))
775 weight = m_zero
776
777 do ik = 1, st%nik
778 do ist = 1, st%nst
779 if(abs(gs_st%occ(ist, ik)) < m_min_occ) cycle
780
781 do uist = ist+1, gs_st%nst
782 if(abs(gs_st%occ(uist, ik)) > m_min_occ) cycle
783
784 weight(ik, ist) = weight(ik, ist) + abs(xiak(ist, uist, ik))**2
785 weight(ik, uist) = weight(ik,uist) + abs(yiak(ist, uist, ik))**2
786 end do
787 end do
788 end do
789
790 write(fname, '(a, f0.4)') 'td.general/tdm_weights-0', omega(ifreq)
791 out_file = io_open(fname, action='write')
792 write(out_file, '(a)') '# ik - kx - ky - kz - sum weights - eigenval and weights(ist,ik) '
793 do ik = 1, st%nik
794 ikpoint = st%d%get_kpoint_index(ik)
795 kpoint(1:sys%space%dim) = sys%kpoints%reduced%point1BZ(1:sys%space%dim,ikpoint)
796 write(out_file, '(i4,4e15.6)', advance='no') ik, kpoint(1:3), sum(weight(ik, 1:gs_st%nst))
797 do uist = 1, gs_st%nst-1
798 write(out_file, '(2e15.6)', advance='no') gs_st%eigenval(uist, ik), weight(ik, uist)
799 end do
800 write(out_file, '(e15.6)') weight(ik, uist)
801 end do
802 call io_close(out_file)
803
804 safe_deallocate_a(weight)
805
807 end subroutine tdtdm_excitonic_weight
808
809end program tdtdm
810
811!! Local Variables:
812!! mode: f90
813!! coding: utf-8
814!! End:
initialize a batch with existing memory
Definition: batch.F90:277
constant times a vector plus a vector
Definition: lalg_basic.F90:173
scales a vector by a constant
Definition: lalg_basic.F90:159
double hypot(double __x, double __y) __attribute__((__nothrow__
double exp(double __x) __attribute__((__nothrow__
double floor(double __x) __attribute__((__nothrow__
This module implements batches of mesh functions.
Definition: batch.F90:135
This module handles the calculation mode.
type(calc_mode_par_t), public calc_mode_par
Singleton instance of parallel calculation mode.
integer, parameter, public p_strategy_states
parallelization in states
integer, parameter, public spinors
Fast Fourier Transform module. This module provides a single interface that works with different FFT ...
Definition: fft.F90:120
subroutine, public fft_all_init(namespace)
initialize the table
Definition: fft.F90:269
subroutine, public fft_all_end()
delete all plans
Definition: fft.F90:380
real(real64), parameter, public m_two
Definition: global.F90:202
subroutine, public global_end()
Finalise parser varinfo file, and MPI.
Definition: global.F90:494
real(real64), parameter, public m_zero
Definition: global.F90:200
complex(real64), parameter, public m_z0
Definition: global.F90:210
complex(real64), parameter, public m_zi
Definition: global.F90:214
real(real64), parameter, public m_epsilon
Definition: global.F90:216
subroutine, public global_init(communicator)
Initialise Octopus.
Definition: global.F90:375
real(real64), parameter, public m_one
Definition: global.F90:201
real(real64), parameter, public m_min_occ
Minimal occupation that is considered to be non-zero.
Definition: global.F90:227
This module implements the underlying real-space grid.
Definition: grid.F90:119
subroutine, public zgrid_symmetrize_single(gr, iop, field, symm_field, suppress_warning)
Definition: grid.F90:870
integer(int64) function, public io_function_fill_how(where)
Use this function to quickly plot functions for debugging purposes: call dio_function_output(io_funct...
Definition: io.F90:116
subroutine, public io_init(defaults)
If the argument defaults is present and set to true, then the routine will not try to read anything f...
Definition: io.F90:165
subroutine, public io_close(iunit, grp)
Definition: io.F90:467
subroutine, public io_skip_header(iunit)
Definition: io.F90:646
subroutine, public io_end()
Definition: io.F90:271
character(len=max_path_len) function, public io_workpath(path, namespace)
construct path name from given name and namespace
Definition: io.F90:318
integer function, public io_open(file, namespace, action, status, form, position, die, recl, grp)
Definition: io.F90:402
integer pure function, public kpoints_get_num_symmetry_ops(this, ik)
Definition: kpoints.F90:1730
integer pure function, public kpoints_get_symmetry_ops(this, ik, index)
Definition: kpoints.F90:1743
subroutine, public kpoints_to_reduced(latt, kin, kout)
Definition: kpoints.F90:1150
subroutine, public kpoints_to_absolute(latt, kin, kout)
Definition: kpoints.F90:1137
This module defines various routines, operating on mesh functions.
This module defines the meshes, which are used in Octopus.
Definition: mesh.F90:120
integer function, public mesh_nearest_point(mesh, pos, dmin, rankmin)
Returns the index of the point which is nearest to a given vector position pos.
Definition: mesh.F90:386
pure subroutine, public mesh_r(mesh, ip, rr, origin, coords)
return the distance to the origin for a given grid point
Definition: mesh.F90:342
real(real64) function, dimension(1:mesh%box%dim), public mesh_x_global(mesh, ipg)
Given a global point index, this function returns the coordinates of the point.
Definition: mesh.F90:817
subroutine, public messages_end()
Definition: messages.F90:273
subroutine, public messages_not_implemented(feature, namespace)
Definition: messages.F90:1068
subroutine, public messages_init(output_dir)
Definition: messages.F90:220
character(len=256), dimension(max_lines), public message
to be output by fatal, warning
Definition: messages.F90:162
subroutine, public messages_fatal(no_lines, only_root_writes, namespace)
Definition: messages.F90:410
subroutine, public messages_input_error(namespace, var, details, row, column)
Definition: messages.F90:691
subroutine, public messages_experimental(name, namespace)
Definition: messages.F90:1040
subroutine, public messages_info(no_lines, iunit, debug_only, stress, all_nodes, namespace)
Definition: messages.F90:594
type(mpi_grp_t), public mpi_world
Definition: mpi.F90:272
This module handles the communicators for the various parallelization strategies.
Definition: multicomm.F90:147
type(namespace_t), public global_namespace
Definition: namespace.F90:135
logical function, public parse_is_defined(namespace, name)
Definition: parser.F90:455
subroutine, public parser_init()
Initialise the Octopus parser.
Definition: parser.F90:402
subroutine, public parser_end()
End the Octopus parser.
Definition: parser.F90:434
integer function, public parse_block(namespace, name, blk, check_varinfo_)
Definition: parser.F90:615
subroutine, public profiling_end(namespace)
Definition: profiling.F90:415
subroutine, public profiling_init(namespace)
Create profiling subdirectory.
Definition: profiling.F90:257
integer, parameter, public restart_proj
Definition: restart.F90:156
integer, parameter, public restart_type_load
Definition: restart.F90:184
subroutine, public spectrum_fix_time_limits(spectrum, time_steps, dt, istart, iend, ntiter)
Definition: spectrum.F90:2515
subroutine, public spectrum_fourier_transform(method, transform, noise, time_start, time_end, t0, time_step, time_function, energy_start, energy_end, energy_step, energy_function)
Computes the sine, cosine, (or "exponential") Fourier transform of the real function given in the tim...
Definition: spectrum.F90:2645
subroutine, public spectrum_init(spectrum, namespace, default_energy_step, default_max_energy)
Definition: spectrum.F90:215
integer default
Definition: spectrum.F90:209
integer, parameter, public spectrum_transform_cos
Definition: spectrum.F90:173
integer, parameter, public spectrum_transform_sin
Definition: spectrum.F90:173
subroutine, public spectrum_count_time_steps(namespace, iunit, time_steps, dt)
Definition: spectrum.F90:2393
pure integer function, public spectrum_nenergy_steps(spectrum)
Definition: spectrum.F90:2956
This module handles spin dimensions of the states and the k-point distribution.
subroutine, public states_elec_distribute_nodes(st, namespace, mc)
Distribute states over the processes for states parallelization.
subroutine, public states_elec_end(st)
finalize the states_elec_t object
subroutine, public states_elec_allocate_wfns(st, mesh, wfs_type, skip, packed)
Allocates the KS wavefunctions defined within a states_elec_t structure.
subroutine, public kpoints_distribute(this, mc)
distribute k-points over the nodes in the corresponding communicator
subroutine, public states_elec_copy(stout, stin, exclude_wfns, exclude_eigenval, special)
make a (selective) copy of a states_elec_t object
subroutine, public states_elec_look(restart, nik, dim, nst, ierr)
Reads the 'states' file in the restart directory, and finds out the nik, dim, and nst contained in it...
This module handles reading and writing restart information for the states_elec_t.
subroutine, public states_elec_load(restart, namespace, space, st, mesh, kpoints, ierr, iter, lr, lowest_missing, label, verbose, skip)
returns in ierr: <0 => Fatal error, or nothing read =0 => read all wavefunctions >0 => could only rea...
subroutine, public symmetries_apply_kpoint_red(this, iop, aa, bb)
Definition: symmetries.F90:561
type(type_t), public type_cmplx
Definition: types.F90:136
brief This module defines the class unit_t which is used by the unit_systems_oct_m module.
Definition: unit.F90:134
This module defines the unit system, used for input and output.
type(unit_system_t), public units_out
subroutine, public unit_system_init(namespace)
type(unit_system_t), public units_inp
the units systems for reading and writing
Definition: xc.F90:116
Class describing the electron system.
Definition: electrons.F90:221
int true(void)
subroutine tdtdm_excitonic_weight()
Definition: tdtdm.F90:863
subroutine tdtdm_output_density()
Definition: tdtdm.F90:764
subroutine tdtdm_get_hole_position(xx_h, ip_h)
Definition: tdtdm.F90:691
program tdtdm
Definition: tdtdm.F90:116