Script
AdvancedLe bloc Script exécute des algorithmes personnalisés en JavaScript ou Python (via Pyodide) de manière synchrone à chaque pas de calcul de la simulation. Il permet d'implémenter des lois de commande complexes, des observateurs d'état, de la logique de commutation non linéaire, des machines d'états et des calculs numériques difficilement formulables sous forme de schémas blocs graphiques.
Les ports d'entrée et de sortie sont configurables dynamiquement depuis l'interface et apparaissent comme variables nommées dans l'environnement de script, aux côtés du temps de simulation , du pas d'intégration et d'interfaces matérielles optionnelles.
Modèle Mathématique
Où :
- représente l'ensemble des variables d'entrée nommées transmises au contexte du script.
- représente les valeurs calculées affectées aux variables de sortie avant la fin du pas.
- et représentent respectivement le temps de simulation instantané et le pas de calcul du solveur.
Paramètres
| Paramètres | Label | Type | Défaut | Description |
|---|---|---|---|---|
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. |
Exemples d'Utilisation
Exemple 1 : Gain programmé adaptatif en JavaScript
Un gain adaptatif modifie l'amplification du retour d'état en fonction de l'amplitude de l'erreur pour réduire le temps de réponse :
const error = setpoint - measurement;
const gain = Math.abs(error) > 2.0 ? 5.0 : 1.5;
controlSignal = gain * error;
Exemple 2 : Commande optimale d'état en Python
Un script Python s'appuie sur NumPy pour calculer un signal de commande optimal en temps réel :
import numpy as np
error = setpoint - measurement
u_opt = float(-1.25 * error)
controlSignal = u_optRemarques & Bonnes Pratiques
- Performances des langages : JavaScript s'exécute nativement avec une surcharge négligeable ; Python fonctionne sous Pyodide et requiert un temps de chargement initial.
- Rechargement à chaud : La modification et l'enregistrement du code pendant la simulation actualise instantanément le comportement sans redémarrage.
- Nomenclature des ports : Les identifiants de ports doivent être des identifiants valides et ne pas entrer en conflit avec les mots-clés réservés (
t,dt,propar,class,import). - Calcul synchrone : Le script s'exécute de façon synchrone dans la boucle d'intégration ; des calculs trop lourds peuvent limiter la fréquence de simulation.
Composants Associés
- Plugin : Exécute des modules WebAssembly compilés pour une rapidité maximale et la protection du code propriétaire.
- MathFunction : Applique des opérations mathématiques élémentaires sur des signaux scalaires.
- StateSpace : Implémente des systèmes dynamiques multivariables linéaires sous forme d'équations d'état.