FVA-Workbench KnowledgeBase

Beispiel 1 Gesamtsystemberechnung durchführen

1methodID = "001_SYSTEM_CALCULATION";
2var compID = 1;
3setAttr("gta_switch_iso_6336_2006", compID, true, EDAT);
4var status = runCalcMethod(methodID, compID);
5if (status == 1) {
6    println("Calculation was successful");
    } else {
7  println("Something went wrong");
    }

Beispiel 2 Lagerlebensdauerberechnung für ein einzelnes Lager durchführen.

methodID = "800_ROLLING_BEARING_LIFETIME";
var compID = 15;
runCalcMethod(methodID, compID);

Liefert alle Meldungen zu einer durchgeführten Berechnung als JSON-Objekt zurück.

Beispiel Alle Meldungen zu einer Berechnung auf dem Scripting-Monitor ausgeben.

let notifications = getNotifications("ALL");

for(i = 0; i < notifications.length; i++) {
    let notification = notifications[i];
    println("Notification #" + i);
    println("---------------");
    println("Type:                " + notification.type);
    println("CalcMethodCompId:    " + notification.calcMethodCompId);
    println("CalcMethodCompName:  " + notification.calcMethodCompName);
    println("CalcMethodId:        " + notification.calcMethodId);
    println("CalcMethodName:      " + notification.calcMethodName);
    println("CalcStepName:        " + notification.calcStepName);
    println("Message:             " + notification.message);
    println(" ");

    let items = notification.items;

    for(j = 0; j < items.length; j++) {
	let notificationItem = items[j];
	println("   Notification Item #" + j);
	println("   ---------------------");
	println("   AttrId:   " + notificationItem.attrId);
	println("   CompId:   " + notificationItem.compId);
	println("   Message:  " + notificationItem.message);
	println("   Value:    " + notificationItem.value);
        println(" ");
    }
println(" ");
}

Vergleich der Meldungsausgabe in der Benutzeroberfläche mit der Ausgabe des Scriptes auf dem Scripting-Monitor.

Beispiel 1 Wert des Attributs Normaleingriffswinkel auf der Konsole ausgeben.

1let compID = getCompByType('cylindrical_mesh')[0];
2let value = getAttr("normal pressure angle", compID, EDAT);
3println(value);

Beispiel 2 Werte des Arrayattributs statische Tragzahl auf der Konsole ausgeben.

1let compID = getCompByType('bearing')[0];
2let value = getAttr("static capacity", compID, RDAT);
3println(value[0]);
4println(value[1]);

Beispiel 1 Wert des Attributs Öltemperatur löschen.

1var compID = 1;
2setAttr('temperature', compID, 90, EDAT);

Beispiel 2 Attribut FVA_54 auf true setzen. Das Attribut FVA_54 entspricht dem Schalter "Graufleckenberechnung nach FVA 54" im Eingabeditor.

1var compID = getCompByType('cylindrical_mesh')[0];
2setAttr('FVA_54', compID, true, EDAT);

Beispiel 1 Wert des Attributs Öltemperatur löschen.

1delAttr('lubricant', 1);

Beispiel Attributeigenschaften des Attributs Zahnbreite auf einem Stirnrad mit der ID 8 abfragen.

1var compID = 8;
2var attributeID = 'face width';
3println('Name: ' + getAttrProperty(attributeID, compID, 'NAME'));
4println('Unit: ' + getAttrProperty(attributeID, compID, 'UNIT_NAME'));
5println('Symbol: ' + getAttrProperty(attributeID, compID, 'SYMBOL'));
6println('Value: ' + getAttrProperty(attributeID, compID, 'RDAT_VALUE'));

Attribute können unter Umständen den Status "locked" haben und nicht via Script geändert werden. Dies ist z.B. der Fall, wenn die Vorgabe des Attributwertes zu einer Überbestimmung des Modells führen würde.

Beispiel

Wurde im Editorview auf der Komponente Stirnradstufe der Dropdown-Eintrag zur Aufteilung der Profilverschiebung "Eingabe der Profilverschiebung nach DIN 3992" ausgewählt, werden die Attribute zur manuellen Eingabe des Nennprofilverschiebungsfaktors ausgeblendet und gesperrt.

Das Script prüft, ob das Attribut "addendum modification coefficient" beschreibbar ist. Wenn ja, wird der neue Wert gesetzt. Wenn nein, wird eine Meldung mit dem Hinweis "Nennprofilverschiebungsfaktor kann nicht gesetzt werden, bitte die Aufteilung Profilverschiebung prüfen" ausgegeben.

