japanese translation updated for fftw module.
[scilab.git] / scilab / modules / fftw / help / ja_JP / fftw_flags.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) 2007 - INRIA
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
11  *
12  -->
13 <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="fftw_flags" xml:lang="ja">
14     <refnamediv>
15         <refname>fftw_flags</refname>
16         <refpurpose>fftプランナアルゴリズム選択用手法を設定する</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>[a,[S]]=fftw_flags(flag)</synopsis>
21     </refsynopsisdiv>
22     <refsection>
23         <title>引数</title>
24         <variablelist>
25             <varlistentry>
26                 <term>flag</term>
27                 <listitem>
28                     <para>
29                         文字列または整数. プランナアルゴリズムを指定.
30                         下記参照.
31                     </para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>a</term>
36                 <listitem>
37                     <para>整数. プランナコード.下記参照.
38                     </para>
39                 </listitem>
40             </varlistentry>
41             <varlistentry>
42                 <term>S</term>
43                 <listitem>
44                     <para>文字列行列. プランナ名.</para>
45                 </listitem>
46             </varlistentry>
47         </variablelist>
48     </refsection>
49     <refsection>
50         <title>説明</title>
51         <para>
52           この関数により,fftwプランナアルゴリズムを定義する際に
53           使用されるアルゴリズムを選択できます.
54           プランナはfftを計算する効率的な手法を定義する
55           際に使用されます.
56         </para>
57         <para>
58           <warning>
59             警告: デフォルト値 "FFTW_ESTIMATE" は通常かなり効率的な
60             プランです.
61             fft効率が実際に重要で
62             類似のコールを数多く行う場合にのみ変更を検討ください.
63           </warning>
64         </para>
65         <para>以下のエントリを指定可能です :</para>
66         <itemizedlist>
67             <listitem>
68                 <para>{FFTW_ESTIMATE} または 64. 
69                   これを指定すると, 他のアルゴリズムで使用される
70                   実際の観測量の代わりに, 
71                   (おそらく準最適の)プランを簡単に選択できる
72                   簡単な経験則が使用されます.
73                   このフラグを指定すると,
74                   入力/出力配列はプランニングの間は上書きされません.
75                   これがデフォルト値です.
76                 </para>
77             </listitem>
78             <listitem>
79                 <para>FFTW_MEASURE または 0. 
80                   実際に計算した複数回のFFTとそれらの実行時間
81                   の計測値から最適なプランをみつけるようFFTWに指示します.
82                   実行する計算機に依存した時間がかかります(通常は数秒).
83                 </para>
84             </listitem>
85             <listitem>
86                 <para>FFTW_PATIENT または 32. 
87                   "FFTW_MEASURE"と似ていますが, 
88                   より広範なアルゴリズムを検討し,しばしば
89                   "より最適な"プランを出力します
90                   (特に大規模な変換の場合).
91                   しかし,プランニング時間は数倍かかります
92                   (特に大規模な変換の場合).
93                 </para>
94             </listitem>
95             
96             <listitem>
97                 <para>FFTW_EXHAUSTIVE または 8. 
98                   "FFTW_PATIENT"に似ていますが, 
99                   高速と思われないようなものを多く含む
100                   さらにより広範なアルゴリズムを検討します.
101                   最も最適なプランを出力しますが,
102                   プランニング時間は著しく増加します.
103                 </para>
104             </listitem>
105         </itemizedlist>
106         
107         
108         <para>注意 : FFTW_MEASURE/FFTW_PATIENT/FFTW_EXHAUSTIVE を使用する時,
109           fftwを2回コールする必要があります.
110           (最初のコールは初期化用, 2回目以降は計算用)
111         </para>
112     </refsection>
113     <refsection>
114         <title>例</title>
115         <programlisting role="example"><![CDATA[ 
116 A=rand(1, 2^9 + 2^15);
117 fftw_forget_wisdom();
118 fftw_flags("FFTW_ESTIMATE");
119 timer(); y=fft(A); timer()//最初のコールでプランを定義
120 timer(); y=fft(A); timer() //同じコールを続ける
121 fftw_flags("FFTW_MEASURE");
122 fftw_forget_wisdom();
123 timer(); y=fft(A); timer()//最初のコールでプランを定義, 5分ほどかかる
124 timer(); y=fft(A); timer() //同じコールを続ける
125
126  ]]></programlisting>
127     </refsection>
128     <refsection>
129         <title>参考</title>
130         <simplelist type="inline">
131             <member>
132                 <link linkend="fft">fft</link>
133             </member>
134             <member>
135                 <link linkend="set_fftw_wisdom">set_fftw_wisdom</link>
136             </member>
137             <member>
138                 <link linkend="get_fftw_wisdom">get_fftw_wisdom</link>
139             </member>
140             <member>
141                 <link linkend="fftw_forget_wisdom">fftw_forget_wisdom</link>
142             </member>
143         </simplelist>
144     </refsection>
145 </refentry>