Script
AdvancedDer Script-Block führt benutzerdefinierte JavaScript- oder Python-Algorithmen (über Pyodide) synchron in jedem Simulationsschritt aus. Dies ermöglicht die Realisierung komplexer Regelgesetze, Zustandsschätzer, nichtlinearer Schaltlogik, Zustandsautomaten und numerischer Routinen, die sich in grafischen Blockschaltbildern nur schwer darstellen lassen.
Ein- und Ausgangsports werden dynamisch über den Einstellungsdialog konfiguriert und stehen innerhalb der Skriptumgebung als benannte Variablen zur Verfügung – ergänzt um die Simulationszeit , die Schrittweite und optionale Hardware-Schnittstellen.
Mathematisches Modell
Wobei:
- die Menge der benannten Eingangsvariablen darstellt, die dem Skript übergeben werden.
- die Ausgangswerte repräsentiert, die vor Abschluss des Zeitschritts zugewiesen werden.
- und die aktuelle Simulationszeit und die numerische Integrationsschrittweite angeben.
Parameter
| Parameter | Label | Typ | Standardwert | Beschreibung |
|---|---|---|---|---|
language |
Language | select | javascript |
Scripting language. Switching language replaces the default starter code if the editor is untouched. |
script |
Script | code | // Available variables: t, dt, propar, and your custom input names
// Assign values to your custom output names
out = input * 2; |
Script executed every simulation step. Use the dedicated Script editor (double-click the block) for syntax highlighting and live console output. |
customInputs |
Input Ports | text | [{"id":"input","label":"Input","dataType":"number"}] |
JSON array of input ports. Each entry: { id, label, dataType }. Edit via the Interface tab in the script editor. |
customOutputs |
Output Ports | text | [{"id":"out","label":"Output","dataType":"number"}] |
JSON array of output ports. Each entry: { id, label, dataType }. Edit via the Interface tab in the script editor. |
scriptUrl |
External Script URL | text | |
Optional URL. Click 'Pull' in the editor to fetch and replace the local script — never auto-fetched. |
Anwendungsbeispiele
Beispiel 1: Adaptive Verstärkungsanpassung in JavaScript
Eine Verstärkungsanpassung (Gain Scheduling) modifiziert die Rückführverstärkung anhand der Regelabweichung zur Verkürzung der Einschwingzeit:
const error = setpoint - measurement;
const gain = Math.abs(error) > 2.0 ? 5.0 : 1.5;
controlSignal = gain * error;
Beispiel 2: Optimale Zustandsrückführung in Python
Ein Python-Skript nutzt NumPy zur Berechnung einer optimalen Stellgröße:
import numpy as np
error = setpoint - measurement
u_opt = float(-1.25 * error)
controlSignal = u_optHinweise & Best Practices
- Laufzeit-Performance: JavaScript wird nativ mit vernachlässigbarem Overhead ausgeführt; Python läuft über Pyodide und benötigt eine initiale Kaltstartzeit.
- Hot-Reloading: Das Speichern geänderter Skripte während einer laufenden Simulation aktualisiert die Funktion ohne Neustart des Solvers.
- Variablennamen: Port-IDs müssen gültige Bezeichner sein und dürfen keine reservierten Schlüsselwörter überschreiben (
t,dt,propar,class,import). - Synchrone Berechnung: Skripte laufen synchron in der Integratorschleife; rechenintensive Schleifen können die maximale Simulationsrate einschränken.
Verwandte Blöcke
- Plugin: Führt vorkompilierte WebAssembly-Module für maximale Rechenleistung und Quellcode-Schutz aus.
- MathFunction: Wendet elementare mathematische Funktionen auf Skalare an.
- StateSpace: Bildet lineare Mehrgrößensysteme über Zustandsraummatrizen ab.