<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="7 8 3 12 7 16"/><polyline points="17 8 21 12 17 16"/><line x1="14" y1="5" x2="10" y2="19"/></svg>

Script

Advanced
Live-Beispiel starten Kostenlos · ohne Anmeldung · läuft im Browser

Der 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 tt, die Schrittweite Δt\Delta t und optionale Hardware-Schnittstellen.

Mathematisches Modell

y(t)=fscript(u(t),t,Δt)\mathbf{y}(t) = \mathbf{f}_{\text{script}}(\mathbf{u}(t), t, \Delta t)

Wobei:

  • u(t)∈Rm\mathbf{u}(t) \in \mathbb{R}^m die Menge der benannten Eingangsvariablen darstellt, die dem Skript übergeben werden.
  • y(t)∈Rp\mathbf{y}(t) \in \mathbb{R}^p die Ausgangswerte repräsentiert, die vor Abschluss des Zeitschritts zugewiesen werden.
  • tt und Δt\Delta t 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_opt

Hinweise & 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.