Script
AdvancedEl 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 , el paso de cálculo e interfaces de hardware opcionales.
Modelo Matemático
Donde:
- representa el conjunto de variables de entrada suministradas al entorno del script.
- representa los valores calculados y asignados a las variables de salida antes de concluir el paso de simulación.
- y 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_optObservaciones 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.