ea874df2420f53f61cd5ae357e738c9a84dd8a06
[scilab.git] / scilab / modules / graphics / help / ja_JP / 2d_plot / plot.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 - Fabrice Leray
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  *
15  -->
16 <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="plot">
17     <refnamediv>
18         <refname>plot</refname>
19         <refpurpose>2Dプロット</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>呼び出しの手順</title>
23         <synopsis>plot(y,&lt;LineSpec&gt;,&lt;GlobalProperty&gt;)
24             plot(x,y,&lt;LineSpec&gt;,&lt;GlobalProperty&gt;)
25             plot(x1,y1,&lt;LineSpec1&gt;,x2,y2,&lt;LineSpec2&gt;,...xN,yN,&lt;LineSpecN&gt;,&lt;GlobalProperty1&gt;,&lt;GlobalProperty2&gt;,..&lt;GlobalPropertyM&gt;
26             plot(&lt;axes_handle&gt;,...)
27         </synopsis>
28     </refsynopsisdiv>
29     <refsection role="parameters">
30         <title>引数</title>
31         <variablelist>
32             <varlistentry>
33                 <term>x</term>
34                 <listitem>
35                     <para>
36                         実数行列またはベクトル. 省略した場合, <literal>1:n</literal>であると
37                         仮定されます. ただし, <literal>n</literal>は<literal>y</literal>パラメータで
38                         指定された曲線の点の数です.
39                     </para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>y</term>
44                 <listitem>
45                     <para>
46                         実数行列またはベクトル. <literal>y</literal> はマクロまたはプリミティブ
47                         として定義された関数とすることもできます.
48                     </para>
49                 </listitem>
50             </varlistentry>
51             <varlistentry>
52                 <term>&lt;LineSpec&gt;</term>
53                 <listitem>
54                     <para>このオプション引数は文字列で
55                         線を描画する手法を指定するショートカットとして使用されます.
56                         <literal>LineSpec</literal>は指定済みの各<literal> y</literal> または <literal>{x,y}</literal>
57                         毎に一つ指定できます.
58                         <literal>LineSpec</literal>はLineStyle,MarkerおよびColorと同時に処理されます
59                         (<link linkend="LineSpec">LineSpec</link>参照).
60                         これらの指定子はプロットされた線において線の種類,マーカの種類および色を定義します.
61                     </para>
62                 </listitem>
63             </varlistentry>
64             <varlistentry>
65                 <term>&lt;GlobalProperty&gt;</term>
66                 <listitem>
67                     <para>このオプションの引数は,
68                         グローバルオブジェクトのプロパティを定義する
69                         一連の命令<literal>{PropertyName,PropertyValue}</literal>
70                         を表し,      このプロットで作成された全ての曲線に適用されます.
71                         利用可能なプロパティの全て参照するには
72                         <link linkend="GlobalProperty">GlobalProperty</link>を参照してください.
73                     </para>
74                 </listitem>
75             </varlistentry>
76             <varlistentry>
77                 <term>&lt;axes_handle&gt;</term>
78                 <listitem>
79                     <para>
80                         このオプションの引数は,カレントの軸ではなく <literal>axes_handle</literal>で
81                         指定した軸の内部にプロットが表示されることを指定します
82                         (<link linkend="gca">gca</link>参照).
83                     </para>
84                 </listitem>
85             </varlistentry>
86         </variablelist>
87     </refsection>
88     <refsection role="description">
89         <title>説明</title>
90         <para>
91             <literal>plot</literal> は一連の二次元曲線をプロットします.
92             <literal>plot</literal> はMatlab構文との互換性を改善するために
93             修正されています.
94             グラフィックの互換性を改善するために, Matlabユーザは
95             (<link linkend="plot2d">plot2d</link>ではなく)
96             <literal>plot</literal>を使用してください.
97         </para>
98         <para>データエントリ仕様 :</para>
99         <para>本節では,記述を明確化するため,オプションの引数
100             <literal>LineSpec</literal>および <literal>GlobalProperty</literal>
101             については言及しません.
102             これはこれらの引数は,
103             (<literal>"Xdata"</literal>,
104             <literal>"Ydata"</literal> および <literal>"Zdata"</literal> プロパティを
105             除く,
106             <link linkend="GlobalProperty">GlobalProperty</link>参照)
107             エントリデータと干渉しないためです.
108             これら全てのオプション引数を同時に指定することが可能です.
109         </para>
110         <para>
111             <literal>y</literal> がベクトルの場合, plot(y) はベクトル <literal>y</literal>
112             をベクトル <literal>1:size(y,'*')</literal>に対してプロットします.
113         </para>
114         <para>
115             <literal>y</literal>が行列の場合, plot(y) は<literal>y</literal>の各列を
116             <literal>1:size(y,1)</literal>に対してプロットします.
117         </para>
118         <para>
119             <literal>x</literal> および <literal>y</literal> がベクトルの場合, plot(x,y) は
120             ベクトル <literal>y</literal> をベクトル <literal>x</literal>に対してプロットします.
121             ベクトル<literal>x</literal> および
122             <literal>y</literal> の要素数は同じである必要があります.
123         </para>
124         <para>
125             <literal>x</literal> がベクトルで <literal>y</literal> が行列の場合, plot(x,y)
126             は <literal>y</literal> の各列をベクトル <literal>x</literal>に対してプロットします.
127             この場合,<literal>y</literal> の列の数は
128             <literal>x</literal> のエントリの数と同じである必要があります.
129         </para>
130         <para>
131             <literal>x</literal> と <literal>y</literal> が行列の場合, plot(x,y) は
132             <literal>y</literal> の各列を<literal>x</literal>の同じ列に対してプロットします.
133             この場合,<literal>x</literal> と<literal>y</literal> の大きさは同じである必要があります.
134         </para>
135         <para>
136             最後に, <literal>x</literal> または <literal>y</literal> が行列の場合,
137             ベクトルは行列の各行または各列に対してプロットされます.
138             この選択は,行列の行また列の次元にベクトルの行または列の次元のどちらが
139             一致するかに応じて行われます.
140             (<literal>x</literal> または <literal>y</literal> のみが)正方行列の場合,
141             列が行よりも優先されます(以下の例参照).
142         </para>
143         <para>
144             <warning>
145                 必要でかつ可能な場合,
146                 <literal>plot</literal> は,
147                 互換性がある次元を取得するため,
148                 <literal>x</literal> および <literal>y</literal>を転置し,警告を出力します.
149                 例えば,
150                 <literal>x</literal> が<literal>y</literal>の列と同じ行数を有する場合.
151                 <literal>y</literal> が正方の場合, 転置は行われません.
152             </warning>
153         </para>
154         <para>
155             <literal>y</literal> はマクロまたはプリミティブとして定義された関数と
156             することも可能です.この場合,
157             <literal>x</literal> データを(ベクトルまたは行列として)指定する必要があり,
158             対応する<literal>y(x)</literal>の計算が暗黙の内に行われます.
159         </para>
160         <para>
161             <literal>LineSpec</literal> と<literal>GlobalProperty</literal> 引数は
162             プロットをカスタマイズするために使用されます.
163             以下に利用可能な全オプションのリストを示します.
164         </para>
165         <variablelist>
166             <varlistentry>
167                 <term>LineSpec</term>
168                 <listitem>
169                     <para>このオプションは曲線の描画方法を簡便な方法で
170                         指定する際に使用されます.
171                         このオプションは,LineStyle, Marker および Color指定子を含む文字列とする
172                         必要があります.
173                     </para>
174                     <para>これらのリファレンスは曖昧さがないように
175                         文字列内で指定することが必要です(順番は重要ではありません).
176                         例えば,ダイヤモンド型の記号を付けた赤い長い破線を指定する場合,
177                         以下のように書くことができます:
178                         <literal>'r--d'</literal> , <literal>'--dire'</literal> または
179                         <literal>'--reddiam'</literal>  または他のあいまいでない命令,
180                         もしくは全体を指定する <literal>'diamondred--'</literal>
181                         (<link linkend="LineSpec">LineSpec</link>参照)
182                     </para>
183                     <para>
184                         線の種類,色,マーカの色(および大きさ)も
185                         ポリラインエンティティプロパティにより(再)設定できることに
186                         注意してください
187                         (<link linkend="polyline_properties">polyline_properties</link>参照).
188                     </para>
189                 </listitem>
190             </varlistentry>
191             <varlistentry>
192                 <term>GlobalProperty</term>
193                 <listitem>
194                     <para>
195                         このオプションは, <literal>LineSpec</literal>を使用する
196                         よりも多くのオプションを用いて曲線のプロット方法を指定できます.
197                         <literal>PropertyName</literal>を定義する文字列と
198                         その値である<literal>PropertyValue</literal>
199                         (<literal>PropertyName</literal>の型に依存して文字列または整数または...)
200                         の組で指定する必要があります.
201                         <literal>GlobalProperty</literal>により複数のプロパティ,
202                         つまり, LineSpec により利用可能なあらゆるプロパティ,
203                         マーカの色(表示色および背景色), 視認性, クリッピング, 曲線の太さ,
204                         を設定可能です.
205                         (<link linkend="GlobalProperty">GlobalProperty</link>参照)
206                     </para>
207                     <para>
208                         これらのプロパティは全て
209                         ポリラインエンティティプロパティ
210                         (<link linkend="polyline_properties">polyline_properties</link>参照)
211                         により(再)設定できることに注意してください.
212                     </para>
213                 </listitem>
214             </varlistentry>
215         </variablelist>
216     </refsection>
217     <refsection role="description">
218         <title>注意</title>
219         <para>デフォルトでは, 連続したプロットは重ね描きされます.
220             前のプロットを消去するには,
221             <literal>clf()</literal>を使用してください. <literal>auto_clear</literal> モードを
222             デフォルトで有効にするには,次のようにデフォルトの軸を編集してください:
223         </para>
224         <para>da=gda();</para>
225         <para>da.auto_clear = 'on'</para>
226         <para>
227             表示を改善するために<literal>plot</literal>関数が親の軸の
228             <literal>box</literal>プロパティを修正することがあります.
229             これは,親の軸が<literal>plot</literal>のコールにより作成されたか,
230             コール前に空である場合に行われます.
231             軸の一つが原点を中心にしている場合, ボックスは無効となります.
232             その他の場合, ボックスが有効になります.
233         </para>
234         <para>
235             ボックスプロパティと軸の配置に関する詳細については,
236             <link linkend="axes_properties">axes_properties</link>を参照ください.
237         </para>
238         <para>
239             色を指定しない場合,曲線をプロットする際にデフォルトの色テーブルが
240             使用されます.
241             複数の線を描画する際,plotコマンドは自動的に
242             このテーブルに基づき周期的に選択します.
243             以下に使用される色を示します:
244         </para>
245         <informaltable border="1">
246             <tr>
247                 <td>
248                     <literal>R</literal>
249                 </td>
250                 <td>
251                     <literal>G</literal>
252                 </td>
253                 <td>
254                     <literal>B</literal>
255                 </td>
256             </tr>
257             <tr>
258                 <td>0.</td>
259                 <td>0.</td>
260                 <td>1.</td>
261             </tr>
262             <tr>
263                 <td>0.</td>
264                 <td>0.5</td>
265                 <td>0.</td>
266             </tr>
267             <tr>
268                 <td>1.</td>
269                 <td>0.</td>
270                 <td>0.</td>
271             </tr>
272             <tr>
273                 <td>0.</td>
274                 <td>0.75</td>
275                 <td>0.75</td>
276             </tr>
277             <tr>
278                 <td>0.75</td>
279                 <td>0.</td>
280                 <td>0.75</td>
281             </tr>
282             <tr>
283                 <td>0.75</td>
284                 <td>0.75</td>
285                 <td>0.</td>
286             </tr>
287             <tr>
288                 <td>0.25</td>
289                 <td>0.25</td>
290                 <td>0.25</td>
291             </tr>
292         </informaltable>
293         <para/>
294         <para>
295             コマンド <literal>plot</literal> を入力することによりデモを見ることができます.
296         </para>
297     </refsection>
298     <refsection role="examples">
299         <title>例</title>
300         <programlisting role="example"><![CDATA[
301 // x 初期化
302 x=[0:0.1:2*%pi]';
303 //simple plot
304 plot(sin(x))
305  ]]></programlisting>
306         <scilab:image>
307             x=[0:0.1:2*%pi]';
308             plot(sin(x))
309         </scilab:image>
310         <programlisting role="example"><![CDATA[
311 clf()
312 x=[0:0.1:2*%pi]';
313 plot(x,sin(x))
314  ]]></programlisting>
315         <scilab:image>
316             x=[0:0.1:2*%pi]';
317             plot(x,sin(x))
318         </scilab:image>
319         <programlisting role="example"><![CDATA[
320 //複数プロット
321 x=[0:0.1:2*%pi]';
322 plot(x,[sin(x) sin(2*x) sin(3*x)])
323  ]]></programlisting>
324         <scilab:image>
325             x=[0:0.1:2*%pi]';
326             plot(x,[sin(x) sin(2*x) sin(3*x)])
327         </scilab:image>
328         <programlisting role="example"><![CDATA[
329 clf()
330 x=[0:0.1:2*%pi]';
331 // 右に軸
332 plot(x,sin(x))
333 a=gca(); // カレントの軸エンティティのハンドル
334 a.y_location ="right";
335  ]]></programlisting>
336         <scilab:image>
337             x=[0:0.1:2*%pi]';
338             plot(x,sin(x))
339             a=gca();
340             a.y_location ="right";
341         </scilab:image>
342         <programlisting role="example"><![CDATA[
343 x=[0:0.1:2*%pi]';
344 // (0,0)を中心とする軸
345 plot(x-4,sin(x),x+2,cos(x))
346 a=gca(); // 軸エンティティのハンドル
347 a.x_location = "origin";
348 a.y_location = "origin";
349 // plotにより作成されたエンティティに複数の処理を行う
350 isoview()
351 a=gca();
352 a.children // 軸の子のリスト : ここでは,2個のエンティティの複合子オブジェクト
353 poly1= a.children.children(2); //線分群のハンドルをpoly1 に保存
354 poly1.foreground = 4; // スタイルを変更する別の方法...
355 poly1.thickness = 3;  // ...曲線の太さ.
356 poly1.clip_state='off' // 制御をクリップ
357 isoview("off")
358  ]]></programlisting>
359         <scilab:image>
360             x=[0:0.1:2*%pi]';
361             plot(x-4,sin(x),x+2,cos(x))
362             a=gca();
363             a.x_location = "origin";
364             a.y_location = "origin";
365             a.children
366             poly1= a.children.children(2);
367             poly1.foreground = 4;
368             poly1.thickness = 3;
369             poly1.clip_state='off'
370         </scilab:image>
371         <programlisting role="example"><![CDATA[
372 //LineSpec と GlobalProperty の例:
373 clf();
374 t=0:%pi/20:2*%pi;
375 plot(t,sin(t),'ro-.',t,cos(t),'cya+',t,abs(sin(t)),'--mo')
376 scf(2)
377 plot([t ;t],[sin(t) ;cos(t)],'xdat',[1:2])
378 scf(3)
379 axfig3 = gca();
380 scf(4) // 空白のままにする
381 plot(axfig3,[t ;t],[sin(t) ;cos(t)],'zdat',[1:2],'marker','d','markerfac','green','markeredg','yel')
382 xdel(winsid())
383  ]]></programlisting>
384         <scilab:image>
385             t=0:%pi/20:2*%pi;
386             plot(t,sin(t),'ro-.',t,cos(t),'cya+',t,abs(sin(t)),'--mo')
387             scf(2)
388             plot([t ;t],[sin(t) ;cos(t)],'xdat',[1:2])
389             scf(3)
390             axfig3 = gca();
391             scf(4) // should remain blank
392             plot(axfig3,[t ;t],[sin(t) ;cos(t)],'zdat',[1:2],'marker','d','markerfac','green','markeredg','yel')
393         </scilab:image>
394         <programlisting role="example"><![CDATA[
395 //データ指定
396 t=-%pi:0.1:%pi;
397 size(t)
398 plot(t) // ベクトルtの大きさに対してyをプロット
399  ]]></programlisting>
400         <scilab:image>
401             t=-%pi:0.1:%pi;
402             size(t)
403             plot(t)
404         </scilab:image>
405         <programlisting role="example"><![CDATA[
406 t=-%pi:0.1:%pi;
407 plot(t,sin(t)); // tに対してsin(t)をプロット
408  ]]></programlisting>
409         <scilab:image>
410             t=-%pi:0.1:%pi;
411             plot(t,sin(t));
412         </scilab:image>
413         <programlisting role="example"><![CDATA[
414 t=[1     1     1     1
415    2     3     4     5
416    3     4     5     6
417    4     5     6     7];
418 plot(t) // 行の大きさに対してtの各列をプロット
419  ]]></programlisting>
420         <scilab:image>
421             t=[1     1     1     1
422             2     3     4     5
423             3     4     5     6
424             4     5     6     7];
425             plot(t) // plots each t column versus row size
426         </scilab:image>
427         <programlisting role="example"><![CDATA[
428 t=[1     1     1     1
429    2     3     4     5
430    3     4     5     6
431    4     5     6     7];
432 subplot(221)
433 plot(t,sin(t)); // 列毎にtに対してsin(t)をプロット
434 xtitle("sin(t) versus t")
435 subplot(222)
436 plot(t,sin(t)')
437 xtitle("sin(t)'' versus t")
438 subplot(223)
439 plot(t',sin(t))
440 a=gca();
441 a.data_bounds=[0 -1;7 1]; // y軸に隠された垂直線を表示
442 xtitle("sin(t) versus t''")
443 subplot(224)
444 plot(t',sin(t)')
445 xtitle("sin(t)'' versus t''")
446  ]]></programlisting>
447         <scilab:image>
448             t=[1     1     1     1
449             2     3     4     5
450             3     4     5     6
451             4     5     6     7];
452             subplot(221)
453             plot(t,sin(t)); // plots sin(t) versus t column by column this time
454             xtitle("sin(t) versus t")
455             subplot(222)
456             plot(t,sin(t)')
457             xtitle("sin(t)'' versus t")
458             subplot(223)
459             plot(t',sin(t))
460             a=gca();
461             a.data_bounds=[0 -1;7 1]; // to see the vertical line hidden by the y axis
462             xtitle("sin(t) versus t''")
463             subplot(224)
464             plot(t',sin(t)')
465             xtitle("sin(t)'' versus t''")
466         </scilab:image>
467         <programlisting role="example"><![CDATA[
468 t=[1     1     1     1
469    2     3     4     5
470    3     4     5     6
471    4     5     6     7];
472 //特別な場合1
473 //x : vector ([5 6 7 8]) and y : matrix (t)
474 x=[5 6 7 8]
475 plot(x,t);
476 plot(x',t); // idem, x はtに一致するように自動的に転置される (ここでは列)
477  ]]></programlisting>
478         <scilab:image>
479             t=[1     1     1     1
480             2     3     4     5
481             3     4     5     6
482             4     5     6     7];
483             x=[5 6 7 8];
484             plot(x',t);
485         </scilab:image>
486         <programlisting role="example"><![CDATA[
487 clf()
488 x=[5 6 7 8]
489 t=[1     1     1     1
490    2     3     4     5
491    3     4     5     6
492    4     5     6     7];
493 // Only one matching possibility case : how to make 4 identical plots in 4 manners...
494 // x is 1x4 (vector) and y is 4x5 (non square matrix)
495 subplot(221);
496 plot(x,[t [8;9;10;12]]');
497 subplot(222);
498 plot(x',[t [8;9;10;12]]);
499 subplot(223);
500 plot(x,[t [8;9;10;12]]');
501 subplot(224);
502 plot(x',[t [8;9;10;12]]');
503 clf()
504  ]]></programlisting>
505         <scilab:image>
506             x=[5 6 7 8]
507             t=[1     1     1     1
508             2     3     4     5
509             3     4     5     6
510             4     5     6     7];
511             // Only one matching possibility case : how to make 4 identical plots in 4 manners...
512             // x is 1x4 (vector) and y is 4x5 (non square matrix)
513             subplot(221);
514             plot(x',[t [8;9;10;12]]);
515             subplot(222);
516             plot(x',[t [8;9;10;12]]);
517             subplot(223);
518             plot(x',[t [8;9;10;12]]);
519             subplot(224);
520             plot(x',[t [8;9;10;12]]);
521         </scilab:image>
522         <programlisting role="example"><![CDATA[
523 t=[1     1     1     1
524    2     3     4     5
525    3     4     5     6
526    4     5     6     7];
527 //特別な場合2
528 // xまたはyのみが疎行列の場合
529 //x : matrix (t) と y  : vector ([1 2 3 4])
530 plot(t,[1 2 3 4]) // plot(t,[1 1 1 1;2 2 2 2;3 3 3 3;4 4 4 4])と同じ
531 plot(t,[1;2;3;4]) // 同じプロット
532 clf();
533  ]]></programlisting>
534         <scilab:image>
535             t=[1     1     1     1
536             2     3     4     5
537             3     4     5     6
538             4     5     6     7];
539             //Special case 2
540             // Case where only x or y is a square matrix
541             //x : matrix (t) and y  : vector ([1 2 3 4])
542             plot(t,[1 2 3 4]') // equivalent to plot(t,[1 1 1 1;2 2 2 2;3 3 3 3;4 4 4 4])
543         </scilab:image>
544         <programlisting role="example"><![CDATA[
545 t=[1     1     1     1
546    2     3     4     5
547    3     4     5     6
548    4     5     6     7];
549 clf();
550 cols = 1:4;
551 // cols is transposed : notice the priority given to the columns treatment
552 plot(t', cols) // equivalent to plot(t',[1 1 1 1;2 2 2 2;3 3 3 3;4 4 4 4])
553 plot(t', cols') // the same plot
554  ]]></programlisting>
555         <scilab:image>
556             t=[1     1     1     1
557             2     3     4     5
558             3     4     5     6
559             4     5     6     7];
560             clf();
561             cols = 1:4;
562             // cols is transposed : notice the priority given to the columns treatment
563             plot(t',cols') // the same plot
564         </scilab:image>
565         <programlisting role="example"><![CDATA[
566 // y はプリミティブで定義された関数
567 plot(1:0.1:10,sin) // plot(1:0.1:10,sin(1:0.1:10))と同じ
568  ]]></programlisting>
569         <scilab:image>
570             plot(1:0.1:10,sin)
571         </scilab:image>
572         <programlisting role="example"><![CDATA[
573 // ..マクロ:
574 deff('[y]=toto(x)','y=x.*x')
575 plot(1:10,toto)
576  ]]></programlisting>
577         <scilab:image>
578             deff('[y]=toto(x)','y=x.*x')
579             plot(1:10,toto)
580         </scilab:image>
581     </refsection>
582     <refsection role="see also">
583         <title>参照</title>
584         <simplelist type="inline">
585             <member>
586                 <link linkend="plot2d">plot2d</link>
587             </member>
588             <member>
589                 <link linkend="surf">surf</link>
590             </member>
591             <member>
592                 <link linkend="scf">scf</link>
593             </member>
594             <member>
595                 <link linkend="clf">clf</link>
596             </member>
597             <member>
598                 <link linkend="xdel">xdel</link>
599             </member>
600             <member>
601                 <link linkend="delete">delete</link>
602             </member>
603             <member>
604                 <link linkend="LineSpec">LineSpec</link>
605             </member>
606             <member>
607                 <link linkend="GlobalProperty">GlobalProperty</link>
608             </member>
609         </simplelist>
610     </refsection>
611 </refentry>