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>