Diffusion2D Class

class electrical.diffusion.Diffusion2D(name='')

Calculates carrier pairs concentration in active region using FEM in two-dimensional Cartesian space

Methods

compute([loops, shb, reg])

Run diffusion calculations

compute_overthreshold()

Deprecated method.

compute_threshold()

Deprecated method.

get_burning_for_mode(mode)

Get power burned over threshold by specified mode [mW].

get_total_burning()

Get total power burned over threshold [mW].

initialize()

Initialize solver.

invalidate()

Set the solver back to uninitialized state.

Attributes

Receivers

inCurrentDensity

Receiver of the current density required for computations [kA/cm²].

inGain

Receiver of the material gain required for computations [1/cm].

inLightE

Receiver of the electric field required for computations [V/m].

inTemperature

Receiver of the temperature required for computations [K].

inWavelength

Receiver of the wavelength required for computations [nm].

Providers

outCarriersConcentration

Provider of the computed carriers concentration [1/cm³].

Other

algorithm

Chosen matrix factorization algorithm

geometry

Geometry provided to the solver

id

Id of the solver object.

initialized

True if the solver has been initialized.

iterative

Iterative matrix parameters (see IterativeParams)

maxerr

Maximum relative residual error (%)

mesh

Mesh provided to the solver

Descriptions

Method Details

Diffusion2D.compute(loops=0, shb=False, reg=None)

Run diffusion calculations

Parameters:

  • loops (int) – Number of iterations to perform. If 0, the solver will run until the convergence.

  • shb (bool) – If True, the solver will use take into account the spatial hole burning effect.

  • reg (int or None) – Index of the active region to compute. If None, perform computations for all the active regions.

Diffusion2D.compute_overthreshold()

Deprecated method. Use compute(shb=True) instead.

Diffusion2D.compute_threshold()

Deprecated method. Use compute() instead.

Diffusion2D.get_burning_for_mode(mode)

Get power burned over threshold by specified mode [mW].

Diffusion2D.get_total_burning()

Get total power burned over threshold [mW].

Diffusion2D.initialize()

Initialize solver.

This method manually initialized the solver and sets initialized to True. Normally calling it is not necessary, as each solver automatically initializes itself when needed.

Returns:

solver initialized state prior to this method call.

Return type:

bool

Diffusion2D.invalidate()

Set the solver back to uninitialized state.

This method frees the memory allocated by the solver and sets initialized to False.

Receiver Details

Diffusion2D.inCurrentDensity = <property object>

Receiver of the current density required for computations [kA/cm²].

You will find usage details in the documentation of the receiver class CurrentDensityReceiver2D.

Example

Connect the receiver to a provider from some other solver:

>>> solver.inCurrentDensity = other_solver.outCurrentDensity

See also

Receciver class: plask.flow.CurrentDensityReceiver2D

Provider class: plask.flow.CurrentDensityProvider2D

Data filter: plask.filter.CurrentDensityFilter2D

Diffusion2D.inGain = <property object>

Receiver of the material gain required for computations [1/cm]. It is required only for the SHB computations.

You will find usage details in the documentation of the receiver class GainReceiver2D.

Example

Connect the receiver to a provider from some other solver:

>>> solver.inGain = other_solver.outGain

See also

Receciver class: plask.flow.GainReceiver2D

Provider class: plask.flow.GainProvider2D

Data filter: plask.filter.GainFilter2D

Diffusion2D.inLightE = <property object>

Receiver of the electric field required for computations [V/m]. It is required only for the SHB computations.

You will find usage details in the documentation of the receiver class ModeLightEReceiver2D.

Example

Connect the receiver to a provider from some other solver:

>>> solver.inLightE = other_solver.outModeLightE

See also

Receciver class: plask.flow.ModeLightEReceiver2D

Provider class: plask.flow.ModeLightEProvider2D

Data filter: plask.filter.ModeLightEFilter2D

Diffusion2D.inTemperature = <property object>

Receiver of the temperature required for computations [K].

You will find usage details in the documentation of the receiver class TemperatureReceiver2D.

Example

Connect the receiver to a provider from some other solver:

>>> solver.inTemperature = other_solver.outTemperature

See also

Receciver class: plask.flow.TemperatureReceiver2D

Provider class: plask.flow.TemperatureProvider2D

Data filter: plask.filter.TemperatureFilter2D

Diffusion2D.inWavelength = <property object>

Receiver of the wavelength required for computations [nm]. It is required only for the SHB computations.

You will find usage details in the documentation of the receiver class ModeWavelengthReceiver.

Example

Connect the receiver to a provider from some other solver:

>>> solver.inWavelength = other_solver.outModeWavelength

See also

Receciver class: plask.flow.ModeWavelengthReceiver

Provider class: plask.flow.ModeWavelengthProvider

Data filter: plask.filter.ModeWavelengthFilter

Provider Details

Diffusion2D.outCarriersConcentration(n=0, mesh, interpolation='default') = <property object>

Provider of the computed carriers concentration [1/cm³].

Parameters:

  • type (str) – Detailed information which carriers are returned. It can be ‘majority’ to return majority carriers in given material, ‘pairs’ for the concentration of electron-hole pairs, ‘electrons’, or ‘holes’ for particular carriers type.

  • mesh (mesh) – Target mesh to get the field at.

  • interpolation (str) – Requested interpolation method.

Returns:

Data with the carriers concentration on the specified mesh [1/cm³].

You may obtain the number of different values this provider can return by testing its length.

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inCarriersConcentration = solver.outCarriersConcentration

Obtain the provided field:

>>> solver.outCarriersConcentration(0, mesh)
<plask.Data at 0x1234567>

Test the number of provided values:

>>> len(solver.outCarriersConcentration)
3

See also

Provider class: plask.flow.CarriersConcentrationProvider2D

Receciver class: plask.flow.CarriersConcentrationReceiver2D

Attribute Details

Diffusion2D.algorithm = <property object>

Chosen matrix factorization algorithm

Diffusion2D.geometry = <property object>

Geometry provided to the solver

Diffusion2D.id = <property object>

Id of the solver object. (read only)

Example

>>> mysolver.id
mysolver:category.type
Diffusion2D.initialized = <property object>

True if the solver has been initialized. (read only)

Solvers usually get initialized at the beginning of the computations. You can clean the initialization state and free the memory by calling the invalidate() method.

Diffusion2D.iterative = <property object>

Iterative matrix parameters (see IterativeParams)

Diffusion2D.maxerr = <property object>

Maximum relative residual error (%)

Diffusion2D.mesh = <property object>

Mesh provided to the solver