auto_xy_LabelDataPoints

Die Funktion auto_xy_LabelDataPoints beschriftet die Datenpunkte eines 1D- oder 2D-Datensatzes mit den Y-Koordinaten. Falls der Datensatz mehr als 50 Datenpunkte enthält, werden 50 Beschriftungen auf die Datenpunkte verteilt.

bool = auto_xy_LabelDataPoints(hData)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat, bShowHelpLine)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat, bShowHelpLine, bHorizontal)
bool = auto_xy_LabelDataPoints(hData, rvOffsetCM, ssStart, ssEnd, ssFormat, bShowHelpLine, bHorizontal, bExt)

Returnwert

bool ist TRUE (1), wenn die Funktion erfolgreich war und sonst FALSE (0).

Parameter

hData

hData ist die Zugriffsnummer (handle) eines 2D Datensatzes. Falls hData ein Vektor mit zwei Datensatz-Zugriffsnummern ist, wird der Datensatz mit den y-Koordinaten des zweiten Datensatzes beschriftet. In diesem Fall müssen beide Datensätze die gleiche Punktanzahl besitzen. Siehe Beispiel.

rvOffsetCM

rvOffsetCM ist ein Vektor mit zwei Elementen:

Wert Bedeutung
rvOffsetCM[1] Verschiebung in x-Richtung in Zentimeter.
rvOffsetCM[2] Verschiebung in y-Richtung in Zentimeter.
ssStart

ssStart Ein Text der vor dem Wert erscheint. Beispiel: "Y=".

ssEnd

ssEnd Ein Text der nach dem Wert erscheint. Beispiel: " Nm".

ssFormat

ssFormat ist das Zahlenformat. Mögliche Einstellungen, siehe printf.

bShowHelpLine

Falls bShowHelpLine den Wert TRUE (1) hat, wird eine Hilfslinie vom Datenpunkt zum Text gezeichnet.

bHorizontal

Falls bHorizontal den Wert TRUE (1) hat, wird das Label horizontal ausgegeben. Beim Wert FALSE (0) wird der Text um 90° gedreht. Defaultwert ist FALSE (0).

bExt

Der Parameter legt fest, ob die Funktion auf die Originaldaten oder die gefilterten Daten zugreift.

Wert Beschreibung
1 Falls gefilterte Daten vorhanden sind: Zugriff auf die gefilterten Daten, sonst auf die Originaldaten. Der Defaultwert ist 1.
0 Zugriff auf die Originaldaten.

Beispiel

In diesem Beispiel wird die Leistung an die Momentenkurve geschrieben.

auto_AddToUI("Examples", "Example 6: WOT 1", "RS_Example6");
def RS_Example6()
{
    MessageBox("In the following dialog please select the file VOLLAST.ASC");
    auto_SetFileNameDialogInit("*.asc; *.nc", GetRootDirectory() + "samples/");
    svFile = auto_GetFileNameDialog(3);
    if (svFile[1] == "DLG_CANCEL") {
        return;
    }
    NumberOfFiles = len(svFile);
    hPage = auto_LoadTemplate("example");
    for (i in 1:NumberOfFiles) {
        svFile[i] = auto_ImportData(svFile[i]);
        hData1 = auto_LoadDataset("Diagramm 1", "N", "MEFF");
        hData2 = auto_LoadDataset("Diagramm 1", "N", "EWGLST");
        auto_xy_LabelDataPoints([hData1, hData2], [0, 0.3], "p=", "kW");
        XYShow(hData2, FALSE);
    }
    auto_ScaleAxes();
    auto_ReplaceTextDialog(svFile[1]);
    auto_UpdatePage(TRUE);
}

History

Version Beschreibung
R2013 Neuer Parameter bExt.
5.15.1 Neuer Parameter bHorizontal.

id-689640