.. _emagEvalGraph:

================================
**Graphical display of results**
================================

.. role:: red
	  
.. admonition:: Command: post_models(*"draw_f_lines", "b"*)
		
 Draws field lines
 
 .. warning::
    
  This command is deprecated and replaced by field_lines(). It wont be available in future FEMAG versions.

 **Parameter**
  *[out]* :red:`b` Freely choosable caller without impact for return values.

 **Example:**
 ::

  post_models("draw_f_lines","b")


.. admonition:: Command: field_lines(psfile, nines)
		
 Draws field lines

 **Parameter**
  | :red:`nlines` Amount of field lines 
  | :red:`psfile` Bezeichnung der auszugebenden Bildatei (eps oder svg) mit Erweiterung. Bei leerer Zeichenkette  wird keine Bilddatei erzeugt.

 ..
  translate below this
 
 **Examples:**
 ::

  field_lines('fieldlines.svg', 10)


.. admonition:: Command: color_gradation(x, y, range, quant, min, max, psfile)
		
 Farbliche Visulisierung der Verteilung einer Größe im ausgewählten Rechengebiet. Es werden jeweils die Ergebnisse der zuletzt durchgeführten Berechnung bzw. Auswertung dargestellt.

 **Parameter**
  | :red:`x/y` Punkt im Rechengebiet 
  | :red:`range` Rechengebiet: tot = alles, sr = Subregion, se = Superelement 
  | :red:`quant` Darzustellende Größe 
  | :red:`min` Kleinstwert der Darstellung 
  | :red:`max` Größtwert der Darstellung (automatische Skalierung wenn min und max gleich Null) 
  | :red:`psfile` Bezeichnung der auszugebenden Bildatei (eps oder svg) mit Erweiterung. Bei leerer Zeichenkette  wird keine Bilddatei erzeugt.

 Allgemein darstellbare Größen (quant)::

  Flussdichte:                Babs, Bx, By, Br, Bt
  Feldstärke:                 Habs, Hx, Hy, Hr, Ht 
  Relative Permeabilität:     (ur) relperm
  Remanenzflussdichte:        Rem 
  Magnetische Energie:        Wm
  Änderung der Flussdichte:   Bdev 
  Änderung der Feldstärke:    Mrdev 
  Vektorpotential:            Vpot

 Speziell darstellbare Größen (quant) in FEMAG-DC bzw. nach stateofproblem(magstatic)::

  Entmagnetisierung:          demag
  Verlustdichte (Eisen & PM): (feloss) pmfelosd


 Darstellbare Größen (quant) in FEMAG-AC bzw. nach stateofproblem(magdynamic)::
  Wirbelstromdichte:          (ecurr) ecurd
  Wirbelstromverlustdichte    (ecloss) eclosd 

 **Bemerkungen**
  Der Bezeichner der darzustellenden Größe (range und quant) sollte ab FEMAG Version 8.2 in Anführungszeichen gesetzt werden. Bei den Vorgängerversionen führen diese jedoch zu einem Abbruch der Skriptausführung. Die nicht in Klammer angegebenen Bezeichnungen sind zu bevorzugen und in zukünftigen FEMAG-Versionen ausschließlich vorhanden.

 **Beispiele:**

 Darstellung der **Induktionsverlteilung** im gesamten Rechengebiet
 ::
    
  color_gradation(0,0,"tot","Babs",0,0,"")
  
 Ausgabe in eine eps- oder svg-Datei definiert durch die Endung des Dateinamens
 ::
    
  color_gradation(0,0,"tot","Babs",0,0,"induction.eps")
  
 Explizit vorgegebene Grenzen der Darstellung, hier von 0.1 bis 1.8 T
 ::
    
  color_gradation(0,0,"tot","Babs",0.1,1.8,"induction.svg")

 Darstellung der **Verlustdichte** im Eisen und in den Permanentmagneten im gesamten Rechengebiet
 ::
    
  color_gradation(0,0,"tot","pmfelosd",0,0,"")
  
 Darstellung der Verlustdichte in einem Superelement ausgewählt durch die kartesischen Koordinaten x=42,2 und y=21.2
 ::
    
   color_gradation(42.2,21.2,"se","pmfelosd",0,0,"")

.. admonition:: Command: post_models("draw_c_grad","b")

 Datenausgabe für Colour Gradations,

 .. warning::
    
  Dieser Befehl ist veraltet, er wird durch colorgradation() ersetzt und steht in zukünftigen FEMAG-Versionen nicht mehr zur Verfügung.


 **Parameter**
  [out] :red:`b` Frei wählbare ohne Bedeutung.
  
 ::

  m.cgrad_mode  = 1  -- colorgradation mode:1 = set, 0 = default
  m.cgrad_qual  = 1  -- cgradation quantity:
                          1 = Absolute Induction B
                          2 = Demagnetization H
                          3 = Loss Distribution
                          4 = Rel. Permeability
                          5 = B Component 1(x,r)
                          6 = B Component 2(y,phi,z)
                          7 = Absolute Fieldstrength H
                          8 = H Component 1 (x,r)
                          9 = H Component 2 (y,phi,z)
                         10 = Error in Ht
                         11 = Error in Bt
                         12 = Energy Distribution
                         13 = B-Field Deviation
                         14 = Mr-Field Deviation
                         15 = Remanence
 
  post_models("draw_c_grad","b")  


 
 **Beispiele**
 
 
 **Absolute Induction B**

 .. image:: Colorgradition_1.png

 **Demagnetization H**

 .. image:: Colorgradition_2.png

 **Loss Distribution**

 .. image:: Colorgradition_3.png

 **Permeability**

 .. image:: Colorgradition_4.png

 **B Component 1(x,r)**

 .. image:: Colorgradition_5.png

 **Component 2(y,phi,z)**

 .. image:: Colorgradition_6.png

 **Absolute Fieldstrength H**

 .. image:: Colorgradition_7.png

 **H Component 1 (x,r)**

 .. image:: Colorgradition_8.png

 **H Component 2 (y,phi,z)**

 .. image:: Colorgradition_9.png

 **B-Field Deviation**

 .. image:: Colorgradition_13.png

 **Mr-Field Deviation**

 .. image:: Colorgradition_14.png

 **Remanence**

 .. image:: Colorgradition_15.png