Typo fixes
[scilab.git] / scilab / modules / graphics / help / ja_JP / bar_histogram / barhomogenize.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="barhomogenize">
14     <refnamediv>
15         <refname>barhomogenize</refname>
16         <refpurpose>カレントの軸に含まれる棒グラフを均質化する</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>barhomogenize()
21             barhomogenize([h[,'style'[,'width']]])
22         </synopsis>
23     </refsynopsisdiv>
24     <refsection>
25         <title>パラメータ</title>
26         <variablelist>
27             <varlistentry>
28                 <term>h</term>
29                 <listitem>
30                     <para>軸ハンドル, (デフォルト: h=gca() ).</para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>style</term>
35                 <listitem>
36                     <para>文字列, 'grouped' または 'stacked' (デフォルト: 'grouped').</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>width</term>
41                 <listitem>
42                     <para>(オプション), 実数スカラー, bar の幅 (利用可能な空間の割合) を定義
43                         (デフォルト: 0.8).
44                     </para>
45                 </listitem>
46             </varlistentry>
47         </variablelist>
48     </refsection>
49     <refsection>
50         <title>説明</title>
51         <para>
52             bar を複数回コールする場合,
53             <literal>barhomogenize</literal> 関数は,カレントの軸に含まれる
54             全ての棒(すなわち,<literal>polyline_style</literal> 6型)の幅とスタイルを
55             均質化します.
56             これらの棒は同じxデータを有する必要があります
57         </para>
58         <para>
59             <literal>barhomogenize( ) :</literal> この場合,
60             デフォルト値,h=gca(),
61             width=0.8, style='grouped' が使用されます. <literal/>
62         </para>
63         <para>
64             <literal>barhomogenize(h,...) :</literal> 
65             描画対象のカレントの軸を定義します.
66         </para>
67         <para>
68             <literal>barhomogenize(...,width,...) :</literal> 
69             棒の幅をパーセント単位で定義します
70             (通常: 0&lt;width&lt;=1).
71         </para>
72         <para>
73             <literal>barhomogenize(...,style,...) :</literal> 
74             棒の描画方法を定義します.
75             オプション = 'grouped'により,
76             M個のポリラインをxの各要素に対して中心に置くことができ,
77             そして, オプション 'stacked' によりこれらをスタックすることができます.
78         </para>
79     </refsection>
80     <refsection>
81         <title>例</title>
82         <scilab:image>
83             subplot(2,3,1)
84             xtitle('ex1: creation of 1 yellow bar and 3 bars')
85             x=1:3;
86             y1=1:3;
87             y2=[4 3 5;6 7 8;9 10 11];
88             bar(x,y1,'yellow');bar(x,y2);
89             
90             subplot(2,3,2) 
91             xtitle('grouped homogenization')
92             x=1:3;
93             y1=1:3;
94             y2=[4 3 5;6 7 8;9 10 11];
95             bar(x,y1,'yellow');bar(x,y2);
96             barhomogenize();
97             
98             subplot(2,3,3)
99             xtitle('stacked homogenization')
100             x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
101             bar(x,y1,'yellow');bar(x,y2);
102             barhomogenize('stacked',1);
103         </scilab:image>
104     </refsection>
105     <refsection>
106         <title>例</title>
107         <programlisting role="example"><![CDATA[ 
108 // 最初の例: 黄色の棒を1つ (polyline_style=6のポリラインを1本)と棒を3つ (polyline_style=6のポリラインを3本) 
109 subplot(2,3,1)
110 xtitle('ex1: creation of 1 yellow bar and 3 bars ')
111 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
112 bar(x,y1,'yellow');bar(x,y2);
113 // これら4本の棒のグループとして均質化
114 subplot(2,3,2) 
115 xtitle('grouped homogenization')
116 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
117 bar(x,y1,'yellow');bar(x,y2);
118 barhomogenize('grouped',1);
119 // これら4本の棒のスタックとして統一化
120 subplot(2,3,3)
121 xtitle('stacked homogenization')
122 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
123 bar(x,y1,'yellow');bar(x,y2);
124 barhomogenize('stacked',1);
125
126 // 第2の例 : 赤色の棒を1つ (polyline_style=6のポリラインを1本) と type=1のポリラインを2本 (plot 関数をコール)
127 subplot(2,3,4)
128 xtitle('ex2: creation of 1 bar and 2 polylines')
129 x=1:10; y=sin(x)/2;
130 bar(x,y,'red')
131 x1=1:10;y1=[sin(x);cos(x)]
132 plot(x1,y1)
133 // 2本目のポリラインのpolyline_style 型をplotから修正 (このポリラインは棒になります)
134 subplot(2,3,5)
135 xtitle('transformation of the second polyline to bar')
136 x=1:10; y=sin(x)/2;
137 bar(x,y,'red')
138 x1=1:10;y1=[sin(x);cos(x)]
139 plot(x1,y1)
140 e=gce(); e2=e.children(2); e2.polyline_style=6;
141 // (bar 関数による)最初の棒(修正による)と2個目の棒の均質化. 
142 subplot(2,3,6)
143 xtitle('grouped homogenization')
144 x=1:10; y=sin(x)/2;
145 bar(x,y,'red')
146 x1=1:10;y1=[sin(x);cos(x)]
147 plot(x1,y1)
148 e=gce(); e2=e.children(2); e2.polyline_style=6;
149 barhomogenize();
150 // 幅とスタイルを変更
151 //barhomogenize('stacked',0.5);
152 //barhomogenize('stacked',1);
153  ]]></programlisting>
154     </refsection>
155     <refsection role="see also">
156         <title>参照</title>
157         <simplelist type="inline">
158             <member>
159                 <link linkend="bar">bar</link>
160             </member>
161             <member>
162                 <link linkend="polyline_properties">polyline_properties</link>
163             </member>
164         </simplelist>
165     </refsection>
166 </refentry>