energy_distribution{ }¶

Calling sequence

classical{ energy_distribution{ } }

Properties

usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)
items: \(\mathrm{maximum\;1}\)

Functionality

Definition and output of integrated electron and hole density as a function of energy, \(n(E)\), \(p(E)\) in units of [\(\mathrm{cm}^{-2}\mathrm{eV}^{-1}\)] in 1D, [\(\mathrm{cm}^{-1}\mathrm{eV}^{-1}\)] in 2D, and [\(\mathrm{eV}^{-1}\)] in 3D.

Attention

min_energy, max_energy always refer to a zero point at the (local) conduction band edge, and not to the photon energy.
max should be set high enough above 0 to contain all occupied electron states and min should be set far enough below the band gap to contain all occupied hole states.
The respective values for energy_resolution should be set smaller than \(k_BT\) if one wishes to fully resolve the structures of the integrated densities and/or of the emission spectra.
However, while setting energy_resolution as low as 0.001 eV has little influence on program execution time, using similarly small values for energy_resolution in energy_resolved_density{ } will result in massive slowdowns (and in 3D also in massive memory use), since the computational effort for obtaining emission spectra grows quadratically with the number of energy bins.

Note

Currently available only for 1-band models.

Example

classical{
    energy_distribution{...}

    Gamma{}
    HH{}
}

Nested keywords

min_energy¶

Calling sequence

classical{ energy_distribution{ min_energy } }

Properties

usage: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;group}}\)
type: \(\mathrm{real\;number}\)
values: no constraints
unit: \(\mathrm{eV}\)

Functionality

minimum energy

Example

classical{
    energy_distribution{
        min_energy = -0.5
        max_energy = 1.8
    }

    Gamma{}
    HH{}
}

max_energy¶

Calling sequence

classical{ energy_distribution{ max_energy } }

Properties

usage: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;group}}\)
type: \(\mathrm{real\;number}\)
values: no constraints
unit: \(\mathrm{eV}\)

Functionality

maximum energy

Example

classical{
    energy_distribution{
        min_energy = -0.5
        max_energy = 1.8
    }

    Gamma{}
    HH{}
}

energy_resolution¶

Calling sequence

classical{ energy_distribution{ energy_resolution } }

Properties

usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)
type: \(\mathrm{real\;number}\)
values: no constraints
unit: \(\mathrm{eV}\)
default: 0.1

Functionality

energy spacing

Example

classical{
    energy_distribution{
        min_energy = -0.5
        max_energy = 1.8
        energy_resolution = 0.01
    }

    Gamma{}
    HH{}
}

only_quantum_regions¶

Calling sequence

classical{ energy_distribution{ only_quantum_regions } }

Properties

usage: \(\mathrm{\textcolor{Dandelion}{conditional}}\)
type: \(\mathrm{choice}\)
choices: yes; no
default: no

Dependencies

quantum{ region{ } } must be defined in the input file to use only_quantum_regions.

Functionality

This keyword can be used to suppress contributions from outside the quantum regions of interest. This works even if quantum mechanics is not enabled in run{ }.

Note

Note that energy_distribution{ }, which directly calculates the space-integrated energy-resolved density, is independent on the group energy_resolved_density{ }.

Example

classical{
    energy_distribution{
        only_quantum_regions = yes

        min_energy = -0.5
        max_energy = 1.8
    }

    Gamma{}
    HH{}
    quantum{
        region{...}
    }
}