Dynamic3D Class

class thermal.dynamic.Dynamic3D(name='')

Finite element thermal solver for 3D Cartesian geometry.

Methods

compute(time)

Run thermal calculations

initialize()

Initialize solver.

invalidate()

Set the solver back to uninitialized state.

Attributes

Receivers

inHeat

Receiver of the heat sources density required for computations [W/m³].

Providers

outHeatFlux

Provider of the computed heat flux [W/m²].

outTemperature

Provider of the computed temperature [K].

outThermalConductivity

Provider of the computed thermal conductivity [W/(m×K)].

Other

algorithm

Chosen matrix factorization algorithm

elapsed_time

Alias for time (obsolete).

empty_elements

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

geometry

Geometry provided to the solver

id

Id of the solver object.

initialized

True if the solver has been initialized.

inittemp

Initial temperature (K)

iterative

Iterative matrix parameters (see IterativeParams)

logfreq

Frequency of iteration progress reporting

lumping

Chosen mass matrix type from lumped or non-lumped (consistent)

mesh

Mesh provided to the solver

methodparam

0.5 - Crank-Nicolson method, 0 - explicit method, 1 - implicit method

rebuildfreq

Frequency of rebuild mass

temperature_boundary

Boundary conditions for the constant temperature

time

Time of calculations performed so far since the last solver invalidation.

timestep

Time step (ns)

Descriptions

Method Details

Dynamic3D.compute(time)

Run thermal calculations

Dynamic3D.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

Dynamic3D.invalidate()

Set the solver back to uninitialized state.

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

Receiver Details

Dynamic3D.inHeat = <property object>

Receiver of the heat sources density required for computations [W/m³].

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

Example

Connect the receiver to a provider from some other solver:

>>> solver.inHeat = other_solver.outHeat

See also

Receciver class: plask.flow.HeatReceiver3D

Provider class: plask.flow.HeatProvider3D

Data filter: plask.filter.HeatFilter3D

Provider Details

Dynamic3D.outHeatFlux(mesh, interpolation='default') = <property object>

Provider of the computed heat flux [W/m²].

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

  • interpolation (str) – Requested interpolation method.

Returns:

Data with the heat flux on the specified mesh [W/m²].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inHeatFlux = solver.outHeatFlux

Obtain the provided field:

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

See also

Provider class: plask.flow.HeatFluxProvider3D

Receciver class: plask.flow.HeatFluxReceiver3D

Dynamic3D.outTemperature(mesh, interpolation='default') = <property object>

Provider of the computed temperature [K].

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

  • interpolation (str) – Requested interpolation method.

Returns:

Data with the temperature on the specified mesh [K].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inTemperature = solver.outTemperature

Obtain the provided field:

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

See also

Provider class: plask.flow.TemperatureProvider3D

Receciver class: plask.flow.TemperatureReceiver3D

Dynamic3D.outThermalConductivity(mesh, interpolation='default') = <property object>

Provider of the computed thermal conductivity [W/(m×K)].

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

  • interpolation (str) – Requested interpolation method.

Returns:

Data with the thermal conductivity on the specified mesh [W/(m×K)].

Example

Connect the provider to a receiver in some other solver:

>>> other_solver.inThermalConductivity = solver.outThermalConductivity

Obtain the provided field:

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

Attribute Details

Dynamic3D.algorithm = <property object>

Chosen matrix factorization algorithm

Dynamic3D.elapsed_time = <property object>

Alias for time (obsolete).

Dynamic3D.empty_elements = <property object>

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

Dynamic3D.geometry = <property object>

Geometry provided to the solver

Dynamic3D.id = <property object>

Id of the solver object. (read only)

Example

>>> mysolver.id
mysolver:category.type
Dynamic3D.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.

Dynamic3D.inittemp = <property object>

Initial temperature (K)

Dynamic3D.iterative = <property object>

Iterative matrix parameters (see IterativeParams)

Dynamic3D.logfreq = <property object>

Frequency of iteration progress reporting

Dynamic3D.lumping = <property object>

Chosen mass matrix type from lumped or non-lumped (consistent)

Dynamic3D.mesh = <property object>

Mesh provided to the solver

Dynamic3D.methodparam = <property object>

0.5 - Crank-Nicolson method, 0 - explicit method, 1 - implicit method

Type:

Initial parameter determining the calculation method

Dynamic3D.rebuildfreq = <property object>

Frequency of rebuild mass

Dynamic3D.temperature_boundary = <property object>

Boundary conditions for the constant temperature

This field holds a list of boundary conditions for the solver. You may access and alter its 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.temperature_boundary.clear()
>>> solver.temperature_boundary.append(solver.mesh.Bottom(), some_value)
>>> solver.temperature_boundary[0].value = different_value
>>> solver.temperature_boundary.insert(0, solver.mesh.Top(), new_value)
>>> solver.temperature_boundary[1].value == different_value
True
Dynamic3D.time = <property object>

Time of calculations performed so far since the last solver invalidation.

Dynamic3D.timestep = <property object>

Time step (ns)