<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
Start het live voorbeeld Gratis · geen account · draait in je browser

Het Script-blok voert door de gebruiker gedefinieerde JavaScript- of Python-algoritmen (via Pyodide) synchroon uit binnen elke simulatiestap. Hiermee kunnen ingenieurs complexe regelwetten, toestandsschatters, niet-lineaire schakellogica, toestandsautomaten en numerieke routines implementeren die grafisch lastig in blokdiagrammen uit te drukken zijn.

Ingangs- en uitgangspoorten worden dynamisch via de blokinterface geconfigureerd en zijn direct als benoemde variabelen beschikbaar in de scriptomgeving, samen met de actuele simulatietijd tt, de integratiestaptijd Δt\Delta t en optionele hardwarecommunicatie-interfaces.

Wiskundig Model

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

Waarin:

  • u(t)∈Rm\mathbf{u}(t) \in \mathbb{R}^m de verzameling benoemde ingangsvariabelen voorstelt die aan de scriptcontext worden aangeboden.
  • y(t)∈Rp\mathbf{y}(t) \in \mathbb{R}^p de berekende waarden voorstelt die vóór het afronden van de tijdstap aan uitgangsvariabelen worden toegewezen.
  • tt en Δt\Delta t de actuele simulatietijd en de solver-integratiestapgrootte leveren.

Parameters

Parameters Label Type Standaard Beschrijving
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.

Gebruiksvoorbeelden

Voorbeeld 1: Adaptieve versterkingsregeling in JavaScript

Een gain-scheduler past de terugkoppelversterking aan op basis van de regelafwijking om de inslingertijd te verkorten:

const error = setpoint - measurement;
const gain = Math.abs(error) > 2.0 ? 5.0 : 1.5;
controlSignal = gain * error;

Voorbeeld 2: Optimale toestandsterugkoppeling in Python

Een Python-script berekent een optimale terugkoppelactie met behulp van NumPy:

import numpy as np
error = setpoint - measurement
u_opt = float(-1.25 * error)
controlSignal = u_opt

Opmerkingen & Best Practices

  • Taalperformantie: JavaScript draait rechtstreeks in de V8-engine met minimale overhead per stap; Python draait via Pyodide en kent een initiële laadtijd bij de eerste start.
  • Hot-reloading: Het bewerken en opslaan van code tijdens een lopende simulatie werkt de functie onmiddellijk bij zonder de simulatie te onderbreken.
  • Veilige poortnamen: Poortnamen moeten geldige identifiers zijn en mogen niet conflicteren met gereserveerde trefwoorden (t, dt, propar, class, import).
  • Synchrone berekening: Het script draait synchroon binnen de rekenlus; zeer zware berekeningen kunnen de maximale simulatiesnelheid beïnvloeden.

Gerelateerde Componenten

  • Plugin: Voert gecompileerde WebAssembly-modules uit voor maximale rekensnelheid en bescherming van intellectueel eigendom.
  • MathFunction: Voert standaard elementaire wiskundige transformaties uit op scalaire ingangssignalen.
  • StateSpace: Implementeert lineaire dynamische multivariabele systemen via toestandsmatrices.