==========
Evaluation
==========

.. role:: red
	  
.. admonition:: Command:   	color_gradation_th 	( 	*x,y,range,Losses,min,max,psfile* 	 ) 
	
 Darstellen der Verlustdichten

 **Parameter**
  | :red:`x/y`	Punkt innerhalb des Ranges [unit]; 0,0 bei range = tot
  | :red:`range`	Dargestellter Bereich: tot = alles, sr = Subregion, se = Superelement
  | :red:`Losses`	Verlustdichte wird dargestellt
  | :red:`min`	Kleinstwert der Darstellung
  | :red:`max`	Größtwert der Darstellung (automatische Skalierung wenn min und max gleich Null})
  | :red:`psfile`	Bezeichnung der auszugebenden Bildatei


.. admonition:: Command:   	color_gradation_th	(	*x,y,range,Temp,min,max,psfile* 	 ) 
	
 Darstellen der Temperaturverteilung

 **Parameter**
  | :red:`x/y`	Punkt innerhalb des Ranges [unit], 0,0 bei range = tot
  | :red:`range`	Dargestellter Bereich: tot = alles, sr = Subregion, se = Superelement
  | :red:`Temp`	Temperaturverteilung wird dargestellt
  | :red:`min`	Kleinstwert der Darstellung
  | :red:`max`	Größtwert der Darstellung (automatische Skalierung wenn min und max gleich Null)
  | :red:`psfile`	Bezeichnung der auszugebenden Bildatei


.. admonition:: Command:   	color_gradation_th 	( 	*x,y,range,Heat_flow_density,min,max,psfile*	 ) 
	
 Darstellen der Wärmeflussdichte

 **Parameter**
  | :red:`x/y`	Punkt innerhalb des Ranges [unit], 0,0 bei range = tot
  | :red:`range`	Dargestellter Bereich: tot = alles, sr = Subregion, se = Superelement
  | :red:`Heat_flow_density`	Wärmeflussdichte wird dargestellt
  | :red:`min`	Kleinstwert der Darstellung
  | :red:`max`	Größtwert der Darstellung (automatische Skalierung wenn min und max gleich Null)
  | :red:`psfile`	Bezeichnung der auszugebenden Bildatei


.. admonition:: Function:   	*Temp* 	  =   	temperature_xy 	( 	*x,y* 	 ) 
	
 Rückgabe der Temperatur in einem Punkt

 **Parameter**
  :red:`x/y`	Punkt [unit]

 Rückgabe
  :red:`Temp` Temperatur im Punkt [K] 


.. admonition:: Function:   	*T, x, y* 	  =   	hotspot 	( 		 ) 
	
 Rückgabe der maximal Temperatur 

 Rückgabe
  | :red:`T` Grösste ermittelte Temperatur [K] 
  | :red:`x/y` Punkt mit grösster Temperatur [unit] 


.. admonition:: Function:   	*Tl, xl, yl, Th, xh, yh* 	  =   	get_temp_limit_sr 	( *srkey* ) 
	
 Rückgabe der minimal und maximal Temperatur in einer Subregion

 Rückgabe
  | :red:`Tl` Kleinste ermittelte Temperatur [K] 
  | :red:`xl/yl` Punkt mit kleinster Temperatur [unit] 
  | :red:`Th` Grösste ermittelte Temperatur [K] 
  | :red:`xh/yh` Punkt mit grösster Temperatur [unit] 


.. admonition:: Function:   	*heatflow* 	  =   	get_heat_flow_line 	( 	*x1, y1, x2, y2* 	 ) 
	
 Berechnet den Wärmefluss durch die gerade Linie vom Punkt 1 (x1/y1) bis zum Punkt 2 (x2/y2).

 **Parameter**
  | :red:`x1/y1`	Startpunkt der Linie [unit]
  | :red:`x2/y2`	Endpunkt der Linie [unit]

 Rückgabe
  | :red:`heatflow` Wärmefluss durch Linie [W/m]

 Der Wärmefluss wird zwischen der Mitte des Element 1, in dem der Punkt 1, liegt und der Mitte des Element 2, in dem der Punkt 2, liegt berechnet.


.. admonition:: Function:   	*heatflow* 	  =   	get_heat_flow_nodechain 	( 	*x1, y1, x2, y2* 	 ) 
	
 Berechnet den Wärmefluss durch die Knotenketten vom Punkt x1/y1 bis zum Punkt x2/y2

 **Parameter**
  | :red:`x1/y1`	Startpunkt auf Knotenkette [unit]
  | :red:`x2/y2`	Endpunkt auf Knotenkette [unit]

 Rückgabe
  | :red:`heatflow` Wärmefluss durch die Knotenketten [W/m] 


.. admonition:: Command: export_calc_results(*<file>.vtu*)

 Exports the results, depending of state_of _problem, to the vtu-file.

 **Parameter**
  | :red:`file` Filename

  
.. admonition:: Command: create_heat_source_network()

 A heat source network is derived based on a FEMAG-TH calculation.
 
 The subregions defined in FEMAG-TH are regarded as nodes.
 
 The thermal resistances are determined from the temperature difference and
 the heat flow between the subregions.
 
 The thermal capacities are calculated from the specific thermal capacities and
 the masses of the subregions.
 
 The losses in the subregions become heat sources in the network.
 
 Boundary conditions with a constant temperature are modeled with a temperature source
 and an internal resistance.
 
 The heat source network is saved in JSON-format in a file with the name <model_name>.hsn