PLaSK User Manual

ActiveCond3D Class

class electrical.shockley.ActiveCond3D(name="")

Finite element thermal solver for 3D Cartesian geometry.

Methods

compute([loops]) Run electrical calculations
get_capacitance() Get the structure capacitance.
get_electrostatic_energy() Get the energy stored in the electrostatic field in the analyzed structure.
get_total_current([nact]) Get total current flowing through active region [mA]
get_total_heat() Get the total heat produced by the current flowing in the structure.
initialize() Initialize solver.
invalidate() Set the solver back to uninitialized state.

Attributes

Receivers

inTemperature Receiver of the temperature required for computations [K].

Providers

outConductivity Provider of the computed electrical conductivity [S/m].
outCurrentDensity Provider of the computed current density [kA/cm²].
outHeat Provider of the computed heat sources density [W/m³].
outPotential Not available in this solver.
outVoltage Provider of the computed voltage [V].

Other

algorithm Chosen matrix factorization algorithm
cond Junction conductivity function [S/m].
convergence Convergence method.
err Maximum estimated error
geometry Geometry provided to the solver
id Id of the solver object.
include_empty Should empty regions (e.g.
initialized True if the solver has been initialized.
itererr Allowed residual iteration for iterative method
iterlim Maximum number of iterations for iterative method
logfreq Frequency of iteration progress reporting
maxerr Limit for the potential updates
mesh Mesh provided to the solver
ncond Conductivity of the n-contact
pcond Conductivity of the p-contact
pnjcond Default effective conductivity of the active region.
start_cond Default effective conductivity of the active region.
voltage_boundary Boundary conditions of the first kind (constant potential)

Descriptions

Method Details

ActiveCond3D.compute(loops=0)

Run electrical calculations

ActiveCond3D.get_capacitance()

Get the structure capacitance.

Returns:Total capacitance [pF].

Note

This method can only be used it there are exactly two boundary conditions specifying the voltage. Otherwise use get_electrostatic_energy() to obtain the stored energy \(W\) and compute the capacitance as: \(C = 2 \, W / U^2\), where \(U\) is the applied voltage.

ActiveCond3D.get_electrostatic_energy()

Get the energy stored in the electrostatic field in the analyzed structure.

Returns:Total electrostatic energy [J].
ActiveCond3D.get_total_current(nact=0)

Get total current flowing through active region [mA]

ActiveCond3D.get_total_heat()

Get the total heat produced by the current flowing in the structure.

Returns:Total produced heat [mW].
ActiveCond3D.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
ActiveCond3D.invalidate()

Set the solver back to uninitialized state.

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

Receiver Details

ActiveCond3D.inTemperature

Receiver of the temperature required for computations [K].

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

Example

Connect the reveiver to a provider from some other solver:

>>> solver.inTemperature = other_solver.outTemperature

See also

Receciver class: plask.flow.TemperatureReceiver3D

Provider class: plask.flow.TemperatureProvider3D

Data filter: plask.filter.TemperatureFilter3D

Provider Details

ActiveCond3D.outConductivity(mesh, interpolation='default')

Provider of the computed electrical conductivity [S/m].

Parameters:
  • mesh (mesh) – Target mesh to get the field at.
  • interpolation (str) – Requested interpolation method.
Returns:

Data with the electrical conductivity on the specified mesh [S/m].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inConductivity = solver.outConductivity

Obtain the provided field:

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

See also

Provider class: plask.flow.ConductivityProvider3D

Receciver class: plask.flow.ConductivityReceiver3D

ActiveCond3D.outCurrentDensity(mesh, interpolation='default')

Provider of the computed current density [kA/cm²].

Parameters:
  • mesh (mesh) – Target mesh to get the field at.
  • interpolation (str) – Requested interpolation method.
Returns:

Data with the current density on the specified mesh [kA/cm²].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inCurrentDensity = solver.outCurrentDensity

Obtain the provided field:

>>> solver.outCurrentDensity(mesh)
<plask.Data at 0x1234567>
ActiveCond3D.outHeat(mesh, interpolation='default')

Provider of the computed heat sources density [W/m³].

Parameters:
  • mesh (mesh) – Target mesh to get the field at.
  • interpolation (str) – Requested interpolation method.
Returns:

Data with the heat sources density on the specified mesh [W/m³].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inHeat = solver.outHeat

Obtain the provided field:

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

See also

Provider class: plask.flow.HeatProvider3D

Receciver class: plask.flow.HeatReceiver3D

ActiveCond3D.outPotential

Not available in this solver. Use outVoltage instead.

ActiveCond3D.outVoltage(mesh, interpolation='default')

Provider of the computed voltage [V].

Parameters:
  • mesh (mesh) – Target mesh to get the field at.
  • interpolation (str) – Requested interpolation method.
Returns:

Data with the voltage on the specified mesh [V].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inVoltage = solver.outVoltage

Obtain the provided field:

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

See also

Provider class: plask.flow.VoltageProvider3D

Receciver class: plask.flow.VoltageReceiver3D

Attribute Details

ActiveCond3D.algorithm

Chosen matrix factorization algorithm

ActiveCond3D.cond

Junction conductivity function [S/m].

This function should take current density [kA/cm²] and temperature [K] as arguments and return a conductivity [S/m]. In case,there is more than one junction you may set such function for any of them by using cond# property, where # is the junction number (specified by a role junction#

or active#).

cond is an alias for cond0.

ActiveCond3D.convergence

Convergence method.

If stable, covergence is slown down to ensure stability.

ActiveCond3D.err

Maximum estimated error

ActiveCond3D.geometry

Geometry provided to the solver

ActiveCond3D.id

Id of the solver object. (read only)

Example

>>> mysolver.id
mysolver:category.type
ActiveCond3D.include_empty

Should empty regions (e.g. air) be included into computation domain?

ActiveCond3D.initialized

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.

ActiveCond3D.itererr

Allowed residual iteration for iterative method

ActiveCond3D.iterlim

Maximum number of iterations for iterative method

ActiveCond3D.logfreq

Frequency of iteration progress reporting

ActiveCond3D.maxerr

Limit for the potential updates

ActiveCond3D.mesh

Mesh provided to the solver

ActiveCond3D.ncond

Conductivity of the n-contact

ActiveCond3D.pcond

Conductivity of the p-contact

ActiveCond3D.pnjcond

Default effective conductivity of the active region.

Effective junction conductivity will be computed starting from this value. Note that the actual junction conductivity after convergence can be obtained with outConductivity.

ActiveCond3D.start_cond

Default effective conductivity of the active region.

Effective junction conductivity will be computed starting from this value. Note that the actual junction conductivity after convergence can be obtained with outConductivity.

ActiveCond3D.voltage_boundary

Boundary conditions of the first kind (constant potential)

This field holds a list of boundary conditions for the solver. You may access and alter is elements a normal Python list. Each element is a special class that has two attributes:

place Boundary condition location (plask.mesh.RectangularBase3D.Boundary).
value Boundary condition value.

When you add new boundary condition, you may use two-argument append, or prepend methods, or three-argument insert method, where you separately specify the place and the value. See the below example for clarification.

Example

>>> solver.voltage_boundary.clear()
>>> solver.voltage_boundary.append(solver.mesh.Bottom(), some_value)
>>> solver.voltage_boundary[0].value = different_value
>>> solver.voltage_boundary.insert(0, solver.mesh.Top(), new_value)
>>> solver.voltage_boundary[1].value == different_value
True