<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
Ejecutar el ejemplo en vivo Gratis · sin registro · funciona en tu navegador

El bloque Script ejecuta algoritmos personalizados en JavaScript o Python (a través de Pyodide) de forma síncrona dentro de cada paso de simulación. Permite implementar leyes de control complejas, estimadores de estado, lógica de conmutación no lineal, máquinas de estados y rutinas numéricas difíciles de representar en diagramas de bloques convencionales.

Los puertos de entrada y salida se configuran dinámicamente desde la interfaz del bloque y están disponibles como variables con nombre dentro del entorno del script, junto con el tiempo de simulación tt, el paso de cálculo Δt\Delta t e interfaces de hardware opcionales.

Modelo Matemático

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

Donde:

  • u(t)∈Rm\mathbf{u}(t) \in \mathbb{R}^m representa el conjunto de variables de entrada suministradas al entorno del script.
  • y(t)∈Rp\mathbf{y}(t) \in \mathbb{R}^p representa los valores calculados y asignados a las variables de salida antes de concluir el paso de simulación.
  • tt y Δt\Delta t corresponden al tiempo de simulación actual y al paso de integración del solucionador numérico.

Parámetros

Parámetros Label Tipo Por defecto Descripción
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.

Ejemplos de Uso

Ejemplo 1: Programación adaptativa de ganancia en JavaScript

Un regulador adapta la ganancia en bucle según la magnitud del error para reducir el tiempo de respuesta:

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

Ejemplo 2: Realimentación óptima de estados en Python

Un script de Python utiliza NumPy para calcular una ley de control óptima en tiempo real:

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

Observaciones y Buenas Prácticas

  • Rendimiento según lenguaje: JavaScript se ejecuta nativamente con una sobrecarga mínima; Python opera sobre Pyodide y requiere una carga inicial en frío.
  • Recarga en caliente: La modificación y guardado del código durante la simulación actualiza inmediatamente la función sin reiniciar el solucionador.
  • Identificadores de puertos: Los nombres de puertos deben ser identificadores válidos y no colisionar con palabras reservadas (t, dt, propar, class, import).
  • Ejecución síncrona: El script se evalúa dentro del ciclo numérico en cada paso; algoritmos con excesivo coste computacional pueden ralentizar la simulación.

Bloques Relacionados

  • Plugin: Ejecuta módulos WebAssembly compilados para máxima velocidad de procesamiento y protección de propiedad intelectual.
  • MathFunction: Aplica operaciones matemáticas estándar sobre señales escalares.
  • StateSpace: Implementa modelos lineales multivariables mediante matrices de espacio de estados.