pie

Paramètres

x

un scalaire ou un vecteur de réels positifs.

sp

un scalaire ou un vecteur de réels.

txt

une cell ou un vecteur de strings.

h

Argument de sortie dans lequel est renvoyé le handle d'un objet graphique de type Compound dont les enfants sont

• h.children(1): un Compound contenant les labels des parts (objets de type Text)
• h.children(2): un Compound contenant les parts slices (objets de type Polyline)

h peut eutre utilisé pour modifier les propriétés des objets après l'appel à la fonction ( voir text_properties et polyline_properties).

Description

x, sp et style doivent etre de meme longueur.

pie(x) : si la longueur du vecteur x est N alors la fonction pie dessine un cercle graphique constitué de N part. La surface de la ième part est egale à  : (x(i)/sum(x))*(aire du cercle unité). c'est la division de la valeur de la ième composante de x divisée par la somme des composantes de x

pie(x,sp) :le vecteur sp permet de couper une ou plusieurs parts du cercle, (la longueur de sp doit etre egale a la longueur de x). Si la valeur de la ième composante de sp est different de 0 alors la ième part est séparée des autres part(donc du cercle) par un espace, Si la valeur de la ième composante de sp est egale à  0 alors elle est attachée aux autres.

pie(x,txt) : le vecteur txt permet d'ecrire un texte à  coté de chacune des part du cercle, la ième composante de txt correspond au texte de la ième part (par défaut : on ecrit à  coté de chaque part le pourcentage de l'aire d'une part par rappport à  la surface totale du cercle. La longueur du vecteur txt doit etre égale à  la longueur.

Exemples

// Premier exemple : un argument d'entrée  x=[1 2 5]
scf(0);
pie([1 2 5]);

// Deuxième example : deux arguments d'entrées x=[5 9  4 6 3], sp=[0 1 0 1 0], la 2ème et 4ème parts du cercle sont séparées des autres
scf(1);
pie([5 9 4 6 3],[0 1 0 1 0]);

// Troisième exemple : trois arguments d'entrées, x=[3 4 6 2], sp=[0 1 0 0], txt=["part1","part2","part3","part4"]
scf(2);
pie([3 4 6 2],[0 1 0 0],["part1","part2","part3","part4"]);

Voir aussi

• xfpolys — fill a set of polygons

Historique