import_hole_fermi_level{ }¶

Calling sequence

currents{ import_hole_fermi_level{ } }

Properties

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

Dependencies

The global group import{ } and the nested group import_electron_fermi_level{ } must be defined.

Functionality

The group allows importing hole quasi-Fermi level to initialize related solver.

Please note that, in case importing an already converged result from solving a (classical or quantum) current-Poisson equation, one should import the electrostatic potential as well to obtain the best convergence.

Moreover, if the imported quasi-Fermi levels and electrostatic potential are resulting from a self-consistent simulation including the Schrödinger equation, and the current simulation is also aiming at solving all three equations self-consistently, then one should omit the running the classical mode of simulation, namely should not call any of the groups poisson{ } and current_poisson{ }. The simulation should begin already with solving the Schrödinger equation to get the best convergence, i.e., quantum_current_poisson{ }.

In case of changed contact bias, one should note that quasi-Fermi levels and electric potential are only imported for areas where they are not defined by boundary conditions (see contacts{ }), i.e., they cannot be used to replace these definitions.

Warning

Importing Fermi levels or potential from a simulation with different contact biases results in discontinuities of both quasi-Fermi levels and electric potential at the edge of the contacts, which may lead either to nonphysical results without subsequent iteration or to very poor convergence in subsequent iterations.

Example

currents{
    recombination_model{}
    import_electron_fermi_level{...}
    import_hole_fermi_level{...}
}

import{...}

Nested keywords

Maintained Keywords¶

The keywords below are available in at least one of currently published releases and are planned to be included also in the next release.

import_from¶

Calling sequence

currents{ import_hole_fermi_level{ import_from } }

Properties

usage: \(\mathrm{\textcolor{WildStrawberry}{required\;within\;the\;group}}\)
type: \(\mathrm{character\;string}\)

Functionality

A reference name to the path of the imported file defined in import{ }.

Example

currents{
    recombination_model{}
    import_electron_fermi_level{
        import_from = "reference_name_1"
    }
    import_hole_fermi_level{
        import_from = "reference_name_2"
    }
}

import{
    file{
        name = "reference_name_1"
        ...
    }
    analytic_function{
        name = "reference_name_2"
        ...
    }
}

component_number¶

Calling sequence

currents{ import_hole_fermi_level{ component_number } }

Properties

usage: \(\mathrm{\textcolor{ForestGreen}{optional\;within\;the\;group}}\)
type: \(\mathrm{integer}\)
unit: \(\mathrm{-}\)
values: {1, 2, 3, 4, ...}
default: 1

Functionality

A number referring to the column of numbers in the imported file to be used as the electron quasi-Fermi level.

Example

currents{
    recombination_model{}
    import_electron_fermi_level{
        import_from = "reference_name"
        component_number = 2
    }
    import_hole_fermi_level{
        import_from = "reference_name"
        component_number = 3
    }
}

import{
    file{
        name = "reference_name"
        ...
    }
}