1 <?xml version="1.0" encoding="UTF-8"?>
3 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
6 * This file must be used under the terms of the CeCILL.
7 * This source file is licensed as described in the file COPYING, which
8 * you should have received as part of this distribution. The terms
9 * are also available at
10 * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
13 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" version="5.0-subset Scilab" xml:id="Graphics" xml:lang="en">
15 <refname>Graphics</refname>
16 <refpurpose>contenu de la bibliothèque graphique</refpurpose>
19 <title>Dessins 2d</title>
23 <link linkend="plot2d">plot2d</link>
26 <para>représentation de courbes dans le plan</para>
28 <emphasis role="bold">Exemple:</emphasis>
31 <scilab:image>plot2d();</scilab:image>
37 <link linkend="plot2d2">plot2d2</link>
40 <para>représentation d'une fonction constante par morceaux</para>
42 <emphasis role="bold">Exemple:</emphasis>
45 <scilab:image>plot2d2();</scilab:image>
51 <link linkend="plot2d3">plot2d3</link>
54 <para>représentation de courbes dans le plan sous forme de barres verticales</para>
56 <emphasis role="bold">Exemple:</emphasis>
59 <scilab:image>plot2d3();</scilab:image>
65 <link linkend="plot2d4">plot2d4</link>
68 <para>représentation de courbes dans le plan sous forme de flèches</para>
70 <emphasis role="bold">Exemple:</emphasis>
73 <scilab:image>plot2d4();</scilab:image>
79 <link linkend="fplot2d">fplot2d</link>
82 <para>représentation d'une courbe définie par une fonction</para>
84 <emphasis role="bold">Exemple:</emphasis>
87 <scilab:image>fplot2d();</scilab:image>
93 <link linkend="champ">champ</link>
96 <para>champ de vecteur 2D</para>
98 <emphasis role="bold">Exemple:</emphasis>
101 <scilab:image>champ();</scilab:image>
107 <link linkend="champ1">champ1</link>
110 <para>champ de vecteur 2D. Flèches colorées</para>
112 <emphasis role="bold">Exemple:</emphasis>
115 <scilab:image>champ1();</scilab:image>
121 <link linkend="fchamp">fchamp</link>
124 <para>champ défini par une équation différentielle du premier ordre</para>
126 <emphasis role="bold">Exemple:</emphasis>
129 <scilab:image>fchamp();</scilab:image>
135 <link linkend="contour2d">contour2d</link>
138 <para>courbes de niveau d'une surface</para>
143 <link linkend="fcontour2d">fcontour2d</link>
146 <para>courbes de niveau d'une surface (définie par une fonction)</para>
148 <emphasis role="bold">Exemple:</emphasis>
151 <scilab:image>fcontour2d();</scilab:image>
157 <link linkend="grayplot">grayplot</link>
160 <para>représentation d'une surface en 2D sous forme de couleurs</para>
162 <emphasis role="bold">Exemple:</emphasis>
165 <scilab:image>grayplot();</scilab:image>
171 <link linkend="fgrayplot">fgrayplot</link>
174 <para>représentation d'une surface (définie par une fonction) en 2D sous forme de couleurs</para>
176 <emphasis role="bold">Exemple:</emphasis>
179 <scilab:image>fgrayplot();</scilab:image>
185 <link linkend="Sgrayplot">Sgrayplot</link>
188 <para>représentation d'une surface en 2D sous forme de couleurs interpolées</para>
190 <emphasis role="bold">Exemple:</emphasis>
193 <scilab:image>Sgrayplot();</scilab:image>
199 <link linkend="Sfgrayplot">Sfgrayplot</link>
202 <para>représentation d'une surface (définie par une fonction) en 2D sous forme de couleurs interpolées</para>
204 <emphasis role="bold">Exemple:</emphasis>
207 <scilab:image>Sfgrayplot();</scilab:image>
213 <link linkend="xgrid">xgrid</link>
216 <para>ajoute une grille sur un dessin 2D</para>
218 <emphasis role="bold">Exemple:</emphasis>
221 <scilab:image>xgrid();</scilab:image>
227 <link linkend="errbar">errbar</link>
230 <para>ajoute des barres d'erreur sur un dessin 2D</para>
232 <emphasis role="bold">Exemple:</emphasis>
235 <scilab:image>errbar();</scilab:image>
241 <link linkend="histplot">histplot</link>
244 <para>dessine un histogramme</para>
246 <emphasis role="bold">Exemple:</emphasis>
249 <scilab:image>histplot();</scilab:image>
255 <link linkend="Matplot">Matplot</link>
258 <para>dessin en 2D d'une matrice en pseudo-couleurs</para>
260 <emphasis role="bold">Exemple:</emphasis>
263 <scilab:image>Matplot();</scilab:image>
270 <title>Dessins 3d</title>
274 <link linkend="plot3d">plot3d</link>
277 <para>représentation en en couleurs d'une surface</para>
279 <emphasis role="bold">Exemple:</emphasis>
282 <scilab:image>plot3d();</scilab:image>
288 <link linkend="plot3d1">plot3d1</link>
291 <para>représentation en en couleurs d'une surface</para>
293 <emphasis role="bold">Exemple:</emphasis>
296 <scilab:image>plot3d1();</scilab:image>
302 <link linkend="fplot3d">fplot3d</link>
305 <para>représente une surface non paramétrique définie par une fonction</para>
307 <emphasis role="bold">Exemple:</emphasis>
310 <scilab:image>fplot3d();</scilab:image>
316 <link linkend="fplot3d1">fplot3d1</link>
319 <para>représente une surface non paramétrique définie par une fonction</para>
321 <emphasis role="bold">Exemple:</emphasis>
324 <scilab:image>fplot3d1();</scilab:image>
330 <link linkend="param3d">param3d</link>
333 <para>représente une courbe paramétrique en 3D</para>
335 <emphasis role="bold">Exemple:</emphasis>
338 <scilab:image>param3d();</scilab:image>
344 <link linkend="param3d1">param3d1</link>
347 <para>représente des courbes paramétriques en 3D</para>
349 <emphasis role="bold">Exemple:</emphasis>
352 <scilab:image>param3d1();</scilab:image>
358 <link linkend="contour">contour</link>
361 <para>courbes de niveau sur une surface en 3D</para>
363 <emphasis role="bold">Exemple:</emphasis>
366 <scilab:image>contour();</scilab:image>
372 <link linkend="fcontour">fcontour</link>
375 <para>courbes de niveau sur une surface en 3D définie par une fonction</para>
377 <emphasis role="bold">Exemple:</emphasis>
380 <scilab:image>fcontour();</scilab:image>
386 <link linkend="hist3d">hist3d</link>
389 <para>représentation d'un histogramme en 3D</para>
391 <emphasis role="bold">Exemple:</emphasis>
394 <scilab:image>hist3d();</scilab:image>
400 <link linkend="genfac3d">genfac3d</link>
403 <para>calcule les facettes d'une surface non paramétrique</para>
405 <emphasis role="bold">Exemple:</emphasis>
408 <scilab:image>genfac3d();</scilab:image>
414 <link linkend="eval3dp">eval3dp</link>
417 <para>calcule les facettes d'une surface paramétrique</para>
419 <emphasis role="bold">Exemple:</emphasis>
422 <scilab:image>p1=linspace(0,2*%pi,10);
423 p2=linspace(0,2*%pi,10);
424 deff("[x,y,z]=scp(p1,p2)",["x=p1.*sin(p1).*cos(p2)";..
425 "y=p1.*cos(p1).*cos(p2)";..
427 [Xf,Yf,Zf]=eval3dp(scp,p1,p2);
435 <link linkend="geom3d">geom3d</link>
438 <para>projection 3D vers 2D après un dessin 3D</para>
440 <emphasis role="bold">Exemple:</emphasis>
443 <scilab:image>deff("[z]=surface(x,y)","z=sin(x)*cos(y)")
445 // 3D plot of the surface
446 fplot3d(t,t,surface,35,45,"X@Y@Z")
447 // now (t,t,sin(t).*cos(t)) is a curve on the surface
448 // which can be drawn using geom3d and xpoly
449 [x,y]=geom3d(%pi/2,0,surface(%pi/2,0))
457 <title>Dessins de polygones et de lignes</title>
461 <link linkend="xpoly">xpoly</link>
464 <para>dessine une ligne brisée ou un polygone</para>
469 <link linkend="xpolys">xpolys</link>
472 <para>dessine un ensemble de lignes brisées ou de polygones</para>
477 <link linkend="xrpoly">xrpoly</link>
480 <para>dessine un polygone régulier</para>
485 <link linkend="xsegs">xsegs</link>
488 <para>dessine des segments déconnectés</para>
493 <link linkend="xfpoly">xfpoly</link>
496 <para>remplit un polygone</para>
501 <link linkend="xfpolys">xfpolys</link>
504 <para>remplit un ensemble de polygones</para>
510 <title>Dessins de rectangles</title>
514 <link linkend="xrect">xrect</link>
517 <para>dessine un rectangle</para>
522 <link linkend="xfrect">xfrect</link>
525 <para>remplit un rectangle</para>
530 <link linkend="xrects">xrects</link>
533 <para>dessine ou remplit un ensemble de rectangles</para>
539 <title>Dessins des arcs</title>
543 <link linkend="xarc">xarc</link>
546 <para>dessine un arc d'ellipse</para>
551 <link linkend="xarcs">xarcs</link>
554 <para>dessine des arcs d'ellipses</para>
559 <link linkend="xfarc">xfarc</link>
562 <para>remplit un secteur angulaire d'ellipse</para>
567 <link linkend="xfarcs">xfarcs</link>
570 <para>remplit des secteurs angulaires d'ellipses</para>
576 <title>Dessins de flèches</title>
580 <link linkend="xarrows">xarrows</link>
583 <para>dessine un ensemble de flèches</para>
589 <title>Dessins de textes</title>
593 <link linkend="xstring">xstring</link>
596 <para>dessine des chaînes de caractères</para>
601 <link linkend="xstringl">xstringl</link>
604 <para>calcule une boîte contenant des chaînes de caractères</para>
609 <link linkend="xstringb">xstringb</link>
612 <para>dessine des chaînes de caractères dans une boîte</para>
614 <emphasis role="bold">Exemple:</emphasis>
617 <scilab:image>xstringb();</scilab:image>
623 <link linkend="xtitle">xtitle</link>
626 <para>ajoute des titres et légendes sur une fenêtre graphique</para>
628 <emphasis role="bold">Exemple:</emphasis>
631 <scilab:image>xtitle();</scilab:image>
637 <link linkend="titlepage">titlepage</link>
640 <para>ajoute un titre au milieu d'une fenêtre graphique</para>
645 <link linkend="xinfo">xinfo</link>
648 <para>affiche une chaîne de caractères dans la sous-fenêtre des messages</para>
654 <title>Cadres et axes</title>
658 <link linkend="drawaxis">drawaxis</link>
661 <para>Draw an axis</para>
666 <link linkend="graduate">graduate</link>
669 <para>graduations simplifiées</para>
674 <link linkend="plotframe">plotframe</link>
677 <para>dessine un cadre avec axes et mise à l'échelle</para>
683 <title>Transformation de coordonnées</title>
687 <link linkend="isoview">isoview</link>
690 <para>échelle isométrique (fonction obsolète)</para>
695 <link linkend="square">square</link>
698 <para>échelle isométrique (par changement de la taille de la fenêtre)</para>
703 <link linkend="scaling">scaling</link>
706 <para>transformation affine d'un ensemble de points</para>
711 <link linkend="rotate">rotate</link>
714 <para>rotation d'un ensemble de points</para>
719 <link linkend="xsetech">xsetech</link>
722 <para>choix d'une sous-fenêtre graphique</para>
727 <link linkend="subplot">subplot</link>
730 <para>divise la fenêtre graphique en sous-fenêtres</para>
735 <link linkend="xgetech">xgetech</link>
738 <para>donne l'échelle graphique courante</para>
743 <link linkend="xchange">xchange</link>
746 <para>transformation de coordonnées réelles vers pixels</para>
752 <title>Couleurs</title>
756 <link linkend="colormap">colormap</link>
759 <para>utilisation des tables de couleurs</para>
764 <link linkend="getcolor">getcolor</link>
767 <para>boîte de dialogue pour sélectionner des couleurs dans la table des couleurs</para>
772 <link linkend="addcolor">addcolor</link>
775 <para>ajout de nouvelles couleurs à la tables des couleurs</para>
780 <link linkend="graycolormap">graycolormap</link>
783 <para>table de couleurs du noir au blanc</para>
788 <link linkend="hotcolormap">hotcolormap</link>
791 <para>table de couleurs "chaude" du rouge au jaune</para>
797 <title>Contexte graphique</title>
801 <link linkend="xset">xset</link>
804 <para>change des valeurs du contexte graphique</para>
809 <link linkend="xget">xget</link>
812 <para>récupère des valeurs du contexte graphique</para>
817 <link linkend="xlfont">xlfont</link>
820 <para>charge une police dans le contexte graphique ou donne la liste des polices</para>
825 <link linkend="getsymbol">getsymbol</link>
828 <para>boîte de dialogue pour choisir un marqueur (ou symbole)</para>
834 <title>Sauvegarde et chargement</title>
838 <link linkend="xsave">xsave</link>
841 <para>sauve les graphiques dans un fichier</para>
846 <link linkend="xload">xload</link>
849 <para>charge des graphiques sauvés</para>
854 <link linkend="xs2bmp">xs2bmp</link>
857 <para>Exporte un graphique vers un fichier au format BMP</para>
862 <link linkend="xs2emf">xs2emf</link>
865 <para>Exporte un graphique vers un fichier au format EMF</para>
870 <link linkend="xs2eps">xs2eps</link>
873 <para>Exporte un graphique vers un fichier au format EPS</para>
878 <link linkend="xs2gif">xs2gif</link>
881 <para>Exporte un graphique vers un fichier au format GIF</para>
886 <link linkend="xs2jpg">xs2jpg</link>
889 <para>Exporte un graphique vers un fichier au format JPG</para>
894 <link linkend="xs2pdf">xs2pdf</link>
897 <para>Exporte un graphique vers un fichier au format PDF</para>
902 <link linkend="xs2png">xs2png</link>
905 <para>Exporte un graphique vers un fichier au format PNG</para>
910 <link linkend="xs2ppm">xs2ppm</link>
913 <para>Exporte un graphique vers un fichier au format PPM</para>
918 <link linkend="xs2ps">xs2ps</link>
921 <para>Exporte un graphique vers un fichier au format PS</para>
926 <link linkend="xs2svg">xs2svg</link>
929 <para>Exporte un graphique vers un fichier au format SVG</para>
935 <title>Primitives graphiques</title>
939 <link linkend="clf">clf</link>
942 <para>efface une fenêtre graphique et les graphiques enregistrés</para>
947 <link linkend="xclear">xclear</link>
950 <para>efface une fenêtre graphique</para>
955 <link linkend="driver">driver</link>
958 <para>choisit un pilote graphique</para>
963 <link linkend="xinit">xinit</link>
966 <para>initialisation d'un pilote graphique</para>
971 <link linkend="xend">xend</link>
974 <para>termine une session graphique</para>
979 <link linkend="xbasr">xbasr</link>
982 <para>redessine une fenêtre graphique</para>
987 <link linkend="replot">replot</link>
990 <para>redessine une fenêtre graphique avec de nouvelles bornes</para>
995 <link linkend="xpause">xpause</link>
998 <para>suspend l'exécution de Scilab</para>
1003 <link linkend="show_window">show_window</link>
1006 <para>met une fenêtre graphique au premier plan</para>
1011 <link linkend="xdel">xdel</link>
1014 <para>supprime une fenêtre graphique</para>
1019 <link linkend="winsid">winsid</link>
1022 <para>renvoie la liste des fenêtre graphiques</para>
1027 <link linkend="xname">xname</link>
1030 <para>change le nom d'une fenêtre graphique</para>
1036 <title>Position de la souris</title>
1040 <link linkend="xclick">xclick</link>
1043 <para>attend un clic de souris</para>
1048 <link linkend="locate">locate</link>
1051 <para>sélection d'un ensemble de points</para>
1056 <link linkend="xgetmouse">xgetmouse</link>
1059 <para>renvoie la position courante du pointeur de la souris</para>
1065 <title>Éditeur interactif</title>
1069 <link linkend="edit_curv">edit_curv</link>
1072 <para>éditeur graphique interactif</para>
1078 <title>Fonctions graphiques en automatique</title>
1082 <link linkend="bode">bode</link>
1085 <para>diagramme de Bode</para>
1087 <emphasis role="bold">Exemple:</emphasis>
1090 <scilab:image>s=poly(0,'s')
1091 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
1092 clf();bode(h,0.01,100);
1099 <link linkend="gainplot">gainplot</link>
1102 <para>diagramme de gain</para>
1104 <emphasis role="bold">Exemple:</emphasis>
1107 <scilab:image>s=poly(0,'s')
1108 h1=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01))
1109 h2=syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
1110 clf();gainplot([h1;h2],0.01,100,['h1';'h2'])
1118 <link linkend="nyquist">nyquist</link>
1121 <para>diagramme de Nyquist</para>
1123 <emphasis role="bold">Exemple:</emphasis>
1126 <scilab:image>s=poly(0,'s')
1127 h=syslin('c',(s^2+2*0.9*10*s+100)/(s^2+2*0.3*10.1*s+102.01));
1128 h1=h*syslin('c',(s^2+2*0.1*15.1*s+228.01)/(s^2+2*0.9*15*s+225))
1131 h_h=ax.children($).children(2);
1132 tip=datatipCreate(h_h,[1.331,0.684]);
1133 datatipSetOrientation(tip,"upper left");
1140 <link linkend="m_circle">m_circle</link>
1143 <para>diagramme M-circle</para>
1145 <emphasis role="bold">Exemple:</emphasis>
1148 <scilab:image>m_circle();</scilab:image>
1154 <link linkend="chart">chart</link>
1157 <para>abaque de Nichols</para>
1159 <emphasis role="bold">Exemple:</emphasis>
1162 <scilab:image>chart();</scilab:image>
1168 <link linkend="black">black</link>
1171 <para>diagramme de Black</para>
1173 <emphasis role="bold">Exemple:</emphasis>
1176 <scilab:image>s=poly(0,'s');
1177 sl=syslin('c',5*(1+s)/(.1*s^4+s^3+15*s^2+3*s+1))
1178 clf();black(sl,0.01,10);
1185 <link linkend="evans">evans</link>
1188 <para>lieu des racines d'Evans</para>
1190 <emphasis role="bold">Exemple:</emphasis>
1193 <scilab:image>evans();</scilab:image>
1199 <link linkend="sgrid">sgrid</link>
1202 <para>grille du plan s</para>
1204 <emphasis role="bold">Exemple:</emphasis>
1207 <scilab:image>sgrid();</scilab:image>
1213 <link linkend="plzr">plzr</link>
1216 <para>diagramme pôle-zéro</para>
1218 <emphasis role="bold">Exemple:</emphasis>
1221 <scilab:image>s=poly(0,'s');
1222 n=[1+s 2+3*s+4*s^2 5; 0 1-s s];
1223 d=[1+3*s 5-s^3 s+1;1+s 1+s+s^2 3*s-1];
1232 <link linkend="zgrid">zgrid</link>
1235 <para>diagramme zgrid</para>
1237 <emphasis role="bold">Exemple:</emphasis>
1240 <scilab:image>zgrid();</scilab:image>