======================================
**Windings (free from eddy-currents)**
======================================

.. role:: red
	  
.. admonition:: Function: *wkey* = def_new_wdg(*x, y, col, label, turns, curr_re, curr_im, con*)

 Definition of a winding conductor (strand).  The imaginary part of the current is meaningful only with FEMAG-AC, and it can be omitted in FEMAG-DC. 

 **Parameter**
  | :red:`x/y` Coordinates of 'seed' point in a superelement
  | :red:`col` Colour ("blue", "green", . . .)
  | :red:`label` Name of the strand (limited to 16 characters), in quotation marks, e.g. "Strang 1
  | :red:`turns` Effective No. of conductors in a coil-side
  | :red:`curr_re` Peak value (Spitzenwert) of the real component of conductor current
  | :red:`curr_im` Peak value of the imaginary component of conductor current
  | :red:`con` Current direction: wi = into the plane, wo = out of the plane



 **Return value**
  :red:`wkey` Winding number, or 0 in case of an error.

 **Example**
 ::
    
  wkey = def_new_wdg(0,5.5,"cyan","Phase U",100,0.0,"wo")   -- define a new winding phase 
  wkey = def_new_wdg(0,5,5,cyan,"Phase U",100,0.0,wo)       -- deprecated version 
 

.. admonition:: Command: add_to_wdg  (*x, y, wky, con1, con2*)
		
 Add a coil side to the winding strand.

 **Parameter**
  | :red:`x/y` Coordinates of 'seed' point in a superelement
  | :red:`wkey` Winding number of the strand to which to add, or "wsamekey" for last defined strand.
  | :red:`con1` Current direction: wi = into the plane, wo = out of the plane
  | :red:`con2` Circuit connection: wser = series, wpar = parallel


.. admonition:: Command: add_to_wdg_nt(*x, y, wkey, con1, con2, turns*)
		
 Hinzufügen einer Spulenseite zum Wicklungsstrang mit individueller Windungszahl
 
 **Parameter**
  | :red:`x/y` Punkt innerhalb eines Superelementes 
  | :red:`wkey` Winding number of the strand to which to add, or "wsamekey" for last defined strand.
  | :red:`con1` Current direction: wi = into the plane, wo = out of the plane
  | :red:`con2` Circuit connection: wser = series, wpar = parallel
  | :red:`turns` Effective No. of conductors in a coil-side


 **Example**
 ::
    
  add_to_wdg_nt(x,y,"wsamekey","wo","wser",101)   -- add a coil side with an individual number of turns
  add_to_wdg_nt(x,y,wsamekey,wo,wser,101)         -- deprecated version 


.. admonition:: Command: del_all_coils()
		
 Delete the entire winding from the current model.

.. admonition:: Command: del_curr_wdg(*wky, curr_re, curr_im*)
		
 Definition of the conductor current in a winding strand. The imaginary part of the current is meaningful only with FEMAG-AC, and it can be omitted in FEMAG-DC.
 
 **Parameter**
  | :red:`wkey` Winding number of the strand to which to add, or wsamekey for last strand.
  | :red:`curr_re` Peak value of the real component of conductor current [A]
  | :red:`curr_im` Peak value of the imaginary component of current [A] (optional)


.. admonition:: Command: def_currdens_se(*x, y, cdens*)
		
 Definition of the current-density in a superelement.
 
 **Parameter**
  | :red:`x,y` Coordinates of 'seed' point in a superelement
  | :red:`cdens` Current-density [A/mm²]


.. admonition:: Command: def_currdens_sr(*x, y, cdens*)
		
 Definition of the current-density in a subregion.
 
 **Parameter**
  | :red:`x,y` Coordinates of 'seed' point in a superelement
  | :red:`cdens` Current-density [A/mm²]


.. admonition:: Command: def_currdens(*x, y, cdens, type*)

 Definition of the current-density in a subregion or a superelement.
 
 **Parameter**
  | :red:`x,y` Coordinates of 'seed' point in a superelement or a subregion
  | :red:`cdens` Current-density [A/mm²]
  | :red:`type` Subregion = 0, Superelement <> 0, 


.. admonition:: Command: shift_windings(*radius*)

 Shifts one or all of the windings of the machine through one slot-pitch clock-wise.
 
 The argument *radius* is optional. If not specified, the air-gap radius, if known in the model, is used, i.e. the winding outside the air-gap is selected and moved. Positive values of *radius* move the winding outside the circle defined by *radius*; negative values move the winding within the circle specified by the value of *radius*. The value zero for *radius* moves all winding systems of the machine.

 **Parameter**
  :red:`radius` Radius to select the winding to be shifted, in global length units.

 **Return value**
  Execution status (0 = error, 1 = no error)