# stairs

Graphique en escalier.

## 📝 Syntaxe

* stairs(Y)
* stairs(X, Y)
* stairs(..., LineSpec)
* stairs(..., Name, Value)
* stairs(ax, ...)
* h = stairs(...)
* \[xb, yb] = stairs(...)

## 📥 Argument d'entrée

* X - Valeurs x.
* Y - Valeurs y.
* LineSpec - Style de ligne, marqueur et/ou couleur : vecteur de caractères ou chaîne scalaire.
* propertyName - Une chaîne scalaire ou un vecteur ligne de caractères.
* propertyValue - Une valeur.
* ax - Objet axes.

## 📤 Argument de sortie

* h - Objet ligne.
* xb - Valeurs x à utiliser avec plot
* yb - Valeurs y à utiliser avec plot

## 📄 Description

Les graphiques en escalier sont un outil précieux pour créer des graphiques temporels de données échantillonnées numériquement.

La fonctionstairs(Y) permet de générer de tels graphiques en traçant les éléments du vecteurY.

SiY est une matrice, une ligne est tracée pour chaque colonne, la couleur des lignes étant déterminée par la propriété ColorOrder des axes.

Dans le cas d'un vecteur Y, l'axe x s'étend de 1 à la longueur de Y, tandis que pour une matrice Y, l'axe x va de 1 au nombre de lignes de Y.

stairs(X, Y) permet de tracer les éléments deY aux emplacements spécifiques définis par le vecteur X.

Il est important de noter que les éléments deX doivent être dans un ordre monotone pour créer un graphique en escalier valide.

## 💡 Exemples

```matlab
f = figure();
f = figure();
x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];
ax = gca();
stairs(ax, X,Y)

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-aea06cdf0bbd10881369be9ce6749546fb282436%2Fstairs_1.svg?alt=media)

```matlab
X = linspace(0,1,45)';
Y = [cos(3*X), exp(X).*sin(9*X)];
h = stairs(X,Y);
h(1).Marker = 'o';
h(1).MarkerSize = 5;
h(2).Marker = '+';
h(2).MarkerFaceColor = 'm';

```

![](https://160667757-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LdPvJ6mJve3gz5MU4d1%2Fuploads%2Fgit-blob-053567112816b3f4adb695bebee709d3525b9c08%2Fstairs_2.svg?alt=media)

## 🔗 Voir aussi

[plot](https://nelson-9.gitbook.io/Nelson/markdown/fr/graphics/plot).

## 🕔 Historique

| Version | 📄 Description   |
| ------- | ---------------- |
| 1.0.0   | version initiale |
