🎯

XYPlot

Sinks

El bloque XYPlot grafica dos señales escalares en tiempo real una frente a otra en una vista de plano de fase, conservando una cantidad configurable de los pares de muestras más recientes en forma de trazo que se desvanece. La visualización se actualiza en vivo en cada paso de simulación, lo que lo hace idóneo para observar ciclos límite, diagramas de fase y trayectorias dinámicas a medida que evolucionan.

A diferencia del bloque ScatterPlot, XYPlot está diseñado para la monitorización animada en tiempo real: únicamente son visibles las trailLength muestras más recientes, de modo que el gráfico siempre enfatiza el comportamiento actual en lugar de acumular el historial completo de la ejecución.

Modelo Matemático

(x(t), y(t))

Entradas y Salidas

Direction	ID	Label	Tipo	Status
→ In	`x`	X	number	Required
→ In	`y`	Y	number	Required

Parámetros

Parámetros	Label	Tipo	Por defecto
`autoScale`	Auto Scale Axes	boolean	`true`
`xMin`	X Min	number	`-1`
`xMax`	X Max	number	`1`
`yMin`	Y Min	number	`-1`
`yMax`	Y Max	number	`1`
`showGrid`	Show Grid	boolean	`true`
`pointColor`	Point Color	string	`#f97316`
`trailLength`	Max Points (0 = keep all)	number	`0`

Ejemplos de Uso

Retrato de fase de Van der Pol

VanDerPol.x  → XYPlot.X
VanDerPol.xdot → XYPlot.Y

Muestra la trayectoria en el espacio de estados de un oscilador de Van der Pol. El ciclo límite se vuelve visible tras unos pocos periodos de oscilación.

Error PID frente a esfuerzo de control

ErrorSignal → XYPlot.X
ControlOutput → XYPlot.Y

Grafique el error frente a la salida del controlador para inspeccionar en tiempo real el comportamiento de saturación y la forma de la ley de control.

Observaciones y Buenas Prácticas

Bloque sumidero (sink): XYPlot no tiene puertos de salida. Es un nodo de visualización terminal y no alimenta ningún cálculo posterior.
Dos entradas escalares: Los puertos X e Y aceptan cada uno una única señal numérica escalar. Las señales vectoriales deben desmultiplexarse antes de conectarse.
Ventana deslizante: Solo se muestran las últimas trailLength muestras. Aumente este valor para observar un historial de trayectoria más prolongado; redúzcalo para centrarse estrictamente en la dinámica instantánea.
Sin eje temporal: El eje horizontal representa el valor de la señal X, no el tiempo de simulación.

Bloques Relacionados

ScatterPlot: Acumula todos los pares de muestras de la ejecución completa; preferible cuando la nube de puntos completa resulta más relevante que la trayectoria reciente.
uPlotDisplay: Osciloscopio de series temporales para graficar señales frente al tiempo de simulación.
Histogram: Muestra la distribución estadística de una única señal escalar.