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

.. role:: red
	  
Wicklungsströme und -spannungen
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Funktion:   	*curr* 	  =   	get_wdg_curr 	( 	*wdg* 	 ) 
	
 Auslesen des Wicklungsstromes des letzten Rechnungsschritt.

 **Parameter**
    :red:`wdg`	Wicklungs-Key oder Wicklungs-Name

 **Return value**
    :red:`curr`	Wicklungsstrom [A]

.. admonition:: Funktion:   	volt 	  =   	get_wdg_volt 	( 	wdg 	 ) 
	
 Auslesen der Wicklungsspannung des letzten Rechnungsschritt.

 **Parameter**
    :red:`wdg`	Wicklungs-Key oder Wicklungs-Name

 **Return value**
    :red:`volt`	Wicklungsspannung [V]

Zweigströme und -spannungen
^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Funktion:   	curr 	  =   	get_branch_curr 	( 	branch, subbranch 	 ) 
	
 Auslesen des Zweigstromes des letzten Rechnungsschritt.

 **Parameter**
  | :red:`branch`	Zweig-Nummer in Netlist oder Zweig-Name
  | :red:`subbranch`	Index des Unter-Zweigs bei Elementen mit mehreren Zweigen (optional, wobei dann die Daten des erster Unter-Zweigs ausgegeben werden)

 **Return value**
    :red:`curr`	Wicklungsstrom [A]

.. admonition:: Funktion:   	volt 	  =   	get_branch_volt 	( 	branch, subbranch 	 ) 
	
 Auslesen der Zweigspannung des letzten Rechnungsschritt.

 **Parameter**
  | :red:`branch`	Zweig-Nummer in Netlist oder Zweig-Name
  | :red:`subbranch`	Index des Unter-Zweigs bei Elementen mit mehreren Zweigen (optional, wobei dann die Daten des erster Unter-Zweigs ausgegeben werden) 

 **Return value**
  | :red:`volt`	Wicklungsspannung [V]

Mechanische Daten
^^^^^^^^^^^^^^^^^

.. admonition:: Funktion:   	rot_angle, torque 	  =   	get_mech_data 	( 		 ) 
	
 Auslesen der Drehwinkels und des Drehmoments.

 **Return value**
  | :red:`rot_angle`	Drehwinkel [rad]
  | :red:`torque`	Drehmoment [Nm] 

  

Data Access
^^^^^^^^^^^
Bei FEMAG-TS wird das Modell während der Berechnung bearbeitet.
Für den Sliding-Mode wird das Modell im Luftspalt aufgetrennt.

Damit nach einer Berechnung das ursprüngliche (nicht aufgetrennte) Modell für weiter Bearbeitungen
wieder zur Verfügung steht, wird für die Berechnung ein Kopie des Datensatzes erstellt.
Die während der Berechnung gültigen Werte (z.B. Permeabilitäten) werden dann in diesen Datensatz
gespeichert.

Will man nun nach einer Berechnung mit Data-Access-Funktionen auf diese Werte zugreifen,
so muss der Datensatz zuerst aktiviert werden.
Dies wird mit dem Aufruf "switch_to_calculation_datas()" gemacht.
Mit dem Aufruf "switch_to_model_datas()" kann schlussendlich der Modell-Datensatz wieder aktiviert werden.
Dabei wird gleichzeitig der Berechnungs-Datensatz gespeichert.
D.h. allfälige Änderungen, die zwischenzeitig am Datensatz vorgenommen wurden,
werden in den Berechnungs-Datensatz gespeichert.

Bei Einzelschritt-Berechnungen ist nach dem Aufruf der Funktion "calc_field_ts_init(...)" dauernd der
Berechnungs-Datensatz, bis zum Aufruf "calc_field_ts_finish()", aktiv.
Dazwischen kann man also ohne den Aufruf der "Switch"-Funktionen die Data-Access-Funktionen verwenden.
Erst nach dem Abschluss ("calc_field_ts_finish( )") muss dazu der Berechnungs-Datensatz wieder
explizit aktiviert werden.

.. admonition:: Funktion:   	switch_to_calculation_datas 	( 		 ) 
	
 Aktiviert den Berechnungs-Buffer.


.. admonition:: Funktion:   	switch_to_model_datas 	( 		 ) 
	
 Aktiviert den Modell-Buffer.