index 6081568..4d5c9d5 100644 (file)
@@ -16,7 +16,9 @@
<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="en" xml:id="noisegen">
<refnamediv>
<refname>noisegen</refname>
-        <refpurpose>noise generation</refpurpose>
+        <refpurpose>
+            noise generation <emphasis role="bold">(obsolete)</emphasis>
+        </refpurpose>
</refnamediv>
<refsynopsisdiv>
<title>Syntax</title>
</refsection>
<refsection>
<title>Description</title>
+        <warning>
+            <literal>noisegen()</literal> is obsolete. It will be removed from Scilab 6.1.x.
+            Please use grand() instead. Examples (clearer, shorter, and more powerful) follow:
+            <para/>
+            <para>
+            100 10-point wide steps with random amplitudes of normal distribution
+            of mean 1 and standard deviation 0.7:
+            </para>
+            <programlisting role="example"><![CDATA[
+            u = grand(1,100,"nor",1,0.7) .*. ones(1,10);
+            clf, plot(u);
+            ]]></programlisting>
+            <para/>
+            <para>
+            40 15-point wide steps with random amplitudes of uniform distribution in [1 3],
+            with initial level 0.5 and final level hold:
+            </para>
+            <programlisting role="example"><![CDATA[
+            width = 15;
+            u = grand(1,40, "unf", 1, 3) .*. ones(1,width);
+            u = [ones(1,8*width)*0.5, u, ones(1,5*width)*u(\$)];
+            clf, plot(u);
+            ]]></programlisting>
+        </warning>
<para>
<literal>noisegen()</literal> generates a Scilab function <literal>b = Noise(t)</literal>
where <literal>Noise(t)</literal> is a piecewise constant function
@@ -109,4 +135,16 @@ plot2d2(t, noise);
</member>
</simplelist>
</refsection>
+    <refsection role="history">
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>6.1.0</revnumber>
+                <revdescription>
+                    noisegen() is obsolete. It will be removed from Scilab 6.1.x.
+                    Please replace it with grand() and .*.
+                </revdescription>
+            </revision>
+        </revhistory>
+    </refsection>
</refentry>