ELPH SELFEN CARRIER DEN RANGE: Difference between revisions

From VASP Wiki
No edit summary
No edit summary
Line 3: Line 3:


Description: List of the range of carrier density (in <math>cm^{-3}</math>) at which to compute the phonon-mediated electron self-energy and transport coefficients.  
Description: List of the range of carrier density (in <math>cm^{-3}</math>) at which to compute the phonon-mediated electron self-energy and transport coefficients.  
{{Available|6.5.2}}
<!--{{Available|6.5.2}}-->
{{not released}}


----
----
Line 10: Line 11:
* ''u'' is the upper limit of the carrier density range.
* ''u'' is the upper limit of the carrier density range.
* ''n'' is the number of steps between the two limits.
* ''n'' is the number of steps between the two limits.
{{NB|important|When ''l'' or ''u'' is set to positive, electrons are added, i.e., ''n''-doping. When ''l'' or ''u'' is set to negative, electrons are removed from (holes are added to) the system, i.e., ''p''-doping.}}
{{NB|important|When ''l'' or ''u'' must both be positive (electrons are added, i.e., ''n''-doping) or negative (electrons are removed from - holes are added to - the system, i.e., ''p''-doping).}}
<!--This can be useful for producing contour plots, e.g., of the ZT figure of merit link to elph-part5 tutorial + add in the list of mu in the OUTCAR?-->
<!--This can be useful for producing contour plots, e.g., of the ZT figure of merit link to elph-part5 tutorial + add in the list of mu in the OUTCAR?-->


For example, {{TAGO|ELPH_SELFEN_CARRIER_DEN_RANGE|-1e20 1e20 3}} would create a list of <b>3</b> points producing densities of:  
You can add these set three (''l'' ''u'' ''n'') N times, so have several ranges of holes or electrons or both. For example, {{TAGO|ELPH_SELFEN_CARRIER_DEN_RANGE|-1e20 -1e16 51 1e20 1e16 51}} would create a list of two groups of carrier densities, (-1e20 -1e16 51) and (1e20 1e16 51). The first group has 51 different carrier densities of holes between -1e20 and -1e16; the second group has 51 different carrier densities of electrons between 1e16 and 1e20. You could also include more groups if you want. You can check the carriers that you have chosen in the {{FILE|OUTCAR}} file:
 
Chemical potential calculation:
===============================
   
   
elph_ismear=-24
elph_fermi_nedos=    501
  elph_selfen_carrier_den=
  elph_selfen_carrier_den=
  -0.100E+21
  -0.832E+20
  -0.692E+20
...
  -0.145E+17
  -0.120E+17
  -0.100E+17
  0.100E+21
  0.832E+20
  0.692E+20
...
  0.145E+17
  0.120E+17
  0.100E+17
{{NB|warning|Be careful not to combine holes and electrons in the same group, as this will likely not create the set of density that you desire, e.g.: {{TAGO|ELPH_SELFEN_CARRIER_DEN_RANGE|-1e20 1e20 3}} creates the following carrier density:
elph_selfen_carrier_den{{=}}
   -0.100E+21
   -0.100E+21
   -0.100E+41
   -0.100E+41
   -0.100E+61
   -0.100E+61
 
}}
'''This is not correct behavior. This tag should not yet be made public.'''


==Related tags and articles==
==Related tags and articles==

Revision as of 14:21, 17 October 2025

ELPH_SELFEN_CARRIER_DEN_RANGE = [real array] 

Description: List of the range of carrier density (in [math]\displaystyle{ cm^{-3} }[/math]) at which to compute the phonon-mediated electron self-energy and transport coefficients.

   Warning: Not yet released!

This page contains information about a feature that will be available in a future release of VASP. In other words, currently you cannot use it even with the latest version of VASP. The information may change significantly until it is released.


From each carrier density specified in the array, a positive (electron doping) or negative (hole doping) number of electrons is added to the value of NELECT and the chemical potential computed. A range of carrier densities can be defined using ELPH_SELFEN_CARRIER_DEN_RANGE = l u n, where:

  • l is the lower limit of the carrier density range.
  • u is the upper limit of the carrier density range.
  • n is the number of steps between the two limits.
Important: When l or u must both be positive (electrons are added, i.e., n-doping) or negative (electrons are removed from - holes are added to - the system, i.e., p-doping).

You can add these set three (l u n) N times, so have several ranges of holes or electrons or both. For example, ELPH_SELFEN_CARRIER_DEN_RANGE = -1e20 -1e16 51 1e20 1e16 51 would create a list of two groups of carrier densities, (-1e20 -1e16 51) and (1e20 1e16 51). The first group has 51 different carrier densities of holes between -1e20 and -1e16; the second group has 51 different carrier densities of electrons between 1e16 and 1e20. You could also include more groups if you want. You can check the carriers that you have chosen in the OUTCAR file:

Chemical potential calculation:
===============================

elph_ismear=-24
elph_fermi_nedos=     501
elph_selfen_carrier_den=
 -0.100E+21
 -0.832E+20
 -0.692E+20
...
 -0.145E+17
 -0.120E+17
 -0.100E+17
  0.100E+21
  0.832E+20
  0.692E+20
...
  0.145E+17
  0.120E+17
  0.100E+17
Warning: Be careful not to combine holes and electrons in the same group, as this will likely not create the set of density that you desire, e.g.: ELPH_SELFEN_CARRIER_DEN_RANGE = -1e20 1e20 3 creates the following carrier density:
elph_selfen_carrier_den=
 -0.100E+21
 -0.100E+41
 -0.100E+61

Related tags and articles