~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/signal_processing/help/ja_JP/cspect.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
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" version="5.0-subset Scilab" xml:id="cspect" xml:lang="ja">
3
 
  <refnamediv>
4
 
    <refname>cspect</refname>
5
 
    <refpurpose>
6
 
      相関法により2つの離散時間信号の間で推定する
7
 
      両側相互スペクトル
8
 
    </refpurpose>
9
 
  </refnamediv>
10
 
  <refsynopsisdiv>
11
 
    <title>呼び出し手順</title>
12
 
    <synopsis>
13
 
      [sm [,cwp]]=cspect(nlags,npoints,wtype,x [,y] [,wpar])
14
 
      [sm [,cwp]]=cspect(nlags,npoints,wtype,nx [,ny] [,wpar])
15
 
    </synopsis>
16
 
  </refsynopsisdiv>
17
 
  <refsection>
18
 
    <title>パラメータ</title>
19
 
    <variablelist>
20
 
      <varlistentry>
21
 
        <term>x</term>
22
 
        <listitem>
23
 
          <para>ベクトル, 最初の信号のデータ.</para>
24
 
        </listitem>
25
 
      </varlistentry>
26
 
      <varlistentry>
27
 
        <term>y</term>
28
 
        <listitem>
29
 
          <para>
30
 
            ベクトル, 二番目の信号のデータ. <literal>y</literal>を
31
 
            省略した場合,<literal>x</literal>に等しいと仮定されます(自己相関).
32
 
            指定された場合,<literal>x</literal>と同じ数の要素を有している必要が
33
 
            あります.
34
 
          </para>
35
 
        </listitem>
36
 
      </varlistentry>
37
 
      <varlistentry>
38
 
        <term>nx</term>
39
 
        <listitem>
40
 
          <para>
41
 
            スカラー : <literal>x</literal>信号の点の数. この場合,
42
 
            信号xのセグメントは<literal>getx</literal>という名前のユーザ定義の関数
43
 
            により読み込まれます (下記参照).
44
 
          </para>
45
 
        </listitem>
46
 
      </varlistentry>
47
 
      <varlistentry>
48
 
        <term>ny</term>
49
 
        <listitem>
50
 
          <para>スカラー : 
51
 
            <literal>y</literal>信号の点の数. この場合,
52
 
            <literal>y</literal>のセグメントが <literal>gety</literal>
53
 
            という名前のユーザ定義関数により読み込まれます (下記参照).
54
 
            指定された場合,<literal>ny</literal>は<literal>nx</literal>に
55
 
            等しくする必要があります.
56
 
          </para>
57
 
        </listitem>
58
 
      </varlistentry>
59
 
      <varlistentry>
60
 
        <term>nlags</term>
61
 
        <listitem>
62
 
          <para>相関遅延の数s (正の整数)</para>
63
 
        </listitem>
64
 
      </varlistentry>
65
 
      <varlistentry>
66
 
        <term>npoints</term>
67
 
        <listitem>
68
 
          <para>変換する点の数 (正の整数)</para>
69
 
        </listitem>
70
 
      </varlistentry>
71
 
      <varlistentry>
72
 
        <term>wtype</term>
73
 
        <listitem>
74
 
          <para>ウインドウ型</para>
75
 
          <itemizedlist>
76
 
            <listitem>
77
 
              <para>
78
 
                <literal>'re'</literal>: 矩形
79
 
              </para>
80
 
            </listitem>
81
 
            <listitem>
82
 
              <para>
83
 
                <literal>'tr'</literal>: 三角形
84
 
              </para>
85
 
            </listitem>
86
 
            <listitem>
87
 
              <para>
88
 
                <literal>'hm'</literal>: ハミング
89
 
              </para>
90
 
            </listitem>
91
 
            <listitem>
92
 
              <para>
93
 
                <literal>'hn'</literal> : ハニング
94
 
              </para>
95
 
            </listitem>
