.. highlightlang:: us

.. index:: 3D-Klassierung eines XYZ-Datensatzes
.. index:: Klassierung

.. _3d-klassierung-eines-xyz-datensatzes:
.. _3d-classification-of-a-xyz-dataset:

3D-Klassierung eines XYZ-Datensatzes
====================================

Einleitung
----------

Mit Hilfe des UniPlot Add-Ins "3D-Klassierung eines XYZ-Datensatzes" können die
Daten eines Kennfelds klassiert werden. Dazu werden die Daten in x- und
y-Richtung in Klassen eingeteilt. Für jede Klasse kann dann ein Kenngröße
bestimmt werden. Das Ergebnis kann grafisch oder als Tabelle dargestellt werden.

Installation
------------

* Wählen Sie :ref:`tools-add-in-manager`.

* Markieren Sie das Add-In "3D-Klassierung eines XYZ-Datensatzes".

* Wählen Sie OK. Beenden Sie UniPlot und starten Sie UniPlot neu.

   .. list-table::
      :header-rows: 0

      * - rs_3dcls.ic
        - UniScript-Datei
      * - rs_3dcls.icl
        - rs_3dcls.ic in übersetzter Form

.. _benutzung-3d-class:

Benutzung
---------

* Wählen Sie :ref:`dateiweitere-datei-funktionen`. Aus der folgenden Liste wählen
  Sie "3D-Klassierung eines XYZ-Datensatzes".

* Im folgenden Dialogfeld wählen Sie eine Datendatei aus.

* Wählen Sie OK.

* Die Datei wird, falls nicht bereits eine NC-Datei ausgewählt wurde, in das
  NC-Format konvertiert. Wenn die Datei erfolgreich konvertiert werden konnte,
  wird das folgende Dialogfeld angezeigt:

  .. image:: S:/uniplot-obj/images/3d-Class-ChannelSelect-de.*

  Wählen Sie den x-Kanal, y-Kanal und einen z-Kanal aus. Im unteren Teil des 
  Dialogfeldes können Sie zwischen einer äquidistanten oder nicht äquidistanten
  Klasseneinteilung wählen. Drücken Sie OK um das Dialogfeld für die Definition
  der Klasseneinteilung zu öffnen.

  Bei der äquidistanten Klasseneinteilung können Sie den Bereich und die Anzahl
  der Klassen festlegen:

  .. image:: S:/uniplot-obj/images/3d-Class-BinDefinition_fix-de.*

  Bei der nicht äquidistanten Klasseneinteilung können Sie eine Liste mit den
  Klassengrenzen festlegen:

  .. image:: S:/uniplot-obj/images/3d-Class-BinDefinition_variable-de.*

* Im Feld "Ausgabe" legen Sie fest, wie die Ergebnisdaten dargestellt werden
  sollen.

Verfahren
---------

Die Daten werden in x- und y-Richtung in Klassen eingeteilt.

Falls als Ausgabe ``Tabelle erzeugen`` gewählt wird, berechnet die Funktion die 
folgenden Matrizen: Minimum, Maximum, Mittelwert, Median, Standardabweichung, 
Summe, Punkte in Klasse (Absolute Häufigkeit), Prozent von Summe(z), Punkte in
Klasse in % (Relative Häufigkeit). 

Die Daten werden in einen Editor kopiert.

Die folgenden Grafiken können erzeugt werden:

.. list-table::
   :header-rows: 0

   * - "Grafik: Minimum"
     - Stellt den kleinsten z-Wert für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Maximum"
     - Stellt den gößten z-Wert für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Mittelwert"
     - Stellt den Mittelwert der z-Werte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Median"
     - Stellt den Median der z-Werte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Standardabweichung"
     - Stellt die Standardabweichung der z-Werte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Summe"
     - Stellt die Summe aller z-Werte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Punkte in Klasse"
     - Stellt die Anzahl der Punkte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Punkte in Klasse"
     - Stellt die Anzahl der Punkte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Punkte in Klasse"
     - Stellt die Anzahl der Punkte für jede Klasse als 3D-Balkendiagramm dar.
   * - "Grafik: Prozent von Summe(z)"
     - Summe aller z-Werte einer Klasse im Verhältnis Gesamtsumme von z.
   * - "Grafik: Punkte in Klasse in % (Relative Häufigkeit)"
     - Anzahl der Punkte für jede Klasse im Verhältnis zur Gesamtpunktanzahl.

.. _history-3d-class:

History
-------

* 19.01.2010: Nicht äquidistante Klasseneinteilung: Verwendet nun die 
  Klassengrenzen anstatt die Klassenmittelpunkte.

* 28.04.2009: Daten werden zusätzlich in die Zwischenablage geschrieben.

* 26.11.2008: Dialog geändert.

* 10.07.2006: Dokumentation zugefügt.

:sub:`id-993880`