* Bug 7967 fixed [doc]: size(meshgrid(..)) better documented
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / elementarymatrices / meshgrid.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA - Farid BELAHCENE
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2020 - Samuel GOUGEON
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="meshgrid" xml:lang="fr">
20     <refnamediv>
21         <refname>meshgrid</refname>
22         <refpurpose>
23             construit des matrices ou hypermatrices en répliquant des vecteurs en 2 ou 3 dimensions
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Séquence d'appel</title>
28         <synopsis>
29             U = meshgrid(u)
30             [U, V] = meshgrid(u)
31             [X, Y] = meshgrid(x, y)
32             [X, Y, Z] = meshgrid(x, y, z)
33         </synopsis>
34     </refsynopsisdiv>
35     <refsection>
36         <title>Paramètres</title>
37         <variablelist>
38             <varlistentry>
39                 <term>u, x, y, z</term>
40                 <listitem>
41                     Vecteurs de types quelconques, de tailles nu, nx, ny, nz.
42                     <para/>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>U, V</term>
47                 <listitem>
48                     Matrices carrées, de taille nu x nu
49                     <para/>
50                 </listitem>
51             </varlistentry>
52             <varlistentry>
53                 <term>X, Y, Z</term>
54                 <listitem>
55                     Matrices ou hypermatrices de mêmes tailles
56                     [<emphasis role="bold">ny</emphasis>, nx] ou
57                     [<emphasis role="bold">ny</emphasis>, nx, nz].
58                     <para/>
59                 </listitem>
60             </varlistentry>
61         </variablelist>
62     </refsection>
63     <refsection>
64         <title>Description</title>
65         <para>
66             meshgrid(..) construit des matrices ou des hypermatrices 3-D par réplication
67             en 2 ou 3 dimensions des vecteurs donnés.
68         </para>
69         <para>
70             <note>
71                 Pour créer des tableaux de taille [<emphasis role="bold">nx</emphasis>, ny]
72                 au lieu de [ny, nx], ou avec plus de 3
73                 dimensions, utiliser <literal>ndgrid(x, y)</literal> ou
74                 <literal>ndgrid(x, y, z,..)</literal>.
75             </note>
76         </para>
77         <para>
78             <warning>
79                 La plupart des fonctions graphiques 2D ou 3D de Scilab telles que
80                 <literal>champ()</literal>,
81                 <literal>grayplot()</literal>, <literal>Sgrayplot()</literal>,
82                 <literal>plot3d()</literal>, <literal>contour()</literal>, etc.. travaillent
83                 directement avec des grilles de coordonnées générées par <literal>ndgrid()</literal>,
84                 non de <literal>meshgrid()</literal>. Les données calculées à partir d'une
85                 grille issue de <literal>meshgrid()</literal> devront être transposées
86                 (voir l'exemple ci-dessous).
87             </warning>
88         </para>
89     </refsection>
90     <refsection>
91         <title>Exemples</title>
92         <programlisting role="example"><![CDATA[
93 [X, Y] = meshgrid(0:2)
94  ]]></programlisting>
95     <screen>
96 --> [X, Y] = meshgrid(0:2)
97  X  =
98    0.   1.   2.
99    0.   1.   2.
100    0.   1.   2.
101
102  Y  =
103    0.   0.   0.
104    1.   1.   1.
105    2.   2.   2.
106 </screen>
107         <para/>
108         <programlisting role="example"><![CDATA[
109 [X, Y] = meshgrid(["a" "bc" "αβγδ"], [-3 5])
110  ]]></programlisting>
111     <screen>
112 --> [X, Y] = meshgrid(["a" "bc" "αβγδ"], [-3 5])
113  X  =
114 !a  bc  αβγδ  !
115 !a  bc  αβγδ  !
116
117  Y  =
118   -3.  -3.  -3.
119    5.   5.   5.
120 </screen>
121         <para/>
122         <para>
123             Application aux grilles graphiques :
124         </para>
125         <programlisting role="example"><![CDATA[
126 // Production des données à illustrer
127 x = -1:0.1:1.7;
128 y = -1:0.1:1;
129 [X, Y] = meshgrid(x, y);
130 Z = sinc(2*%pi * X.*Y);
131
132 // Préparation de la fenêtre graphique
133 clf
134 drawlater
135 gcf().color_map = parulacolormap(64);
136 gcf().axes_size = [650 530];
137
138 // Affichage graphique
139 subplot(2,2,1)
140 Sgrayplot(x, y, Z')
141 title(["Sgrayplot(x, y, Z'' ) " "$←\;Z^t\; requis$"], "fontsize",3)
142 isoview, colorbar
143
144 subplot(2,2,2)
145 plot3d(x, y, Z', -125,50)
146 gce().color_flag = 1;
147 title(["plot3d(x, y, Z'' ) " "$←\;Z^t\; requis$"], "fontsize",3)
148 isoview
149
150 subplot(2,2,3)
151 champ(x,y,sin(2*X'),cos(2*Y'))
152 title(["champ(x, y, sin(X'' ),cos(Y'' ))" "$←\;X^t\;\;Y^t\; requis$"], "fontsize",3)
153 isoview
154
155 subplot(2,2,4)
156 surf(X, Y, Z)
157 title("surf(X, Y, Z)", "fontsize",3)
158 isoview
159
160 gcf().children.tight_limits = ["on" "on" "on"];
161 drawnow
162  ]]></programlisting>
163         <para/>
164         <scilab:image>
165             // Generating data
166             x = -1:0.1:1.7;
167             y = -1:0.1:1;
168             [X, Y] = meshgrid(x, y);
169             Z = sinc(2*%pi * X.*Y);
170
171             // Setting the graphic figure
172             clf
173             drawlater
174             gcf().color_map = parulacolormap(64);
175             gcf().axes_size = [650 530];
176
177             // Plotting
178             subplot(2,2,1)
179             Sgrayplot(x, y, Z')
180             title(["Sgrayplot(x, y, Z'' ) " "$←\;Z^t\; required$"], "fontsize",3)
181             isoview, colorbar
182
183             subplot(2,2,2)
184             plot3d(x, y, Z', -125,50)
185             gce().color_flag = 1;
186             title(["plot3d(x, y, Z'' ) " "$←\;Z^t\; required$"], "fontsize",3)
187             isoview
188
189             subplot(2,2,3)
190             champ(x,y,sin(2*X'),cos(2*Y'))
191             title(["champ(x, y, sin(X'' ),cos(Y'' ))" "$←\;X^t\;\;Y^t\; required$"], "fontsize",3)
192             isoview
193
194             subplot(2,2,4)
195             surf(X, Y, Z)
196             title("surf(X, Y, Z)", "fontsize",3)
197             isoview
198
199             gcf().children.tight_limits = ["on" "on" "on"];
200             drawnow
201         </scilab:image>
202     </refsection>
203     <refsection role="see also">
204         <title>Voir aussi</title>
205         <simplelist type="inline">
206             <member>
207                 <link linkend="ndgrid">ndgrid</link>
208             </member>
209             <member>
210                 <link linkend="repmat">repmat</link>
211             </member>
212             <member>
213                 <link linkend="feval">feval</link>
214             </member>
215         </simplelist>
216     </refsection>
217 </refentry>