* Bug 16166 fixed: noisegen() obsolete
[scilab.git] / scilab / modules / cacsd / help / fr_FR / noisegen.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) 2013 - Scilab Enterprises - Paul Bignier
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
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" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="fr" xml:id="noisegen">
17     <refnamediv>
18         <refname>noisegen</refname>
19         <refpurpose>génération de bruit <emphasis role="bold">(obsolète)</emphasis></refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>Séquence d'appel</title>
23         <synopsis>b = noisegen(pas, Tmax, sig)</synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>Paramètres</title>
27         <variablelist>
28             <varlistentry>
29                 <term>pas</term>
30                 <listitem>
31                     <para>scalaire réel, le pas de temps</para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>Tmax</term>
36                 <listitem>
37                     <para>scalaire réel, le temps final de l'intervalle de génération</para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>sig</term>
42                 <listitem>
43                     <para>scalaire réel, l'écart-type du bruit</para>
44                 </listitem>
45             </varlistentry>
46         </variablelist>
47     </refsection>
48     <refsection>
49         <title>Description</title>
50         <warning>
51             <literal>noisegen()</literal> is obsolete. It will be removed from Scilab 6.1.x.
52             Please use grand() instead. Examples (clearer, shorter, and more powerful) follow:
53             <para/>
54             <para>
55             100 10-point wide steps with random amplitudes of normal distribution
56             of mean 1 and standard deviation 0.7:
57             </para>
58             <programlisting role="example"><![CDATA[
59             u = grand(1,100,"nor",1,0.7) .*. ones(1,10);
60             clf, plot(u);
61             ]]></programlisting>
62             <para/>
63             <para>
64             40 15-point wide steps with random amplitudes of uniform distribution in [1 3],
65             with initial level 0.5 and final level hold:
66             </para>
67             <programlisting role="example"><![CDATA[
68             width = 15;
69             u = grand(1,40, "unf", 1, 3) .*. ones(1,width);
70             u = [ones(1,8*width)*0.5, u, ones(1,5*width)*u($)];
71             clf, plot(u);
72             ]]></programlisting>
73         </warning>
74         <para>
75             <literal>noisegen()</literal> génère une fonction Scilab <literal>b = Noise(t)</literal>
76             où <literal>Noise(t)</literal> est une fonction constante par morceaux
77             (constante sur <literal>[k*pas, (k+1)*pas]</literal>). Les valeurs de chaque intervalle
78             constant sont aléatoires, i.i.d Gaussiennes à écart-type <literal>sig</literal>.
79             La fonction est constante pour <literal>t &lt;= 0</literal> et
80             <literal>t &gt;= Tmax</literal>.
81         </para>
82         <para>
83             <note>
84                 Remarque: des fonctions de génération aléatoires telles que <link linkend="rand">rand</link> et
85                 <link linkend="grand">grand</link> sont une alternative à la génération de bruit
86                 contenant un large panel de lois de distribution (voir exemple 2 ci-dessous).
87             </note>
88         </para>
89     </refsection>
90     <refsection>
91         <title>Exemples</title>
92         <para>
93             Exemple #1: noisegen()
94         </para>
95         <programlisting role="example"><![CDATA[
96 noisegen(0.5, 30, 1.0);
97 x = -5:0.01:35;
98 y = feval(x, Noise);
99 plot(x, y);
100  ]]></programlisting>
101         <scilab:image>
102             noisegen(0.5, 30, 1.0);
103             x = -5:0.01:35;
104             y = feval(x, Noise);
105             plot(x, y);
106         </scilab:image>
107         <para>
108             Exemple #2: rand()
109         </para>
110         <programlisting role="example"><![CDATA[
111 // Tracer un bruit blanc gaussien de moyenne nulle à variance 1.
112 // Pour utiliser une variance différente, multiplier rand() par la racine carrée de la variance.
113 t = 0:.5:30;
114 sig = 1; // Ecart-type du bruit blanc gaussien.
115 noise = sig*rand(t, "normal");
116 plot2d2(t, noise);
117  ]]></programlisting>
118         <scilab:image>
119             t = 0:.5:30;
120             sig = 1;
121             noise = sig*rand(t, "normal");
122             plot2d2(t, noise)
123         </scilab:image>
124     </refsection>
125     <refsection role="see also">
126         <title>Vori aussi</title>
127         <simplelist type="inline">
128             <member>
129                 <link linkend="rand">rand</link>
130             </member>
131             <member>
132                 <link linkend="grand">grand</link>
133             </member>
134         </simplelist>
135     </refsection>
136     <refsection role="history">
137         <title>Historique</title>
138         <revhistory>
139             <revision>
140                 <revnumber>6.1.0</revnumber>
141                 <revdescription>
142                     noisegen() is obsolete. It will be removed from Scilab 6.1.x.
143                     Please replace it with grand() and .*.
144                 </revdescription>
145             </revision>
146         </revhistory>
147     </refsection>
148 </refentry>