3. Überblick XYZ-Datensätze

Am einfachsten können die Eigenschaften eines Datensatzes mit der Funktion XYZSetProps gesetzt werden (ab UniPlot 4.0.3).

	Erzeugen und Zerstören
XYZCreate	XYZCreate erzeugt einen 3D-Datensatz. Die Daten können entweder als XYZ-Tripel oder als Matrix vorliegen.Die XYZ-Tripel können beliebig in der XY-Ebene verteilt sein. Es sind mindestens 3 Koordinaten-Tripel erforderlich, um einen 3D-Datensatz erzeugen zu können. Aus den XYZ-Tripeln wird durch Interpolation eine Z-Matrix berechnet.
XYZDestroy	XYZDestroy zerstört einen mit XYZCreate oder XYZCreateFromMatrix erzeugten Datensatz.
XYZCreateFromMatrix	XYZCreateFromMatrix erzeugt einen 3D-Datensatz.

	Daten und Interpolation (Setzen)
XYZSetData	XYZSetData setzt die x/y/z-Koordinaten eines Datensatzes.
XYZSetDataSource	Siehe XYSetDataSource
XYZSetInterDensity	XYZSetInterDensity legt die Anzahl der Zeilen und Spalten der Interpolations-Matrix fest.
XYZSetInterOnGrid	XYZSetInterOnGrid legt fest, ob das Gebiet und die Zeilen- und Spaltenanzahl der Interpolationsmatrix von der Skalierung der x- und der y-Achse übernommen werden soll.
XYZSetInterRange	XYZSetInterRange legt den Koordinatenbereich der Interpolations-Matrix in der x,y-Ebene fest.
XYZSetInterSmooth	XYZSetInterSmooth legt den Glättungsfaktor für die Interpolation der Matrix fest.
XYZSetInterpolationType	XYZSetInterpolationType setzt den Interpolationstyp, der für die Interpolation der beliebig verteilten Daten verwendet wird.
XYZSetMatrixRange	XYZSetMatrixRange legt die x,y-Koordinaten der Matrix-Eckpunkte fest.

	Daten und Interpolation (Erfragen)
XYZGetData	XYZGetData gibt die Originaldatenpukte zurück.
XYZGetDataSource	Siehe XYGetDataSource
XYZGetInsideMatrix	XYZGetInsideMatrix gibt eine Matrix mit 1/0-Werten zurück, die angeben ob die Werte die die Funktion XYZGetMatrix liefert, innerhalb oder außerhalb der Datenhülle liegen.
XYZGetInterDensity	XYZGetInterDensity liefert die Anzahl der Zeilen und Spalten der Interpolations-Matrix.
XYZGetInterSmoothFactor	XYZGetInterSmoothFactor liefert den Glättungsfaktor.
XYZGetInterpolZValues	XYZGetInterpolZValues liefert einen Vektor mit interpolierten Z-Koordinaten.
XYZGetInterpolationType	XYZGetInterpolationType liefert den Interpolationstyp, der für die Interpolation der beliebig verteilten x/y/z-Daten verwendet wird.
XYZGetMatrix	XYZGetMatrix gibt die interpolierte Matrix zurück.
XYZGetMatrixColData	XYZGetMatrixColData liefert die x-Koordinaten.
XYZGetMatrixRange	XYZGetMatrixRange liefert den Wertebereich der Matrix in x- und y-Richtung.
XYZGetMatrixRowData	XYZGetMatrixRowData liefert die y-Koordinaten.
XYZGetMatrixSize	XYZGetMatrixSize liefert die Anzahl an Zeilen und Spalten der Interpolations-Matrix.
XYZGetNumberOfPoints	XYZGetNumberOfPoints liefert die Anzahl der Datenpunkte in einem 3D Datensatz (x/y/z-Triple).
XYZIsInterOnGrid	XYZIsInterOnGrid
XYZIsMatrixOnly	XYZIsMatrixOnly prüft ob der Datensatz von einer Matrix oder beliebig verteilten x/y/z-Tripeln erzeugt worden ist.

