============================================
**Solid conductors (eddy-current-carrying)**
============================================

.. role:: red
	  
.. admonition:: Function: wkey = def_new_bar(*x, y, col, label, c_re, c_im, con, cond, muer, len, vsys, vel1, vel2*)

 Definition of a solid conductor. The parameters after *cond* are optional. If values are not specified (or are negative) for *cond*, *perm* or *len*, then already-defined material properties are retained. If the parameters *vsys*, *vel1* and *vel2* are missing, the conductor has no velocity.

 **Parameter**
  | :red:`x,y` Coordinates of 'seed' point in a superelement
  | :red:`col` Colour of the conductor strands (*red*, *blue*, *green*, ...) 
  | :red:`label` Name of the strand (limited to 16 characters), in quotation marks, e.g. *"Strang 1"*
  | :red:`c_re` Peak value of the real component of conductor current [A]
  | :red:`c_im` Peak value of the imaginary component of current [A] (optional)
  | :red:`con` Current direction: *"wi"* = into the plane, *"wo"* = out of the plane
  | :red:`cond` Conductivity [S/m]
  | :red:`muer` Relative permeability
  | :red:`len` Relative axial length, %
  | :red:`vsys` Reference system of movement (*"cartes"*, *"polar"*, *"cylind"*) (optional)
  | :red:`vel1` Velocity in the first (*x* or *r*) coordinate [m/s]
  | :red:`vel2` Velocity in the second (*y* or *φ*) coordinate [m/s]

 ..
  remove space

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

 **Example**::
   
  wdgkey = def_new_bar(0,5.5,"yellow","Rotor",1.1,2.3,"wi",1.4E6,500,100,"cartes",10,20)
  wdgkey = def_new_bar(0,5.5,yellow,"Rotor",1.1,2.3,wi,1.4E6,500,100,cartes,10,20)       -- deprecated version


 **Example with incomplete parameters:** 

 The currently reference system is used for the speed specification::
   
  def_new_bar(x,y,col,label,c_re,c_im,con,cond,muer,len,vel1,vel2)


 A polar reference system is assumed for the speed specification (rotation)::
   
  def_new_bar(x,y,col,label,c_re,c_im,con,cond,muer,len,vel2)


 Definition of a conductor with no speed::
   
  def_new_bar(x,y,col,label,c_re,c_im,con,cond,muer,len)


 Examples with only partially specified material properties::
   
  def_new_bar(x,y,col,label,c_re,c_im,con,cond,muer)    -- len is unchanged
  def_new_bar(x,y,col,label,c_re,c_im,con,cond)         -- muer is unchanged


.. admonition:: Command: add_to_bar(*x, y, wkey, con1, con2, cond, muer, len*)

 Add a strand to a solid conductor. The parameters *cond*, *muer* and *len* are optional; if these are missing, the material properties of the conductor are applied to the added strand. Negative values retain already-defined material properties.

 **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 strand.
  | :red:`con1` Current direction: *"wi"* = into the plane, *"wo"* = out of the plane
  | :red:`con2` Circuit connection: *"wser"* = series, *"wpar"* = parallel
  | :red:`cond` Conductivity [S/m]
  | :red:`muer` Relative permeability
  | :red:`len` Relative axial length, %

 **Example**::
   
  add_to_bar(0,5.5,"wsamekey","wi","wpar")
  add_to_bar(0,5.5,wsamekey,wi,wpar)       -- deprecated version


 **Examples** with individual material properties for the subconductors::
   
  add_to_bar(0,5.5,"wsamekey","wi","wpar",1.4E6,500,110)
  add_to_bar(0,5.5,"wsamekey","wi","wpar",1.4E6,500)
  add_to_bar(0,5.5,"wsamekey","wi","wpar",1.4E6)
 
.. admonition:: Command: def_curr_wb(*wkey, curr_re, curr_im*)   

 Definition of conductor current (eddy-current-free or solid conductor). 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)