mirror of
https://github.com/triqs/dft_tools
synced 2024-09-02 01:03:42 +02:00
128 lines
6.0 KiB
ReStructuredText
128 lines
6.0 KiB
ReStructuredText
.. _analysis:
|
|
|
|
Analysing tools
|
|
===============
|
|
|
|
This section explains how to use some tools of the package in order to analyse the data.
|
|
|
|
.. warning::
|
|
The package does NOT provide an explicit method to do an analytic continuation of the
|
|
self energies and Green functions from Matsubara frequencies to the real frequancy axis!
|
|
There are methods included e.g. in the ALPS package, which can be used for these purposes. But
|
|
be careful: All these methods have to be used very carefully!!
|
|
|
|
The analysing tools can be found in an extension of the :class:`SumkLDA` class, they are
|
|
loaded by::
|
|
|
|
from pytriqs.applications.dft.sumk_lda_tools import *
|
|
|
|
This import the module ``SumkLDATools``. There are two practical tools, for which you don't
|
|
need a self energy on the real axis:
|
|
|
|
* The density of states of the Wannier orbitals.
|
|
* Partial charges according to the Wien2k definition.
|
|
|
|
Other routines need the self energy on the real frequency axis. If you managed to get them, you can
|
|
calculate
|
|
|
|
* the momentum-integrated spectral function including self-energy effects.
|
|
* the momentum-resolved spectral function (i.e. ARPES)
|
|
|
|
The initialisation of the class is completely equivalent to the initialisation of the :class:`SumkLDA`
|
|
class::
|
|
|
|
SK = SumkLDATools(hdf_file = filename)
|
|
|
|
By the way, all routines available in :class:`SumkLDA` are also available here.
|
|
|
|
Routines without real-frequency self energy
|
|
-------------------------------------------
|
|
|
|
For plotting the
|
|
density of states of the Wannier orbitals, you simply type::
|
|
|
|
SK.check_input_dos(om_min, om_max, n_om)
|
|
|
|
which produces plots between real frequencies `om_min` and `om_max`, using a mesh of `n_om` points. There
|
|
is an optional parameter, `broadening`, which defines an additional Lorentzian broadening, and is set to `0.01`
|
|
by default.
|
|
|
|
Since we can calculate the partial charges directly from the Matsubara Green's functions, we also don't need a
|
|
real frequency self energy for this purpose. The calculation is done by::
|
|
|
|
ar = HDFArchive(SK.hdf_file)
|
|
SK.put_Sigma([ ar['SigmaF'] ])
|
|
del ar
|
|
dm = SK.partial_charges()
|
|
|
|
which calculates the partial charges using the input that is stored in the hdf5 file (self energy, double counting,
|
|
chemical potential). Here we assumed that the final self energy is stored as `SigmaF` in the archive.
|
|
On return, dm is a list, where the list items correspond to the density matrices of all shells
|
|
defined in the list ``SK.shells``. This list is constructed by the Wien2k converter routines and stored automatically
|
|
in the hdf5 archive. For the detailed structure of `dm`, see the reference manual.
|
|
|
|
|
|
Routines with real-frequency self energy
|
|
----------------------------------------
|
|
|
|
In order to plot data including correlation effects on the real axis, one has to provide the real frequency self energy.
|
|
Most conveniently, it is stored as a real frequency :class:`BlockGf` object in the hdf5 file::
|
|
|
|
ar = HDFArchive(filename+'.h5','a')
|
|
ar['SigmaReFreq'] = Sigma_real
|
|
del ar
|
|
|
|
You may also store it in text files. If all blocks of your self energy are of dimension 1x1 you store them in `fname_(block)0.dat` files. Here `(block)` is a block name (`up`, `down`, or combined `ud`). In the case when you have matrix blocks, you store them in `(i)_(j).dat` files (where `(i)` and `(j)` are the orbital indices) in the `fname_(block)` directory
|
|
|
|
|
|
This self energy is loaded and put into the :class:`SumkLDA` class by the function::
|
|
|
|
SK.constr_Sigma_real_axis(filename, hdf=True, hdf_dataset='SigmaReFreq',n_om=0)
|
|
|
|
where:
|
|
|
|
* `filename` is the name of the hdf5 archive file or the `fname` pattern in text files names as described above.
|
|
* `hdf=True`: the real-axis self energy will be read from the hdf5 file, `hdf=False`: from the text files
|
|
* `hdf_dataset` the name of dataset where the self energy is stored in the hdf5 file
|
|
* `n_om` number of points in the real-axis mesh (used only if `hdf=False`)
|
|
|
|
|
|
The chemical potential as well as the double
|
|
counting correction were already read in the initialisation process.
|
|
|
|
With this self energy, we can do now::
|
|
|
|
SK.dos_partial(broadening=broadening)
|
|
|
|
This produces the momentum-integrated spectral functions (density of states, DOS), also orbitally resolved.
|
|
The variable `broadening` is an additional Lorentzian broadening that is added to the resulting spectra.
|
|
The output is printed into the files
|
|
|
|
* `DOScorr(sp).dat`: The total DOS. `(sp)` stands for `up`, `down`, or combined `ud`. The latter case
|
|
is relevant for calculations including spin-orbit interaction.
|
|
* `DOScorr(sp)_proj(i).dat`: The DOS projected to an orbital with index `(i)`. The index `(i)` refers to
|
|
the indices given in ``SK.shells``.
|
|
* `DOScorr(sp)_proj(i)_(m)_(n).dat`: Sames as above, but printed as orbitally resolved matrix in indices
|
|
`(m)` and `(n)`. For `d` orbitals, it gives separately the DOS
|
|
for, e.g., :math:`d_{xy}`, :math:`d_{x^2-y^2}`, and so on.
|
|
|
|
Another quantity of interest is the momentum-resolved spectral function, which can directly be compared to ARPES
|
|
experiments. We assume here that we already converted the output of the :program:`dmftproj` program with the
|
|
converter routines, see :ref:`interfacetowien`. The spectral function is calculated by::
|
|
|
|
SK.spaghettis(broadening)
|
|
|
|
The output is
|
|
written as the 3-column files ``Akw(sp).dat``, where `(sp)` has the same meaning as above. The output format is
|
|
`k`, :math:`\omega`, `value`. Optional parameters are
|
|
|
|
* `shift`: An additional shift, added as `(ik-1)*shift`, where `ik` is the index of the `k` point. Useful for plotting purposes,
|
|
standard value is 0.0.
|
|
* `plotrange`: A python list with two entries, first being :math:`\omega_{min}`, the second :math:`\omega_{max}`, setting the plot
|
|
range for the output. Standard value is `None`, in this case the momentum range as given in the self energy is plotted.
|
|
* `ishell`: If this is not `None` (standard value), but an integer, the spectral function projected to the orbital with index `ishell`
|
|
is plotted to the files. Attention: The spectra are not rotated to the local coordinate system as used in the :program:`Wien2k`
|
|
program (For experts).
|
|
|
|
|