Graphics tests: fix histrogram references
[scilab.git] / scilab / modules / graphics / help / ja_JP / bar_histogram / bar.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) INRIA - Farid Belahcene
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: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="bar">
14     <refnamediv>
15         <refname>bar</refname>
16         <refpurpose>棒ヒストグラム</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>bar(y)
21             bar(x,y)
22             bar([h],x,y [,width [,color [,style]]])
23         </synopsis>
24     </refsynopsisdiv>
25     <refsection>
26         <title>引数</title>
27         <variablelist>
28             <varlistentry>
29                 <term>h</term>
30                 <listitem>
31                     <para>axes ハンドル, (デフォルト: h=gca() ).</para>
32                 </listitem>
33             </varlistentry>
34             <varlistentry>
35                 <term>y</term>
36                 <listitem>
37                     <para>実数スカラー, 大きさ Nのベクトル, または N*M行列.</para>
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>x</term>
42                 <listitem>
43                     <para>実数スカラー, 大きさ Nのベクトル, (デフォルト:  y がベクトルの場合,
44                         x はベクトルで xの長さはyの長さに等しくなります.
45                         yが行列の場合,xはベクトルとなりxの長さはyの行数と等しくなります.
46                     </para>
47                 </listitem>
48             </varlistentry>
49             <varlistentry>
50                 <term>width</term>
51                 <listitem>
52                     <para>(オプション), 実数スカラー, bar の幅 (利用可能な空間の割合) を定義
53                         (デフォルト: 0.8, すなわち 80%).
54                     </para>
55                 </listitem>
56             </varlistentry>
57             <varlistentry>
58                 <term>color</term>
59                 <listitem>
60                     <para>(オプション), 文字列 (デフォルト: 'blue'), カラーバーの内側の色を指定.</para>
61                 </listitem>
62             </varlistentry>
63             <varlistentry>
64                 <term>style:</term>
65                 <listitem>
66                     <para>文字列, 'grouped' または 'stacked' (デフォルト: 'grouped').</para>
67                 </listitem>
68             </varlistentry>
69         </variablelist>
70     </refsection>
71     <refsection>
72         <title>説明</title>
73         <para>
74             <literal>bar(y,...) :</literal> y がベクトルの場合, bar 関数は
75             <literal>polyline_style</literal>  6型を有するポリラインを描画します.
76             y がベクトルの場合, bar はベクトルyをベクトル1:size(y,'*')に対して
77             描画します. y が行列 N*M の場合, bar は M個のポリライン(6型)を描画し,
78             各ポリラインはyの列に対してベクトルx=1:size(y,1)に対応します.
79         </para>
80         <para>
81             <literal>bar(x,y,...) :</literal> yがベクトルの場合, bar 関数は
82             <literal>polyline_style</literal> 6型 を有するポリラインを描画します.
83             ただし, xの長さ = yの長さとなります.
84             y が行列 NxMの場合, bar 関数は6型 を有するM本のポリラインを描画します.
85             各ポリラインはyの列に対するベクトルxに対応します.
86         </para>
87         <para>
88             <literal>bar(h,...) :</literal> は描画を実行中のカレントの軸を定義します.
89         </para>
90         <para>
91             <literal>bar(...,width,...) :</literal> は棒の幅をパーセント単位で
92             定義します(通常: 0&lt;width&lt;=1).
93         </para>
94         <para>
95             <literal>bar(...,style,...) :</literal> は棒の描画方法を定義します.
96             y が行列 N*M の場合 (つまり, M本の6型ポリライン),
97             M個の棒を描画する方法が二種類あります.
98             styleオプション = 'grouped'により,
99             M個のポリラインをxの各要素に対して中心に置くことができます,
100             そして, style オプション 'stacked' によりこれらをスタックすることができます.
101         </para>
102         <para>
103             <literal>bar(...,color,...) : </literal>は,barの色を定義します.
104             bar関数は<literal>plot</literal>関数と同じカラーマップを使用します.
105         </para>
106         <para>barを複数回コールする場合,
107             <literal>barhomogenize</literal>関数により
108             カレントの軸に含まれる
109             全ての棒(すなわち,6型のポリライン)の幅とスタイルを統一できます.
110         </para>
111     </refsection>
112     <refsection>
113         <title>例</title>
114         <scilab:image>
115             y=[1 -3 5];
116             bar(y,0.5,'yellow');
117         </scilab:image>
118     </refsection>
119     <refsection>
120         <title>例</title>
121         <programlisting role="example"><![CDATA[
122 // 最初の例: 棒を描画 (すなわち,polyline_style type =6のポリライン) ただし,
123 // width=0.5 , color='yellow' で default style='grouped', x=1:length(y).
124 scf(0);
125 y=[1 -3 5];
126 bar(y,0.5,'yellow');
127  ]]></programlisting>
128
129         <programlisting role="example"><![CDATA[
130
131 // 2番目の例: 棒を 3 つ描画 (すなわち,polyline_style type =6の3個のポリライン),default style='grouped'
132 scf(1);
133 x=[1 2 5]; y=[1  -5 6;3 -2 7;4  -3 8];
134 bar(x,y);
135  ]]></programlisting>
136         <scilab:image>
137             x=[1 2 5];
138             y=[1  -5 6;3 -2 7;4  -3 8];
139             bar(x,y);
140         </scilab:image>
141         <programlisting role="example"><![CDATA[
142
143 // 3番目の例 : style='stacked'.
144 scf(2);
145 x=[1 2 5]; y=[1 4 7;2 5 8;3 6  9];
146 bar(x,y,'stacked');
147  ]]></programlisting>
148         <scilab:image>
149             x=[1 2 5];
150             y=[1 4 7;2 5 8;3 6  9];
151             bar(x,y,'stacked');
152         </scilab:image>
153         <programlisting role="example"><![CDATA[
154 // 4番目の例: width=0.2;color='green'; default style='grouped'
155 scf(3);
156 x=[1 2 5]; y=[1 4 7;2 5 8;3 6 9];
157 bar(x,y,0.2,'green');
158  ]]></programlisting>
159         <scilab:image>
160             x=[1 2 5];
161             y=[1 4 7;2 5 8;3 6 9];
162             bar(x,y,0.2,'green');
163         </scilab:image>
164     </refsection>
165     <refsection role="see also">
166         <title>参照</title>
167         <simplelist type="inline">
168             <member>
169                 <link linkend="barh">barh</link>
170             </member>
171             <member>
172                 <link linkend="barhomogenize">barhomogenize</link>
173             </member>
174             <member>
175                 <link linkend="plot">plot</link>
176             </member>
177             <member>
178                 <link linkend="histplot">histplot</link>
179             </member>
180             <member>
181                 <link linkend="polyline_properties">polyline_properties</link>
182             </member>
183         </simplelist>
184     </refsection>
185 </refentry>