XYSetErrorData

XYSetErrorData setzt die Fehlerwerte. Die Fehlerwerte werden für die Ausgabe der Fehlerbalken verwendet.

bool = XYSetErrorData(hData, ssXY, rvMinusError, rvPlusError)
bool = XYSetErrorData(hData, ssXY)

Returnwert

bool ist TRUE (1), wenn die Werte gesetzt werden konnten und sonst FALSE (0).

Parameter

hData

hData ist die Zugriffsnummer (Handle) des Datensatzes, der mit XYCreate erzeugt wurde.

ssXY

ssXY ist „X“ für die Fehler in x-Richtung und „Y“ für die Fehler in y-Richtung.

rvMinusError

Vektor mit den negativen Fehlerwerten. Die Fehlerwerte müssen größer als 0 sein. Negative Fehler bzw. ein Fehler mit dem Wert 0 werden nicht ausgegeben.

rvPlusError

Vektor mit den positiven Fehlerwerten. Die Anzahl der Datenpunkte muss gleich der Anzahl der Datenpunkte in rvMinusError und der Datenpunkte im Datensatz sein.

Kommentar

Die Fehlerwerte werden positiv eingegeben. Sie werden relativ zum Anzeigewert definiert. Positive Fehler werden zum Anzeigewerte addiert und negative Fehler subtrahiert. Fehler mit dem Wert 0 werden nicht ausgegeben. Die Anzahl der Datenpunkte ist auf 200.000 beschränkt. Die Anzahl der Fehlerwerte muss genau mit der Anzahl der Datenpunkte im Datensatz übereinstimmen. Ansonsten werden keine Fehlerbalken angezeigt.

Beim Aufruf mit zwei Parametern werden die Fehlerwerte gelöscht.

Beispiel

hDoc = DocCreate();
hPage = PageCreate();
hLayer = LayerCreate();
DocAddPage(hDoc, hPage);
PageAddLayer(hPage, hLayer);

rvX = [1, 2, 3, 4, 5];
rvY = [3, 5, 4, 6, 5];
rvMErr = [0.3, 0.4, 0.5, 0, 0.7];  // minus error
rvPErr = [0.2, 0.5, 0, 0.6, 0.3];  // plus error

hData = auto_xy_CreateErrorDataset(hLayer, "Test", rvX, rvY, rvMErr, rvPErr);
LayerAutoScale(hLayer);

rvConfig = XYGetErrorbarConfig(hData, "Y");
PenSetColor(rvConfig[1], [255,0,0]) // red
PenSetWidth(rvConfig[1], 5) // line width
rvConfig[2] = 5; // line width
rvConfig[3] = 0.3; // width in cm
XYSetErrorbarConfig(hData, "Y", rvConfig);
PenDestroy(rvConfig[1]);  // Delete Pen

History

Version Beschreibung
R2018.1 Neu

id-1820599