96
 
            <listitem>
97
 
              <para>
98
 
                <literal>'kr'</literal>: カイザー,この場合,wpar
99
 
                引数を指定する必要があります
100
 
              </para>
101
 
            </listitem>
102
 
            <listitem>
103
 
              <para>
104
 
                <literal>'ch'</literal>: チェビシェフ, この場合, wpar
105
 
                引数を指定する必要があります
106
 
              </para>
107
 
            </listitem>
108
 
          </itemizedlist>
109
 
        </listitem>
110
 
      </varlistentry>
111
 
      <varlistentry>
112
 
        <term>wpar</term>
113
 
        <listitem>
114
 
          <para>
115
 
            <literal>Kaiser および Chebyshev
116
 
              ウインドウに関するオプションパラメータ:
117
 
            </literal>
118
 
          </para>
119
 
          <itemizedlist>
120
 
            <listitem>
121
 
              <para>
122
 
                'kr': <literal>wpar は厳密に正の数である必要があります</literal>
123
 
              </para>
124
 
            </listitem>
125
 
            <listitem>
126
 
              <para>
127
 
                'ch': <literal>wpar</literal> は要素数2のベクトル
128
 
                <literal> [main_lobe_width,side_lobe_height]である必要があります.
129
 
                  ただし,
130
 
                </literal>
131
 
                <literal>0&lt;main_lobe_width&lt;.5</literal>, および
132
 
                <literal>side_lobe_height&gt;0</literal>
133
 
              </para>
134
 
            </listitem>
135
 
          </itemizedlist>
136
 
        </listitem>
137
 
      </varlistentry>
138
 
      <varlistentry>
139
 
        <term>sm</term>
140
 
        <listitem>
141
 
          <para>
142
 
            正規化された周波数の間隔<literal>[0,1]</literal>において
143
 
            パワースペクトルを推定します.
144
 
            大きさ<literal>npoints</literal>の行配列です.
145
 
            自己相関関数の場合は実数,
146
 
            相互相関関数の場合は複素数の配列です.
147
 
          </para>
148
 
        </listitem>
149
 
      </varlistentry>
150
 
      <varlistentry>
151
 
        <term>cwp</term>
152
 
        <listitem>
153
 
          <para>
154
 
            チェビシェフウインドウの場合は,チェビシェフウインドウのパラメータ
155
 
            の未指定のもの.
156
 
            指定されていないチェビシェフウインドウのパラメータ
157
 
          </para>
158
 
        </listitem>
159
 
      </varlistentry>
160
 
    </variablelist>
161
 
  </refsection>
162
 
  <refsection>
163
 
    <title>説明</title>
164
 
    <para>
165
 
      2つの信号<literal>x</literal> および <literal>y</literal>の
166
 
      信号の相互スペクトル,そうでない場合は <literal>x</literal>を計算します.
167
 
      スペクトル密度は相関法により得られます.
168
 
    </para>
169
 
    <para/>
170
 
    <para>
171
 
      <inlinemediaobject>
172
 
        <imageobject>
173
 
          <imagedata>
174
 
            <mml:math>
175
 
              <mml:semantics>
176
 
                <mml:mrow>
177
 
                  <mml:msub>
178
 
                    <mml:mi>S</mml:mi>
179
 
                    <mml:mi mml:fontstyle="italic">xy</mml:mi>
180
 
                  </mml:msub>
181
 
                  <mml:mrow>
182
 
                    <mml:mrow>
183
 
                      <mml:mo mml:stretchy="false">(</mml:mo>
184
 
                      <mml:mo mml:stretchy="false">ω</mml:mo>
185
 
                      <mml:mo mml:stretchy="false">)</mml:mo>
186
 
                    </mml:mrow>
187
 
                    <mml:mo mml:stretchy="false">=</mml:mo>
188
 
                    <mml:mfrac>
189
 
                      <mml:mn>1</mml:mn>
190
 
                      <mml:mi>N</mml:mi>