Isolinien

Für die Isolinien verwendet UniPlot intern eine Tabelle mit 100 Plätzen. Die Tabelle legt die Werte der Isolinien, die Farbfüllung zwischen 2 Isolinienwerten sowie die Zeichenstifte für die Isolinien fest.

Index	Iso-Wert	Iso-Color	Iso-Pen
0	-	red	-
1	100	green	solid-1-black
2	200	blue	solid-1-black
3
…
99

Der Tabelleneintrag mit dem Index 0 legt die Farbe für die Fläche die kleiner als der Isolinienwert mit dem Index 1 ist fest (XYZSetFillMinColor).

Die Spalte Iso-Wert kann mit den Funktionen XYZAddIsoValues, XYZSetIsoValues und XYZDeleteIsoValues geändert werden. Über die Funktion XYZGetNumberOfIsoValues kann erfragt werden, wieviele der 99 Plätze verwendet werden.

Die Spalte Iso-Color wird mit der Funktion XYZSetFillColors geändert und die Spalte Iso-Pen mit der Funktion XYZSetPens.

Beispiele (der Pfeil in der ersten Spalte zeigt die Zahl, die die Funktion XYZGetNumberOfIsoValues zurück geben würde an):

Index	Iso-Wert	Iso-Color	Iso-Pen
0	-	red	-
1	100	green	solid-1-black
2	200	blue	solid-2-black
3	300	white	solid-3-black
->4	400	black	solid-4-black

XYZSetIsoValues(hData, [200,300])

ändert die Tabelle in

Index	Iso-Wert	Iso-Color	Iso-Pen
0	-	red	-
1	200	blue	solid-2-black
->2	300	white	solid-3-black

XYZAddIsoValues(hData, [250,350])

ändert die Tabelle in

Index	Iso-Wert	Iso-Color	Iso-Pen
0	-	red	-
1	200	blue	solid-1-black
2	250	blue	solid-1-black
3	300	white	solid-3-black
->4	350	white	solid-3-black

	Isolinien (Setzen)
XYZAddIsoValues	XYZAddIsoValues fügt einem 3D-Datensatz Isolinen zu.
XYZDeleteIsoValues	XYZDeleteIsoValues löscht Isolinienwerte.
XYZDeleteLinesInRect	XYZDeleteLinesInRect löscht alle Isolinien, die ein Rechteck schneiden.
XYZEnableColorMap	XYZEnableColorMap schaltet die Verwendung der definierten Farbliste ein oder aus.
XYZIsIsolinesVisible	XYZIsIsolinesVisible prüft, ob die Isolinien-Anzeige eingeschaltet ist.
XYZSetColorMap	XYZSetColorMap setzt den Namen einer Farbliste für das Füllen der Flächen eines Kontourdiagramms.
XYZSetFill	XYZSetFill schaltet den Farbverlauf für das Isolinien-Diagramm ein oder aus.
XYZSetFillColors	XYZSetFillColors setzt die Farben für das Füllen der Flächen zwischen den Isolinien bzw. für den Farbverlauf der 3D-Oberfläche.
XYZSetFillMinColor	XYZSetFillMinColor setzt die Farbe für das Füllen der Flächen, deren Z-Wert kleiner als der kleinste Isolinienwert ist.
XYZSetIsoValues	XYZSetIsoValues legt die Werte der Isolinien fest.
XYZSetIsoValuesScaleType	XYZSetIsoValuesScaleType legt fest, wie die Isolinienwerte bestimmt werden.
XYZSetPens	XYZSetPens setzt die Zeichenstifte für die Ausgabe der Isolinien.
XYZSetSpline	XYZSetSpline legt fest, ob die Isolinien als Spline oder Polygon ausgegeben werden.
XYZShowIsolines	XYZShowIsolines schaltet die Isolinien-Anzeige für das Isolinien-Diagramm ein oder aus.

	Isolinien (Erfragen)
