======================
**Winding definition**
======================

.. role:: red
	  
Zusätzlich zu den bereits bekannten Wicklungstypen (wire&current, bar&voltage) gibt es bei FEMAG-TS noch die Typen wire&voltage, wire extern, bar&current und bar extern. Da auch bei den bestehenden Wicklungstypen zusätzliche Angaben nötig sind (Leitfähigkeit, Permeabilität , Länge und Füllfaktor), gibt es eine allgemeinere Funktion zur Wicklungsdefinition.

**Definiert den ersten Zweig einer Wicklung**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Funktion: *wkey* = def_branch_of_new_wdg (*x, y, col, label, cond, source, dir, turns*)
	
 Definition des ersten Zweigs einer neuen Wicklung

 **Parameter**
  | :red:`x,y`	Koordinate der Wicklung
  | :red:`col`	Farbe
  | :red:`label` Bezeichnung
  | :red:`cond` Leitertyp («wire», «bar»)
  | :red:`source` Quelletyp («current», «voltage», «extern»)
  | :red:`dir`	Stromrichtung bzw. Wickelsinn: In die Ebene wi, aus der Ebene wo
  | :red:`turns` Effektive Leiterzahl der Spulenseite (bei «bar»=1 oder optional). Wenn «turns» nicht angegeben wird, wird die Windungszahl «turns=1» gesetzt.

 Return value
  :red:`wkey` Wicklungskey oder 0 bei einem Fehler

**Hinzufügen eines Zweigs zu Spule**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: add_branch_to_wdg (*x, y, wkey, dir, connect, turns*)

 Hinzufügen einer Spulenseite zu einer bestehenden Wicklung mit individueller Windungszahl
         
 **Parameter**
  | :red:`x,y`	Koordinate der Wicklung
  | :red:`wkey`	Wicklungskey zu der die Spulenseite hinzugefügt werden soll oder wsamekey für letzte Wicklung
  | :red:`dir`	Stromrichtung bzw. Wickelsinn: In die Ebene wi, aus der Ebene wo
  | :red:`connect`	Schaltungsart: Seriell = wser, parallel = wpar
  | :red:`turns`	Effektive Leiterzahl der Spulenseite (bei «bar» = 1 oder optional). Wenn «turns» nicht angegeben wird, wird die Windungszahl des letzten definierten Zweiges verwendet.

**Ändern des Spulentyps**
^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: change_wdg_type (*wkey, cond, source*) 

 Ändert den Leitertyp und den Quellentyp einer Wicklung

 **Parameter**
  | :red:`wkey`	Wicklungskey
  | :red:`cond`	Leitertyp («wire», «bar»)
  | :red:`source`	Quelletyp («current», «voltage»)

**Materialdaten der Wicklung**
------------------------------

**Lineare Materialdaten der Wicklung**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: def_wdg_material (*wkey, conduc, muer, fillfac, length*)

 Setzt die Parameter für die Ermittlung der Stromverdrängung und des internen Widerstands. Dabei wird für alle Nuten derselbe Füllfaktor gesetzt. D.h. bei Wicklungen wird angenommen, dass für jeden Wickelstrang dieselbe Fläche definiert wurde.

 **Parameter**
  | :red:`wkey`	Wicklungskey
  | :red:`conduc`	Spezifische Leitfähigkeit des Leitermaterials [S/m]
  | :red:`muer`	Relative Permeabilität [1]
  | :red:`fillfac`	Füllfaktor [%]
  | :red:`lenght`	Relative Länge der Wicklung bezogen auf die Maschinenlänge [%]

 Beim ohmschen Widerstand und damit beim ohmschen Spannungsabfall wird die relative Länge berücksichtigt. Nicht jedoch bei der induzierten Spannung.

**Nichtlineare Materialdaten der Wicklung**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: def_wdg_material_nl (*wkey, conduc, "mc-file", fillfac, length*)
	
 Setzt die Parameter für die Ermittlung der Stromverdrängung und des internen Widerstands. Dabei wird für alle Nuten derselbe Füllfaktor gesetzt. D.h. bei Wicklungen wird angenommen, dass für jeden Wickelstrang dieselbe Fläche definiert wurde.

 **Parameter**
  | :red:`wkey`	Wicklungskey
  | :red:`conduc`	Spezifische Leitfähigkeit des Leitermaterials [S/m]
  | :red:`"mc-file"`	Name der Magnetisierungskennlinie
  | :red:`fillfac`	Füllfaktor [%]
  | :red:`lenght`	Relative Länge der Wicklung bezogen auf die Maschinenlänge [%]

 Beim ohmschen Widerstand und damit beim ohmschen Spannungsabfall wird die relative Länge berücksichtigt. Nicht jedoch bei der induzierten Spannung.

**Externe Widerstände**
-----------------------

.. admonition:: Command: def_ext_resist (*wkey, Rs, Ls*)
	
 Setzt die zusätzliche seriellen Ersatzelemente

 **Parameter**
  | :red:`wkey`	Wicklungskey
  | :red:`Rs`	Zusätzlicher Seriewiderstand [Ohm]
  | :red:`Ls`	Zusätzliche Streuinduktivität [H]

**Gruppieren der Wicklungen**
-----------------------------

Die einzelnen Wicklungen können zu Gruppen zusammen gefasst werden. Jede Gruppe erhält bei der Berechnung ein eigenes Graphik-Fenster. In den Ausgabe-Files werden die Wicklungen der einzelnen Gruppen ebenfalls zusammen gefasst. Auf die Berechnung hat die Gruppierung keinen Einfluss. Sie dient lediglich zur übersichtlichen Strukturierung der Ausgabedaten.

**Definition einer neuen Gruppe**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Funktion: *grpkey* = def_new_grp (*label, type, col*)

 Die Funktion erzeugt eine Wicklungsgruppe mit dem nächsten freien grpkey.

 **Parameter**
  | :red:`label`	Name der Wicklungsgruppe
  | :red:`type 0`: Die Gruppe wird im Graphik-Window dargestellt,
  | :red:`type 1`: Die Gruppe wird im Graphik-Window nicht dargestellt
  | :red:`col`	Farbe der Gruppe

 Return value
  | :red:`grpkey`	Gruppennummer oder 0 bei einem Fehler

**Wicklung zur Gruppe hinzufügen**
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: add_wdg_to_grp (*grpke, wkey*) 

 Fügt existierende Wicklung zu einer bereits definierten Gruppe hinzu.

 **Parameter**
  | :red:`grpkey`	Key der Wicklungsgruppe
  | :red:`wkey`	Key der Wicklung, die Wicklung wird an die bestehende Gruppe angehängt.

**Löschen einer Gruppe**
^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: del_grp (*grpkey*) 
	
 Löscht eine definierte Gruppe und alle ihre Relationen.

 **Parameter**
  | :red:`grpkey`	Nummer der zu löschenden Gruppe

**Löschen aller Gruppe**
^^^^^^^^^^^^^^^^^^^^^^^^

.. admonition:: Command: del_all_grp ( )
	
 Löscht alle definierten Gruppen und alle ihre Relationen.