let gearID = 8;
let addendum_modification = 0.3;
if(isAttrLocked("addendum modification coefficient", gearID) == false){
    setAttr("addendum modification coefficient", gearID, addendum_modification, EDAT);
}else{
    println("Addendum modification factor cannot be set, please check the addendum modification allocation.");
}

Für weitere Informationen siehe Datenhaltung (EDAT/RDAT)

Beispiel 1 Alle RDAT-Werte löschen.

delRDAT();

Beispiel 1 Bei allen Wälzlagern im Getriebemodell den Eingabetyp auf "Steifigkeit" setzten.

1let bearings = getCompByType("bearing");

2for (i=0; i < bearings.length; i++){
3	setAttr("bearing data type", bearings[i], 2, EDAT);
    }

Beispiel 1 Namen und Typ einer Komponente auf der Scripting Konsole ausgeben.

1var compID = 3;
2println(getCompProperty(compID,'TYPE'));
3println(getCompProperty(compID,'NAME'));

Beispiel Namen einer Komponente ändern.

var compID = 3;
setCompProperty(compID, "NAME", "New component name");

Beispiel 1 Räder einer Stirnradstufe abfragen

1var stageID = 3;
2var gearIDs = getSubComponents(stageID, "general_gear");
3println(gearIDs[0]);
4println(gearIDs[1]);

Beispiel 1 Kerbstelle auf einer Welle einfügen und Basisattribute belegen

1let shaftID = 3;
2let notchID = addSubComponent(shaftID, "notch");

3setAttr("notch kind", notchID, 6, EDAT);
4setAttr("position", notchID, 6, EDAT);
5setAttr("notch width", notchID, 5, EDAT);
6setAttr("notch radius", notchID, 2, EDAT);
7setAttr("depth", notchID, 2, EDAT);
8setAttr("surface roughness", notchID, 10, EDAT);

1	Variable shaftID enthält die ID der Welle, auf der die Kerbstelle eingefügt werden soll.
2	Neue Komponente vom Typ "notch" via addSubComponent() auf der Welle 3 einfügen. Der Rückgabewert der Funktion, die ID der neuen Kerbstelle, wird in der Variable notchID gespeichert.
3	Combo-Attribut "Kerbform" auf der neuen Kerbstelle via setAttr() auf 6 setzten. Der Wert 6 entspricht einer Rechtecknut. (Weitere Optionen siehe Bild)
4	Position der Kerbstelle setzten.
5	Kerbbreite der Kerbstelle setzen.
6	Kerbradius der Kerbstelle setzen.
7	Kerbtiefe der Kerbstelle setzten.
8	Oberflächenrauheit R_z der Kerbstelle setzten.

Beispiel 2 Einer bestehenden Welle Abschnitte hinzufügen

var shaftID = 3;
var nbrOuterContours = 3;
var nbrInnerContours = 2;
var outerContourIDs = [];
var innerContourIDs = [];
var outerContourlenght = [30, 50, 20];
var innerContourlenght = [40, 80];
var outerContourDiameters = [30, 50, 25];
var innerContourDiameters = [10, 20];

for (let i = 0; i < nbrOuterContours; i++){
  let options = {};
  outerContourIDs.push(addSubComponent(shaftID, "contour",{side: "outer", direction: "left"}));
}
for (let i = 0; i < nbrInnerContours; i++){
    innerContourIDs.push(addSubComponent(shaftID, "contour",{side: "inner", direction: "left"}));
}
for(let i = 0; i < nbrOuterContours; i++){
    setAttr("length",             outerContourIDs[i], outerContourlenght[i], EDAT);
    setAttr("beginning diameter", outerContourIDs[i], outerContourDiameters[i], EDAT);
    setAttr("end diameter",       outerContourIDs[i], outerContourDiameters[i], EDAT);
}
for(let i = 0; i < nbrInnerContours; i++){
    setAttr("length",             innerContourIDs[i], innerContourlenght[i], EDAT);
    setAttr("beginning diameter", innerContourIDs[i], innerContourDiameters[i], EDAT);
    setAttr("end diameter",       innerContourIDs[i], innerContourDiameters[i], EDAT);
}

Beispiel Belastungskomponente von einer Welle löschen

var shaftID = 4;
var forceID = 10;

deleteSubComponent(shaftID, forceID);

Beispiel Werkstoff 16MnCr5 als Komponente zum Modell hinzufügen und einem Stirnrad zuweisen