XYZGetAutoScaleValues	XYZGetAutoScaleValues liefert einen Vektor mit Isolinienwerten.
XYZGetColorMap	XYZGetColorMap liefert den Namen der gesetzten Farbliste.
XYZGetFillColors	XYZGetFillColors erfragt die Füllfarben eines 3D-Datensatzes.
XYZGetFillMinColor	XYZGetFillMinColor liefert die Farbe für das Füllen der Flächen, deren Z-Wert kleiner als der kleinste Isolinienwert ist.
XYZGetIsoAreas	XYZGetIsoAreas gibt die Flächen der Isolinien zurück (als Anteil in Prozent zur Gesamtfäche des Kennfeldes).
XYZGetIsoValues	XYZGetIsoValues gibt die Isolinienwerte zurück.
XYZGetIsoValuesScaleType	XYZGetIsoValuesScaleType liefert Informationen über die Ermittlung der Isolinienwerte (Autoskalierung, Typ, Anzahl der Autowerte).
XYZGetIsoline	XYZGetIsoline liefert die x/y-Koordinaten der Isolinie eines XYZ-Datensatzes.
XYZGetNumberOfIsoValues	XYZGetNumberOfIsoValues liefert die Anzahl an Isolinienwerten des Datensatzes.
XYZGetPens	XYZGetPens gibt einen Vektor mit den Zugriffsnummern der Zeichenstifte der Isolinien zurück.
XYZIsColorMapEnabled	XYZIsColorMapEnabled liefert TRUE (1), wenn die Farbliste verwendet wird.
XYZIsFilled	XYZIsFilled liefert einen Wert, der anzeigt, ob die Flächen zwischen den Isolinien farblich ausgefüllt werden.
XYZIsSpline	XYZIsSpline erfragt, ob die Punkte der Isolinien durch einen Spline verbunden sind.

	Isolinien-Beschriftungen (Setzen)
XYZDeleteLabel	XYZDeleteLabel löscht die Beschriftungen der Isolinien innerhalb eines Rechtecks.
XYZInsertLabel	XYZInsertLabel beschriftet die Isolinien mit ihrem z-Wert.
XYZSetIsoLabelFont	XYZSetIsoLabelFont setzt die Schriftart für die Ausgabe der Isolinien-Beschriftungen.
XYZSetLabelFormat	XYZSetLabelFormat legt das Ausgabeformat für die Beschriftung der Isolinien, der Volllastlinie und der Datenpunkte fest.
XYZSetLabelFormatType	XYZSetLabelFormatType legt fest, wie die Nachkommastellen für Isolinien-Label bestimmt werden (manuell oder automatisch).
XYZSetLabelOrientation	XYZSetLabelOrientation legt fest, ob die Beschriftung der Isolinien horizontal oder an die Steigung der Isolinien angepasst werden soll.
XYZSetLabelTypeIsolines	XYZSetLabelTypeIsolines legt fest, wie die Isolinien beschriftet werden.
XYZShowLabelInABox	XYZShowLabelInABox legt fest, ob die Isolinien-Beschriftung eingerahmt werden sollen.
XYZShowLabelInLineColor	XYZShowLabelInLineColor legt fest, ob die Beschriftung der Isolinien in der Farbe der Isolinien oder der gewählten Schriftfarbe erfolgen soll.
XYZShowLabelTransparent	XYZShowLabelTransparent legt fest, ob die Isolinien-Beschriftung transparent oder mit weißem Hintergrund ausgegeben werden sollen.

	Isolinien-Beschriftungen (Erfragen)
