Octopus
rdmft.F90
Go to the documentation of this file.
1!! Copyright (C) 2012-2019 I. Theophilou, N. Helbig
2!! Copyright (C) 2019 F. Buchholz, M. Oliveira
3!!
4!! This program is free software; you can redistribute it and/or modify
5!! it under the terms of the GNU General Public License as published by
6!! the Free Software Foundation; either version 2, or (at your option)
7!! any later version.
8!!
9!! This program is distributed in the hope that it will be useful,
10!! but WITHOUT ANY WARRANTY; without even the implied warranty of
11!! MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12!! GNU General Public License for more details.
13!!
14!! You should have received a copy of the GNU General Public License
15!! along with this program; if not, write to the Free Software
16!! Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17!! 02110-1301, USA.
18!!
19
20#include "global.h"
21
22module rdmft_oct_m
23 use debug_oct_m
30 use energy_oct_m
32 use global_oct_m
33 use grid_oct_m
37 use io_oct_m
39 use ions_oct_m
40 use, intrinsic :: iso_fortran_env
43 use loct_oct_m
44 use math_oct_m
45 use mesh_oct_m
49 use mpi_oct_m
52 use output_oct_m
55 use parser_oct_m
60 use space_oct_m
65 use unit_oct_m
67 use v_ks_oct_m
68 use xc_oep_oct_m
70
71 implicit none
72
73 private
74 public :: &
75 rdm_t, &
76 rdmft_init, &
77 rdmft_end, &
79
80 type rdm_t
81 private
82 type(eigensolver_t) :: eigens
83 integer :: max_iter
84 integer :: iter
85 integer :: nst
86 integer :: n_twoint !number of unique two electron integrals
87 logical :: do_basis
88 logical :: hf
89 real(real64) :: mu
90 real(real64) :: occsum
91 real(real64) :: qtot
92 real(real64) :: scale_f
93 real(real64) :: toler
94 real(real64) :: conv_ener
95 real(real64) :: maxFO
96 real(real64) :: tolerFO
97
98 real(real64), allocatable :: eone(:)
99 real(real64), allocatable :: eone_int(:, :)
100 real(real64), allocatable :: twoint(:)
101 real(real64), allocatable :: hartree(:, :)
102 real(real64), allocatable :: exchange(:, :)
103 real(real64), allocatable :: evalues(:)
104 real(real64), allocatable :: vecnat(:, :)
105 real(real64), allocatable :: Coul(:,:,:)
106 real(real64), allocatable :: Exch(:,:,:)
107
108 integer, allocatable :: i_index(:, :)
109 integer, allocatable :: j_index(:, :)
110 integer, allocatable :: k_index(:, :)
111 integer, allocatable :: l_index(:, :)
112 end type rdm_t
113
114 type(rdm_t), pointer :: rdm_ptr
115
116contains
118 ! ---------------------------------------------------------
119 subroutine rdmft_init(rdm, namespace, gr, st, hm, mc, space, fromScratch)
120 type(rdm_t), intent(out) :: rdm
121 type(namespace_t), intent(in) :: namespace
122 type(grid_t), intent(inout) :: gr
123 type(states_elec_t), intent(in) :: st
124 type(hamiltonian_elec_t), intent(in) :: hm
125 type(multicomm_t), intent(in) :: mc
126 class(space_t), intent(in) :: space
127 logical, intent(in) :: fromScratch
128
129 push_sub(rdmft_init)
130
131 if(st%nst < st%qtot + 1) then
132 message(1) = "Too few states to run RDMFT calculation"
133 message(2) = "Number of states should be at least the number of electrons plus one"
134 call messages_fatal(2, namespace=namespace)
135 end if
136
137 if (states_are_complex(st)) then
138 call messages_not_implemented("Complex states for RDMFT", namespace=namespace)
139 end if
140
141 ! The documentation for the variable is found in scf_init.
142 call parse_variable(namespace, 'MaximumIter', 200, rdm%max_iter)
143
144 !%Variable RDMTolerance
145 !%Type float
146 !%Default 1e-7 Ha
147 !%Section SCF::RDMFT
148 !%Description
149 !% Convergence criterion for stopping the occupation numbers minimization. Minimization is
150 !% stopped when all derivatives of the energy wrt. each occupation number
151 !% are smaller than this criterion. The bisection for finding the correct mu that is needed
152 !% for the occupation number minimization also stops according to this criterion.
153 !%End
154 call parse_variable(namespace, 'RDMTolerance', 1.0e-7_real64, rdm%toler)
155
156 !%Variable RDMToleranceFO
157 !%Type float
158 !%Default 1e-4 Ha
159 !%Section SCF::RDMFT
160 !%Description
161 !% Convergence criterion for stopping the diagonalization of the Fock matrix in the Piris method.
162 !% Orbital minimization is stopped when all off-diagonal ellements of the Fock matrix
163 !% are smaller than this criterion.
164 !%End
165 call parse_variable(namespace, 'RDMToleranceFO', 1.0e-4_real64, rdm%tolerFO)
166
167 !%Variable RDMConvEner
168 !%Type float
169 !%Default 1e-6 Ha
170 !%Section SCF::RDMFT
171 !%Description
172 !% Convergence criterion for stopping the overall minimization of the energy with
173 !% respect to occupation numbers and the orbitals. The minimization of the
174 !% energy stops when the total energy difference between two subsequent
175 !% minimizations of the energy with respect to the occupation numbers and the
176 !% orbitals is smaller than this criterion. It is also used to exit the orbital minimization.
177 !%End
178 call parse_variable(namespace, 'RDMConvEner', 1.0e-7_real64, rdm%conv_ener)
180 !%Variable RDMBasis
181 !%Type logical
182 !%Default yes
183 !%Section SCF::RDMFT
184 !%Description
185 !% If true, all the energy terms and corresponding derivatives involved in RDMFT will
186 !% not be calculated on the grid but on the basis of the initial orbitals
187 !%End
188 call parse_variable(namespace, 'RDMBasis',.true., rdm%do_basis)
190 if (rdm%do_basis .and. fromscratch) then
191 call messages_write("RDMFT calculations with RDMBasis = yes cannot be started FromScratch", new_line=.true.)
192 call messages_write("Run a calculation for independent particles first")
193 call messages_fatal(namespace=namespace)
194 end if
196 !%Variable RDMHartreeFock
197 !%Type logical
198 !%Default no
199 !%Section SCF::RDMFT
200 !%Description
201 !% If true, the code simulates a HF calculation, by omitting the occ.num. optimization
202 !% can be used for test reasons
203 !%End
204 call parse_variable(namespace, 'RDMHartreeFock',.false., rdm%hf)
206 rdm%nst = st%nst
207 if (rdm%do_basis) then
208 rdm%n_twoint = rdm%nst*(rdm%nst + 1)*(rdm%nst**2 + rdm%nst + 2)/8
209 safe_allocate(rdm%eone_int(1:rdm%nst, 1:rdm%nst))
210 safe_allocate(rdm%twoint(1:rdm%n_twoint))
211 safe_allocate(rdm%i_index(1:2,1:rdm%n_twoint))
212 safe_allocate(rdm%j_index(1:2,1:rdm%n_twoint))
213 safe_allocate(rdm%k_index(1:2,1:rdm%n_twoint))
214 safe_allocate(rdm%l_index(1:2,1:rdm%n_twoint))
215 safe_allocate(rdm%vecnat(1:rdm%nst, 1:rdm%nst))
216 safe_allocate(rdm%Coul(1:rdm%nst, 1:rdm%nst, 1:rdm%nst))
217 safe_allocate(rdm%Exch(1:rdm%nst, 1:rdm%nst, 1:rdm%nst))
218 rdm%eone_int = m_zero
219 rdm%twoint = m_zero
220 rdm%vecnat(:, :) = diagonal_matrix(rdm%nst, m_one)
221 rdm%i_index = m_zero
222 rdm%j_index = m_zero
223 rdm%k_index = m_zero
224 rdm%l_index = m_zero
225 rdm%Coul = m_zero
226 rdm%Exch = m_zero
227 else
228 ! initialize eigensolver.
229 call eigensolver_init(rdm%eigens, namespace, gr, st, hm, mc, space)
230 end if
231
232 safe_allocate(rdm%eone(1:rdm%nst))
233 safe_allocate(rdm%hartree(1:rdm%nst, 1:rdm%nst))
234 safe_allocate(rdm%exchange(1:rdm%nst, 1:rdm%nst))
235 safe_allocate(rdm%evalues(1:rdm%nst))
236
237 rdm%eone = m_zero
238 rdm%hartree = m_zero
239 rdm%exchange = m_zero
240 rdm%evalues = m_zero
241 rdm%mu = m_two*st%eigenval(max(int(st%qtot*m_half), 1), 1)
242 rdm%qtot = st%qtot
243 rdm%occsum = m_zero
244 rdm%scale_f = 1e-2_real64
245 rdm%maxFO = m_zero
246 rdm%iter = 0
247
248 pop_sub(rdmft_init)
249 end subroutine rdmft_init
250
251 ! ----------------------------------------
252
253 subroutine rdmft_end(rdm)
254 type(rdm_t), intent(inout) :: rdm
255
256 push_sub(rdmft_end)
257
258 safe_deallocate_a(rdm%evalues)
259 safe_deallocate_a(rdm%eone)
260 safe_deallocate_a(rdm%hartree)
261 safe_deallocate_a(rdm%exchange)
262
263 if (rdm%do_basis) then
264 safe_deallocate_a(rdm%eone_int)
265 safe_deallocate_a(rdm%twoint)
266 safe_deallocate_a(rdm%i_index)
267 safe_deallocate_a(rdm%j_index)
268 safe_deallocate_a(rdm%k_index)
269 safe_deallocate_a(rdm%l_index)
270 safe_deallocate_a(rdm%vecnat)
271 safe_deallocate_a(rdm%Coul)
272 safe_deallocate_a(rdm%Exch)
273 else
274 call eigensolver_end(rdm%eigens)
275 end if
276
277 pop_sub(rdmft_end)
278 end subroutine rdmft_end
279
280 ! ----------------------------------------
281
282 ! scf for the occupation numbers and the natural orbitals
283 subroutine scf_rdmft(rdm, namespace, space, mc, gr, ions, ext_partners, st, ks, hm, outp, restart_dump)
284 type(rdm_t), intent(inout) :: rdm
285 type(namespace_t), intent(in) :: namespace
286 type(electron_space_t), intent(in) :: space
287 type(multicomm_t), intent(in) :: mc
288 type(grid_t), intent(in) :: gr
289 type(ions_t), intent(in) :: ions
290 type(partner_list_t), intent(in) :: ext_partners
291 type(states_elec_t), intent(inout) :: st
292 type(v_ks_t), intent(inout) :: ks
293 type(hamiltonian_elec_t), intent(inout) :: hm
294 type(output_t), intent(in) :: outp
295 type(restart_t), intent(in) :: restart_dump
296
297 type(states_elec_t) :: states_save
298 integer :: iter, icount, ip, ist, ierr, maxcount, iorb
299 integer(int64) :: what_i
300 real(real64) :: energy, energy_dif, energy_old, energy_occ, xpos, xneg, rel_ener
301 real(real64), allocatable :: dpsi(:, :), dpsi2(:, :)
302 logical :: conv
303 character(len=MAX_PATH_LEN) :: dirname
304
305 push_sub(scf_rdmft)
306
307 if (hm%d%ispin /= 1) then
308 call messages_not_implemented("RDMFT exchange function not yet implemented for spin_polarized or spinors", &
309 namespace=namespace)
310 end if
311
312 ! problem is about k-points for exchange
313 if (space%is_periodic()) then
314 call messages_not_implemented("Periodic system calculations for RDMFT", namespace=namespace)
315 end if
316
317 ! exchange routine needs all states on each processor currently
318 if(st%parallel_in_states) then
319 call messages_not_implemented("RDMFT parallel in states", namespace=namespace)
320 end if
321
322 call messages_print_with_emphasis(msg='RDMFT Calculation', namespace=namespace)
323 call messages_print_var_value('RDMBasis', rdm%do_basis, namespace=namespace)
324
325 !set initial values
326 energy_old = 1.0e20_real64
327 xpos = m_zero
328 xneg = m_zero
329 energy = m_zero
330 if (.not. rdm%do_basis) then
331 maxcount = 1 !still needs to be checked
332 else
333 maxcount = 50
334 !precalculate matrix elements in basis
335 write(message(1),'(a)') 'Calculating Coulomb and exchange matrix elements in basis'
336 write(message(2),'(a)') '--this may take a while--'
337 call messages_info(2, namespace=namespace)
338
339 call two_body_me(gr, st, space, namespace, hm%kpoints, hm%exxop%psolver, 1, st%nst, rdm%i_index, rdm%j_index, rdm%k_index, &
340 rdm%l_index, rdm%twoint)
341 call rdm_integrals(rdm, namespace, hm, st, gr)
342 call sum_integrals(rdm)
343 endif
344
345 ! Start the actual minimization, first step is minimization of occupation numbers
346 ! Orbital minimization is according to Piris and Ugalde, Vol. 30, No. 13, J. Comput. Chem. (scf_orb) or
347 ! using conjugated gradient (scf_orb_cg)
348 conv = .false.
349 do iter = 1, rdm%max_iter
350 rdm%iter = rdm%iter + 1
351 write(message(1), '(a)') '**********************************************************************'
352 write(message(2),'(a, i4)') 'Iteration:', iter
353 call messages_info(2, namespace=namespace)
354 ! occupation number optimization unless we are doing Hartree-Fock
355 if (rdm%hf) then
356 call scf_occ_no(rdm, namespace, gr, hm, space, st, energy_occ)
357 else
358 call scf_occ(rdm, namespace, gr, hm, space, st, energy_occ)
359 end if
360 ! orbital optimization
361 write(message(1), '(a)') 'Optimization of natural orbitals'
362 call messages_info(1, namespace=namespace)
363 do icount = 1, maxcount
364 if (rdm%do_basis) then
365 call scf_orb(rdm, namespace, gr, st, hm, space, energy)
366 else
367 call scf_orb_cg(rdm, namespace, space, gr, ions, ext_partners, st, ks, hm, energy)
368 end if
369 energy_dif = energy - energy_old
370 energy_old = energy
371 if (rdm%do_basis) then
372 if (abs(energy_dif)/abs(energy) < rdm%conv_ener .and. rdm%maxFO < rdm%tolerFO) exit
373 if (energy_dif < m_zero) then
374 xneg = xneg + 1
375 else
376 xpos = xpos + 1
377 end if
378 if (xneg > 1.5e0_real64*xpos) then
379 rdm%scale_f = 1.01_real64*rdm%scale_f
380 elseif (xneg < 1.1e0_real64*xpos) then
381 rdm%scale_f = 0.95_real64* rdm%scale_f
382 end if
383 endif !rdm%do_basis
384 end do !icount
385 xneg = m_zero
386 xpos = m_zero
387
388 rel_ener = abs(energy_occ-energy)/abs(energy)
389
390 write(message(1),'(a,11x,es20.10)') 'Total energy:', units_from_atomic(units_out%energy,energy + hm%ep%eii)
391 write(message(2),'(a,1x,es20.10)') 'Rel. energy difference:', rel_ener
392 call messages_info(2, namespace=namespace)
393
394 if (.not. rdm%hf .and. rdm%do_basis) then
395 write(message(1),'(a,18x,es20.10)') 'Max F0:', rdm%maxFO
396 call messages_info(1, namespace=namespace)
397 end if
398
399
400 if (rdm%do_basis) then
401 conv = (rel_ener < rdm%conv_ener) .and. rdm%maxFO < rdm%tolerFO
402 else
403 conv = rel_ener < rdm%conv_ener
404 endif
405
406 !Is this still okay or does it restrict the possible convergence? FB: Does this makes sense at all?
407 if (rdm%toler > 1e-4_real64) rdm%toler = rdm%toler*1e-1_real64
408
409 ! save restart information
410 if ((conv .or. restart_walltime_period_alarm(mc%master_comm) .or. iter == rdm%max_iter)) then
411 if (rdm%do_basis) then
412 call states_elec_copy(states_save, st)
413 safe_allocate(dpsi(1:gr%np, 1:st%d%dim))
414 safe_allocate(dpsi2(1:gr%np, 1:st%d%dim))
415 do iorb = 1, st%nst
416 dpsi = m_zero
417 do ist = 1, st%nst
418 call states_elec_get_state(st, gr, ist, 1, dpsi2)
419 do ip = 1, gr%np
420 dpsi(ip,1) = dpsi(ip,1) + rdm%vecnat(ist, iorb)*dpsi2(ip,1)
421 end do
422 end do
423 call states_elec_set_state(states_save, gr, iorb, 1, dpsi)
424 end do
425 call density_calc(states_save, gr, states_save%rho)
426 ! if other quantities besides the densities and the states are needed they also have to be recalculated here!
427 call states_elec_dump(restart_dump, space, states_save, gr, hm%kpoints, ierr, iter=iter)
428
429 if (conv .or. iter == rdm%max_iter) then
430 call states_elec_end(st)
431 call states_elec_copy(st, states_save)
432 end if
433
434 call states_elec_end(states_save)
435
436 safe_deallocate_a(dpsi)
437 safe_deallocate_a(dpsi2)
438 else
439 call states_elec_dump(restart_dump, space, st, gr, hm%kpoints, ierr, iter=iter)
440
441 ! calculate maxFO for cg-solver
442 if (.not. rdm%hf) then
443 call calc_maxfo (namespace, hm, st, gr, rdm)
444 write(message(1),'(a,18x,es20.10)') 'Max F0:', rdm%maxFO
445 call messages_info(1, namespace=namespace)
446 end if
447 endif
448
449 if (ierr /= 0) then
450 message(1) = 'Unable to write states wavefunctions.'
451 call messages_warning(1, namespace=namespace)
452 end if
453
454 endif
455
456 ! write output for iterations if requested
457 if (any(outp%what) .and. outp%duringscf) then
458 do what_i = lbound(outp%what, 1), ubound(outp%what, 1)
459 if (outp%what_now(what_i, iter)) then
460 write(dirname,'(a,a,i4.4)') trim(outp%iter_dir), "scf.", iter
461 call output_all(outp, namespace, space, dirname, gr, ions, iter, st, hm, ks)
462 call output_modelmb(outp, namespace, space, dirname, gr, ions, iter, st)
463 call scf_write_static(dirname, "info")
464 exit
465 end if
466 end do
467 end if
468
469 if (conv) exit
470 end do
471
472 if(conv) then
473 write(message(1),'(a,i3,a)') 'The calculation converged after ',rdm%iter,' iterations'
474 write(message(2),'(a,9x,es20.10)') 'The total energy is ', units_from_atomic(units_out%energy,energy + hm%ep%eii)
475 call messages_info(2, namespace=namespace)
476 else
477 write(message(1),'(a,i3,a)') 'The calculation did not converge after ', iter-1, ' iterations '
478 write(message(2),'(a,es15.5)') 'Relative energy difference between the last two iterations ', rel_ener
479 write(message(3),'(a,es15.5)') 'The maximal non-diagonal element of the Hermitian matrix F is ', rdm%maxFO
480 call messages_info(3, namespace=namespace)
481 end if
482
483 call scf_write_static(static_dir, "info")
484 call output_all(outp, namespace, space, static_dir, gr, ions, -1, st, hm, ks)
485 call output_modelmb(outp, namespace, space, static_dir, gr, ions, -1, st)
486
487 pop_sub(scf_rdmft)
488
489 contains
490 ! ---------------------------------------------------------
491 subroutine scf_write_static(dir, fname)
492 character(len=*), intent(in) :: dir, fname
493
494 integer :: iunit, ist
495 real(real64), allocatable :: photon_number_state (:), ekin_state (:), epot_state (:)
496
498
499 safe_allocate(photon_number_state(1:st%nst))
500 safe_allocate(ekin_state(1:st%nst))
501 safe_allocate(epot_state(1:st%nst))
502
503 if(st%system_grp%is_root()) then
504 call io_mkdir(dir, namespace)
505 iunit = io_open(trim(dir) // "/" // trim(fname), namespace, action='write')
506
507 call grid_write_info(gr, iunit=iunit)
508
509 call v_ks_write_info(ks, iunit=iunit)
510
511 if (rdm%do_basis) then
512 write(iunit, '(a)')'Orbital optimization with [basis set]'
513 else
514 write(iunit, '(a)')'Orbital optimization with [conjugated gradients]'
515 end if
516 write(iunit, '(1x)')
517
518 if (rdm%hf) then
519 write(iunit, '(a)')'Hartree Fock calculation'
520 write(iunit, '(1x)')
521 end if
522
523 if (hm%psolver%is_dressed) then
524 write(iunit, '(a)')'Dressed state calculation'
525 call photon_mode_write_info(hm%psolver%photons, iunit=iunit)
526 write(iunit, '(1x)')
527 end if
528
529 ! scf information
530 if(conv) then
531 write(iunit, '(a, i4, a)')'SCF converged in ', iter, ' iterations'
532 else
533 write(iunit, '(a)') 'SCF *not* converged!'
534 end if
535 write(iunit, '(1x)')
536
537 write(iunit, '(3a,es20.10)') 'Total Energy [', trim(units_abbrev(units_out%energy)), ']:', &
538 units_from_atomic(units_out%energy, energy + hm%ep%eii)
539 write(iunit,'(a,1x,f16.12)') 'Sum of occupation numbers:', rdm%occsum
540 else
541 iunit = 0
542 end if
543
544 if (hm%psolver%is_dressed) then
545 call calc_photon_number(space, gr, st, hm%psolver%photons, photon_number_state, ekin_state, epot_state)
546 if(st%system_grp%is_root()) then
547 write(iunit,'(a,1x,f14.12)') 'Total mode occupation:', hm%psolver%photons%number(1)
548 end if
549 end if
550
551 if(st%system_grp%is_root()) then
552 if (rdm%max_iter > 0) then
553 write(iunit, '(a)') 'Convergence:'
554 write(iunit, '(6x, a, es15.8)') 'maxFO = ', rdm%maxFO
555 write(iunit, '(6x, a, es15.8)') 'rel_ener = ', rel_ener
556 write(iunit,'(1x)')
557 end if
558 ! otherwise, these values are uninitialized, and unknown.
559 end if
560
561 if (st%system_grp%is_root()) then
562 ! Write header
563 write(iunit,'(a)') 'Natural occupation numbers:'
564 write(iunit,'(a4,5x,a12)', advance='no') '#st', 'Occupation'
565 if (.not. rdm%do_basis) write(iunit,'(5x,a12)', advance='no') 'conv'
566 if (hm%psolver%is_dressed) write(iunit,'(3(5x,a12))', advance='no') 'Mode Occ.', '-1/2d^2/dq^2', '1/2w^2q^2'
567 write(iunit,*)
568
569 ! Write values
570 do ist = 1, st%nst
571 write(iunit,'(i4,3x,f14.12)', advance='no') ist, st%occ(ist, 1)
572 if (.not. rdm%do_basis) write(iunit,'(3x,f14.12)', advance='no') rdm%eigens%diff(ist, 1)
573 if (hm%psolver%is_dressed) then
574 write(iunit,'(3(3x,f14.12))', advance='no') photon_number_state(ist), ekin_state(ist), epot_state(ist)
575 end if
576 write(iunit,*)
577 end do
578 end if
579
580 if (st%system_grp%is_root()) then
581 call io_close(iunit)
582 end if
583
584 safe_deallocate_a(photon_number_state)
585 safe_deallocate_a(ekin_state)
586 safe_deallocate_a(epot_state)
587
589 end subroutine scf_write_static
590 end subroutine scf_rdmft
591
592 ! ---------------------------------------------------------
593 subroutine calc_maxfo (namespace, hm, st, gr, rdm)
594 type(namespace_t), intent(in) :: namespace
595 type(rdm_t), intent(inout) :: rdm
596 type(grid_t), intent(in) :: gr
597 type(hamiltonian_elec_t), intent(inout) :: hm
598 type(states_elec_t), intent(inout) :: st
599
600 real(real64), allocatable :: lambda(:, :), FO(:, :)
601 integer :: ist, jst
602
603 push_sub(calc_maxfo)
604
605 safe_allocate(lambda(1:st%nst,1:st%nst))
606 safe_allocate(fo(1:st%nst, 1:st%nst))
607
608 ! calculate FO operator to check Hermiticity of lagrange multiplier matrix (lambda)
609 lambda = m_zero
610 fo = m_zero
611 call construct_lambda(namespace, hm, st, gr, lambda, rdm)
612
613 !Set up FO matrix to check maxFO
614 do ist = 1, st%nst
615 do jst = 1, ist - 1
616 fo(jst, ist) = - (lambda(jst, ist) - lambda(ist ,jst))
617 end do
618 end do
619 rdm%maxFO = maxval(abs(fo))
620
621 safe_deallocate_a(lambda)
622 safe_deallocate_a(fo)
623
624 pop_sub(calc_maxfo)
625 end subroutine calc_maxfo
626
627 ! ---------------------------------------------------------
628 subroutine calc_photon_number(space, gr, st, photons, photon_number_state, ekin_state, epot_state)
629 class(space_t), intent(in) :: space
630 type(grid_t), intent(in) :: gr
631 type(states_elec_t), intent(in) :: st
632 type(photon_mode_t), intent(inout) :: photons
633 real(real64), intent(out) :: photon_number_state(:)
634 real(real64), intent(out) :: ekin_state(:)
635 real(real64), intent(out) :: epot_state(:)
636
637 integer :: ist, dim_photon, ip
638 real(real64) :: q2_exp, laplace_exp
639 real(real64), allocatable :: psi(:, :), psi_q2(:), dpsidq(:), d2psidq2(:)
640
641 push_sub(calc_photon_number)
642
643 ! The photon dimension is always the last
644 dim_photon = space%dim
645
646 safe_allocate(psi(1:gr%np_part, 1))
647 safe_allocate(psi_q2(1:gr%np))
648 safe_allocate(dpsidq(1:gr%np_part))
649 safe_allocate(d2psidq2(1:gr%np))
650
651 photons%number(1) = m_zero
652
653 do ist = 1, st%nst
654 call states_elec_get_state(st, gr, ist, 1, psi)
655
656 ! <phi(ist)|d^2/dq^2|phi(ist)> ~= <phi(ist)| d/dq (d/dq|phi(ist)>)
657 call dderivatives_partial(gr%der, psi(:, 1), dpsidq(:), dim_photon, ghost_update = .true., set_bc = .true.)
658 call dderivatives_partial(gr%der, dpsidq(1:gr%np_part), d2psidq2(:), dim_photon, ghost_update = .true., set_bc = .true.)
659 laplace_exp = dmf_dotp(gr, psi(:, 1), d2psidq2(:))
660 ekin_state(ist) = -m_half*laplace_exp
661
662 ! <phi(ist)|q^2|psi(ist)>= |q|psi(ist)>|^2
663 !$omp parallel do
664 do ip = 1, gr%np
665 psi_q2(ip) = psi(ip, 1) * gr%x_t(ip, dim_photon)**2
666 end do
667 !$omp end parallel do
668 q2_exp = dmf_dotp(gr, psi(:, 1), psi_q2(:))
669 epot_state(ist) = m_half * photons%omega(1)**2 * q2_exp
670
671 !! N_phot(ist)=( <phi_i|H_ph|phi_i>/omega - 0.5 ) / N_elec
672 !! with <phi_i|H_ph|phi_i>=-0.5* <phi(ist)|d^2/dq^2|phi(ist)> + 0.5*omega <phi(ist)|q^2|psi(ist)>
673 photon_number_state(ist) = -m_half*laplace_exp / photons%omega(1) + m_half * photons%omega(1) * q2_exp
674 photon_number_state(ist) = photon_number_state(ist) - m_half
675
676 !! N_phot_total= sum_ist occ_ist*N_phot(ist)
677 photons%number(1) = photons%number(1) + (photon_number_state(ist) + m_half)*st%occ(ist, 1)
678 ! 0.5 must be added again to do the normalization due to the total charge correctly
679 end do
680
681 photons%number(1) = photons%number(1) - st%qtot/m_two
682
683 safe_deallocate_a(psi)
684 safe_deallocate_a(psi_q2)
685 safe_deallocate_a(dpsidq)
686 safe_deallocate_a(d2psidq2)
687
689 end subroutine calc_photon_number
690
691 ! ---------------------------------------------------------
692
693 ! reset occ.num. to 2/0
694 subroutine set_occ_pinning(st)
695 type(states_elec_t), intent(inout) :: st
696
697 real(real64), allocatable :: occin(:, :)
698
699 push_sub(set_occ_pinning)
700
701 safe_allocate(occin(1:st%nst, 1:st%nik))
702
703 occin(1:st%nst, 1:st%nik) = st%occ(1:st%nst, 1:st%nik)
704 where(occin(:, :) < m_one) occin(:, :) = m_zero
705 where(occin(:, :) > m_one) occin(:, :) = st%smear%el_per_state
706
707 st%occ(:, :) = occin(:, :)
708
709 safe_deallocate_a(occin)
710
711 pop_sub(set_occ_pinning)
712 end subroutine set_occ_pinning
713
714
715 ! ---------------------------------------------------------
716 ! dummy routine for occupation numbers which only calculates the necessary variables for further use
717 ! used in Hartree-Fock mode
718 subroutine scf_occ_no(rdm, namespace, gr, hm, space, st, energy)
719 type(rdm_t), intent(inout) :: rdm
720 type(namespace_t), intent(in) :: namespace
721 type(grid_t), intent(in) :: gr
722 type(hamiltonian_elec_t), intent(in) :: hm
723 class(space_t), intent(in) :: space
724 type(states_elec_t), intent(inout) :: st
725 real(real64), intent(out) :: energy
726
727 integer :: ist
728
729 push_sub(scf_occ_no)
730
731 write(message(1),'(a)') 'SKIP Optimization of occupation numbers'
732 call messages_info(1, namespace=namespace)
733
734 call set_occ_pinning(st)
735
736 energy = m_zero
737
738 call rdm_derivatives(rdm, namespace, hm, st, gr, space)
739
740 call total_energy_rdm(rdm, st%occ(:,1), energy)
741
742 rdm%occsum = sum(st%occ(1:st%nst, 1:st%nik))
743
744 write(message(1),'(a4,5x,a12)')'#st','Occupation'
745 call messages_info(1, namespace=namespace)
746
747 do ist = 1, st%nst
748 write(message(1),'(i4,3x,f11.9)') ist, st%occ(ist, 1)
749 call messages_info(1, namespace=namespace)
750 end do
751
752 write(message(1),'(a,1x,f13.9)') 'Sum of occupation numbers', rdm%occsum
753 write(message(2),'(a,es20.10)') 'Total energy occ', units_from_atomic(units_out%energy,energy + hm%ep%eii)
754 call messages_info(2, namespace=namespace)
755
756 pop_sub(scf_occ_no)
757 end subroutine scf_occ_no
758
759 ! scf for the occupation numbers
760 subroutine scf_occ(rdm, namespace, gr, hm, space, st, energy)
761 type(rdm_t), target, intent(inout) :: rdm
762 type(namespace_t), intent(in) :: namespace
763 type(grid_t), intent(in) :: gr
764 type(hamiltonian_elec_t), intent(in) :: hm
765 class(space_t), intent(in) :: space
766 type(states_elec_t), intent(inout) :: st
767 real(real64), intent(out) :: energy
768
769 integer :: ist, icycle, ierr
770 real(real64) :: sumgi1, sumgi2, sumgim, mu1, mu2, mum, dinterv, thresh_occ
771 real(real64), allocatable :: occin(:, :)
772 real(real64), parameter :: smallocc = 0.00001_real64
773 real(real64), allocatable :: theta(:)
774 real(real64) :: objective
775 integer, parameter :: max_cycle = 200
776
777 push_sub(scf_occ)
778 call profiling_in("SCF_OCC")
779
780 write(message(1),'(a)') 'Optimization of occupation numbers'
781 call messages_info(1, namespace=namespace)
782
783 safe_allocate(occin(1:st%nst, 1:st%nik))
784 safe_allocate(theta(1:st%nst))
785
786 occin = m_zero
787 theta = m_zero
788 energy = m_zero
790 ! Defines a threshold on occ nums to avoid numerical instabilities.
791 ! Needs to be changed consistently with the same variable in objective_rdmft
792 thresh_occ = 1e-14_real64
793
794 !Initialize the occin. Smallocc is used for numerical stability
795 occin(1:st%nst, 1:st%nik) = st%occ(1:st%nst, 1:st%nik)
796 where(occin(:, :) < smallocc) occin(:, :) = smallocc
797 where(occin(:, :) > st%smear%el_per_state - smallocc) occin(:, :) = st%smear%el_per_state - smallocc
798
799 !Renormalize the occupation numbers
800 rdm%occsum = st%qtot
801
802 st%occ(:, :) = occin(:, :)
803
804 call rdm_derivatives(rdm, namespace, hm, st, gr, space)
805
806 !finding the chemical potential mu such that the occupation numbers sum up to the number of electrons
807 !bisection to find the root of rdm%occsum-st%qtot=M_ZERO
808 mu1 = rdm%mu !initial guess for mu
809 mu2 = -1.0e-6_real64
810 dinterv = m_half
811
812 ! Set pointer to rdm, so that it is available in the functions called by the minimizer
813 rdm_ptr => rdm
814
815 !use n_j=sin^2(2pi*theta_j) to treat pinned states, minimize for both intial mu
816 theta(:) = asin(sqrt(occin(:, 1)/st%smear%el_per_state))*(m_half/m_pi)
817 call minimize_multidim(minmethod_bfgs, st%nst, theta, 0.05_real64, 0.01_real64, &
818 1e-12_real64, 1e-12_real64, 200, objective_rdmft, write_iter_info_rdmft, objective, ierr)
819 sumgi1 = rdm%occsum - st%qtot
820 rdm%mu = mu2
821 theta(:) = asin(sqrt(occin(:, 1)/st%smear%el_per_state))*(m_half/m_pi)
822 call minimize_multidim(minmethod_bfgs, st%nst, theta, 0.05_real64, 0.01_real64, &
823 1e-12_real64, 1e-12_real64, 200, objective_rdmft, write_iter_info_rdmft, objective, ierr)
824 sumgi2 = rdm%occsum - st%qtot
825
826 ! Adjust the interval between the initial mu to include the root of rdm%occsum-st%qtot=M_ZERO
827 do icycle = 1, max_cycle
828 if (sumgi1*sumgi2 <= m_zero) exit
829 if (sumgi2 > m_zero) then
830 mu2 = mu1
831 sumgi2 = sumgi1
832 mu1 = mu1 - dinterv
833 rdm%mu = mu1
834 theta(:) = asin(sqrt(occin(:, 1)/st%smear%el_per_state))*(m_half/m_pi)
835 call minimize_multidim(minmethod_bfgs, st%nst, theta, 0.05_real64, 0.01_real64, &
836 1e-12_real64, 1e-12_real64, 200, objective_rdmft, write_iter_info_rdmft, objective, ierr)
837 sumgi1 = rdm%occsum - st%qtot
838 else
839 mu1 = mu2
840 sumgi1 = sumgi2
841 mu2 = mu2 + dinterv
842 rdm%mu = mu2
843 theta(:) = asin(sqrt(occin(:, 1)/st%smear%el_per_state))*(m_half/m_pi)
844 call minimize_multidim(minmethod_bfgs, st%nst, theta, 0.05_real64, 0.01_real64, &
845 1e-12_real64, 1e-12_real64, 200, objective_rdmft, write_iter_info_rdmft, objective, ierr)
846 sumgi2 = rdm%occsum - st%qtot
847 end if
848 end do
849
850 do icycle = 1, 50
851 mum = (mu1 + mu2)*m_half
852 rdm%mu = mum
853 theta(:) = asin(sqrt(occin(:, 1)/st%smear%el_per_state))*(m_half/m_pi)
854 call minimize_multidim(minmethod_bfgs, st%nst, theta, 0.05_real64, 0.0001_real64, &
855 1e-12_real64, 1e-12_real64, 200, objective_rdmft, write_iter_info_rdmft, objective, ierr)
856 sumgim = rdm%occsum - st%qtot
857
858 if (sumgi1*sumgim < m_zero) then
859 mu2 = mum
860 else
861 mu1 = mum
862 sumgi1 = sumgim
863 end if
864
865 ! check occ.num. threshold again after minimization
866 do ist = 1, st%nst
867 st%occ(ist,1) = m_two*sin(theta(ist)*m_pi*m_two)**2
868 if (st%occ(ist,1) <= thresh_occ ) st%occ(ist,1) = thresh_occ
869 end do
870
871 if (abs(sumgim) < rdm%toler .or. abs((mu1-mu2)*m_half) < rdm%toler) exit
872 end do
873
874 nullify(rdm_ptr)
875
876 if (icycle >= 50) then
877 write(message(1),'(a,1x,f11.4)') 'Bisection ended without finding mu, sum of occupation numbers:', rdm%occsum
878 call messages_fatal(1, namespace=namespace)
879 end if
880
881 do ist = 1, st%nst
882 st%occ(ist, 1) = st%smear%el_per_state*sin(theta(ist)*m_pi*m_two)**2
883 end do
884
885 objective = objective + rdm%mu*(rdm%occsum - rdm%qtot)
886 energy = objective
887
888 write(message(1),'(a4,5x,a12)')'#st','Occupation'
889 call messages_info(1, namespace=namespace)
890
891 do ist = 1, st%nst
892 write(message(1),'(i4,3x,f14.12)') ist, st%occ(ist, 1)
893 call messages_info(1, namespace=namespace)
894 end do
895
896 write(message(1),'(a,3x,f11.9)') 'Sum of occupation numbers: ', rdm%occsum
897 write(message(2),'(a,11x,es20.10)') 'Total energy: ', units_from_atomic(units_out%energy, energy + hm%ep%eii)
898 call messages_info(2, namespace=namespace)
899
900 safe_deallocate_a(occin)
901 safe_deallocate_a(theta)
902
903 call profiling_out("SCF_OCC")
904 pop_sub(scf_occ)
905 end subroutine scf_occ
906
907 ! ---------------------------------------------------------
908 subroutine objective_rdmft(size, theta, objective, getgrad, df)
909 integer, intent(in) :: size
910 real(real64), intent(in) :: theta(size)
911 real(real64), intent(inout) :: objective
912 integer, intent(in) :: getgrad
913 real(real64), intent(inout) :: df(size)
914
915 integer :: ist
916 real(real64) :: thresh_occ, thresh_theta
917 real(real64), allocatable :: dE_dn(:),occ(:)
918
919 push_sub(objective_rdmft)
920
921 assert(size == rdm_ptr%nst)
922
923 safe_allocate(de_dn(1:size))
924 safe_allocate(occ(1:size))
925
926 occ = m_zero
927
928 ! Defines a threshold on occ nums to avoid numerical instabilities.
929 ! Needs to be changed consistently with the same variable in scf_occ
930 thresh_occ = 1e-14_real64
931 thresh_theta = asin(sqrt(thresh_occ/m_two))*(m_half/m_pi)
932
933 do ist = 1, size
934 occ(ist) = m_two*sin(theta(ist)*m_pi*m_two)**2
935 if (occ(ist) <= thresh_occ ) occ(ist) = thresh_occ
936 end do
937
938 rdm_ptr%occsum = sum(occ(1:size))
939
940 !calculate the total energy without nuclei interaction and the energy
941 !derivatives with respect to the occupation numbers
942
943 call total_energy_rdm(rdm_ptr, occ, objective, de_dn)
944 do ist = 1, size
945 if (occ(ist) <= thresh_occ ) then
946 df(ist) = m_four*m_pi*sin(m_four*thresh_theta*m_pi)*(de_dn(ist) - rdm_ptr%mu)
947 else
948 df(ist) = m_four*m_pi*sin(m_four*theta(ist)*m_pi)*(de_dn(ist) - rdm_ptr%mu)
949 end if
950 end do
951 objective = objective - rdm_ptr%mu*(rdm_ptr%occsum - rdm_ptr%qtot)
952
953 safe_deallocate_a(de_dn)
954 safe_deallocate_a(occ)
955
956 pop_sub(objective_rdmft)
957 end subroutine objective_rdmft
958
959 ! ---------------------------------------------------------
960 subroutine write_iter_info_rdmft(iter, size, energy, maxdr, maxdf, theta)
961 integer, intent(in) :: iter
962 integer, intent(in) :: size
963 real(real64), intent(in) :: energy, maxdr, maxdf
964 real(real64), intent(in) :: theta(size)
965
966 push_sub(write_iter_info_rdmft)
967
968 ! Nothing to do.
969
970 pop_sub(write_iter_info_rdmft)
971 end subroutine write_iter_info_rdmft
972
973 ! scf for the natural orbitals
974 subroutine scf_orb(rdm, namespace, gr, st, hm, space, energy)
975 type(rdm_t), intent(inout) :: rdm
976 type(namespace_t), intent(in) :: namespace
977 type(grid_t), intent(in) :: gr
978 type(states_elec_t), intent(inout) :: st
979 type(hamiltonian_elec_t), intent(in) :: hm
980 class(space_t), intent(in) :: space
981 real(real64), intent(out) :: energy
982
983 integer :: ist, jst
984 real(real64), allocatable :: lambda(:, :), fo(:, :)
985
986 push_sub(scf_orb)
987 call profiling_in("SCF_ORB_BASIS")
988
989 !matrix of Lagrange Multipliers from Equation (8), Piris and Ugalde, Vol. 30, No. 13, J. Comput. Chem.
990 safe_allocate(lambda(1:st%nst,1:st%nst))
991 safe_allocate(fo(1:st%nst, 1:st%nst)) !Generalized Fockian Equation (11)
992
993 lambda = m_zero
994 fo = m_zero
995
996 call construct_lambda(namespace, hm, st, gr, lambda, rdm)
997
998 !Set up fo matrix
999 if (rdm%iter==1) then
1000 do ist = 1, st%nst
1001 do jst = 1, ist
1002 fo(ist, jst) = m_half*(lambda(ist, jst) + lambda(jst, ist))
1003 fo(jst, ist) = fo(ist, jst)
1004 end do
1005 end do
1006 else
1007 do ist = 1, st%nst
1008 do jst = 1, ist - 1
1009 fo(jst, ist) = - ( lambda(jst, ist) - lambda(ist ,jst))
1010 end do
1011 end do
1012 rdm%maxfo = maxval(abs(fo))
1013 do ist = 1, st%nst
1014 fo(ist, ist) = rdm%evalues(ist)
1015 do jst = 1, ist-1
1016 if(abs(fo(jst, ist)) > rdm%scale_f) then
1017 fo(jst, ist) = rdm%scale_f*fo(jst,ist)/abs(fo(jst, ist))
1018 end if
1019 fo(ist, jst) = fo(jst, ist)
1020 end do
1021 end do
1022 end if
1023
1024 call lalg_eigensolve(st%nst, fo, rdm%evalues)
1025 call assign_eigfunctions(rdm, st, fo)
1026 call sum_integrals(rdm) ! to calculate rdm%Coul and rdm%Exch with the new rdm%vecnat
1027 call rdm_derivatives(rdm, namespace, hm, st, gr, space)
1028 call total_energy_rdm(rdm, st%occ(:,1), energy)
1029
1030 safe_deallocate_a(lambda)
1031 safe_deallocate_a(fo)
1032
1033 call profiling_out("SCF_ORB_BASIS")
1034 pop_sub(scf_orb)
1035 end subroutine scf_orb
1036
1037
1038 !-----------------------------------------------------------------
1039 ! Minimize the total energy wrt. an orbital by conjugate gradient
1040 !-----------------------------------------------------------------
1041 subroutine scf_orb_cg(rdm, namespace, space, gr, ions, ext_partners, st, ks, hm, energy)
1042 type(rdm_t), intent(inout) :: rdm
1043 type(namespace_t), intent(in) :: namespace
1044 type(electron_space_t), intent(in) :: space
1045 type(grid_t), intent(in) :: gr
1046 type(ions_t), intent(in) :: ions
1047 type(partner_list_t), intent(in) :: ext_partners
1048 type(states_elec_t), intent(inout) :: st
1049 type(v_ks_t), intent(inout) :: ks
1050 type(hamiltonian_elec_t), intent(inout) :: hm
1051 real(real64), intent(out) :: energy
1052
1053 integer :: ik, ist, maxiter
1054
1056 push_sub(scf_orb_cg)
1057 call profiling_in("CG")
1058
1059 call v_ks_calc(ks, namespace, space, hm, st, ions, ext_partners)
1060 call hm%update(gr, namespace, space, ext_partners)
1061
1062 rdm%eigens%converged = 0
1063 if(st%system_grp%is_root() .and. .not. debug%info) then
1064 call loct_progress_bar(-1, st%lnst*st%d%kpt%nlocal)
1065 end if
1066 do ik = st%d%kpt%start, st%d%kpt%end
1067 rdm%eigens%matvec = 0
1068 maxiter = rdm%eigens%es_maxiter
1069 call deigensolver_cg(namespace, gr, st, hm, rdm%eigens%pre, rdm%eigens%tolerance, maxiter, &
1070 rdm%eigens%converged(ik), ik, rdm%eigens%diff(:, ik), rdm%eigens%energy_change_threshold, &
1071 rdm%eigens%orthogonalize_to_all, rdm%eigens%conjugate_direction)
1072
1073 if (.not. rdm%eigens%folded_spectrum) then
1074 ! recheck convergence after subspace diagonalization, since states may have reordered (copied from eigensolver_run)
1075 rdm%eigens%converged(ik) = 0
1076 do ist = 1, st%nst
1077 if(rdm%eigens%diff(ist, ik) < rdm%eigens%tolerance) then
1078 rdm%eigens%converged(ik) = ist
1079 else
1080 exit
1081 end if
1082 end do
1083 end if
1084 end do
1085
1086 if(st%system_grp%is_root() .and. .not. debug%info) then
1087 write(stdout, '(1x)')
1088 end if
1089
1090 ! calculate total energy with new states
1091 call density_calc (st, gr, st%rho)
1092 call v_ks_calc(ks, namespace, space, hm, st, ions, ext_partners)
1093 call hm%update(gr, namespace, space, ext_partners)
1094 call rdm_derivatives(rdm, namespace, hm, st, gr, space)
1095
1096 call total_energy_rdm(rdm, st%occ(:,1), energy)
1097
1098 call profiling_out("CG")
1099 pop_sub(scf_orb_cg)
1100 end subroutine scf_orb_cg
1101
1102
1103 ! ----------------------------------------
1104 ! constructs the Lagrange multiplyers needed for the orbital minimization
1105 subroutine construct_lambda(namespace, hm, st, gr, lambda, rdm)
1106 type(namespace_t), intent(in) :: namespace
1107 type(hamiltonian_elec_t), intent(in) :: hm
1108 type(states_elec_t), intent(inout) :: st
1109 type(grid_t), intent(in) :: gr
1110 real(real64), intent(out) :: lambda(:, :)
1111 type(rdm_t), intent(inout) :: rdm
1112
1113 real(real64), allocatable :: hpsi(:, :), hpsi1(:, :), dpsi(:, :), dpsi1(:, :)
1114 real(real64), allocatable :: fock(:,:,:), FV(:,:)
1115 integer :: ist, iorb, jorb, jst
1116
1117 push_sub(construct_lambda)
1118
1119 lambda = m_zero
1120
1121 !calculate the Lagrange multiplyer lambda matrix on the grid, Eq. (9), Piris and Ugalde, Vol. 30, No. 13, J. Comput. Chem.
1122 if (.not. rdm%do_basis) then
1123 safe_allocate(hpsi(1:gr%np,1:st%d%dim))
1124 safe_allocate(hpsi1(1:gr%np,1:st%d%dim))
1125 safe_allocate(dpsi(1:gr%np_part ,1:st%d%dim))
1126 safe_allocate(dpsi1(1:gr%np_part ,1:st%d%dim))
1127
1128 do iorb = 1, st%nst
1129 call states_elec_get_state(st, gr, iorb, 1, dpsi)
1130 call dhamiltonian_elec_apply_single(hm, namespace, gr, dpsi, hpsi, iorb, 1)
1131
1132 do jorb = iorb, st%nst
1133 ! calculate <phi_j|H|phi_i> =lam_ji
1134 call states_elec_get_state(st, gr, jorb, 1, dpsi1)
1135 lambda(jorb, iorb) = dmf_dotp(gr, dpsi1(:,1), hpsi(:,1))
1137 ! calculate <phi_i|H|phi_j>=lam_ij
1138 if (iorb /= jorb ) then
1139 call dhamiltonian_elec_apply_single(hm, namespace, gr, dpsi1, hpsi1, jorb, 1)
1140 lambda(iorb, jorb) = dmf_dotp(gr, dpsi(:,1), hpsi1(:,1))
1141 end if
1142 end do
1143 end do
1144
1145
1146 else ! calculate the same lambda matrix on the basis
1147 !call sum_integrals(rdm)
1148 safe_allocate(fv(1:st%nst, 1:st%nst))
1149 safe_allocate(fock(1:st%nst, 1:st%nst, 1:st%nst))
1150 fock = m_zero
1151
1152 do iorb = 1, st%nst
1153 do ist = 1, st%nst
1154 do jst = 1, ist
1155 fock(ist, jst, iorb) = st%occ(iorb, 1)*rdm%eone_int(ist,jst)
1156 do jorb = 1, st%nst
1157 !The coefficient of the Exchange term below is only for the Mueller functional
1158 fock(ist ,jst, iorb) = fock(ist, jst, iorb) + st%occ(iorb, 1)*st%occ(jorb, 1)*rdm%Coul(ist, jst, jorb) &
1159 - sqrt(st%occ(iorb, 1))*sqrt(st%occ(jorb, 1))*rdm%Exch(ist, jst, jorb)
1160 end do
1161 fock(jst, ist, iorb) = fock(ist, jst, iorb)
1162 end do
1163 end do
1164 end do
1165
1166 ! FV(:,jorb) = fock(:,:,jorb) * vecnat(:,jorb)
1167 do jorb = 1, st%nst
1168 call lalg_gemv(st%nst, st%nst, m_one, fock(:,:,jorb), rdm%vecnat(:, jorb), m_zero, fv(:, jorb))
1169 end do
1170 ! lambda = vecnat^T * FV
1171 call lalg_gemm_cn(st%nst, st%nst, st%nst, m_one, rdm%vecnat, fv, m_zero, lambda)
1172 end if
1173
1174
1175 if (.not. rdm%do_basis) then
1176 safe_deallocate_a(hpsi)
1177 safe_deallocate_a(hpsi1)
1178 safe_deallocate_a(dpsi)
1179 safe_deallocate_a(dpsi1)
1180 else
1181 safe_deallocate_a(fv)
1182 safe_deallocate_a(fock)
1183 end if
1184
1185 pop_sub(construct_lambda)
1186 end subroutine construct_lambda
1187
1188 ! ----------------------------------------
1189
1190 ! finds the new states after the minimization of the orbitals (Piris method)
1191 subroutine assign_eigfunctions(rdm, st, lambda)
1192 type(rdm_t), intent(inout) :: rdm
1193 type(states_elec_t), intent(inout) :: st
1194 real(real64), intent(in) :: lambda(:, :)
1195
1196 integer :: iorb, jorb, ist
1197 real(real64), allocatable :: vecnat_new(:, :)
1198
1199 push_sub(assign_eigenfunctions)
1201 safe_allocate(vecnat_new(1:st%nst, 1:st%nst))
1202 do iorb = 1, st%nst
1203 do ist = 1, st%nst
1204 vecnat_new(ist, iorb) = m_zero
1205 do jorb = 1, st%nst
1206 vecnat_new(ist , iorb) = vecnat_new(ist, iorb) + rdm%vecnat(ist, jorb)*lambda(jorb, iorb)
1207 end do
1208 end do
1209 end do
1210
1211 rdm%vecnat(:, :) = vecnat_new(:, :)
1212
1213 safe_deallocate_a(vecnat_new)
1214
1215 pop_sub(assign_eigenfunctions)
1216 end subroutine assign_eigfunctions
1217
1218 ! --------------------------------------------
1219
1220 ! calculates the total energy when only the occupation numbers are updated
1221 subroutine total_energy_rdm(rdm, occ, energy, dE_dn)
1222 type(rdm_t), intent(in) :: rdm
1223 real(real64), intent(in) :: occ(:)
1224 real(real64), intent(out) :: energy
1225 real(real64), optional, intent(out) :: dE_dn(:)
1226
1227 integer :: ist
1228 real(real64), allocatable :: V_h(:), V_x(:), sqrt_occ(:)
1229
1230 push_sub(total_energy_rdm)
1231
1232 safe_allocate(v_h(1:rdm%nst))
1233 safe_allocate(v_x(1:rdm%nst))
1234 safe_allocate(sqrt_occ(1:rdm%nst))
1235
1236 energy = m_zero
1237
1238 !Calculate hartree and exchange contribution
1239 !This is only for the Mueller functional and has to be changed
1240 sqrt_occ(1:rdm%nst) = sqrt(occ(1:rdm%nst))
1241 ! V_h = hartree * occ ; V_x = -exchange * sqrt(occ) (beta = 0 overwrites)
1242 call lalg_gemv(rdm%nst, rdm%nst, m_one, rdm%hartree, occ, m_zero, v_h)
1243 call lalg_gemv(rdm%nst, rdm%nst, -m_one, rdm%exchange, sqrt_occ, m_zero, v_x)
1244 do ist = 1, rdm%nst
1245 v_x(ist) = v_x(ist)*m_half/max(sqrt_occ(ist), 1.0e-16_real64)
1246 end do
1247
1248
1249 !Calculate the energy derivative with respect to the occupation numbers
1250 if (present(de_dn)) then
1251 de_dn(:) = rdm%eone(:) + v_h(:) + v_x(:)
1252 end if
1253
1254 !Total energy calculation without nuclei interaction
1255 do ist = 1, rdm%nst
1256 energy = energy + occ(ist)*rdm%eone(ist) &
1257 + m_half*occ(ist)*v_h(ist) &
1258 + occ(ist)*v_x(ist)
1259 end do
1260
1261 safe_deallocate_a(sqrt_occ)
1262 safe_deallocate_a(v_h)
1263 safe_deallocate_a(v_x)
1264
1265 pop_sub(total_energy_rdm)
1266 end subroutine total_energy_rdm
1267
1268 ! ----------------------------------------
1269 ! calculates the derivatives of the energy terms with respect to the occupation numbers
1270 subroutine rdm_derivatives(rdm, namespace, hm, st, gr, space)
1271 type(rdm_t), intent(inout) :: rdm
1272 type(namespace_t), intent(in) :: namespace
1273 type(hamiltonian_elec_t), intent(in) :: hm
1274 type(states_elec_t), intent(inout) :: st
1275 type(grid_t), intent(in) :: gr
1276 class(space_t), intent(in) :: space
1277
1278
1279 real(real64), allocatable :: hpsi(:, :), rho1(:), rho(:), dpsi(:, :), dpsi2(:, :)
1280 real(real64), allocatable :: v_ij(:,:,:,:,:)
1281 real(real64) :: dd
1282 type(states_elec_t) :: xst
1283
1284 integer :: ist, jst, nspin_, iorb, jorb, ip
1285
1287
1288
1289 nspin_ = min(st%d%nspin, 2)
1290
1291 if (.not. rdm%do_basis) then
1292 safe_allocate(hpsi(1:gr%np, 1:st%d%dim))
1293 safe_allocate(rho1(1:gr%np))
1294 safe_allocate(rho(1:gr%np))
1295 safe_allocate(dpsi(1:gr%np_part, 1:st%d%dim))
1296 safe_allocate(dpsi2(1:gr%np, 1:st%d%dim))
1297 safe_allocate(v_ij(1:gr%np, 1:st%nst, 1:st%nst, 1:st%nik, 1:st%nik))
1298
1299 v_ij = m_zero
1300 rdm%eone = m_zero
1301 rdm%hartree = m_zero
1302 rdm%exchange = m_zero
1303
1304 !derivative of one-electron energy with respect to the natural orbitals occupation number
1305 do ist = 1, st%nst
1306 call states_elec_get_state(st, gr, ist, 1, dpsi)
1307
1308 ! calculate one-body energy
1309 call dhamiltonian_elec_apply_single(hm, namespace, gr, dpsi, hpsi, ist, 1, &
1311 rdm%eone(ist) = dmf_dotp(gr, dpsi(:, 1), hpsi(:, 1))
1312 end do
1313
1314 !integrals used for the hartree and exchange parts of the total energy and their derivatives
1315 ! maybe better to let that be done from the lower level routines like hamiltonian apply?
1317 ! only used to calculate total energy
1318 call xst%nullify()
1319 call dexchange_operator_compute_potentials(hm%exxop, namespace, space, gr, st, xst, hm%kpoints, f_out = v_ij)
1320 call states_elec_end(xst)
1321
1322 do ist = 1, st%nst
1323 call states_elec_get_state(st, gr, ist, 1, dpsi)
1324
1325 !$omp parallel do
1326 do ip = 1, gr%np
1327 rho1(ip) = dpsi(ip, 1)**2
1328 end do
1329 !$omp end parallel do
1330
1331 do jst = ist, st%nst
1332 rdm%hartree(ist, jst) = dmf_dotp(gr, rho1, v_ij(:,jst, jst, 1, 1))
1333 rdm%hartree(jst, ist) = rdm%hartree(ist, jst)
1334 call states_elec_get_state(st, gr, jst, 1, dpsi2)
1335 !$omp parallel do
1336 do ip = 1, gr%np
1337 rho(ip) = dpsi2(ip, 1)*dpsi(ip, 1)
1338 end do
1339 !$omp end parallel do
1340 rdm%exchange(ist, jst) = dmf_dotp(gr, rho, v_ij(:, ist, jst, 1, 1))
1341 rdm%exchange(jst, ist) = rdm%exchange(ist, jst)
1342 end do
1343 end do
1344
1345
1346 safe_deallocate_a(hpsi)
1347 safe_deallocate_a(rho)
1348 safe_deallocate_a(rho1)
1349 safe_deallocate_a(dpsi)
1350 safe_deallocate_a(dpsi2)
1351 safe_deallocate_a(v_ij)
1352
1353 else !if energy derivatives are expanded in a basis set
1354
1355 do iorb = 1, st%nst
1356 rdm%eone(iorb) = m_zero
1357 do ist = 1, st%nst
1358 do jst = 1, st%nst
1359 dd = rdm%vecnat(ist, iorb)*rdm%vecnat(jst, iorb)
1360 rdm%eone(iorb) = rdm%eone(iorb) + dd*rdm%eone_int(ist, jst)
1361 end do
1362 end do
1363 end do
1364
1365 do iorb = 1, st%nst
1366 do jorb =1 , iorb
1367 rdm%hartree(iorb ,jorb) = m_zero
1368 rdm%exchange(iorb,jorb) = m_zero
1369 do ist =1, st%nst
1370 do jst =1, st%nst
1371 dd = rdm%vecnat(ist, iorb)*rdm%vecnat(jst, iorb)
1372 rdm%hartree(iorb ,jorb) = rdm%hartree(iorb ,jorb)+rdm%Coul(ist,jst, jorb)*dd
1373 rdm%exchange(iorb ,jorb) = rdm%exchange(iorb ,jorb)+rdm%Exch(ist,jst, jorb)*dd
1374 end do
1375 end do
1376 rdm%hartree(jorb, iorb) = rdm%hartree(iorb, jorb)
1377 rdm%exchange(jorb, iorb) = rdm%exchange(iorb, jorb)
1378 end do
1379 end do
1380 end if
1381
1382 pop_sub(rdm_derivatives)
1383 end subroutine rdm_derivatives
1384
1385 ! --------------------------------------------
1386 !calculates the one electron integrals in the basis of the initial orbitals
1387 subroutine rdm_integrals(rdm, namespace, hm, st, mesh)
1388 type(rdm_t), intent(inout) :: rdm
1389 type(namespace_t), intent(in) :: namespace
1390 type(hamiltonian_elec_t), intent(in) :: hm
1391 type(states_elec_t), intent(in) :: st
1392 class(mesh_t), intent(in) :: mesh
1393
1394 real(real64), allocatable :: hpsi(:, :)
1395 real(real64), allocatable :: dpsi(:, :), dpsi2(:, :)
1396 integer :: ist, jst
1397
1398 push_sub(rdm_integrals)
1399
1400 safe_allocate(dpsi(1:mesh%np_part, 1:st%d%dim))
1401 safe_allocate(dpsi2(1:mesh%np, 1:st%d%dim))
1402 safe_allocate(hpsi(1:mesh%np, 1:st%d%dim))
1403
1404 !calculate integrals of the one-electron energy term with respect to the initial orbital basis
1405 do ist = 1, st%nst
1406 call states_elec_get_state(st, mesh, ist, 1, dpsi)
1407 do jst = ist, st%nst
1408 call states_elec_get_state(st, mesh, jst, 1, dpsi2)
1409
1410 ! calculate one-body integrals
1411 call dhamiltonian_elec_apply_single(hm, namespace, mesh, dpsi, hpsi, ist, 1, &
1413 rdm%eone_int(jst, ist) = dmf_dotp(mesh, dpsi2(:, 1), hpsi(:, 1))
1414 rdm%eone_int(ist, jst) = rdm%eone_int(jst, ist)
1415 end do
1416 end do
1417
1418 safe_deallocate_a(hpsi)
1419 safe_deallocate_a(dpsi)
1420 safe_deallocate_a(dpsi2)
1421
1422 pop_sub(rdm_integrals)
1423 end subroutine rdm_integrals
1424
1425 ! --------------------------------------------
1426 ! constructs the Hartree and Exchange part of the RDMFT Fock matrix
1427 subroutine sum_integrals(rdm)
1428 type(rdm_t), intent(inout) :: rdm
1429
1430 integer :: ist, jst, kst, lst, iorb, icount
1431 logical :: inv_pairs
1432 real(real64) :: two_int, wij, wik, wil, wjk, wjl, wkl
1433 real(real64), allocatable :: dm(:,:,:)
1434
1435 push_sub(sum_integrals)
1436
1437 safe_allocate(dm(1:rdm%nst, 1:rdm%nst, 1:rdm%nst))
1438
1439 rdm%Coul = m_zero
1440 rdm%Exch = m_zero
1441 dm = m_zero
1442
1443 do iorb = 1, rdm%nst
1444 do ist = 1, rdm%nst
1445 do jst = 1, ist
1446 dm(ist, jst, iorb) = rdm%vecnat(ist, iorb)*rdm%vecnat(jst, iorb)
1447 dm(jst, ist, iorb) = dm(ist, jst, iorb)
1448 end do
1449 end do
1450 end do
1451
1452 do icount = 1, rdm%n_twoint
1453
1454 ist = rdm%i_index(1,icount)
1455 jst = rdm%j_index(1,icount)
1456 kst = rdm%k_index(1,icount)
1457 lst = rdm%l_index(1,icount)
1458
1459 two_int = rdm%twoint(icount)
1460
1461 ! create weights of unique integrals
1462 if(ist == jst) then
1463 wij = m_one
1464 else
1465 wij = m_two
1466 endif
1467 if(kst == lst) then
1468 wkl = m_one
1469 else
1470 wkl = m_two
1471 endif
1472
1473 if(ist == kst .and. jst /= lst) then
1474 wik = m_two
1475 else
1476 wik = m_one
1477 endif
1478 if(ist == lst .and. jst /= kst) then
1479 wil = m_two
1480 else
1481 wil = m_one
1482 endif
1483 if(jst == kst .and. ist /= lst) then
1484 wjk = m_two
1485 else
1486 wjk = m_one
1487 endif
1488 if(jst == lst .and. ist /= kst) then
1489 wjl = m_two
1490 else
1491 wjl = m_one
1492 endif
1493
1494 inv_pairs = (ist /= kst .or. jst /= lst)
1495
1496 do iorb = 1, rdm%nst
1497
1498 !the Hartree terms
1499 rdm%Coul(ist, jst, iorb) = rdm%Coul(ist, jst, iorb) + dm(kst, lst, iorb)*wkl*two_int
1500 if (inv_pairs) rdm%Coul(kst, lst, iorb) = rdm%Coul(kst, lst, iorb) + dm(ist, jst, iorb)*wij*two_int
1501
1502 !the exchange terms
1503 !weights are only included if they can differ from one
1504 rdm%Exch(ist, kst, iorb) = rdm%Exch(ist, kst, iorb) + two_int*dm(jst, lst, iorb)*wik
1505 if (kst /= lst) then
1506 rdm%Exch(ist, lst, iorb) = rdm%Exch(ist, lst, iorb) + two_int*dm(jst, kst, iorb)*wil
1507 end if
1508 if (ist /= jst) then
1509 if(jst >= kst) then
1510 rdm%Exch(jst, kst, iorb) = rdm%Exch(jst, kst, iorb) + two_int*dm(ist, lst, iorb)*wjk
1511 else
1512 if (inv_pairs) rdm%Exch(kst, jst, iorb) = rdm%Exch(kst, jst, iorb) + two_int*dm(ist, lst, iorb)
1513 end if
1514 end if
1515 if (ist /=jst .and. kst /= lst) then
1516 if (jst >= lst) then
1517 rdm%Exch(jst, lst, iorb) = rdm%Exch(jst, lst, iorb) + two_int*dm(ist, kst, iorb)*wjl
1518 else
1519 if (inv_pairs) rdm%Exch(lst, jst, iorb) = rdm%Exch(lst, jst, iorb) + two_int*dm(ist, kst, iorb)
1520 end if
1521 end if
1523 end do !iorb
1524 end do !icount
1525
1526 do iorb =1, rdm%nst
1527 do ist = 1, rdm%nst
1528 do jst = 1, ist-1
1529 rdm%Coul(jst, ist, iorb) = rdm%Coul(ist, jst, iorb)
1530 rdm%Exch(jst, ist, iorb) = rdm%Exch(ist, jst, iorb)
1531 end do
1532 end do
1533 end do
1534
1535 safe_deallocate_a(dm)
1536
1537 pop_sub(sum_integrals)
1538 end subroutine sum_integrals
1539
1540end module rdmft_oct_m
1541
1542
1543!! Local Variables:
1544!! mode: f90
1545!! coding: utf-8
1546!! End:
The same as above but with (Hermitian) transpose of A.
Definition: lalg_basic.F90:238
Prints out to iunit a message in the form: ["InputVariable" = value] where "InputVariable" is given b...
Definition: messages.F90:182
double sin(double __x) __attribute__((__nothrow__
double asin(double __x) __attribute__((__nothrow__
type(debug_t), save, public debug
Definition: debug.F90:158
This module implements a calculator for the density and defines related functions.
Definition: density.F90:122
subroutine, public density_calc(st, gr, density, istin)
Computes the density from the orbitals in st.
Definition: density.F90:653
This module calculates the derivatives (gradients, Laplacians, etc.) of a function.
subroutine, public dderivatives_partial(der, ff, op_ff, dir, ghost_update, set_bc)
apply the partial derivative along dir to a mesh function
subroutine, public deigensolver_cg(namespace, mesh, st, hm, pre, tol, niter, converged, ik, diff, energy_change_threshold, orthogonalize_to_all, conjugate_direction, shift)
conjugate-gradients method.
Definition: eigen_cg.F90:198
subroutine, public eigensolver_init(eigens, namespace, gr, st, hm, mc, space, deactivate_oracle)
subroutine, public eigensolver_end(eigens)
subroutine, public dexchange_operator_compute_potentials(this, namespace, space, gr, st, xst, kpoints, F_out)
real(real64), parameter, public m_two
Definition: global.F90:202
real(real64), parameter, public m_zero
Definition: global.F90:200
real(real64), parameter, public m_four
Definition: global.F90:204
real(real64), parameter, public m_pi
some mathematical constants
Definition: global.F90:198
character(len= *), parameter, public static_dir
Definition: global.F90:279
real(real64), parameter, public m_half
Definition: global.F90:206
real(real64), parameter, public m_one
Definition: global.F90:201
This module implements the underlying real-space grid.
Definition: grid.F90:119
subroutine, public grid_write_info(gr, iunit, namespace)
Definition: grid.F90:519
integer, parameter, public term_local_external
integer, parameter, public term_non_local_potential
integer, parameter, public term_kinetic
subroutine, public dhamiltonian_elec_apply_single(hm, namespace, mesh, psi, hpsi, ist, ik, terms, set_bc, set_phase)
This module defines classes and functions for interaction partners.
Definition: io.F90:116
subroutine, public io_close(iunit, grp)
Definition: io.F90:467
subroutine, public io_mkdir(fname, namespace, parents)
Definition: io.F90:361
integer function, public io_open(file, namespace, action, status, form, position, die, recl, grp)
Definition: io.F90:402
System information (time, memory, sysname)
Definition: loct.F90:117
subroutine, public loct_progress_bar(a, maxcount)
A wrapper around the progress bar, such that it can be silenced without needing to dress the call wit...
Definition: loct.F90:276
This module is intended to contain "only mathematical" functions and procedures.
Definition: math.F90:117
This module defines various routines, operating on mesh functions.
This module defines the meshes, which are used in Octopus.
Definition: mesh.F90:120
subroutine, public messages_print_with_emphasis(msg, iunit, namespace)
Definition: messages.F90:898
subroutine, public messages_not_implemented(feature, namespace)
Definition: messages.F90:1068
character(len=512), private msg
Definition: messages.F90:167
subroutine, public messages_warning(no_lines, all_nodes, namespace)
Definition: messages.F90:525
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_info(no_lines, iunit, debug_only, stress, all_nodes, namespace)
Definition: messages.F90:594
integer, parameter, public minmethod_bfgs
Definition: minimizer.F90:136
This module handles the communicators for the various parallelization strategies.
Definition: multicomm.F90:147
this module contains the low-level part of the output system
Definition: output_low.F90:117
subroutine, public output_modelmb(outp, namespace, space, dir, gr, ions, iter, st)
this module contains the output system
Definition: output.F90:117
subroutine, public output_all(outp, namespace, space, dir, gr, ions, iter, st, hm, ks)
Definition: output.F90:495
subroutine, public photon_mode_write_info(this, iunit, namespace)
subroutine, public profiling_out(label)
Increment out counter and sum up difference between entry and exit time.
Definition: profiling.F90:631
subroutine, public profiling_in(label, exclude)
Increment in counter and save entry time.
Definition: profiling.F90:554
subroutine scf_occ(rdm, namespace, gr, hm, space, st, energy)
Definition: rdmft.F90:856
subroutine calc_maxfo(namespace, hm, st, gr, rdm)
Definition: rdmft.F90:689
subroutine objective_rdmft(size, theta, objective, getgrad, df)
Definition: rdmft.F90:1004
subroutine scf_orb_cg(rdm, namespace, space, gr, ions, ext_partners, st, ks, hm, energy)
Definition: rdmft.F90:1137
subroutine, public rdmft_end(rdm)
Definition: rdmft.F90:349
subroutine, public scf_rdmft(rdm, namespace, space, mc, gr, ions, ext_partners, st, ks, hm, outp, restart_dump)
Definition: rdmft.F90:379
subroutine, public rdmft_init(rdm, namespace, gr, st, hm, mc, space, fromScratch)
Definition: rdmft.F90:215
subroutine write_iter_info_rdmft(iter, size, energy, maxdr, maxdf, theta)
Definition: rdmft.F90:1056
subroutine set_occ_pinning(st)
Definition: rdmft.F90:790
subroutine calc_photon_number(space, gr, st, photons, photon_number_state, ekin_state, epot_state)
Definition: rdmft.F90:724
subroutine assign_eigfunctions(rdm, st, lambda)
Definition: rdmft.F90:1287
subroutine construct_lambda(namespace, hm, st, gr, lambda, rdm)
Definition: rdmft.F90:1201
subroutine sum_integrals(rdm)
Definition: rdmft.F90:1523
subroutine rdm_integrals(rdm, namespace, hm, st, mesh)
Definition: rdmft.F90:1483
subroutine scf_orb(rdm, namespace, gr, st, hm, space, energy)
Definition: rdmft.F90:1070
subroutine total_energy_rdm(rdm, occ, energy, dE_dn)
Definition: rdmft.F90:1317
subroutine scf_occ_no(rdm, namespace, gr, hm, space, st, energy)
Definition: rdmft.F90:814
subroutine rdm_derivatives(rdm, namespace, hm, st, gr, space)
Definition: rdmft.F90:1366
pure logical function, public states_are_complex(st)
subroutine, public states_elec_end(st)
finalize the states_elec_t object
subroutine, public states_elec_copy(stout, stin, exclude_wfns, exclude_eigenval, special)
make a (selective) copy of a states_elec_t object
This module handles reading and writing restart information for the states_elec_t.
subroutine, public states_elec_dump(restart, space, st, mesh, kpoints, ierr, iter, lr, verbose)
brief This module defines the class unit_t which is used by the unit_systems_oct_m module.
Definition: unit.F90:134
character(len=20) pure function, public units_abbrev(this)
Definition: unit.F90:225
This module defines the unit system, used for input and output.
type(unit_system_t), public units_out
subroutine, public v_ks_write_info(ks, iunit, namespace)
Definition: v_ks.F90:614
subroutine, public v_ks_calc(ks, namespace, space, hm, st, ions, ext_partners, calc_eigenval, time, calc_energy, calc_current, force_semilocal)
Definition: v_ks.F90:703
This module provices a simple timer class which can be used to trigger the writing of a restart file ...
Definition: walltimer.F90:123
logical function, public restart_walltime_period_alarm(comm)
Definition: walltimer.F90:375
subroutine scf_write_static(dir, fname)
Definition: rdmft.F90:587
Extension of space that contains the knowledge of the spin dimension.
Description of the grid, containing information on derivatives, stencil, and symmetries.
Definition: grid.F90:171
Describes mesh distribution to nodes.
Definition: mesh.F90:187
Stores all communicators and groups.
Definition: multicomm.F90:208
output handler class
Definition: output_low.F90:166
The states_elec_t class contains all electronic wave functions.
int true(void)