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.

id-893074