36cc72606eb3a7ecb3c2916fa83ddf44a27a78e6
[scilab.git] / scilab / modules / graphics / help / fr_FR / 3d_plot / hist3d.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="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" xml:id="hist3d" xml:lang="fr">
3     <refnamediv>
4         <refname>hist3d</refname>
5         <refpurpose>représentation 3D d'un histogramme</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Séquence d'appel</title>
9         <synopsis>hist3d(mtx,[theta,alpha,leg,flag,ebox])
10             hist3d(mtx,&lt;opt_args&gt;)
11             hist3d(list(mtx,x,y),[theta,alpha,leg,flag,ebox])
12             hist3d(list(mtx,x,y),&lt;opt_args&gt;)
13         </synopsis>
14     </refsynopsisdiv>
15     <refsection>
16         <title>Paramètres</title>
17         <variablelist>
18             <varlistentry>
19                 <term>mtx</term>
20                 <listitem>
21                     <para>matrice de taille (m,n) définissant l'histogramme
22                         <literal>mtx(i,j)=F(x(i),y(j))</literal>, où <literal>x</literal> et
23                         <literal>y</literal> sont considérés égaux à <literal>0:m</literal>
24                         et <literal>0:n</literal>.
25                     </para>
26                 </listitem>
27             </varlistentry>
28             <varlistentry>
29                 <term>list(mtx,x,y)</term>
30                 <listitem>
31                     <para>où mtx est une matrice de taille (m,n) définissant
32                         l'histogramme <literal>mtx(i,j)=F(x(i),y(j))</literal>, avec
33                         <literal>x</literal> et <literal>y</literal> deux vecteurs de
34                         tailles respectives (1,m+1) et (1,n+1).
35                     </para>
36                 </listitem>
37             </varlistentry>
38             <varlistentry>
39                 <term>&lt;opt_args&gt;</term>
40                 <listitem>
41                     <para>
42                         Représente une séquence de la forme <literal>clé1=valeur1,
43                             clé2=valeur2
44                         </literal>
45                         ,... où <literal>clé1,
46                             clé2,...
47                         </literal>
48                         peut être n'importe quel paramètre optionnel de <link linkend="plot3d">plot3d</link>
49                         (<literal>theta,alpha,leg,flag,ebox</literal>).
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>theta,alpha,leg,flag,ebox</term>
55                 <listitem>
56                     <para>
57                         voir <link linkend="plot3d">plot3d</link>.
58                     </para>
59                 </listitem>
60             </varlistentry>
61         </variablelist>
62     </refsection>
63     <refsection>
64         <title>Description</title>
65         <para>
66             <literal>hist3d</literal> représente un histogramme 2D dans
67             l'espace. Les valeurs sont associées aux intervalles <literal>[x(i)
68                 x(i+1)[ X [y(i) y(i+1)[
69             </literal>
70             .
71         </para>
72         <para>
73             Taper <literal>hist3d()</literal> pour voir une démonstration de la
74             fonction.
75         </para>
76     </refsection>
77     <refsection>
78         <title>Exemples</title>
79         <programlisting role="example"><![CDATA[
80         hist3d();
81  ]]></programlisting>
82         <scilab:image localized="true">hist3d();</scilab:image>
83         <programlisting role="example"><![CDATA[
84 hist3d(10*rand(10,10));
85  ]]></programlisting>
86         <scilab:image>hist3d(10*rand(10,10));</scilab:image>
87         <programlisting role="example"><![CDATA[
88 Z = zeros(100,5);
89 A = abs(rand(40,5));
90 Z(1:40,:) = A;
91 scf();
92 hist3d(Z);
93  ]]></programlisting>
94         <scilab:image>
95             Z = zeros(100,5);
96             A = abs(rand(40,5));
97             Z(1:40,:) = A;
98             scf();
99             hist3d(Z);
100         </scilab:image>
101         <programlisting role="example"><![CDATA[
102 Z = zeros(100,5);
103 A = abs(rand(40,5));
104 Z(1:40,:) = A;
105 Index = find(Z==0);
106 Z(Index) = %nan;
107 scf();
108 hist3d(Z);
109  ]]></programlisting>
110         <scilab:image>
111             Z = zeros(100,5);
112             A = abs(rand(40,5));
113             Z(1:40,:) = A;
114             Index = find(Z==0);
115             Z(Index) = %nan;
116             scf();
117             hist3d(Z);
118         </scilab:image>
119         <programlisting role="example"><![CDATA[
120 Z = zeros(100,5);
121 A = abs(rand(40,5));
122 Z(1:40,:) = A;
123 A = abs(rand(10,5));
124 Z(91:100,:) = A;
125 scf();
126 hist3d(Z);
127  ]]></programlisting>
128         <scilab:image>
129             Z = zeros(100,5);
130             A = abs(rand(40,5));
131             Z(1:40,:) = A;
132             A = abs(rand(10,5));
133             Z(91:100,:) = A;
134             scf();
135             hist3d(Z);
136         </scilab:image>
137     </refsection>
138     <refsection role="see also">
139         <title>Voir aussi</title>
140         <simplelist type="inline">
141             <member>
142                 <link linkend="histplot">histplot</link>
143             </member>
144             <member>
145                 <link linkend="plot3d">plot3d</link>
146             </member>
147         </simplelist>
148     </refsection>
149 </refentry>