191
 
                    </mml:mfrac>
192
 
                  </mml:mrow>
193
 
                  <mml:mrow>
194
 
                    <mml:mo mml:stretchy="false">(</mml:mo>
195
 
                    <mml:mrow>
196
 
                      <mml:mrow>
197
 
                        <mml:munderover>
198
 
                          <mml:mo mml:stretchy="false">∑</mml:mo>
199
 
                          <mml:mrow>
200
 
                            <mml:mi>n</mml:mi>
201
 
                            <mml:mo mml:stretchy="false">=</mml:mo>
202
 
                            <mml:mn>0</mml:mn>
203
 
                          </mml:mrow>
204
 
                          <mml:mrow>
205
 
                            <mml:mi>N</mml:mi>
206
 
                            <mml:mo mml:stretchy="false">−</mml:mo>
207
 
                            <mml:mn>1</mml:mn>
208
 
                          </mml:mrow>
209
 
                        </mml:munderover>
210
 
                        <mml:mi>x</mml:mi>
211
 
                      </mml:mrow>
212
 
                      <mml:mrow>
213
 
                        <mml:mo mml:stretchy="false">(</mml:mo>
214
 
                        <mml:mi>n</mml:mi>
215
 
                        <mml:mo mml:stretchy="false">)</mml:mo>
216
 
                      </mml:mrow>
217
 
                      <mml:msup>
218
 
                        <mml:mi>e</mml:mi>
219
 
                        <mml:mrow>
220
 
                          <mml:mrow>
221
 
                            <mml:mo mml:stretchy="false">−</mml:mo>
222
 
                            <mml:mi>i</mml:mi>
223
 
                          </mml:mrow>
224
 
                          <mml:mo mml:stretchy="false">ω</mml:mo>
225
 
                          <mml:mi>n</mml:mi>
226
 
                        </mml:mrow>
227
 
                      </mml:msup>
228
 
                    </mml:mrow>
229
 
                    <mml:mo mml:stretchy="false">)</mml:mo>
230
 
                  </mml:mrow>
231
 
                  <mml:mrow>
232
 
                    <mml:mo mml:stretchy="false">(</mml:mo>
233
 
                    <mml:mrow>
234
 
                      <mml:mrow>
235
 
                        <mml:munderover>
236
 
                          <mml:mo mml:stretchy="false">∑</mml:mo>
237
 
                          <mml:mrow>
238
 
                            <mml:mi>n</mml:mi>
239
 
                            <mml:mo mml:stretchy="false">=</mml:mo>
240
 
                            <mml:mn>0</mml:mn>
241
 
                          </mml:mrow>
242
 
                          <mml:mrow>
243
 
                            <mml:mi>N</mml:mi>
244
 
                            <mml:mo mml:stretchy="false">−</mml:mo>
245
 
                            <mml:mn>1</mml:mn>
246
 
                          </mml:mrow>
247
 
                        </mml:munderover>
248
 
                        <mml:mover mml:accent="true">
249
 
                          <mml:mi>y</mml:mi>
250
 
                          <mml:mo mml:stretchy="false">ˉ</mml:mo>
251
 
                        </mml:mover>
252
 
                      </mml:mrow>
253
 
                      <mml:mrow>
254
 
                        <mml:mo mml:stretchy="false">(</mml:mo>
255
 
                        <mml:mi>n</mml:mi>
256
 
                        <mml:mo mml:stretchy="false">)</mml:mo>
257
 
                      </mml:mrow>
258
 
                      <mml:msup>
259
 
                        <mml:mi>e</mml:mi>
260
 
                        <mml:mrow>
261
 
                          <mml:mi>i</mml:mi>
262
 
                          <mml:mo mml:stretchy="false">ω</mml:mo>
263
 
                          <mml:mi>n</mml:mi>
264
 
                        </mml:mrow>
265
 
                      </mml:msup>
266
 
                    </mml:mrow>
267
 
                    <mml:mo mml:stretchy="false">)</mml:mo>
