update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / bar_histogram / barhomogenize.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 - Farid Belahcene
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="barhomogenize">
26     
27     <refnamediv>
28         
29         <refname>barhomogenize</refname>
30         
31         <refpurpose>カレントの軸に含まれる棒グラフを均質化する</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>barhomogenize()
40             
41             barhomogenize([h[,'style'[,'width']]])
42             
43         </synopsis>
44         
45     </refsynopsisdiv>
46     
47     <refsection>
48         
49         <title>パラメータ</title>
50         
51         <variablelist>
52             
53             <varlistentry>
54                 
55                 <term>h</term>
56                 
57                 <listitem>
58                     
59                     <para>軸ハンドル, (デフォルト: h=gca() ).</para>
60                     
61                 </listitem>
62                 
63             </varlistentry>
64             
65             <varlistentry>
66                 
67                 <term>style</term>
68                 
69                 <listitem>
70                     
71                     <para>文字列, 'grouped' または 'stacked' (デフォルト: 'grouped').</para>
72                     
73                 </listitem>
74                 
75             </varlistentry>
76             
77             <varlistentry>
78                 
79                 <term>width</term>
80                 
81                 <listitem>
82                     
83                     <para>(オプション), 実数スカラー, bar の幅 (利用可能な空間の割合) を定義
84                         
85                         (デフォルト: 0.8).
86                         
87                     </para>
88                     
89                 </listitem>
90                 
91             </varlistentry>
92             
93         </variablelist>
94         
95     </refsection>
96     
97     <refsection>
98         
99         <title>説明</title>
100         
101         <para>
102             
103             bar を複数回コールする場合,
104             
105             <literal>barhomogenize</literal> 関数は,カレントの軸に含まれる
106             
107             全ての棒(すなわち,<literal>polyline_style</literal> 6型)の幅とスタイルを
108             
109             均質化します.
110             
111             これらの棒は同じxデータを有する必要があります
112             
113         </para>
114         
115         <para>
116             
117             <literal>barhomogenize( ) :</literal> この場合,
118             
119             デフォルト値,h=gca(),
120             
121             width=0.8, style='grouped' が使用されます. <literal/>
122             
123         </para>
124         
125         <para>
126             
127             <literal>barhomogenize(h,...) :</literal> 
128             
129             描画対象のカレントの軸を定義します.
130             
131         </para>
132         
133         <para>
134             
135             <literal>barhomogenize(...,width,...) :</literal> 
136             
137             棒の幅をパーセント単位で定義します
138             
139             (通常: 0&lt;width&lt;=1).
140             
141         </para>
142         
143         <para>
144             
145             <literal>barhomogenize(...,style,...) :</literal> 
146             
147             棒の描画方法を定義します.
148             
149             オプション = 'grouped'により,
150             
151             M個のポリラインをxの各要素に対して中心に置くことができ,
152             
153             そして, オプション 'stacked' によりこれらをスタックすることができます.
154             
155         </para>
156         
157     </refsection>
158     
159     <refsection>
160         
161         <title>例</title>
162         
163         <scilab:image>
164             
165             subplot(2,3,1)
166             
167             xtitle('ex1: creation of 1 yellow bar and 3 bars')
168             
169             x=1:3;
170             
171             y1=1:3;
172             
173             y2=[4 3 5;6 7 8;9 10 11];
174             
175             bar(x,y1,'yellow');bar(x,y2);
176             
177             
178             
179             subplot(2,3,2) 
180             
181             xtitle('grouped homogenization')
182             
183             x=1:3;
184             
185             y1=1:3;
186             
187             y2=[4 3 5;6 7 8;9 10 11];
188             
189             bar(x,y1,'yellow');bar(x,y2);
190             
191             barhomogenize();
192             
193             
194             
195             subplot(2,3,3)
196             
197             xtitle('stacked homogenization')
198             
199             x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
200             
201             bar(x,y1,'yellow');bar(x,y2);
202             
203             barhomogenize('stacked',1);
204             
205         </scilab:image>
206         
207     </refsection>
208     
209     <refsection>
210         
211         <title>例</title>
212         
213         <programlisting role="example"><![CDATA[ 
214
215 // 最初の例: 黄色の棒を1つ (polyline_style=6のポリラインを1本)と棒を3つ (polyline_style=6のポリラインを3本) 
216
217 subplot(2,3,1)
218
219 xtitle('ex1: creation of 1 yellow bar and 3 bars ')
220
221 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
222
223 bar(x,y1,'yellow');bar(x,y2);
224
225 // これら4本の棒のグループとして均質化
226
227 subplot(2,3,2) 
228
229 xtitle('grouped homogenization')
230
231 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
232
233 bar(x,y1,'yellow');bar(x,y2);
234
235 barhomogenize('grouped',1);
236
237 // これら4本の棒のスタックとして統一化
238
239 subplot(2,3,3)
240
241 xtitle('stacked homogenization')
242
243 x=1:3; y1=1:3; y2=[4 3 5;6 7 8;9 10 11];
244
245 bar(x,y1,'yellow');bar(x,y2);
246
247 barhomogenize('stacked',1);
248
249
250
251 // 第2の例 : 赤色の棒を1つ (polyline_style=6のポリラインを1本) と type=1のポリラインを2本 (plot 関数をコール)
252
253 subplot(2,3,4)
254
255 xtitle('ex2: creation of 1 bar and 2 polylines')
256
257 x=1:10; y=sin(x)/2;
258
259 bar(x,y,'red')
260
261 x1=1:10;y1=[sin(x);cos(x)]
262
263 plot(x1,y1)
264
265 // 2本目のポリラインのpolyline_style 型をplotから修正 (このポリラインは棒になります)
266
267 subplot(2,3,5)
268
269 xtitle('transformation of the second polyline to bar')
270
271 x=1:10; y=sin(x)/2;
272
273 bar(x,y,'red')
274
275 x1=1:10;y1=[sin(x);cos(x)]
276
277 plot(x1,y1)
278
279 e=gce(); e2=e.children(2); e2.polyline_style=6;
280
281 // (bar 関数による)最初の棒(修正による)と2個目の棒の均質化. 
282
283 subplot(2,3,6)
284
285 xtitle('grouped homogenization')
286
287 x=1:10; y=sin(x)/2;
288
289 bar(x,y,'red')
290
291 x1=1:10;y1=[sin(x);cos(x)]
292
293 plot(x1,y1)
294
295 e=gce(); e2=e.children(2); e2.polyline_style=6;
296
297 barhomogenize();
298
299 // 幅とスタイルを変更
300
301 //barhomogenize('stacked',0.5);
302
303 //barhomogenize('stacked',1);
304
305  ]]></programlisting>
306         
307     </refsection>
308     
309     <refsection role="see also">
310         
311         <title>参照</title>
312         
313         <simplelist type="inline">
314             
315             <member>
316                 
317                 <link linkend="bar">bar</link>
318                 
319             </member>
320             
321             <member>
322                 
323                 <link linkend="polyline_properties">polyline_properties</link>
324                 
325             </member>
326             
327         </simplelist>
328         
329     </refsection>
330     
331 </refentry>
332