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

bXSort

Nach 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