.. highlightlang:: us

.. index:: y^data-box-whisker

.. _data-box-whisker:

Daten=>Box-Whisker
------------------

Dieser Befehl erzeugt für einen 2D-Datensatz einen Box-Whisker-Plot. 

.. image:: S:/uniplot-obj/images/DataBoxWhisker-de.*

.. us.dialog

.. us.dlgitem

**Box-Whisker-Plot anzeigen**

.. us.dlgitem

**X-Position**

   Legt die horizontale Position der Box im Diagramm fest. Der Wert wird in den
   Koordinaten der x-Achse fest.

.. us.dlgitem

**Breite**

   Legt die Breite der Box in cm fest.

.. us.dlgitem

**Füllfarbe**

   Legt die Füllfarbe fest. Beim Wert ``auto`` wird die Farbe von der Linienfarbe
   der Kurve übernommen.

.. us.dlgitem

**Linienfarbe**

   Legt die Randfarbe fest. Beim Wert ``auto`` wird die Füllfarbe abgedunkelt oder
   aufgehellt.

.. us.dlgitem

**Linienbreite**

   Legt die Breite der Randlinie in 0.1 mm Schritten fest.

.. us.dlgitem

**Extremwerte anzeigen**

   Wenn die Option ausgewählt ist, werden die Punkte, die ausserhalb des 
   1,5-Fachen des Interquartilsabstands (1,5×IQR) überschreiten bzw. 
   unterschreiten als Ausreißer markiert.

   Die maximale Länge der Whisker ist auf das 1,5-Fache des IQR beschränkt.

.. us.dlgitem

**Max. Anzahl an Ausreißern**

   Wenn die Anzahl der Ausreißer den Maximalwert überschreitet, werden die 
   Ausreißer aufsteigend sortiert und die maximale Anzahl gleichmäßig verteilt
   ausgewählt. 

.. us.dlgitem

**Marker-Typ**

   Hier kann der Marker für die Ausreißer ausgewählt werden.

.. us.dlgitem 

**Zeige Kerben (Notch) (95% Konfidenzintervall des Median)**

  Die Höhe der Kerbe (Notch) wird aus dem IQR berechnet:
  Kerbhöhe: median +/- 1,57 x IQR/sqrt(n), wobei n die Anzahl der Datenpunkte ist.
  Die Tiefe wurde willkürlich mit 20% der Boxbreite festgelegt.

.. us.dlgitem

**Text mit Median- und IQR-Wert anzeigen**

   Erzeugt ein Textobjekt mit dem Medianwert und dem IQR (Interquartilsabstand
   (englisch interquartile range).

.. us.example

**Beispiel**

.. image:: S:/uniplot-obj/images/DataMoreDataFunctionBoxWhiskerPlot.*

UniScript-Beispiel::

   a = [25, 28, 29, 29, 30, 34, 35, 35, 37, 38];
   hv = plot(1:len(a),a);
   rvFillColor = [135, 206, 235];
   obj = [. "BoxPlot-Show-Notched" = 1, 
      "BoxPlot-Show-Info-Text" = 1, 
      "BoxPlot-FillColor-Auto" = 0, 
      "BoxPlot-FillColor" = rvFillColor,
      "BoxPlot-Width" = 1.0, //cm;
      "BoxPlot-XPos" = 2.5,
      "BoxPlot-LineColor-Auto" = 1,
      "BoxPlot-LineColor" = color_get_contrast_color(rvFillColor, 100),
      "BoxPlot-LineWidht" = 8,
      "BoxPlot-bShowExtreme" = TRUE,
      "BoxPlot-bShowExtreme-count" = 10,
      "BoxPlot-Marker-Style" = 5,
      "BoxPlot-Show-Notched" = FALSE,
      "BoxPlot-Show-Info-Text" = TRUE];
   auto_xy_BoxPlot(hv[3], obj);

.. us.comment

**Kommentar**

Die Box zeigt die Quantilwerte 25% unten, der Strich in der Box ist der Mediant
Wert und der Quantilwert 75% legt die obere Grenze der Box fest. 
Der Whisker unterhalb der Box zeigt das Minimum des Datensatzes und der 
obere Whisker das Maximum des Datensatzes. Die maximale Länge der Whisker ist auf 
das 1,5-Fache des IQR beschrängt. Der IQR (Höhe des Box) zeigt den Bereich, in 
dem sich 50% der Daten befinden. Interquartilsabstand 
(englisch interquartile range)::

   IQR = q0.75 - q0.25 

Mehr zum Box-Whisker-Plot finden Sie im Wikipedia Artikel
`Box-Plot <https://de.wikipedia.org/wiki/Box-Plot>`_.

.. seealso::
   :ref:`daten`,
   :ref:`detect_peaks`

:sub:`id-1272203`