<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
Lancer l’exemple en direct Gratuit · sans inscription · dans votre navigateur

Le 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 tt, du pas d'intégration Δt\Delta t et d'interfaces matérielles optionnelles.

Modèle Mathématique

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

Où :

  • u(t)∈Rm\mathbf{u}(t) \in \mathbb{R}^m représente l'ensemble des variables d'entrée nommées transmises au contexte du script.
  • y(t)∈Rp\mathbf{y}(t) \in \mathbb{R}^p représente les valeurs calculées affectées aux variables de sortie avant la fin du pas.
  • tt et Δt\Delta t 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_opt

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