XYZGetIsoLabelFont	XYZGetIsoLabelFont gibt den Font für die Beschriftung der Isolinien zurück.
XYZGetLabelFormat	XYZGetLabelFormat liefert das Zahlenformat für die Isolinienschriftungen, die Beschriftungen der Volllastlinie und die Beschriftungen der Datenpunkte.
XYZGetLabelFormatType	XYZGetLabelFormatType erfragt, wie die Nachkommastellen für Isolinien-Label bestimmt werden (manuell oder automatisch).
XYZGetLabelOrientation	XYZGetLabelOrientation liefert die Orientierung der Isolinienbeschriftungen.
XYZGetLabelTypeIsolines	XYZGetLabelTypeIsolines erfragt wie die Isolinien beschriftet werden.
XYZIsLabelInABox	XYZIsLabelInABox erfragt, ob um die Isolinien-Label ein Rahmen gezeichnet wird.
XYZIsLabelInLineColor	XYZIsLabelInLineColor erfragt, ob die Isolinien-Label in der selben Farbe wie die Isolinien ausgegeben werden.
XYZIsLabelTransparent	XYZIsLabelTransparent erfragt, ob um die Isolinien-Label ein Rahmen gezeichnet wird.

	Hülle (Setzen)
XYZSetHullLabelDistance	XYZSetHullLabelDistance legt die Länge der Hilfslinie zwischen Hüllenpunkt und Beschriftung fest.
XYZSetHullNewData	XYZSetHullNewData erzeugt eine neue Datenhülle, die auch Inseln enthalten kann.
XYZSetHullPen	XYZSetHullPen setzt den Zeichenstift für die Hülle.
XYZSetHullSpline	XYZSetHullSpline legt fest, ob der nördlichste Teil der Hülle als Spline ausgegeben werden soll.
XYZSetHullType	XYZSetHullType legt fest, wie die Hülle des Isoliniendiagramms ausgegeben wird.
XYZShowHullLabel	XYZShowHullLabel legt fest, ob die Hülle beschriftet werden soll.
XYZShowHullLabelHorizontal	XYZShowHullLabelHorizontal legt fest, ob die Beschriftung der Hülle horizontal oder vertikal erfolgen soll.

	Hülle (Erfragen)
XYZGetHullData	XYZGetHullData liefert die Datenpunkte die das Kennfeld in der xy-Ebene begrenzen.
XYZGetHullLabelDistance	XYZGetHullLabelDistance
XYZGetHullPen	XYZGetHullPen erfragt den Zeichenstift der Hülle.
XYZGetHullType	XYZGetHullType erfragt, wie die Hülle der Isolinien ausgegeben wird.
XYZIsHullLabelHorizontal	XYZIsHullLabelHorizontal liefert einen Wert, der anzeigt ob die Hüllenbeschriftung horizontal oder vertikal erfolgt.
XYZIsHullLabelVisible	XYZIsHullLabelVisible erfragt, ob die Hülle (Volllastkurve) beschriftet ist.
XYZIsHullSpline	XYZIsHullSpline

	Streuplot (Setzen)
XYZSetMarker	XYZSetMarker setzt den Marker für die Ausgabe der Datenpunktmarkierung (Scatter-Plot).
XYZSetMarkerLabelFont	XYZSetMarkerLabelFont setzt die Schriftart für die Ausgabe der Datenpunktbeschriftung.
XYZSetMaxMarker	XYZSetMaxMarker setzt den Marker für die Markierung des Datenpunktes mit dem größten z-Wert.
XYZSetMinMarker	XYZSetMinMarker setzt den Marker für die Markierung des Datenpunktes mit dem kleinsten z-Wert.
XYZSetScatterLabelOffset	XYZSetScatterLabelOffset setzt den Offset der Z-Beschriftungen in Streudiagramm.
XYZShowMarker	XYZShowMarker schaltet die Darstellung der Datenpunktmarkierungen der Originaldaten ein oder aus.
XYZShowMarkerLabel	XYZShowMarkerLabel schaltet die Darstellung der Datenpunktbeschriftung der Originaldaten mit ihrem z-Wert ein oder aus. Das Zahlenformat wird von den Isolinienbeschriftungen übernommen.
XYZShowMarkerLineIndex	XYZShowMarkerLineIndex legt fest, ob die Datenpunkte mit der Zeilennummer der Datendatei markiert werden sollen.
XYZShowMaxMarker	XYZShowMaxMarker legt fest, ob der Datenpunkt mit dem größsten z-Wert durch ein Symbol mit Beschriftung markiert werden soll.
XYZShowMinMarker	XYZShowMinMarker legt fest, ob der Datenpunkt mit dem kleinsten z-Wert durch ein Symbol mit Beschriftung markiert werden soll.

	Streuplot (Erfragen)