268
 
                  </mml:mrow>
269
 
                </mml:mrow>
270
 
                <mml:annotation mml:encoding="StarMath 5.0"> S_{xy}(%omega)={1}
271
 
                  over {N} (sum from{n=0} to{N-1} x(n)e^{-i %omega n}) ( sum
272
 
                  from{n=0} to{N-1} bar y(n)e^{i %omega n})
273
 
                </mml:annotation>
274
 
              </mml:semantics>
275
 
            </mml:math>
276
 
          </imagedata>
277
 
        </imageobject>
278
 
      </inlinemediaobject>
279
 
    </para>
280
 
    <para>The correlation method calculates the spectral estimate as the
281
 
      Fourier transform of a modified estimate of the auto/cross correlation
282
 
      function. This auto/cross correlation modified estimate consist of
283
 
      repeatedly calculating estimates of the autocorrelation function from
284
 
      overlapping sub-segments if the data, and then averaging these estimates
285
 
      to obtain the result.
286
 
    </para>
287
 
    <para>The number of points of the window is
288
 
      <literal>2*nlags-1.</literal>
289
 
    </para>
290
 
    <para>
291
 
      For batch processing, the<literal> x</literal> and
292
 
      <literal>y</literal> data may be read segment by segment using the
293
 
      <literal>getx </literal>and <literal>gety</literal> user defined
294
 
      functions. These functions have the following calling sequence:
295
 
    </para>
296
 
    <para>
297
 
      <literal>xk=getx(ns,offset)</literal> and
298
 
      <literal>yk=gety(ns,offset)</literal> where <literal>ns</literal> is the
299
 
      segment size and <literal>offset</literal> is the index of the first
300
 
      element of the segment in the full signal.
301
 
    </para>
302
 
  </refsection>
303
 
  <refsection>
304
 
    <title>警告</title>
305
 
    <para>5.0.2までのバージョンのScilabでは,返り値は
306
 
      現在の値の絶対値でした.
307
 
    </para>
308
 
  </refsection>
309
 
  <refsection>
310
 
    <title>参考文献</title>
311
 
    <para>Oppenheim, A.V., and R.W. Schafer. Discrete-Time Signal Processing,
312
 
      Upper Saddle River, NJ: Prentice-Hall, 1999
313
 
    </para>
314
 
  </refsection>
315
 
  <refsection>
316
 
    <title>例</title>
317
 
    <programlisting role="example"><![CDATA[ 
318
 
rand('normal');rand('seed',0);
319
 
x=rand(1:1024-33+1);
320
 
//eqfirでローパスフィルタを作成m
321
 
nf=33;bedge=[0 .1;.125 .5];des=[1 0];wate=[1 1];
322
 
h=eqfir(nf,bedge,des,wate);
323
 
//有色のデータを得るために白色のデータをフィルタ処理
324
 
h1=[h 0*ones(1:max(size(x))-1)];
325
 
x1=[x 0*ones(1:max(size(h))-1)];
326
 
hf=fft(h1,-1);   xf=fft(x1,-1);yf=hf.*xf;y=real(fft(yf,1));
327
 
sm=cspect(100,200,'tr',y);
328
 
smsize=max(size(sm));fr=(1:smsize)/smsize;
329
 
plot(fr,log(sm))
330
 
 ]]></programlisting>
331
 
  </refsection>
332
 
  <refsection role="see also">
333
 
    <title>参照</title>
334
 
    <simplelist type="inline">
335
 
      <member>
336
 
        <link linkend="pspect">pspect</link>
337
 
      </member>
338
 
      <member>
339
 
        <link linkend="mese">mese</link>
340
 
      </member>
341
 
      <member>
342
 
        <link linkend="corr">corr</link>
343
 
      </member>
344
 
    </simplelist>
345
 
  </refsection>
346
 
</refentry>