.. _accessModel:

=====
Model
=====

.. role:: red
.. role:: big
	  
Befehle, die das Lesen und Zuweisen der Werte und Eigenschaften des Finite-Elemente-Modells ermöglichen.

Geometrische Größen (Koordinaten, Längen und Flächen) entsprechen der global gewählten Längeneinheit (gobal_unit, siehe :any:`settings`). Übergebene oder zurückgelieferte Vektoren (Komponenten der Vektoren) beziehen sich, wenn in der Funktionsbeschreibung nicht explizit angegeben, auf das kartesisches System. Zur einfachen Umrechnung zwischen unerschiedlichen Bezugssystemen stehen Funktionen zur :any:`trans` zur Verfügung.


:big:`Übersicht`

----------------------------------------------------------------------

+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| Bezeichner          | Anzahl Werte | Einheit | Zugriff get/set | Beschreibung                                                                                                                                           |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_nodes           | 1            | -       | g               | Anzahl der Knoten des Modells (ab Rel. 8.3)                                                                                                            |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| node_hidx           | 1            | -       | g               | Number of nodechains in model (since Rel. 9.1)                                                                                                         |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| ndchn_hidx          | 1            | -       | g               | Größte im Modell verwendete Knotennummer (Key) (ab Rel 8.3)                                                                                            |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_elem            | 1            | -       | g               | Anzahl der Finiten Elemente des Modells (ab Rel. 8.2)                                                                                                  |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| elem_hidx           | 1            | -       | g               | Größte im Modell verwendete Elementnummer (Key) (ab Rel 8.3)                                                                                           |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_spel            | 1            | -       | g               | Anzahl der Superelemente des Modells (ab Rel. 8.3)                                                                                                     |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| spel_hidx           | 1            | -       | g               | Größte im Modell verwendete Superelementnummer (Key) (ab Rel. 8.3)                                                                                     |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_sreg            | 1            | -       | g               | Anzahl der Subregionen des Modells (ab Rel. 8.3)                                                                                                       |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| sreg_hidx           | 1            | -       | g               | Größte im Modell verwendete Subregionnummer (Key) (ab Rel. 8.3)                                                                                        |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_wdg             | 1            | -       | g               | Anzahl der Wicklungen und Massivleiter des Modells (ab Rel. 8.3)                                                                                       |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| wdg_hidx            | 1            | -       | g               | Größte im Modell verwendete Wicklungsnummer (Key) (ab Rel. 8.3)                                                                                        |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_slots           | 1            | -       | g               | Nutzahl des modellierten Maschinenteils (ab Rel. 8.2)                                                                                                  |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| num_poles           | 1            | -       | g               | Anzahl der Pole des modellierten Maschinenteils (ab Re. 8.2)                                                                                           |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_basfreq   | 2            | Hz      | g               | Bezugsfrequenz der Koeffizienten des Jordan-Modells. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).         |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_basind    | 2            | T       | g               | Bezugsinduktion der Koeffizienten des Jordan-Modells. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).        |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_hystcoef  | 2            | W/kg    | g               | Spezifische Hystereseverluste nach dem Jordan-Modell. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).        |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_eddycoef  | 2            | W/kg    | g               | Spezifische Wirbelstromverluste nach dem Jordan-Modell. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).      |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_hystfexp  | 2            | -       | g               | Frequenzexponent der Hystereseverluste des Jordan-Modells. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).   |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_eddyfexp  | 2            | -       | g               | Frequenzexponent der Wirbelstromverluste des Jordan-Modells. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2). |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_indexp    | 2            | -       | g               | Induktionsexponent des Jordan-Modells. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).                       |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+
| iron_loss_fieldfact | 2            | -       | g               | Feldfaktor (rotierend oder pulsierend) des Jordan-Modells. Erster Wert für den äußeren und zweiter Wert für den inneren Maschinenteil (ab Rel. 8.2).   |
+---------------------+--------------+---------+-----------------+--------------------------------------------------------------------------------------------------------------------------------------------------------+

gu = globale Längeneinheit


:big:`Befehlsbeschreibung`

----------------------------------------------------------------------

.. admonition:: Function:   	*d1, d2, ...* 	  =   	get_mod_data 	( 	*"identifier"* 	 ) 
	
 Liest Attribute/Parameter des Modells und gibt diese zurück.

 **Parameter**
  [in] :red:`identifier` Art der auszulesenden Daten (siehe Tabelle)

 **Rückgabewerte**
  | :red:`d1` Erster Rückgabewert
  | :red:`d2` Zweiter Rückgabewert

 Beispiel: Ermittlung des Strangstromes
 ::

  P = get_mod_data("num_poles")