Library with models for connecting thermal models

Each machine model is equipped with a machine-specific conditional `thermalPort`

.
If `useThermalPort == false`

, a machine-specific thermal ambient prescribing constant temperatures is used inside the machine.
If `useThermalPort == true`

, a thermal model or machine-specific thermal ambient prescribing the temperatures has to be connected from outside.
On the other hand, all losses are dissipated to this internal or external thermal ambient.

The machine specific thermal connector contains heatPorts
for all relevant loss sources of the machine type, although some of the loss sources are not yet implemented;
these heatPorts are left unconnected inside the machine, i.e., the HeatFlowRate is zero,
but they have to be connected to a constant temperature source in the internal or external thermal ambient.
Simple machine-specific thermal ambients for constant temperatures (`useTemperatureInputs == false`

)
or temperatures prescribed via signal inputs (`useTemperatureInputs == true`

) are provided in this package.

Up to now, only Ohmic losses in stator and rotor windings are implemented. They are modeled as linearly temperature dependent resistors:

ROperational = RRef * (1 + alphaRef * (TOperational - TRef))

- Resistance
`RRef`

at reference temperature - Reference temperature
`TRef`

- Linear temperature coefficient
`alpha20`

at 20°C - Operational temperature
`TOperational`

(if`useThermalPort == false`

; otherwise, the operational temperature is provided via the heatPort) - Nominal temperature
`TNominal`

(required for DC machines to calculate the turns ratio)

The linear temperature coefficient `alpha20`

at 20°C = 293.15 K has to be converted to reference temperature `TRef`

:

alpha20 alphaRef = ------------------------------- 1 + alpha20 * (TRef - 293.15)

For this reason, the function convertAlpha is provided. In sub-package Constants linear temperature coefficients at 20°C for commonly used materials are defined.

- The default / start values of all resistances are left unchanged.
- The default / start values of all reference temperatures are set to 20°C.
- The default / start values of all linear temperature coefficients are set to 0.
- The default / start values of all operational temperatures are set to 20°C.
- The default / start values of all nominal temperatures are set to 20°C.

`heatPortStatorWinding[m]`

: m=3 heatPorts for the m=3 stator phases`heatPortRotorWinding`

: heatPort for the rotor cage`heatPortStatorCore`

: stator core losses (not yet fully implemented)`heatPortRotorCore`

: rotor core losses (not yet connected/implemented)`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortStatorWinding[m]`

: m=3 heatPorts for the m=3 stator phases`heatPortRotorWinding[m]`

: m=3 heatPorts for the m=3 rotor phases`heatPortBrush`

: brush losses (not yet connected/implemented)`heatPortStatorCore`

: stator core losses (not yet fully implemented)`heatPortRotorCore`

: rotor core losses (not yet fully implemented)`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortStatorWinding[m]`

: m=3 heatPorts for the m=3 stator phases`heatPortRotorWinding`

: conditional (`useDamperCage=true/false`

) heatPort for the damper cage`heatPortPermanentMagnet`

: permanent magnet losses (not yet connected/implemented)`heatPortStatorCore`

: stator core losses (not yet fully implemented)`heatPortRotorCore`

: rotor core losses (not yet connected/implemented)`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortStatorWinding[m]`

: m=3 heatPorts for the m=3 stator phases`heatPortRotorWinding`

: conditional (`useDamperCage=true/false`

) heatPort for the damper cage`heatPortExcitation`

: electrical excitation`heatPortBrush`

: brush losses`heatPortStatorCore`

: stator core losses (not yet fully implemented)`heatPortRotorCore`

: rotor core losses (not yet connected/implemented)`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortStatorWinding[m]`

: m=3 heatPorts for the m=3 stator phases`heatPortRotorWinding`

: conditional (`useDamperCage=true/false`

) heatPort for the damper cage`heatPortStatorCore`

: stator core losses (not yet fully implemented)`heatPortRotorCore`

: rotor core losses (not yet connected/implemented)`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortArmature`

: armature losses`heatPortPermanentMagnet`

: permanent magnet losses (not yet connected/implemented)`heatPortBrush`

: brush losses`heatPortCore`

: armature core losses`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortArmature`

: armature losses`heatPortExcitation`

: electrical (shunt) excitation`heatPortBrush`

: brush losses`heatPortCore`

: armature core losses`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortArmature`

: armature losses`heatPortSeriesExcitation`

: electrical series excitation`heatPortBrush`

: brush losses`heatPortCore`

: armature core losses`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPortArmature`

: armature losses`heatPortShuntExcitation`

: electrical (shunt) excitation`heatPortSeriesExcitation`

: electrical series excitation`heatPortBrush`

: brush losses`heatPortCore`

: armature core losses`heatPortStrayLoad`

: stray load losses`heatPortFriction`

: friction losses

`heatPort1[m]`

: m=3 heatPorts for the m=3 primary phases`heatPort2[m]`

: m=3 heatPorts for the m=3 secondary phases`heatPortCore`