gearID = 8;
var materialID = addDbComponent("material", "16MnCr5");
setAttr("material", gearID, materialID, EDAT);

Beispiel Datenbankkomponente mit der ID 120 löschen

deleteDbComponent("120");

Beispiel 1 Aktualisiert die Datenbank Komponente mit der ID 22 mit den Daten aus der Globalen Datenbank.

refreshDbComp(22);

Beispiel 1

1var text = "This is text";
2var array = [1, 2.2, 3, 4];
3println(text);
    for (i=0; i<array.length; i++){
4     println(array[i]);
    }

Beispiel 1 Text als Meldung ausgeben.

var text = "This is a message. Click OK to continue."
alert(text);

Beispiel 2 Mehrere Meldungen in einer Schleife ausgeben.

1for (i = 0; i < 5; i++){
2    alert("This is the " + i + ". run"); 
     }

Beispiel 1 Drehmoment vom Nutzer abfragen und den Attributwert auf der Belastungskomponente entsprechend setzen.

1var forceID = 20;
2var torque = prompt("Please enter input torque");
3setAttr("scaled torque", forceID, torque, EDAT);

Beispiel 1 Text in eine vom Nutzer ausgewählte Datei schreiben.

1let options = {directory: "c/example", filename: "myfile.txt", type: "save"};
2let path = promptFile(options);
3let text = "This Text will be written to the ASCII File";
4writeToFile(path, text, "c", "UTF-8");

Beispiel 1 Textdatei in ein vom Nutzer ausgewähltes Verzeichnis schreiben.

1let directory = promptDirectory("c:/example");
2let filename = "text.txt";
3let path = directory +"/"+ filename;
4let text = "This Text will be written to the ASCII File";
5writeToFile(path, text, "c", "UTF-8");

Beispiel 1 Kriterium für den Korrekturvorschlag vom Nutzer abfragen und das entsprechende Attribut in der FVA-Workbench setzen.

Die Möglichen Werte für das Combo-Attribut "Kriterium für Flankenmodifikationen aus der 3d Lastverteilung" kann in der Attributübersicht nachgeschlagen werden.

1let dropDownEntries = [
                           "Linear increase in pressure", 
                           "Uniform pressure distribution", 
                           "Linear increase of line loads", 
                           "Uniform line loads"
                          ];
2let modCriterion = promptSelect("Select modification criterion for 3d loaddistribution", dropDownEntries);

3switch (modCriterion) {
        case "Linear increase in pressure":   modCriterion = "0"; break; 
        case "Uniform pressure distribution": modCriterion = "1"; break;
        case "Linear increase of line loads": modCriterion = "2"; break;
        case "Uniform line loads":            modCriterion = "3"; break;
        default: break; 
    };

4setAttr("modification_criterion_load_distribution_3d", 1, modCriterion, EDAT);

Beispiel 1 Monitor leeren

clearMonitor();

Beispiel 1 HTML-Report generieren

1var templateFile = "C:\\template.wbrep";
2var outputFile = "C:\\temp\\output\\report.html";
3var options = {compactView: false, 
                   language: "de", 
                   completeTree: false, 
                   notifications: true, 
                   navigationBar: true};
4generateReport(templateFile, outputFile, options);

Beispiel 1 Lädt ein Modell aus dem angegebenen Verzeichnis.

loadModel("c:\\modell.wbpz");

Beispiel 1 Modelldatei speichern

saveModel();

Beispiel 1 Datei model.wbpz in das Verzeichnis C:\temp exportieren.

exportModel("C:\\temp\\model.wbpz");

Beispiel 2 Modell im REXS-Format (Version 1.2) exportieren

1var options = {IncludeEmptyAttributes: "true" ,DataClass: "RDAT", Version: 1.2};
2exportModel("C:\\temp\\model.rexs", options);

Beispiel 1 Textdatei einlesen und auf der Scripting-Konsole ausgeben.

1var path = "c:\\textfile.txt";
2var text = readFile(path);

3for (i = 0; i < text.length; i++){
4    println(text[i]);
5    println(parseFloat(text[i])+ parseFloat(text[i]));
     }

Beispiel Textdatei erstellen und weitere Texte anhängen.

1var path = "C:\\temp\\test.txt";
2writeToFile(path, "Part 1\n", "c", "UTF-8");
3writeToFile(path, "Part 2\n", "a", "UTF-8");
4writeToFile(path, "Part 3",   "c", "UTF-8");

Beispiel

