update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / 2d_plot / histplot.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4
5  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
6
7  * Copyright (C) INRIA - Serge Steer
8
9  *
10
11  * This file must be used under the terms of the CeCILL.
12
13  * This source file is licensed as described in the file COPYING, which
14
15  * you should have received as part of this distribution.  The terms
16
17  * are also available at
18
19  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
20
21  *
22
23  -->
24
25 <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="histplot">
26     
27     <refnamediv>
28         
29         <refname>histplot</refname>
30         
31         <refpurpose>ヒストグラムをプロットする</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>
40             
41             [cf, ind] = histplot(n, data [,normalization] [,polygon], &lt;opt_args&gt;)
42             
43             [cf, ind] = histplot(x, data [,normalization] [,polygon], &lt;opt_args&gt;)
44             
45         </synopsis>
46         
47     </refsynopsisdiv>
48     
49     <refsection>
50         
51         <title>引数</title>
52         
53         <variablelist>
54             
55             <varlistentry>
56                 
57                 <term>n</term>
58                 
59                 <listitem>
60                     
61                     <para>正の整数 (クラスの数)</para>
62                     
63                 </listitem>
64                 
65             </varlistentry>
66             
67             <varlistentry>
68                 
69                 <term>x</term>
70                 
71                 <listitem>
72                     
73                     <para>
74                         
75                         クラスを定義する増加方向のベクトル (<literal>x</literal>は2個以上の要素を有します)
76                         
77                     </para>
78                     
79                 </listitem>
80                 
81             </varlistentry>
82             
83             <varlistentry>
84                 
85                 <term>data</term>
86                 
87                 <listitem>
88                     
89                     <para>ベクトル (解析するデータ)</para>
90                     
91                 </listitem>
92                 
93             </varlistentry>
94             
95             <varlistentry>
96                 
97                 <term>normalization</term>
98                 
99                 <listitem>
100                     
101                     <para>論理値 (%t (デフォルト値) または %f)</para>
102                     
103                 </listitem>
104                 
105             </varlistentry>
106             
107             <varlistentry>
108                 
109                 <term>polygon</term>
110                 
111                 <listitem>
112                     
113                     <para>論理値 (%t または %f (デフォルト値))</para>
114                     
115                 </listitem>
116                 
117             </varlistentry>
118             
119             <varlistentry>
120                 
121                 <term>&lt;opt_args&gt;</term>
122                 
123                 <listitem>
124                     
125                     <para>
126                         
127                         一連の命令 <literal>key1=value1,key2=value2</literal>
128                         
129                         ,... を表します.ただし,<literal>key1</literal>,
130                         
131                         <literal>key2,...</literal> は任意の<link linkend="plot2d">plot2d</link> の
132                         
133                         オプションのパラメータ
134                         
135                         (<literal>style,strf,leg, rect,nax, logflag,frameflag, axesflag </literal>)
136                         
137                         とすることができます.
138                         
139                     </para>
140                     
141                 </listitem>
142                 
143             </varlistentry>
144             
145             <varlistentry>
146                 
147                 <term>cf</term>
148                 
149                 <listitem>
150                     
151                     <para>
152                         
153                         これは一連の命令 <literal>key1=value1,key2=value2</literal>,...を表します.
154                         
155                         ただし, <literal>key1</literal>,
156                         
157                         <literal>key2,...</literal> は,
158                         
159                         <link linkend="plot2d">plot2d</link>の任意のオプションパラメータ
160                         
161                         (<literal>style,strf,leg, rect,nax, logflag,frameflag, axesflag </literal>)
162                         
163                         とすることができます.
164                         
165                     </para>
166                     
167                 </listitem>
168                 
169             </varlistentry>
170             
171             <varlistentry>
172                 
173                 <term>ind</term>
174                 
175                 <listitem>
176                     
177                     <para>
178                         
179                         これは一連の命令<literal>key1=value1,key2=value2</literal>
180                         
181                         ,...を表します. ただし,<literal>key1</literal>,
182                         
183                         <literal>key2,...</literal> は,
184                         
185                         <link linkend="plot2d">plot2d</link>の任意のオプションパラメータ
186                         
187                         (<literal>style,strf,leg, rect,nax, logflag,frameflag, axesflag </literal>)
188                         
189                         とすることができます.
190                         
191                     </para>
192                     
193                 </listitem>
194                 
195             </varlistentry>
196             
197         </variablelist>
198         
199     </refsection>
200     
201     <refsection>
202         
203         <title>説明</title>
204         
205         <para>
206             
207             この関数は,クラス<literal>x</literal>を用いて<literal>data</literal>ベクトル
208             
209             のヒストグラム(柱状グラフ)をプロットします.
210             
211             <literal>x</literal>のかわりにクラスの数<literal>n</literal>が指令された場合,
212             
213             クラスは等間隔で<emphasis>dx = (x(n+1)-x(1))/n</emphasis>として
214             
215             <emphasis>x(1) = min(data) &lt;  x(2) = x(1) + dx  &lt;  ...  &lt; x(n+1) = max(data)</emphasis>
216             
217             となるように選択されます.
218             
219         </para>
220         
221         <para> 
222             
223             クラスはC1 = [x(1), x(2)]およびi &gt;= 2の時にCi = ( x(i), x(i+1)]
224             
225             により定義されます.
226             
227             <literal>data</literal>の総数 Nmax  (Nmax = length(data))となり,
228             
229             Ciに含まれる<literal>data</literal>要素の数 Niは
230             
231             <literal>normalization</literal>が true (デフォルト)の場合には
232             
233             <emphasis>Ni/(Nmax (x(i+1)-x(i)))</emphasis>となります.
234             
235             そうでない場合, <emphasis>Ni</emphasis> となります.
236             
237             正規化が行われる場合,このヒストグラムは以下の制約を満たします:
238             
239         </para>
240         
241         <para>
242             
243             <latex style="display"><![CDATA[ \int_{x(1)}^{x(n+1)}h(x)\,\mathrm{d}x=1 ]]></latex>
244             
245         </para>
246         
247         <para>
248             
249             任意の <link linkend="plot2d">plot2d</link> (オプション) パラメータを指定できます;
250             
251             例えば,色番号2 (標準カラーマップを使用する場合には青)のヒストグラムをプロットする場合や,
252             
253             矩形 [-3,3]x[0,0.5] の内側へのプロットを制限する場合,
254             
255             <literal>histplot(n,data, style=2, rect=[-3,0,3,0.5])</literal>
256             
257             を使用することができます.
258             
259         </para>
260         
261         <para>
262             
263             周波数ポリゴンは,ヒストグラムの全てのビンの頂部の中点をつなぐことにより描画されるグラフn
264             
265             線です.
266             
267             このため, ポリゴン周波数チャートをプロットするために
268             
269             <literal>histplot</literal> を使用できます.
270             
271         </para>
272         
273         <para>
274             
275             オプションの引数 <literal>polygon</literal> は,直線を有するヒストグラムの
276             
277             各バーの頂部の中点を接続します.
278             
279         </para>
280         
281         <para>
282             
283             <literal>polygon=%t</literal>の場合,
284             
285             周波数ポリゴンチャート付きのヒストグラムが出力されます.
286             
287         </para>
288         
289         <para>
290             
291             デモを参照するには <literal>histplot()</literal>コマンドを入力してください.
292             
293         </para>
294         
295     </refsection>
296     
297     <refsection>
298         
299         <title>例</title>
300         
301         <simplelist>
302             
303             <member>
304                 
305                 例 #1: ガウス乱数標本の種々のヒストグラム
306                 
307                 <programlisting role="example"><![CDATA[
308
309 d=rand(1,10000,'normal');  // ガウス乱数標本
310
311 clf();histplot(20,d)
312
313 clf();histplot(20,d,normalization=%f)
314
315 clf();histplot(20,d,leg='rand(1,10000,''normal'')',style=5)
316
317 clf();histplot(20,d,leg='rand(1,10000,''normal'')',style=16, rect=[-3,0,3,0.5]);
318
319 ]]></programlisting>
320                 
321                 <scilab:image>
322                     
323                     d=rand(1,10000,'normal');
324                     
325                     clf();histplot(20,d,leg='rand(1,10000,''normal'')',style=16, rect=[-3,0,3,0.5]);
326                     
327                 </scilab:image>
328                 
329             </member>
330             
331             <member>
332                 
333                 例 #2: 二項分布 (B(6,0.5)) 乱数標本のヒストグラム
334                 
335                 <programlisting role="example"><![CDATA[
336
337 d = grand(1000,1,"bin", 6, 0.5);
338
339 c = linspace(-0.5,6.5,8);
340
341 clf()
342
343 subplot(2,1,1)
344
345 histplot(c, d, style=2)
346
347 xtitle("normalized histogram")
348
349 subplot(2,1,2)
350
351 histplot(c, d, normalization=%f, style=5)
352
353 xtitle("non normalized histogram")
354
355 ]]></programlisting>
356                 
357                 <scilab:image localized="true">
358                     
359                     d = grand(1000,1,"bin", 6, 0.5);
360                     
361                     c = linspace(-0.5,6.5,8);
362                     
363                     clf()
364                     
365                     subplot(2,1,1)
366                     
367                     histplot(c, d, style=2)
368                     
369                     xtitle("normalized histogram")
370                     
371                     subplot(2,1,2)
372                     
373                     histplot(c, d, normalization=%f, style=5)
374                     
375                     xtitle("non normalized histogram")
376                     
377                 </scilab:image>
378                 
379             </member>
380             
381             <member>
382                 
383                 例 #3: 指数乱数標本のヒストグラム
384                 
385                 <programlisting role="example"><![CDATA[
386
387 lambda = 2;
388
389 X = grand(100000,1,"exp", 1/lambda);
390
391 Xmax = max(X);
392
393 clf()
394
395 histplot(40, X, style=2)
396
397 x = linspace(0,max(Xmax),100)';
398
399 plot2d(x,lambda*exp(-lambda*x),strf="000",style=5)
400
401 legend(["exponential random sample histogram" "exact density curve"]);
402
403 ]]></programlisting>
404                 
405                 <scilab:image localized="true">
406                     
407                     lambda = 2;
408                     
409                     X = grand(100000,1,"exp", 1/lambda);
410                     
411                     Xmax = max(X);
412                     
413                     clf()
414                     
415                     histplot(40, X, style=2)
416                     
417                     x = linspace(0,max(Xmax),100)';
418                     
419                     plot2d(x,lambda*exp(-lambda*x),strf="000",style=5)
420                     
421                     legend(["exponential random sample histogram" "exact density curve"]);
422                     
423                 </scilab:image>
424                 
425             </member>
426             
427             <member>
428                 
429                 例 #4: 周波数ポリゴンチャートおよびガウス乱数標本のヒストグラム
430                 
431                 <programlisting role="example"><![CDATA[
432
433 n=10;
434
435 data=rand(1,1000,"normal");
436
437 clf(); histplot(n, data, style=12, polygon=%t);
438
439 legend(["normalized histogram" "frequency polygon chart"]);
440
441 ]]></programlisting>
442                 
443                 <scilab:image localized="true">
444                     
445                     n=10;
446                     
447                     data=rand(1,1000,"normal");
448                     
449                     clf(); histplot(n,data,style=12,polygon=%t);
450                     
451                     legend(["normalized histogram" "frequency polygon chart"]);
452                     
453                 </scilab:image>
454                 
455             </member>
456             
457         </simplelist>
458         
459     </refsection>
460     
461     <refsection role="see also">
462         
463         <title>参照</title>
464         
465         <simplelist type="inline">
466             
467             <member>
468                 
469                 <link linkend="histc">histc</link>
470                 
471             </member>
472             
473             <member>
474                 
475                 <link linkend="hist3d">hist3d</link>
476                 
477             </member>
478             
479             <member>
480                 
481                 <link linkend="plot2d">plot2d</link>
482                 
483             </member>
484             
485             <member>
486                 
487                 <link linkend="bar">bar</link>
488                 
489             </member>
490             
491             <member>
492                 
493                 <link linkend="dsearch">dsearch</link>
494                 
495             </member>
496             
497         </simplelist>
498         
499     </refsection>
500     
501 </refentry>
502