Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
documentation:language_reference:functions:newoperator [2016/10/09 21:48] – created Maurits W. Haverkortdocumentation:language_reference:functions:newoperator [2026/11/17 07:05] (current) – Maurits W. Haverkort
Line 1: Line 1:
 +====== NewOperator ======
 +;;# 
 +<color #ed1c24>Modified in 0.9.1</color>
 +;;#
 +
 +###
 +//NewOperator(name, ...)// creates one of the standard operators as described in the section on standard operators. A "Basis" option on the last position selects the one particle basis the orbitals are in, see below. //[[documentation:language_reference:functions:angularmomentumoperators|AngularMomentumOperators()]]// creates several of the standard operators of a single atomic shell in one call. The operators //[[documentation:standard_operators:dirac_operator|"Dirac"]]//, //[[documentation:standard_operators:atomic_coulomb_repulsion|"AU"]]// and //[[documentation:standard_operators:nuclear_multipole|"NuclearMultipole"]]// act on atomic orbitals given by their radial functions, see below.
 +###
 +
 +###
 +//NewOperator(Nf, Nb, CreationTable)// can be used to create any operator of the form:
 +\begin{eqnarray}
 +\nonumber  O =         && \alpha^{(0,0)}  1 \\
 +\nonumber + \sum_i     && \alpha^{(1,0)}_i a^{\dagger}_i + \alpha^{(0,1)}_i a_i \\
 +\nonumber + \sum_{i,j} && \alpha^{(2,0)}_{i,j} a^{\dagger}_ia^{\dagger}_j + \alpha^{(1,1)}_{i,j} a^{\dagger}_ia_j + \alpha^{(0,2)}_{i,j} a_ia_j \\
 +          + \sum_{i,j,k} && ... .
 +\end{eqnarray}
 +The format of //CreationTable// for the above listed operator is:
 +//NewOperator(Nf, Nb, { {$i_1$,$j_1$,$k_1$,$\alpha_{i_1,j_1,k_1}$},{$i_2$,$j_2$,$\alpha_{i_2,j_2}$},...})//
 +Whereby positive indices create a particle, negative indices annihilate a particle. Index $i$ for 0 to Nf-1 label Fermions, from Nf to Nf+Nb label Bosons. $\alpha$ can be either a real or a complex number. NewOperator can take a forth element specifying options.
 +###
 +
 +===== Input =====
 +
 +  * Nf : Integer
 +  * Nb : Integer
 +  * CreationTable : Table of tables, whereby each table is a list of orbital indices where a particle needs to be created (positive) or annihilated (negative) and a prefactor (real or complex number). Note that -0 and +0 are different.
 +  * Possible options
 +    * "Restrictions" A list specifying restrictions when applying the operator to a wave-function.
 +    * "Name" a string specifying the name of the operator
 +    * "NBitsKey" a list of integers specifying the number of bits in the key used for the hash lookup tables. Only useful when a lot of operations are done on the operators. Not used when Operator * Wavefunction is calculated.
 +    * "Basis" a string either "Y", "Z", "K", or "jjz" specifying the one particle orbital basis used for a standard operator related to an atomic (spherical) shell. Options are:
 +
 +^ value ^ basis ^ order of the indices ^
 +| "Y" | spherical harmonics $Y_{l,m}$, the default | //IndexUp// and //IndexDn// both hold the $2l+1$ orbitals from $m=-l$ to $m=l$ |
 +| "Z" | tesseral harmonics, the real combinations of $Y_{l,m}$ and $Y_{l,-m}$ | as for "Y", in the order of //[[documentation:language_reference:functions:ytozmatrix|YtoZMatrix()]]//, sine first, then cosine |
 +| "K" | cubic harmonics, defined for $l \leq 3$ | as for "Y", in the order of //[[documentation:language_reference:functions:ytokmatrix|YtoKMatrix()]]//, by irreducible representation |
 +| "jjz" | eigenstates of $j$ and $j_z$ | //IndexUp// holds the $2l$ states of $j=l-1/2$ and //IndexDn// the $2l+2$ states of $j=l+1/2$, both from $j_z=-j$ to $j_z=j$, in the order of //[[documentation:language_reference:functions:ytojjzmatrix|YtojjzMatrix()]]// |
 +
 +
 +===== Output =====
 +
 +  * O : Operator
 +
 +===== Example 1 =====
 +;;# 
 +<color #ed1c24>New in 0.9.1</color>
 +;;#
 +
 +<code Quanty Example.Quanty>
 +-- the atomic operators of Ne on its own Dirac-Fock orbitals
 +G, F, Atom = CalculateAtomicBasisFunctions(10)
 +indices, NF = CreateAtomicIndicesList(Atom.Labels, {{"Kappas", true}})
 +
 +H0 = NewOperator("Dirac", NF, 10, indices, G, F, Atom.Nucleus)  -- kinetic energy, rest mass and nucleus
 +U  = NewOperator("AU", NF, indices, G, F)                         -- Coulomb interaction
 +
 +M = OperatorToMatrix(H0)
 +for i, label in ipairs(Atom.Labels) do
 +  local k = indices[i][1] + 1
 +  print(string.format("<%s|h_D|%s> = %12.6f Hartree", label, label, M[k][k]))
 +end
 +psi = NewWavefunction(NF, 0, {{string.rep("1", NF), 1}})
 +print(string.format("<psi|H0 + U|psi> = %.8f Hartree, Atom.Etot = %.8f Hartree", psi*(H0 + U)*psi, Atom.Etot))
 +</code>
 +
 +<file Quanty_Output Example.out>
 +<1s1/2|h_D|1s1/2> =   -49.978118 Hartree
 +<2s1/2|h_D|2s1/2> =   -11.130511 Hartree
 +<2p1/2|h_D|2p1/2> =   -10.106977 Hartree
 +<2p3/2|h_D|2p3/2> =   -10.086830 Hartree
 +<psi|H0 + U|psi> = -128.69193053 Hartree, Atom.Etot = -128.69193053 Hartree
 +</file>
 +
 +###
 +The diagonal elements of the Dirac operator are the one particle energies (kinetic energy and attraction by the nucleus) of the Dirac-Fock orbitals. Together with the Coulomb interaction, the energy of the Slater determinant of the closed-shell atom is its Dirac-Fock total energy.
 +###
 +
 +===== Example 2 =====
 +
 +###
 +A general operator defined by creation (positive index) and annihilation (negative index) numbers
 +###
 +
 +==== Input ====
 +<code Quanty NewOperator.Quanty>
 +Nf = 5
 +Nb = 0
 +O = NewOperator(Nf, Nb, {{             10},
 +                         {0,-0,         3},
 +                         {0,1,2,3,4,  1+I}},
 +                {{"Name","Liberty"}})
 +print(O)
 +</code>
 +
 +==== Result ====
 +<file Quanty_Output NewOperator.out>
 +Operator: Liberty
 +QComplex         =          2 (Real==0 or Complex==1 or Mixed==2)
 +MaxLength        =          5 (largest number of product of lader operators)
 +NFermionic modes =          5 (Number of fermionic modes (site, spin, orbital, ...) in the one particle basis)
 +NBosonic modes   =          0 (Number of bosonic modes (phonon modes, ...) in the one particle basis)
 +
 +Operator of Length   0
 +QComplex      =          0 (Real==0 or Complex==1)
 +N             =          1 (number of operators of length   0)
 +|  1.00000000000000E+01
 +
 +Operator of Length   2
 +QComplex      =          0 (Real==0 or Complex==1)
 +N             =          1 (number of operators of length   2)
 +C  0 A  0 |  3.00000000000000E+00
 +
 +Operator of Length   5
 +QComplex      =          1 (Real==0 or Complex==1)
 +N             =          1 (number of operators of length   5)
 +C  4 C  3 C  2 C  1 C  0 |  1.00000000000000E+00  1.00000000000000E+00
 +</file>
 +
 +===== Table of contents =====
 +{{indexmenu>.#1}}
 +
 +
 +
 +
  
Print/export