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(ssError);
}
// NC_Edit(ssNCFile);
}
test_auto_CalculateNCFormula();
History
Version |
Beschreibung |
---|---|
R2014.3 |
Neu. |
Siehe auch
Überblick Automatisierung der Diagrammerstellung, auto_ImportData, Definition von Formeln, obj_create
id-681772