: iron core losses (not yet connected/implemented)

Extends from `Modelica.Icons.Package`

(Icon for standard packages).

Name | Description |
---|---|

`AsynchronousInductionMachines` … | Thermal parts of asynchronous induction machines |

`Constants` … | Material Constants |

`convertAlpha` | Converts alpha from temperature 1 (default 20 degC) to temperature 2 |

`convertResistance` | Converts resistance from reference temperature to an actual temperature |

`DCMachines` … | Thermal parts of DC machines |

`LinearTemperatureCoefficient20` | Linear temperature coefficient with choices |

`linearTemperatureDependency` | Converts a value (e.g. resistance) from reference temperature to an actual temperature |

`SynchronousInductionMachines` … | Thermal parts of synchronous induction machines |

`ThermalAmbientTransformer` | Thermal ambient for transformers |

Linear temperature coefficient with choices

Extends from `Modelica.SIunits.LinearTemperatureCoefficient`

.

Name | Value |
---|---|

`quantity` | `"LinearTemperatureCoefficient"` |

`unit` | `"1/K"` |

`min` | `-Modelica.Constants.inf` |

`max` | `Modelica.Constants.inf` |

`start` | `0.` |

`unbounded` | `false` |

Converts alpha from temperature 1 (default 20 degC) to temperature 2

From the temperature coefficient `alpha1`

at temperature `T1`

(default 20 degC = 293.15 K)
the temperature coefficient `alpha2`

at temperature `T2`

is calculated:

alpha1 alpha2 = ------------------------ 1 + alpha1 * (T2 - T1)

Extends from `Modelica.Icons.Function`

(Icon for functions).

Type | Name | Description |
---|---|---|

`LinearTemperatureCoefficient` | `alpha1` | Temperature coefficient at temperature 1 (default: 20 degC) |

`Temperature` | `T2` | Temperature 2 |

`Temperature` | `T1` | Temperature 1 (default: 20 degC) |

Type | Name | Description |
---|---|---|

`LinearTemperatureCoefficient` | `alpha2` | Temperature coefficient at TRef |

Converts resistance from reference temperature to an actual temperature

From the temperature coefficient `alpha20`

at 20 degC (equals to 293.15 K) the parameter `alphaRef`

at `TRef`

alpha20 alphaRef = ------------------------------- 1 + alpha20 * (TRef - 293.15)

is determined; using this value, actual resistance `R`

with respect to the actual temperature `T`

is calculated by

R ------ = 1 + alphaRef * (T - TRef) RRef

where `RRef`

is the resistance at the reference temperature `TRef`

.

Extends from `Modelica.Icons.Function`

(Icon for functions).

Type | Name | Description |
---|---|---|

`Resistance` | `RRef` | Resistance at TRef |

`Temperature` | `TRef` | Reference temperature |

`LinearTemperatureCoefficient` | `alpha20` | Temperature coefficient at 20 degC |

`Temperature` | `T` | Actual temperature |

Type | Name | Description |
---|---|---|

`Resistance` | `R` | Actual resistance at T |

Converts a value (e.g. resistance) from reference temperature to an actual temperature

This is the same function as Modelica.Electrical.Machines.Thermal.convertResistance but without physical units for input RRef and result R. This avoids problems if the function is used to calculate linear temperature dependency for other values than resistances.

From the temperature coefficient `alpha20`

at 20 degC (equals to 293.15 K) the parameter `alphaRef`

at `TRef`

alpha20 alphaRef = ------------------------------- 1 + alpha20 * (TRef - 293.15)

is determined; using this value, actual value (e.g. resistance `R`

) with respect to the actual temperature `T`

is calculated by

R ------ = 1 + alphaRef * (T - TRef) RRef

where `RRef`

is the value (e.g. resistance) at the reference temperature `TRef`

.

Extends from `Modelica.Icons.Function`

(Icon for functions).

Type | Name | Description |
---|---|---|

`Real` | `RRef` | Value at TRef |

`Temperature` | `TRef` | Reference temperature |

`LinearTemperatureCoefficient` | `alpha20` | Temperature coefficient at 20 degC |

`Temperature` | `T` | Actual temperature |

Type | Name | Description |
---|---|---|

`Real` | `R` | Actual value at T |

Thermal ambient for transformers

Thermal ambient for transformers to prescribe winding temperatures either constant or via signal connectors. Additionally, all losses = heat flows are recorded.

Type | Name | Default | Description |
---|---|---|---|

`Integer` | `m` | `3` | Number of phases |

`Boolean` | `useTemperatureInputs` | `false` | If true, temperature inputs are used; else, temperatures are constant |

`Temperature` | `T1` | Temperature of primary windings | |

`Temperature` | `T2` | Temperature of secondary windings |

Type | Name | Description |
---|---|---|

`ThermalPortTransformer` | `thermalPort` | |

`RealInput` | `TPrimary` | Temperature of primary windings |

`RealInput` | `TSecondary` | Temperature of secondary windings |