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
id-893074