Misc fix after afaec81 953f96 d12faf
[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  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2018 - 2019 - Samuel GOUGEON
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"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
18           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
19           xml:lang="ja" xml:id="plot">
20     <refnamediv>
21         <refname>plot</refname>
22         <refpurpose>2Dプロット</refpurpose>
23     </refnamediv>
24     <refsynopsisdiv>
25         <title>呼び出しの手順</title>
26         <synopsis>
27             plot     // demo
28             plot(y)
29             plot(x, y)
30             plot(x, fun)
31             plot(x, list(fun, param))
32             plot(.., LineSpec)
33             plot(.., LineSpec, GlobalProperty)
34             plot(x1, y1, LineSpec1, x2,y2,LineSpec2,...xN, yN, LineSpecN, GlobalProperty1,.. GlobalPropertyM)
35             plot(x1,fun1,LineSpec1, x2,y2,LineSpec2,...xN,funN,LineSpecN, GlobalProperty1, ..GlobalPropertyM)
36             plot(logflag,...)
37             plot(axes_handle,...)
38         </synopsis>
39     </refsynopsisdiv>
40     <refsection role="parameters">
41         <title>引数</title>
42         <variablelist>
43             <varlistentry>
44                 <term>x</term>
45                 <listitem>
46                     <para>
47                         実数行列またはベクトル. 省略した場合, <literal>1:n</literal>であると
48                         仮定されます. ただし, <literal>n</literal>は<literal>y</literal>パラメータで
49                         指定された曲線の点の数です.
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>y</term>
55                 <listitem>
56                     <para>
57                         実数行列またはベクトル.
58                     </para>
59                 </listitem>
60             </varlistentry>
61             <varlistentry>
62                 <term>fun, fun1, ..</term>
63                 <listitem>
64                     <para>
65                         handle of a function, as in <literal>plot(x, sin)</literal>.
66                     </para>
67                     <para>
68                         If the function to plot needs some parameters as input arguments, the
69                         function and its parameters can be specified through a list, as in
70                         <literal>plot(x, list(delip, -0.4))</literal>
71                     </para>
72                 </listitem>
73             </varlistentry>
74             <varlistentry>
75                 <term>LineSpec</term>
76                 <listitem>
77                     <para>このオプション引数は文字列で
78                         線を描画する手法を指定するショートカットとして使用されます.
79                         <literal>LineSpec</literal>は指定済みの各<literal> y</literal> または <literal>{x,y}</literal>
80                         毎に一つ指定できます.
81                         <literal>LineSpec</literal>はLineStyle,MarkerおよびColorと同時に処理されます
82                         (<link linkend="LineSpec">LineSpec</link>参照).
83                         これらの指定子はプロットされた線において線の種類,マーカの種類および色を定義します.
84                     </para>
85                 </listitem>
86             </varlistentry>
87             <varlistentry>
88                 <term>GlobalProperty</term>
89                 <listitem>
90                     <para>このオプションの引数は,
91                         グローバルオブジェクトのプロパティを定義する
92                         一連の命令<literal>{PropertyName,PropertyValue}</literal>
93                         を表し,    このプロットで作成された全ての曲線に適用されます.
94                         利用可能なプロパティの全て参照するには
95                         <link linkend="GlobalProperty">GlobalProperty</link>を参照してください.
96                     </para>
97                 </listitem>
98             </varlistentry>
99             <varlistentry>
100                 <term>logflag</term>
101                 <listitem>
102                     <para>
103                         "ln" | "nl" | "ll" : 2-character word made of "l" standing for
104                         "<emphasis role="bold">L</emphasis>ogarithmic" or/and "n" standing for
105                         "<emphasis role="bold">N</emphasis>ormal". The first character applies to
106                         the X axis, the second to the Y axis. Hence, "ln" means that the X axis
107                         is logarithmic and the Y axis is normal. The default is "nn":
108                         both axes in normal scales.
109                     </para>
110                     <para>
111                         <literal>logflag</literal> must be used after <literal>axes_handle</literal>
112                         (if any) and before the first curve's data <literal>x</literal> or
113                         <literal>y</literal> or <literal>fun</literal>.
114                         It applies to all curves drawn by the <literal>plot(…)</literal> instruction.
115                     </para>
116                 </listitem>
117             </varlistentry>
118             <varlistentry>
119                 <term>axes_handle</term>
120                 <listitem>
121                     <para>
122                         このオプションの引数は,カレントの軸ではなく <literal>axes_handle</literal>で
123                         指定した軸の内部にプロットが表示されることを指定します
124                         (<link linkend="gca">gca</link>参照).
125                     </para>
126                 </listitem>
127             </varlistentry>
128         </variablelist>
129     </refsection>
130     <refsection role="description">
131         <title>説明</title>
132         <para>
133             <literal>plot</literal> は一連の二次元曲線をプロットします.
134             <literal>plot</literal> はMatlab構文との互換性を改善するために
135             修正されています.
136             グラフィックの互換性を改善するために, Matlabユーザは
137             (<link linkend="plot2d">plot2d</link>ではなく)
138             <literal>plot</literal>を使用してください.
139         </para>
140         <para>データエントリ仕様 :</para>
141         <para>本節では,記述を明確化するため,オプションの引数
142             <literal>LineSpec</literal>および <literal>GlobalProperty</literal>
143             については言及しません.
144             これはこれらの引数は,
145             (<literal>"Xdata"</literal>,
146             <literal>"Ydata"</literal> および <literal>"Zdata"</literal> プロパティを
147             除く,
148             <link linkend="GlobalProperty">GlobalProperty</link>参照)
149             エントリデータと干渉しないためです.
150             これら全てのオプション引数を同時に指定することが可能です.
151         </para>
152         <para>
153             <literal>y</literal> がベクトルの場合, plot(y) はベクトル <literal>y</literal>
154             をベクトル <literal>1:size(y,'*')</literal>に対してプロットします.
155         </para>
156         <para>
157             <literal>y</literal>が行列の場合, plot(y) は<literal>y</literal>の各列を
158             <literal>1:size(y,1)</literal>に対してプロットします.
159         </para>
160         <para>
161             <literal>x</literal> および <literal>y</literal> がベクトルの場合, plot(x,y) は
162             ベクトル <literal>y</literal> をベクトル <literal>x</literal>に対してプロットします.
163             ベクトル<literal>x</literal> および
164             <literal>y</literal> の要素数は同じである必要があります.
165         </para>
166         <para>
167             <literal>x</literal> がベクトルで <literal>y</literal> が行列の場合, plot(x,y)
168             は <literal>y</literal> の各列をベクトル <literal>x</literal>に対してプロットします.
169             この場合,<literal>y</literal> の列の数は
170             <literal>x</literal> のエントリの数と同じである必要があります.
171         </para>
172         <para>
173             <literal>x</literal> と <literal>y</literal> が行列の場合, plot(x,y) は
174             <literal>y</literal> の各列を<literal>x</literal>の同じ列に対してプロットします.
175             この場合,<literal>x</literal> と<literal>y</literal> の大きさは同じである必要があります.
176         </para>
177         <para>
178             最後に, <literal>x</literal> または <literal>y</literal> が行列の場合,
179             ベクトルは行列の各行または各列に対してプロットされます.
180             この選択は,行列の行また列の次元にベクトルの行または列の次元のどちらが
181             一致するかに応じて行われます.
182             (<literal>x</literal> または <literal>y</literal> のみが)正方行列の場合,
183             列が行よりも優先されます(以下の例参照).
184         </para>
185         <para>
186             <warning>
187                 必要でかつ可能な場合,
188                 <literal>plot</literal> は,
189                 互換性がある次元を取得するため,
190                 <literal>x</literal> および <literal>y</literal>を転置し,警告を出力します.
191                 例えば,
192                 <literal>x</literal> が<literal>y</literal>の列と同じ行数を有する場合.
193                 <literal>y</literal> が正方の場合, 転置は行われません.
194             </warning>
195         </para>
196         <para>
197             <literal>y</literal> はマクロまたはプリミティブとして定義された関数と
198             することも可能です.この場合,
199             <literal>x</literal> データを(ベクトルまたは行列として)指定する必要があり,
200             対応する<literal>y(x)</literal>の計算が暗黙の内に行われます.
201         </para>
202         <para>
203             <literal>LineSpec</literal> と<literal>GlobalProperty</literal> 引数は
204             プロットをカスタマイズするために使用されます.
205             以下に利用可能な全オプションのリストを示します.
206         </para>
207         <variablelist>
208             <varlistentry>
209                 <term>LineSpec</term>
210                 <listitem>
211                     <para>このオプションは曲線の描画方法を簡便な方法で
212                         指定する際に使用されます.
213                         このオプションは,LineStyle, Marker および Color指定子を含む文字列とする
214                         必要があります.
215                     </para>
216                     <para>これらのリファレンスは曖昧さがないように
217                         文字列内で指定することが必要です(順番は重要ではありません).
218                         例えば,ダイヤモンド型の記号を付けた赤い長い破線を指定する場合,
219                         以下のように書くことができます:
220                         <literal>'r--d'</literal> , <literal>'--dire'</literal> または
221                         <literal>'--reddiam'</literal>  または他のあいまいでない命令,
222                         もしくは全体を指定する <literal>'diamondred--'</literal>
223                         (<link linkend="LineSpec">LineSpec</link>参照)
224                     </para>
225                     <para>
226                         線の種類,色,マーカの色(および大きさ)も
227                         ポリラインエンティティプロパティにより(再)設定できることに
228                         注意してください
229                         (<link linkend="polyline_properties">polyline_properties</link>参照).
230                     </para>
231                 </listitem>
232             </varlistentry>
233             <varlistentry>
234                 <term>GlobalProperty</term>
235                 <listitem>
236                     <para>
237                         このオプションは, <literal>LineSpec</literal>を使用する
238                         よりも多くのオプションを用いて曲線のプロット方法を指定できます.
239                         <literal>PropertyName</literal>を定義する文字列と
240                         その値である<literal>PropertyValue</literal>
241                         (<literal>PropertyName</literal>の型に依存して文字列または整数または...)
242                         の組で指定する必要があります.
243                         <literal>GlobalProperty</literal>により複数のプロパティ,
244                         つまり, LineSpec により利用可能なあらゆるプロパティ,
245                         マーカの色(表示色および背景色), 視認性, クリッピング, 曲線の太さ,
246                         を設定可能です.
247                         (<link linkend="GlobalProperty">GlobalProperty</link>参照)
248                     </para>
249                     <para>
250                         これらのプロパティは全て
251                         ポリラインエンティティプロパティ
252                         (<link linkend="polyline_properties">polyline_properties</link>参照)
253                         により(再)設定できることに注意してください.
254                     </para>
255                 </listitem>
256             </varlistentry>
257         </variablelist>
258     </refsection>
259     <refsection role="description">
260         <title>注意</title>
261         <para>デフォルトでは, 連続したプロットは重ね描きされます.
262             前のプロットを消去するには,
263             <literal>clf()</literal>を使用してください. <literal>auto_clear</literal> モードを
264             デフォルトで有効にするには,次のようにデフォルトの軸を編集してください:
265         </para>
266         <para>da=gda();</para>
267         <para>da.auto_clear = 'on'</para>
268         <para>
269             表示を改善するために<literal>plot</literal>関数が親の軸の
270             <literal>box</literal>プロパティを修正することがあります.
271             これは,親の軸が<literal>plot</literal>のコールにより作成されたか,
272             コール前に空である場合に行われます.
273             軸の一つが原点を中心にしている場合, ボックスは無効となります.
274             その他の場合, ボックスが有効になります.
275         </para>
276         <para>
277             ボックスプロパティと軸の配置に関する詳細については,
278             <link linkend="axes_properties">axes_properties</link>を参照ください.
279         </para>
280         <para>
281             色を指定しない場合,曲線をプロットする際にデフォルトの色テーブルが
282             使用されます.
283             複数の線を描画する際,plotコマンドは自動的に
284             このテーブルに基づき周期的に選択します.
285             以下に使用される色を示します:
286         </para>
287         <informaltable border="1">
288             <tr>
289                 <th> <literal>R</literal> </th>
290                 <th> <literal>G</literal> </th>
291                 <th> <literal>B</literal> </th>
292             </tr>
293             <tr> <td>0.</td>   <td>0.</td>   <td>1.</td>   </tr>
294             <tr> <td>0.</td>   <td>0.5</td>  <td>0.</td>   </tr>
295             <tr> <td>1.</td>   <td>0.</td>   <td>0.</td>   </tr>
296             <tr> <td>0.</td>   <td>0.75</td> <td>0.75</td> </tr>
297             <tr> <td>0.75</td> <td>0.</td>   <td>0.75</td> </tr>
298             <tr> <td>0.75</td> <td>0.75</td> <td>0.</td>   </tr>
299             <tr> <td>0.25</td> <td>0.25</td> <td>0.25</td> </tr>
300         </informaltable>
301         <para/>
302         <para>
303             コマンド <literal>plot</literal> を入力することによりデモを見ることができます.
304         </para>
305     </refsection>
306     <refsection role="examples">
307         <title>例</title>
308         <para>
309             <emphasis role="bold">Choosing the normal or logarithmic plotting mode:</emphasis>
310         </para>
311         <programlisting role="example"><![CDATA[
312 gda().grid = [1 1]*color("grey70");
313 title(gda(), "fontsize", 3, "color", "lightseagreen", "fontname", "helvetica bold");
314
315 x = linspace(1e-1,100,1000);
316 xm = 35;
317 dx = 17;
318 G = exp(-((x-xm)/dx).^2/2)*30;
319
320 scf(1); clf
321
322 subplot(2,2,1), plot(x, G),       title("plot(x, y)")
323 subplot(2,2,2), plot("ln", x, G), title("semilog-x : plot(""ln"", x, y)"); gca().sub_ticks(1) = 8;
324 subplot(2,2,3), plot("nl", x, G), title("semilog-y : plot(""nl"", x, y)"); gca().sub_ticks(2) = 8;
325 subplot(2,2,4), plot("ll", x, G), title("loglog : plot(""ll"", x, y)");    gca().sub_ticks = [8 8];
326
327 sda();
328  ]]></programlisting>
329         <scilab:image>
330             gda().grid = [1 1]*color("grey70");
331             title(gda(), "", "fontsize", 3, "color", "lightseagreen", "fontname", "helvetica bold");
332
333             x = linspace(1e-1,100,1000);
334             xm = 35;
335             dx = 17;
336             G = exp(-((x-xm)/dx).^2/2)*30;
337             scf(1); clf
338             subplot(2,2,1), plot(x, G),       title("plot(x, y)")
339             subplot(2,2,2), plot("ln", x, G), title("semilog-x : plot(""ln"", x, y)")
340             gca().sub_ticks(1) = 8;
341             subplot(2,2,3), plot("nl", x, G), title("semilog-y : plot(""nl"", x, y)")
342             gca().sub_ticks(2) = 8;
343             subplot(2,2,4), plot("ll", x, G), title("loglog : plot(""ll"", x, y)")
344             gca().sub_ticks = [8 8];
345
346             gcf().axes_size = [750 520];
347             sda();
348         </scilab:image>
349         <para/>
350         <para>
351             <emphasis role="bold">Simple plot of a single curve:</emphasis>
352         </para>
353         <programlisting role="example"><![CDATA[
354 // Default abscissae = indices
355 subplot(1,2,1)
356 plot(sin(0:0.1:2*%pi))
357 xlabel("x indices")
358
359 // With explicit abscissae:
360 x = [0:0.1:2*%pi]';
361 subplot(1,2,2)
362 plot(x, sin(x))
363 xlabel("Specified abscissae")
364  ]]></programlisting>
365         <scilab:image>
366             // Default abscissae = indices
367             subplot(1,2,1)
368             plot(sin(0:0.1:2*%pi))
369             xlabel("x indices")
370
371             // With explicit abscissae:
372             x = [0:0.1:2*%pi]';
373             subplot(1,2,2)
374             plot(x, sin(x))
375             xlabel("Specified abscissae")
376
377             gcf().axes_size = [700 350];
378         </scilab:image>
379         <para/>
380         <para>
381             <emphasis role="bold">Multiple curves with shared abscissae:</emphasis>
382             Y: 1 column = 1 curve:
383         </para>
384         <programlisting role="example"><![CDATA[
385 clf
386 x = [0:0.1:2*%pi]';
387 plot(x, [sin(x) sin(2*x) sin(3*x)])
388  ]]></programlisting>
389         <scilab:image>
390             x=[0:0.1:2*%pi]';
391             plot(x,[sin(x) sin(2*x) sin(3*x)])
392
393             gcf().axes_size = [700 350];
394         </scilab:image>
395         <para/>
396         <para>
397             <emphasis role="bold">
398                 Specifying a macro or a builtin instead of explicit ordinates:
399             </emphasis>
400         </para>
401         <programlisting role="example"><![CDATA[
402 clf
403 subplot(2,2,1)         // sin() is a builtin
404 plot(1:0.1:10, sin)    // <=> plot(1:0.1:10, sin(1:0.1:10))
405 title("plot(x, sin)", "fontsize",3)
406
407 // with a macro:
408 deff('y = myFun(x)','y = x + rand(x)')
409 subplot(2,2,2)
410 plot(-3:0.1:5, myFun)
411 title("plot(x, myFun)", "fontsize",3)
412
413 // With functions with parameters:
414 subplot(2,2,3)
415 plot(1:0.05:7, list(delip, -0.4))  // <=> plot(1:0.05:7, delip(1:0.05:7,-0.4) )
416 title("plot(x, list(delip,-0.4))", "fontsize",3)
417
418 function Y = myPow(x,p)
419     [X,P] = ndgrid(x,p);
420     Y = X.^P;
421     m = max(abs(Y),"r");
422     for i = 1:size(Y,2)
423         Y(:,i) = Y(:,i)/m(i);
424     end
425 endfunction
426 x = -5:0.1:6;
427 subplot(2,2,4)
428 plot(x, list(myPow,1:5))
429 title("plot(x, list(myPow,1:5))", "fontsize",3)
430  ]]></programlisting>
431         <scilab:image><![CDATA[
432             subplot(2,2,1)         // sin() is a builtin
433             plot(1:0.1:10, sin)    // <=> plot(1:0.1:10, sin(1:0.1:10))
434             title("plot(x,sin)", "fontsize",3)
435
436             // with a macro:
437             deff('y = myFun(x)','y = x + rand(x)')
438             subplot(2,2,2)
439             plot(-3:0.1:5, myFun)
440             title("plot(x, myFun)", "fontsize",3)
441
442             // With functions with parameters:
443             subplot(2,2,3)
444             plot(1:0.05:7, list(delip, -0.4))  // <=> plot(1:0.05:7, delip(1:0.05:7,-0.4) )
445             title("plot(x, list(delip,-0.4))", "fontsize",3)
446
447             function Y = myPow(x,p)
448                 [X,P] = ndgrid(x,p);
449                 Y = X.^P;
450                 m = max(abs(Y),"r");
451                 for i = 1:size(Y,2)
452                     Y(:,i) = Y(:,i)/m(i);
453                 end
454             endfunction
455             x = -5:0.1:6;
456             subplot(2,2,4)
457             plot(x, list(myPow,1:5))
458             title("plot(x, list(myPow,1:5))", "fontsize",3)
459
460             gcf().axes_size = [730 500];
461         ]]></scilab:image>
462         <para/>
463         <para>
464             <emphasis role="bold">Setting curves simple styles when calling plot():</emphasis>
465         </para>
466         <programlisting role="example"><![CDATA[
467 clf
468 t = -%pi:%pi/20:2*%pi;
469 // sin() : in Red, with O marks, without line
470 // cos() : in Green, with + marks, with a solid line
471 // gaussian: in Blue, without marks, with dotted line
472 gauss = 1.5*exp(-(t/2-1).^2)-1;
473
474 plot(t,sin,'ro', t,cos,'g+-', t,gauss,':b')
475  ]]></programlisting>
476         <scilab:image><![CDATA[
477             t = -%pi:%pi/20:2*%pi;
478             // sin() : in Red, with O marks, without line
479             // cos() : in Green, with + marks, with a solid line
480             // gaussian: in Blue, without marks, with dotted line
481             gauss = 1.5*exp(-(t/2-1).^2)-1;
482
483             plot(t,sin,'ro', t,cos,'g+-', t,gauss,':b')
484
485             gcf().axes_size = [800 400];
486         ]]>
487         </scilab:image>
488         <para/>
489         <para>
490         Vertical segments between two curves, with automatic colors, and using Global properties
491         for markers styles. Targeting a defined axes.
492         </para>
493         <programlisting role="example"><![CDATA[
494 clf
495 subplot(1,3,3)
496 ax3 = gca();         // We will draw here later
497 xsetech([0 0 0.7 1]) // Defines the first Axes area
498 t = -3:%pi/20:7;
499 // Tuning markers properties
500 plot([t ;t],[sin(t) ;cos(t)],'marker','d','markerFaceColor','green','markerEdgeColor','yel')
501
502 // Targeting a defined axes
503 plot(ax3, t, sin)
504  ]]></programlisting>
505         <scilab:image><![CDATA[
506             clf
507             subplot(1,3,3)
508             ax3 = gca();         // We will draw here later
509             xsetech([0 0 0.7 1]) // Defines the first Axes area
510             t = -3:%pi/20:7;
511             // Tuning markers properties
512             plot([t ;t],[sin(t) ;cos(t)],'marker','d','markerFaceColor','green','markerEdgeColor','yel')
513
514             // Targeting a defined axes
515             plot(ax3, t, sin)
516
517             gcf().axes_size = [800 400];
518         ]]>
519         </scilab:image>
520         <para/>
521         <para/>
522         <para>
523             <emphasis role="bold">Case of a non-square Y matrix:</emphasis>
524             When it is consistent and required, X or/and Y data are
525             automatically transposed in order to become plottable.
526         </para>
527         <programlisting role="example"><![CDATA[
528 clf()
529 x = [5 6 7 8]
530 y = [1   1   1   1   8
531      2   3   4   5   9
532      3   4   5   6  10
533      4   5   6   7  12];
534
535 // Only one matching possibility case: how to make 4 identical plots in 4 manners...
536 // x is 1x4 (vector) and y is 4x5 (non square matrix)
537 subplot(221); plot(x', y , "o-");    // OK as is
538 subplot(222); plot(x , y , "o-");    // x is transposed
539 subplot(223); plot(x', y', "o-");    // y is transposed
540 subplot(224); plot(x , y', "o-");    // x and y are transposed
541  ]]></programlisting>
542         <scilab:image>
543             x = [5 6 7 8]
544             y = [1   1   1   1   8
545                  2   3   4   5   9
546                  3   4   5   6  10
547                  4   5   6   7  12];
548
549             // Only one matching possibility case: how to make 4 identical plots in 4 manners...
550             // x is 1x4 (vector) and y is 4x5 (non square matrix)
551             subplot(221); plot(x', y , "o-");    // OK as is
552             subplot(222); plot(x , y , "o-");    // x is transposed
553             subplot(223); plot(x', y', "o-");    // y is transposed
554             subplot(224); plot(x , y', "o-");    // x and y are transposed
555         </scilab:image>
556         <para>
557             <emphasis role="bold">Case of a square Y matrix, and X implicit or square:</emphasis>
558         </para>
559         <programlisting role="example"><![CDATA[
560 clf
561 t = [1   1   1   1
562      2   3   4   5
563      3   4   5   6
564      4   5   6   7];
565
566 subplot(231), plot(t,"o-") , title("plot(t)",  "fontsize",3)
567 subplot(234), plot(t',"o-"), title("plot(t'')", "fontsize",3)
568
569 subplot(232), plot(t,t,"o-") , title("plot(t, t)",  "fontsize",3)
570 subplot(233), plot(t,t',"o-"), title("plot(t,t'')", "fontsize",3)
571
572 subplot(235), plot(t', t,"o-"),  title("plot(t'', t)",   "fontsize",3)
573 subplot(236), plot(t', t',"o-"), title("plot(t'', t'')", "fontsize",3)
574
575 for i=1:6, gcf().children(i).data_bounds([1 3]) = 0.5; end
576  ]]></programlisting>
577         <scilab:image>
578             clf
579             t = [1   1   1   1
580                  2   3   4   5
581                  3   4   5   6
582                  4   5   6   7];
583
584             subplot(231), plot(t,"o-") , title("plot(t)",  "fontsize",3)
585             subplot(234), plot(t',"o-"), title("plot(t'')", "fontsize",3)
586
587             subplot(232), plot(t,t,"o-") , title("plot(t, t)",  "fontsize",3)
588             subplot(233), plot(t,t',"o-"), title("plot(t,t'')", "fontsize",3)
589
590             subplot(235), plot(t', t,"o-"),  title("plot(t'', t)",   "fontsize",3)
591             subplot(236), plot(t', t',"o-"), title("plot(t'', t'')", "fontsize",3)
592
593             for i=1:6, gcf().children(i).data_bounds([1 3]) = 0.5; end
594
595             gcf().axes_size = [800 450];
596         </scilab:image>
597         <para/>
598         <para>
599             <emphasis role="bold">Special cases of a matrix X and a vector Y:</emphasis>
600         </para>
601         <programlisting role="example"><![CDATA[
602 clf
603 X = [1   1   1   1
604      2   3   4   5
605      3   4   5   6
606      4   5   6   7];
607 y = [1 2 3 4];
608
609 subplot(221), plot(X, y,  "o-"), title("plot(X, row)",  "fontsize",3)
610         // equivalent to plot(t, [1 1 1 1; 2 2 2 2; 3 3 3 3; 4 4 4 4])
611 subplot(223), plot(X, y', "o-"), title("plot(X, col)  (row = col'')",  "fontsize",3)
612 subplot(222), plot(X',y,  "o-"), title("plot(X'', row)",  "fontsize",3)
613 subplot(224), plot(X',y', "o-"), title("plot(X'', col)  (row = col'')",  "fontsize",3)
614
615 for i = 1:4, gcf().children(i).data_bounds([1 3]) = 0.5; end
616  ]]></programlisting>
617         <scilab:image>
618             clf
619             X = [1   1   1   1
620                  2   3   4   5
621                  3   4   5   6
622                  4   5   6   7];
623             y = [1 2 3 4];
624
625             subplot(221), plot(X, y,  "o-"), title("plot(X, row)",  "fontsize",3)
626                     // equivalent to plot(t, [1 1 1 1; 2 2 2 2; 3 3 3 3; 4 4 4 4])
627             subplot(223), plot(X, y', "o-"), title("plot(X, col)  (row = col'')",  "fontsize",3)
628             subplot(222), plot(X',y,  "o-"), title("plot(X'', row)",  "fontsize",3)
629             subplot(224), plot(X',y', "o-"), title("plot(X'', col)  (row = col'')",  "fontsize",3)
630
631             for i = 1:4, gcf().children(i).data_bounds([1 3]) = 0.5; end
632         </scilab:image>
633         <para/>
634         <para/>
635         <para>
636             <emphasis role="bold">Post-tuning Axes and curves:</emphasis>
637         </para>
638         <programlisting role="example"><![CDATA[
639 x=[0:0.1:2*%pi]';
640 plot(x-4,sin(x),x+2,cos(x))
641
642 // (0,0)を中心とする軸
643 a=gca(); // 軸エンティティのハンドル
644 a.x_location = "origin";
645 a.y_location = "origin";
646 isoview on
647
648 // plotにより作成されたエンティティに複数の処理を行う
649 a.children // 軸の子のリスト : ここでは,2個のエンティティの複合子オブジェクト
650 poly1= a.children.children(2); //線分群のハンドルをpoly1 に保存
651 poly1.foreground = 4; // スタイルを変更する別の方法...
652 poly1.thickness = 3;  // ...曲線の太さ.
653 poly1.clip_state='off' // 制御をクリップ
654 isoview off
655  ]]></programlisting>
656         <scilab:image>
657             x = [0:0.1:2*%pi]';
658             plot(x-4,sin(x),x+2,cos(x))
659             a = gca();
660             a.x_location = "origin";
661             a.y_location = "origin";
662             isoview on
663             a.children
664             poly1 = a.children.children(2);
665             poly1.foreground = 4;
666             poly1.thickness = 3;
667             poly1.clip_state='off'
668             isoview off
669         </scilab:image>
670     </refsection>
671     <refsection role="see also">
672         <title>参照</title>
673         <simplelist type="inline">
674             <member>
675                 <link linkend="plot2d">plot2d</link>
676             </member>
677             <member>
678                 <link linkend="plot2d2">plot2d2</link>
679             </member>
680             <member>
681                 <link linkend="plot2d3">plot2d3</link>
682             </member>
683             <member>
684                 <link linkend="plot2d4">plot2d4</link>
685             </member>
686             <member>
687                 <link linkend="param3d">param3d</link>
688             </member>
689             <member>
690                 <link linkend="surf">surf</link>
691             </member>
692             <member>
693                 <link linkend="scf">scf</link>
694             </member>
695             <member>
696                 <link linkend="clf">clf</link>
697             </member>
698             <member>
699                 <link linkend="xdel">xdel</link>
700             </member>
701             <member>
702                 <link linkend="delete">delete</link>
703             </member>
704             <member>
705                 <link linkend="LineSpec">LineSpec</link>
706             </member>
707             <member>
708                 <link linkend="color_list">Named colors</link>
709             </member>
710             <member>
711                 <link linkend="GlobalProperty">GlobalProperty</link>
712             </member>
713         </simplelist>
714     </refsection>
715     <refsection role="history">
716         <title>履歴</title>
717         <revhistory>
718             <revision>
719                 <revnumber>6.0.1</revnumber>
720                 <revdescription>
721                     The "color"|"foreground", "markForeground", and "markBackground" GlobalProperty
722                     colors can now be chosen among the full predefined colors list, or by
723                     their "#RRGGBB" hexadecimal codes, or by their indices in the colormap.
724                 </revdescription>
725             </revision>
726             <revision>
727                 <revnumber>6.0.2</revnumber>
728                 <revdescription>
729                     Plotting a function fun(x, params) with input parameters is now possible with
730                     plot(x, list(fun, params)).
731                 </revdescription>
732             </revision>
733             <revision>
734                 <revnumber>6.1.0</revnumber>
735                 <revdescription>
736                     logflag option added.
737                 </revdescription>
738             </revision>
739         </revhistory>
740     </refsection>
741 </refentry>