* Bug 16166 fixed: noisegen() obsolete
[scilab.git] / scilab / modules / cacsd / help / ja_JP / noisegen.xml
index bcac806..c560cb3 100644 (file)
@@ -16,7 +16,7 @@
 <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="ja" xml:id="noisegen">
     <refnamediv>
         <refname>noisegen</refname>
-        <refpurpose>ノイズ生成</refpurpose>
+        <refpurpose>ノイズ生成 <emphasis role="bold">(obsolete)</emphasis></refpurpose>
     </refnamediv>
     <refsynopsisdiv>
         <title>呼び出し手順</title>
     </refsynopsisdiv>
     <refsection>
         <title>説明</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>
             Scilab 関数 <literal>[b]=Noise(t)</literal>を生成します.
             ただし, <literal>Noise(t)</literal>は区分定数関数です
@@ -44,4 +68,16 @@ y=feval(x,Noise);
 plot(x,y);
  ]]></programlisting>
     </refsection>
+    <refsection role="history">
+        <title>履歴</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>