XYZGetMarker	XYZGetMarker liefert eine Kopie des Marker-Handles, der für den Streuplot verwerdet wird.
XYZGetMarkerLabelFont	XYZGetMarkerLabelFont
XYZGetMaxMarker	XYZGetMaxMarker liefert eine Kopie des Marker-Handles, der für die Markierung des Maximums verwerdet wird.
XYZGetMinMarker	XYZGetMinMarker liefert eine Kopie des Marker-Handles, der für die Markierung des Minimums verwerdet wird.
XYZGetScatterLabelOffset	XYZGetScatterLabelOffset liefert den Offset der Z-Beschriftungen in einem Streu-Diagramm.
XYZIsMarkerLabelVisible	XYZIsMarkerLabelVisible
XYZIsMarkerLineIndexVisible	XYZIsMarkerLineIndexVisible prüft, ob die Zeilennummer der Originaldaten angezeigt werden.
XYZIsMarkerVisible	XYZIsMarkerVisible erfragt, ob der Datensatz als Streuplot angezeigt wird.
XYZIsMaxMarkerVisible	XYZIsMaxMarkerVisible prüft, ob die Maximum Wert markiert ist.
XYZIsMinMarkerVisible	XYZIsMinMarkerVisible prüft, ob der Marker für die Markierung des Datenpunktes mit dem kleinsten z-Wert angezeigt wird.

	Oberflächenplot (Setzen)
XYZSet3DBaseValue	XYZSet3DBaseValue legt den Wert fest, auf den die Oberfläche außerhalb der Datenhülle gesetzt werden soll.
XYZSet3DInsideColor	XYZSet3DInsideColor legt die Farbe der 3D-Oberfläche innerhalb der Datenhülle fest.
XYZSet3DInsidePen	XYZSet3DInsidePen legt die Linienart für das Netz der 3D-Oberfläche innerhalb der Datenhülle fest.
XYZSet3DOutsideColor	XYZSet3DOutsideColor legt die Farbe der 3D-Oberfläche außerhalb der Datenhülle fest.
XYZSet3DOutsideHull	XYZSet3DOutsideHull legt fest, wie die 3D-Oberfläche außerhalb der Datenhülle ausgegeben werden soll.
XYZSet3DOutsidePen	XYZSet3DOutsidePen legt die Linienart für das Netz der 3D-Oberfläche außerhalb der Datenhülle fest.
XYZSet3DScatterBarWidth	XYZSet3DScatterBarWidth setzt die Balkenbreite bei der 3D-Streu-Darstellung in Prozent der Diagrammgröße fest
XYZSet3DShowIsolines	XYZSet3DShowIsolines legt fest, ob die Isolinie auf die 3D-Oberfläche gezeichnet werden sollen.
XYZSet3DSurfaceAttrib	XYZSet3DSurfaceAttrib legt die Netz-Ausgabe der 3D-Oberfläche fest.
XYZSet3DSurfaceType	XYZSet3DSurfaceType legt die Darstellung der 3D-Oberfläche fest.

	Oberflächenplot (Erfragen)
