Script
AdvancedHet 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 , de integratiestaptijd en optionele hardwarecommunicatie-interfaces.
Wiskundig Model
Waarin:
- de verzameling benoemde ingangsvariabelen voorstelt die aan de scriptcontext worden aangeboden.
- de berekende waarden voorstelt die vóór het afronden van de tijdstap aan uitgangsvariabelen worden toegewezen.
- en 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_optOpmerkingen & 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.