🎯

XYPlot

Sinks

Le bloc XYPlot trace deux signaux scalaires en temps réel l'un par rapport à l'autre dans une vue de plan de phase, en conservant un nombre configurable des paires d'échantillons les plus récentes sous la forme d'une traînée qui s'estompe. L'affichage est actualisé en direct à chaque pas de simulation, ce qui le rend particulièrement adapté à l'observation des cycles limites, des portraits de phase et des trajectoires dynamiques au fil de leur évolution.

Contrairement au bloc ScatterPlot, le XYPlot est conçu pour une surveillance animée en temps réel : seuls les trailLength échantillons les plus récents sont visibles, de sorte que le tracé met toujours l'accent sur le comportement instantané plutôt que d'accumuler l'historique complet de l'exécution.

Modèle Mathématique

(x(t), y(t))

Entrées & Sorties

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

Paramètres

Paramètres	Label	Type	Défaut
`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`

Exemples d'Utilisation

Portrait de phase de Van der Pol

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

Affiche la trajectoire dans l'espace d'état d'un oscillateur de Van der Pol. Le cycle limite devient visible après quelques périodes d'oscillation.

Erreur PID vs effort de commande

ErrorSignal → XYPlot.X
ControlOutput → XYPlot.Y

Trace l'erreur par rapport à la sortie du régulateur pour inspecter en temps réel le comportement de saturation et l'allure de la loi de commande.

Remarques & Bonnes Pratiques

Bloc puits (sink) : Le bloc XYPlot n'a pas de ports de sortie. C'est un nœud d'affichage terminal qui n'alimente aucun calcul en aval.
Deux entrées scalaires : Les ports X et Y acceptent chacun un signal numérique scalaire unique. Les signaux vectoriels doivent être démultiplexés avant connexion.
Fenêtre glissante : Seuls les trailLength derniers échantillons sont affichés. Augmentez cette valeur pour visualiser un historique de trajectoire plus long ; diminuez-la pour vous concentrer sur la dynamique instantanée.
Aucun axe temporel : L'axe horizontal représente la valeur du signal X, et non le temps de simulation.

Composants Associés

ScatterPlot : Accumule toutes les paires d'échantillons pour l'ensemble de la simulation ; recommandé lorsque le nuage de points complet importe davantage que la trajectoire récente.
uPlotDisplay : Oscilloscope temporel pour tracer des signaux en fonction du temps de simulation.
Histogram : Affiche la distribution statistique d'un signal scalaire individuel.