Differences

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

Link to this comparison view

Next revision		Previous revision
documentation:language_reference:objects:wavefunction:properties:nbitskey [2016/09/25 13:54] – created Maurits W. Haverkortdocumentation:language_reference:objects:wavefunction:properties:nbitskey [2025/11/20 04:20] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +====== NBitsKey ======
  
 +###
 +unsigned integer, read and write
 +###
 +
 +###
 +Integer representing the size of the Hash key (//size// = 2<sup>//NBitsKey//</sup>). Wavefunctions are stored in a sparse format. In order to quickly find determinants within the function we use has functions and lookup tables. The size of the lookup table is currently static. This will change in future versions, but for the moment one needs to control this size manually. The larger the key the more memory is needed. If the key is smaller than the total number of determinants present in the wavefunction the program will slow down. For optimal performance the keylist should be larger than the total number of determinants present.
 +###
 +
 +===== Example =====
 +
 +###
 +We can define the function:
 +$$
 +|\psi\rangle = \left(\frac{1}{\sqrt{4}} a^{\dagger}_0 a^{\dagger}_1 + \frac{1}{\sqrt{4}} a^{\dagger}_0 a^{\dagger}_2 + (1+I)\frac{1}{\sqrt{4}} a^{\dagger}_1 a^{\dagger}_2 \right)|0\rangle.
 +$$
 +In order to get some information on the internal representation of this function we can use the Print method including the option //{"Full",true}//. This prints, besides information on the wavefunction also information on pointer addresses and hash tables.
 +###
 +
 +###
 +If we reduce the hash table from 2<sup>16</sup> to 2<sup>1</sup> we find that there are some collisions between the determinants. For determinants with collisions we automatically create a linked list such that the right determinant is always found. The value of //NBitsKey// thus only refers to performance, never to the final answer.
 +###
 +
 +==== Input ====
 +<code Quanty Example.Quanty>
 +NF=3
 +NB=0
 +psi = NewWavefunction(NF, NB, {{"110",sqrt(1/4)},{"101",sqrt(1/4)},{"011",(1+I)*sqrt(1/4)}})
 +psi.Print({{"Full",true}})
 +psi.NBitsKey=1
 +psi.Print({{"Full",true}})
 +</code>
 +
 +==== Result ====
 +<file Quanty_Output>
 +Full printout of WaveFunction: Wave Function
 +
 +Genneral settings
 +QComplex      =          1 (Real==0 or Complex==1)
 +N             =          3 (Number of basis functions used to discribe psi)
 +NBlok         =          1 (Number of bloks needed to store psi)
 +NFermion      =          3 (Number of fermions in the one particle basis)
 +NBoson        =          0 (Number of bosons in the one particle basis)
 +NWord         =          1 (NFermion/8)+NBoson
 +NBitsKey      =         16 (Size of the key used for the hash table lookup)
 +
 +Pointer positions (addresses)
 +**ValueRe     = 0x101c53ff0
 +**ValueIm     = 0x101c55ff0
 +**Next        = 0x101c57ff0
 +**Determinant = 0x101c59ff0
 +BlokNr.       = 0
 +*ValueRe      = 0x101c5c000
 +*ValueIm      = 0x101c7e000
 +*Next         = 0x101ca0000
 +*Determinant  = 0x101cb2000
 +
 +Non-zero elements of Hash Table
 +i=      13917 , key=          2
 +i=      29407 , key=          3
 +i=      48988 , key=          1
 +
 +  pre-factor             +I  pre-factor            Pointer Addres  Next_Hash Hash_Value   Determinant
 +  5.000000000000E-01         0.000000000000E+00       0x101c5c008          0      48988   C0
 +  5.000000000000E-01         0.000000000000E+00       0x101c5c010          0      13917   A0
 +  5.000000000000E-01         5.000000000000E-01       0x101c5c018          0      29407   60
 +
 +
 +Full printout of WaveFunction: Wave Function
 +
 +Genneral settings
 +QComplex      =          1 (Real==0 or Complex==1)
 +N             =          3 (Number of basis functions used to discribe psi)
 +NBlok         =          1 (Number of bloks needed to store psi)
 +NFermion      =          3 (Number of fermions in the one particle basis)
 +NBoson        =          0 (Number of bosons in the one particle basis)
 +NWord         =          1 (NFermion/8)+NBoson
 +NBitsKey      =          1 (Size of the key used for the hash table lookup)
 +
 +Pointer positions (addresses)
 +**ValueRe     = 0x101ccbff0
 +**ValueIm     = 0x101ccdff0
 +**Next        = 0x101ccfff0
 +**Determinant = 0x101cd1ff0
 +BlokNr.       = 0
 +*ValueRe      = 0x101c5c000
 +*ValueIm      = 0x101c7e000
 +*Next         = 0x101ca0000
 +*Determinant  = 0x101cb2000
 +
 +Non-zero elements of Hash Table
 +i=          0 , key=          1
 +i=          1 , key=          2
 +
 +  pre-factor             +I  pre-factor            Pointer Addres  Next_Hash Hash_Value   Determinant
 +  5.000000000000E-01         0.000000000000E+00       0x101c5c008          0          0   C0
 +  5.000000000000E-01         0.000000000000E+00       0x101c5c010          3          1   A0
 +  5.000000000000E-01         5.000000000000E-01       0x101c5c018          0          1   60
 +</file>
 +
 +===== Available properties =====
 +{{indexmenu>.#1}}

You are here: Quanty - a quantum many body script language » Documentation » Language Reference » Objects » Wavefunction » Properties » NBitsKey

Print/export