XYZGet3DInsideColor	XYZGet3DInsideColor liefert die Füllfarbe für die 3D-Oberfläche bzw. für die 3D-Balken innerhalb der Datenhülle.
XYZGet3DInsidePen	XYZGet3DInsidePen liefert den Zeichenstift, der für die Netzlinien innerhalb der Datenhülle bei der 3D-Darstellung verwendet wird.
XYZGet3DOutsideColor	XYZGet3DOutsideColor liefert die Füllfarbe für die 3D-Oberfläche bzw. für die 3D-Balken außerhalb der Datenhülle.
XYZGet3DOutsideHull	XYZGet3DOutsideHull liefert die Einstellung für die 3D-Oberflächen-Darstellung außerhalb der Datenhülle.
XYZGet3DOutsidePen	XYZGet3DOutsidePen liefert den Zeichenstift, der für das Netz der 3D-Oberfläche außerhalb der Datenhülle verwendet wird.
XYZGet3DScatterBarWidth	XYZGet3DScatterBarWidth liefert die Balkenbreite bei der 3D-Streu-Darstellung in Prozent der Diagrammgröße fest.
XYZGet3DSurfaceAttrib	XYZGet3DSurfaceAttrib gibt zurück, wie das Netz der 3D-Oberfläche ausgegeben wird.
XYZGet3DSurfaceType	XYZGet3DSurfaceType liefert die Darstellungsart der 3D-Oberfläche.
XYZGet3DZBaseValue	XYZGet3DZBaseValue liefert den Wert fest, auf den die Oberfläche außerhalb der Datenhülle gesetzt wird.
XYZIs3DIsolinesVisible	XYZIs3DIsolinesVisible

	Sonstiges (Setzen)
XYZConfigDlg	XYZConfigDlg zeigt das Dialogfeld für den angegebenen 3D-Datensatz an.
XYZCopy	XYZCopy erzeugt die identische Kopie eines vorhandenen 3D Datensatzes.
XYZCopyConfig	XYZCopyConfig kopiert die Konfiguration eines 3D-Datensatzes in einen anderen 3D-Datensatz.
XYZSetBubbleAttribute	XYZSetBubbleAttribute setzt die Attribute für die Darstellung der Blasen.
XYZSetBubbleScaleValues	XYZSetBubbleScaleValues setzt die Skalierung für die Berechnung der Blasengröße.
XYZSetBubbleSize	XYZSetBubbleSize setzt die Blasengröße in Zentimeter.
XYZSetDefault	XYZSetDefault setzt die Eigenschaften eines Datensatzes auf Default-Werte.
XYZSetProps	XYZSetProps setzt Eigenschaften eines x/y/z-Datensatzes.
XYZSetSelect	XYZSetSelect selektiert den Datensatz. Im Diagramm wird der selektierte Datensatz durch 3 kleine Rechtecke an jeder Isolinie markiert.
XYZShow	XYZShow schaltet einen Datensatz ein oder aus.
XYZShowBubble	XYZShowBubble legt fest, ob der Datenpunkte als Bubble plot (Blasen mit unterschiedlicher Größe und Farbe) dargestellt werden sollen.
XYZShowTriangulation	XYZShowTriangulation legt fest, ob die Triangulation der beliebig verteilten Originaldatenpunkte ausgegeben werden soll.
XYZUpdate	XYZUpdate muss aufgerufen werden, wenn Attribute des 3D-Datensatzes geändert wurden.

	Sonstiges (Erfragen)
XYZGetBubbleAttribute	XYZGetBubbleAttribute liefert die Attribute für die Darstellung der Blasen.
XYZGetBubbleScaleValues	XYZGetBubbleScaleValues liefert die Skalierung für die Berechnung der Blasengröße.
XYZGetBubbleSize	XYZGetBubbleSize liefert die Blasengröße in Zentimeter.
XYZGetProps	XYZGetProps liefert die Eigenschaften eines x/y/z-Datensatzes.
XYZIsBubbleVisible	XYZIsBubbleVisible erfragt, ob der Datensatz als Bubbleplot angezeigt wird.
XYZIsSelected	XYZIsSelected erfragt, ob der Datensatz markiert ist.
XYZIsTriangulation	XYZIsTriangulation erfragt, ob die Triangulation der Datenpunkte ausgegeben wird.
XYZIsVisible	XYZIsVisible erfragt, ob der Datensatz anzeigt wird.

Siehe auch

UniScript-Funktionen-Überblick

_id-893074