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 |
Siehe auch
Überblick XY-Datensätze, XYGetErrorData, XYGetErrorbarConfig, XYSetData, XYCreate, XYSetScaleOffset, XYSetGetOrgDataFlag
id-1820599