Fixed the build following license changes
[scilab.git] / scilab / modules / statistics / help / ja_JP / summaries / tabul.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) 2000 - INRIA - Carlos Klimann
5  * 
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  * === LICENSE_END ===
15  *
16  -->
17 <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="tabul">
18     <refnamediv>
19         <refname>tabul</refname>
20         <refpurpose>行列またはベクトルの値の頻度</refpurpose>
21     </refnamediv>
22     <refsynopsisdiv>
23         <title>呼び出し手順</title>
24         <synopsis>[m]=tabul(X [,order])</synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>パラメータ</title>
28         <variablelist>
29             <varlistentry>
30                 <term>X</term>
31                 <listitem>
32                     <para>ベクトルまたは行列 (実数または複素数または文字列)</para>
33                 </listitem>
34             </varlistentry>
35             <varlistentry>
36                 <term>order</term>
37                 <listitem>
38                     <para>(オプションの) 文字 "d" または "i" (デフォルト値: "d")を指定します</para>
39                 </listitem>
40             </varlistentry>
41             <varlistentry>
42                 <term>m</term>
43                 <listitem>
44                     <para>
45                         列行列 (<literal>X</literal> は数値ベクトルまたは行列)
46                         またはメンバー2つを有するリスト
47                         (<literal>X</literal> が文字列ベクトルまたは行列).
48                     </para>
49                 </listitem>
50             </varlistentry>
51         </variablelist>
52     </refsection>
53     <refsection>
54         <title>説明</title>
55         <para>
56             この関数は,数値または文字列のベクトルまたは行列<literal>X</literal>の
57             値の頻度を計算します :
58         </para>
59         <variablelist>
60             <varlistentry>
61                 <term>X が数値のベクトルまたは行列の場合</term>
62                 <listitem>
63                     <para>
64                         <literal>m</literal> は2列の行列で,
65                         最初の列には<literal>X</literal>の異なる値,
66                         他の列にはこれらの値の頻度が含まれます
67                         (m(i,2)はm(i,1)の出現頻度です).
68                     </para>
69                 </listitem>
70             </varlistentry>
71             <varlistentry>
72                 <term>X が文字列のベクトルまたは行列の場合</term>
73                 <listitem>
74                     <para>
75                         <literal>m</literal> はリストで,
76                         その最初のメンバーは  
77                         <literal>X</literal>の異なる値から構成される
78                         文字列(列)ベクトル,
79                         2番目のメンバーは
80                         その要素がこれらの値の頻度となる(列)ベクトルです
81                         (m(i)(2)は文字列m(i)(1)の出現頻度です).
82                     </para>
83                 </listitem>
84             </varlistentry>
85         </variablelist>
86         <para>
87             オプションのパラメータ<literal>order</literal> は,  "d" または "i" とする
88             必要があり (デフォルトは
89             order="d"), Xの異なる値がソートされる順序(降順(d)または昇順(i))を指定します.
90         </para>
91     </refsection>
92     <refsection>
93         <title>例</title>
94         <programlisting role="example"><![CDATA[ 
95 // 最初の例
96 X = [2 8 0 3 7 6 8 7 9 1 6 7 7 2 5 2 2 2 9 7]
97 m1 = tabul(X)
98 m2 = tabul(X, "i")
99 // 二番目の例
100 X = ["ba" "baba" "a" "A" "AA" "a" "aa" "aa" "aa" "A" "ba"]
101 m = tabul(X,"i")
102 // 3番目の例
103 n = 50000;
104 X = grand(n,1,"bin",70,0.5);
105 m = tabul(X,"i");
106 clf()
107 plot2d3(m(:,1), m(:,2)/n)
108 xtitle("empirical probabilities of B(70,0.5)")
109 // 最後の例 : scilabライセンスにおける単語の頻度を計算
110 text = read(SCI+"/COPYING",-1,1,"(A)");     // scilabライセンスを読む
111 bigstr = strcat(text," ");                  // 全ての行を一つの大きな文字列にする
112 sep =  [" " "," "." ";" "*" ":" "-" """"];  // 単語セパレータ
113 words = tokens(bigstr, sep);                // 大きな文字列を単語に分割
114 m = tabul(words);                           // 各単語の出現頻度を計算
115 [occ , p] = gsort(m(2));                    // 降順に頻度をソート
116 results = [m(1)(p) string(occ)]             // 結果を表示
117  ]]></programlisting>
118     </refsection>
119     <refsection role="see also">
120         <title>参照</title>
121         <simplelist type="inline">
122             <member>
123                 <link linkend="dsearch">dsearch</link>
124             </member>
125             <member>
126                 <link linkend="histplot">histplot</link>
127             </member>
128         </simplelist>
129     </refsection>
130     <refsection>
131         <title>参考文献</title>
132         <para>
133             Wonacott, T.H. &amp; Wonacott, R.J.; Introductory Statistics, 
134             fifth edition, J.Wiley &amp; Sons, 1990.
135         </para>
136     </refsection>
137 </refentry>