auto_xy_CreateErrorDataset¶
auto_xy_CreateErrorDataset erzeugt einen neuen 2D-Datensatz mit Fehlerbalken.
-
hData = auto_xy_CreateErrorDataset(hLayer, ssName, rvX, rvY, rvMinusError, rvPlusError) -
hData = auto_xy_CreateErrorDatasetEx(hLayer, ncid, svVarName) -
hData = auto_xy_CreateErrorDatasetEx(hLayer, ncid, svVarName, oParameter) -
hData = auto_xy_CreateErrorDatasetEx(hLayer, ssNCName, svVarName) -
hData = auto_xy_CreateErrorDatasetEx(hLayer, ssNCName, svVarName, oParameter)
Returnwert
hData ist die Zugriffsnummer (Handle) des neu erstellten Datensatzes oder 0 im Falle eines Fehlers.
Parameter
-
hLayer hLayer ist die Zugriffsnummer des Diagramms, in das der Datensatz ausgegeben werden soll (siehe PageGetLayerHandle).
-
ssName ssName ist der Name des Datensatzes der mit XYCreate erstellt wird.
-
rvX rvX ist ein Vektor mit x-Koordianten.
-
rvY rvY ist ein Vektor mit y-Koordinaten.
-
rvMinusError rvMinusError ist ein Vektor mit den negativen Fehler-Balken.
-
rvPlusError rvPlusError ist ein Vektor mit den positiven Fehler-Balken. Die Anzahl der Werte muss mit der Anzahl an Werten in rvMinusError und der Anzahl der x-/y-Koordinaten übereinstimmen.
-
ncid ncid ist die Zugriffsnummer (Handle) einer NC-Datei, die von einem erfolgreichen Aufruf von nc_create zurückgeliefert wurde.
-
ssNCFile ssNCFile ist der Dateiname einer NC-Datei.
-
svVarName svVarName ist ein Vektor von String-Werten mit 4 Kanalnamen:
["x", "y", "minusError", "plusError"]. Die Werte für x, y, Minus- und Plus-Fehler werden aus diesen Kanälen gelesen
-
oParameter oParameter ist ein Objekt mit optionalen Parametern, zum Beispiel
[. bXSort = TRUE ].Element Name Beschreibung Default-Wert bXSortNach x sortieren. FALSE
Kommentar
The positive error values are added to the data point and the minus error values are subtracted from the data value. An error value of 0 is not displayed. The number of data points is limited to 200,000. The number of error points must match the number of data points in the dataset.
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);
History
| Version | Beschreibung |
|---|---|
| R2018.1 | Neu |
id-999724