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