let filestatus = fileExists("c:/example/file.txt");
println(filestatus);

Beispiel Prüft, ob eine Datei lesbar ist.

let filestatus = isFileReadable("c:/example/file.txt");
println(filestatus);

Beispiel Prüft, ob eine Datei schreibbar ist.

let filestatus = isFileWriteable("c:/example/file.txt");
println(filestatus);

Beispiel 1 Berechnungsmeldungen als .xml exportieren.

exportNotifications("C:\\temp\\notifications.xml");

Beispiel 1 Externe Scripte einbinden

1#include "*";
2#include "folder\\*";
3#include "folder\\script.wbjs";
4#include "c:\\scripting\\folder\\script.wbjs"

Folgende Funktionen werden abgeschaltet:

Beispiel 1 Mehrere Meldungen in einer Schleife ausgeben

1var safety = 1.8;
2if(safety > 2){
3    generateReport("c:\\template.wbrep", "c:\\report.html");
4}else{
5    stopScript("The safety is: "+safety+"\nScript was stopped");
}

Einige Scripting Funktionen können nur im GUI-Modus bzw. nur im Batch-Modus ausgeführt werden. Über die isBatchMode() Funktion kann während der Scriptlaufzeit überprüft werden, in welchem Modus sich die FVA-Workbench befindet und entsprechend darauf reagiert werden.

Beispiel Schreiben einer Textdatei in ein Verzeichnis.

Wenn das Script im GUI-Modus ausgeführt wird, wird der Benutzer per Dialog nach dem zu verwendenden Verzeichnis gefragt. Im Batch-Modus wird das Verzeichnis verwendet, in dem sich die Modelldatei befindet.

let filename = "textfile.txt";
let text = "This text will be written to the file";
let directory;
let resultpath;

if (isBatchMode() == true) {
    directory = getModelProperty("FOLDER");
} else {
    directory = promptDirectory();
}

resultpath = directory+filename;
println("File written: "+resultpath);
writeToFile(resultpath, text, "c", "UTF-8");

Beispiel 1 Textdatei in einem Unterverzeichnis des Modellverzeichnisses schreiben.

1let modelpath = getModelProperty("FOLDER");
2let modelname = getModelProperty("MODEL_NAME");
3let filepath = modelpath + "new_directory/textfile.txt";
4writeToFile(filepath, modelname, "c", "UTF-8");

Beispiel Verzeichniss für Reportvorlagen und Ausgabeverzeichnis abfragen und Ergebnisreport erzeugen.

1let reportTemplateDirectory = getDirectory("report_templates");
2let templateFile = reportTemplateDirectory +"\\myReportTemplate.wbrep";

3let outputDirectory = getDirectory("reports");
4let outputFile = outputDirectory+"\\report.html";

5generateReport(templateFile, outputFile);

6println("Report was saved here: "+outputFile);

Beispiel

World Clock API ist ein Server, der das aktuelle Datum und die Uhrzeit in JSON zurückgibt. Der Server gibt die Daten als String zurück. Um diesen String in ein JSON Objekt zu konvertieren kann der JSON.parse Befehl verwendet werden. Dann kann über die Punktnotation auf die Elemente im JSON Objekt zugegriffen werden.

let JSON_string = get('http://worldclockapi.com/api/json/utc/now');
let JSON_object = JSON.parse(JSON_string);

println(JSON_string);
println(JSON_object.currentDateTime);
println(JSON_object.dayOfTheWeek);

Beispiel

In diesem Script werden "name" und "password" als Parameter an einen Demo Server übergeben. Die Antwort des Servers ist ein JSON String. Die Antwort des Servers enthält auch die gesendeten Parameter. Um den String in ein JSON Objekt zu konvertieren kann der JSON.parse Befehl verwendet werden.

let JSON_string = post('https://postman-echo.com/post', {'name':'mustermann', 'password':'secret'});
let JSON_object = JSON.parse(JSON_string);

println(JSON_string);
println(JSON_object.data.name);
println(JSON_object.data.password);

Beispiel Nach einer Berechnung werden je nach Sprache unterschiedliche Meldungen ausgegeben.

1let status = runCalcMethod("001_SYSTEM_CALCULATION", 1);
2let language = getLanguage();
3let success_message = language == "de" ? "Die Berechnung war erfolgreich" : "Calculation was successful";
4let fail_message = language == "de" ? "Die Berechnung ist fehlgeschlagen" : "Calculation failed";

5if (status == 1) {
6    println(success_message);
7    } else {
8  println(fail_message );
    }