auto_CalculateNCFormula

auto_CalculateNCFormula fügt einer NC-Datei einen berechneten Kanal zu.

ssError = auto_CalculateNCFormula(ssNCFile, oFormula)
ssError = auto_CalculateNCFormula(ncid, oFormula)

Returnwert

Return Value

ssError ist ein leerer string (""), falls die Formel berechnet werden konnte. Falls ein Fehler auftritt, enthält ssError eine Fehlermeldung.

Parameter

Parameters

ssNCFile

ssNCFile

ncid

ncid

oFormula

oFormula ist ein Objekt mit den folgenden optionalen Elementen (siehe Beispiel):

Element Default Value Description
ssFormula required Ist der Formeltext. In der Formel können alle in der NC-Datei vorhandenen Kanäle verwendet werden. Siehe Definition von Formeln.
ssOutputName required Ist der Name des Ergebniskanals. Der Name darf nur Buchstaben und Unterstriche und Zahlen enthalten und nicht mit einer Zahl beginnen.
ssUnit „“ Ist die Einheit des Ergebniskanals.
ssDescription „“ Ist eine Beschreibung der Formel.
ssOnlyIf „“ Ist der Name einer Bedingung.
ssFormat „“ Ist ein Formatstring. Beispiele: %g oder %.2lf.
ssUseSIUnits „0“ Wenn „1“ angegeben wird, rechnet die Formel mit SI-Einheiten.
rsDeleteICFile TRUE (1) Beim Wert 0 wird die Formel nicht aus dem Temp-Verzeichnis gelöscht.

Kommentar

Wie eine Formel definiert werden kann, wird im Artikel Formelinterpreter 1 - Einführung beschrieben. Alle in der Formel verwendeten Kanäle müssen in der Datei existieren. In der Formel können Funktionen aufgerufen werden, siehe Definition von Formeln. Die Formel wird nicht registriert. Die Formel wird nur einmal berechnet.

Beispiel

def test_auto_CalculateNCFormula()
{
    ssNCFile = auto_ImportData(GetRootDirectory() + "samples/test1.xls");
    oFormula = [.
        ssFormula = "EngSpd * SAETrq / 9550",
        ssOutputName = "Power",
        ssUnit = "kW",
        ssFormat="%.2lf"];  // 2 decimal places

    ssError = auto_CalculateNCFormula(ssNCFile, oFormula)
    if (ssError != "") {
        log_error("", "auto_CalculateNCFormula", ssError);
        error();
    }
//    NC_Edit(ssNCFile);
}
test_auto_CalculateNCFormula();

History

Version Beschreibung
R2014.3 Neu.

id-681772