GPL + CeCILL Header change
[scilab.git] / scilab / modules / graphics / help / ja_JP / 2d_plot / plot2d.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
8
9  * Copyright (C) 2009 - DIGITEO - Pierre Lando
10
11  * Copyright (C) 2010 - DIGITEO - Yann Collette
12
13  * 
14
15
16  * Copyright (C) 2012 - 2016 - Scilab Enterprises
17  *
18  * This file is hereby licensed under the terms of the GNU GPL v2.0,
19  * pursuant to article 5.3.4 of the CeCILL v.2.1.
20  * This file was originally licensed under the terms of the CeCILL v2.1,
21  * and continues to be available under such terms.
22  * For more information, see the COPYING file which you should have received
23  * along with this program.
24  * === LICENSE_END ===
25
26  *
27
28  -->
29
30 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="plot2d" xml:lang="ja">
31     
32     <refnamediv>
33         
34         <refname>plot2d</refname>
35         
36         <refpurpose>2Dプロット</refpurpose>
37         
38     </refnamediv>
39     
40     <refsynopsisdiv>
41         
42         <title>呼び出し手順</title>
43         
44         <synopsis>
45             
46             plot2d([logflag,][x,],y[,style[,strf[,leg[,rect[,nax]]]]])
47             
48             plot2d([logflag,][x,],y,&lt;opt_args&gt;)
49             
50         </synopsis>
51         
52     </refsynopsisdiv>
53     
54     <refsection>
55         
56         <title>パラメータ</title>
57         
58         <variablelist>
59             
60             <varlistentry>
61                 
62                 <term>x</term>
63                 
64                 <listitem>
65                     
66                     <para>実数の行列またはベクトル. 省略された場合, 
67                         
68                         ベクトル<literal>1:n</literal>が指定されたと仮定します.
69                         
70                         ただし, <literal>n</literal>は<literal>y</literal>
71                         
72                         パラメータで指定された曲線の点の数です.
73                         
74                     </para>
75                     
76                 </listitem>
77                 
78             </varlistentry>
79             
80             <varlistentry>
81                 
82                 <term>y</term>
83                 
84                 <listitem>
85                     
86                     <para>実数の行列またはベクトル.</para>
87                     
88                 </listitem>
89                 
90             </varlistentry>
91             
92             <varlistentry>
93                 
94                 <term>&lt;opt_args&gt;</term>
95                 
96                 <listitem>
97                     
98                     <para>
99                         
100                         一連の命令 <literal>key1=value1,key2=value2</literal>,...
101                         
102                         を表します.
103                         
104                         ただし, <literal>key1</literal>, <literal>key2,...</literal>
105                         
106                         には以下のどれかを指定できます:
107                         
108                     </para>
109                     
110                     <variablelist>
111                         
112                         <varlistentry>
113                             
114                             <term>logflag</term>
115                             
116                             <listitem>
117                                 
118                                 <para>
119                                     
120                                     軸スケール (線形または対数)を設定します.
121                                     
122                                     値は文字列で, 以下の値のどれかを指定します:
123                                     
124                                     <literal>"nn"</literal>, <literal>"nl"</literal> ,
125                                     
126                                     <literal>"ln"</literal> および <literal>"ll"</literal> .
127                                     
128                                 </para>
129                                 
130                             </listitem>
131                             
132                         </varlistentry>
133                         
134                         <varlistentry>
135                             
136                             <term>style</term>
137                             
138                             に
139                             
140                             <listitem>
141                                 
142                                 <para>各曲線のスタイルを設定します.
143                                     
144                                     値は整数値(正または負)を有する実数ベクトルを指定します.
145                                     
146                                 </para>
147                                 
148                             </listitem>
149                             
150                         </varlistentry>
151                         
152                         <varlistentry>
153                             
154                             <term>strf</term>
155                             
156                             <listitem>
157                                 
158                                 <para>凡例の表示を制御します.</para>
159                                 
160                                 <para>
161                                     
162                                     <literal>strf</literal> は長さ3の文字列
163                                     
164                                     <literal>"xyz"</literal>です.
165                                     
166                                     (デフォルトでは,<literal>strf="081"</literal>)
167                                     
168                                 </para>
169                                 
170                             </listitem>
171                             
172                         </varlistentry>
173                         
174                         <varlistentry>
175                             
176                             <term>leg</term>
177                             
178                             <listitem>
179                                 
180                                 <para>曲線の凡例を設定します.
181                                     
182                                     値には文字列を指定します.
183                                     
184                                 </para>
185                                 
186                             </listitem>
187                             
188                         </varlistentry>
189                         
190                         <varlistentry>
191                             
192                             <term>rect</term>
193                             
194                             <listitem>
195                                 
196                                 <para>
197                                     
198                                     プロットに使用する最小限の領域を設定します.
199                                     
200                                     値には以下の4個のエントリを有する実数ベクトルを指定します:
201                                     
202                                     <literal>[xmin,ymin,xmax,ymax]</literal>.
203                                     
204                                 </para>
205                                 
206                             </listitem>
207                             
208                         </varlistentry>
209                         
210                         <varlistentry>
211                             
212                             <term>nax</term>
213                             
214                             <listitem>
215                                 
216                                 <para>軸ラベルと目盛の定義を設定します.
217                                     
218                                     値には4個の整数エントリ<literal>[nx,Nx,ny,Ny]</literal>を有する
219                                     
220                                     実数ベクトルを指定します.
221                                     
222                                 </para>
223                                 
224                             </listitem>
225                             
226                         </varlistentry>
227                         
228                         <varlistentry>
229                             
230                             <term>frameflag</term>
231                             
232                             <listitem>
233                                 
234                                 <para>指定された最小限の領域に基づく実際の座標系の範囲の
235                                     
236                                     計算を制御します.
237                                     
238                                     値には, 0 から 8までの範囲の整数を指定します.
239                                     
240                                 </para>
241                                 
242                             </listitem>
243                             
244                         </varlistentry>
245                         
246                         <varlistentry>
247                             
248                             <term>axesflag</term>
249                             
250                             <listitem>
251                                 
252                                 <para>軸の描画方法を指定します. 値には,
253                                     
254                                     0 から 5までの範囲の整数を指定します.
255                                     
256                                 </para>
257                                 
258                             </listitem>
259                             
260                         </varlistentry>
261                         
262                     </variablelist>
263                     
264                 </listitem>
265                 
266             </varlistentry>
267             
268         </variablelist>
269         
270     </refsection>
271     
272     <refsection>
273         
274         <title>説明</title>
275         
276         <para>
277             
278             <literal>plot2d</literal> は一連の2次元曲線をプロットします.
279             
280             Matlabの<literal>plot</literal>構文に慣れている場合には, 
281             
282             <link linkend="plot">plot</link>を使用するべきです.
283             
284         </para>
285         
286         <para>
287             
288             <literal>x</literal> および <literal>y</literal> がベクトルの場合,
289             
290             plot2d(x,y,&lt;opt_args&gt;) はベクトル <literal>y</literal> を
291             
292             ベクトル <literal>x</literal>に対してプロットします. 
293             
294             ベクトル<literal>x</literal> および <literal>y</literal>は
295             
296             同じ数のエントリを有する必要があります.
297             
298         </para>
299         
300         <para>
301             
302             <literal>x</literal> がベクトルで <literal>y</literal> が行列の場合,
303             
304             plot2d(x,y,&lt;opt_args&gt;) は<literal>y</literal>の各列を
305             
306             ベクトル<literal>x</literal>に対してプロットします.
307             
308             この場合,<literal>y</literal>の列の数は<literal>x</literal>
309             
310             のエントリの数に等しい必要があります.
311             
312         </para>
313         
314         <para>
315             
316             <literal>x</literal> および <literal>y</literal> が行列の場合,
317             
318             plot2d(x,y,&lt;opt_args&gt;) は<literal>y</literal>の各列を
319             
320             対応する<literal>x</literal>の列に対してプロットします.
321             
322             この場合,<literal>x</literal> と<literal>y</literal>の
323             
324             大きさは同じである必要があります.
325             
326         </para>
327         
328         <para>
329             
330             <literal>y</literal> がベクトルの場合, plot2d(y,&lt;opt_args&gt;)
331             
332             はベクトル <literal>y</literal> をベクトル
333             
334             <literal>1:size(y,'*')</literal>に対してプロットします.
335             
336         </para>
337         
338         <para>
339             
340             <literal>y</literal> が行列の場合, plot2d(y,&lt;opt_args&gt;)
341             
342             は<literal>y</literal>の各列をベクトル
343             
344             <literal>1:size(y,1)</literal>に対してプロットします.
345             
346         </para>
347         
348         <para>
349             
350             プロットをカスタマイズするために引数<literal>&lt;opt_args&gt;</literal> を
351             
352             使用することができます.
353             
354         </para>
355         
356         <variablelist>
357             
358             <varlistentry>
359                 
360                 <term>logflag</term>
361                 
362                 <listitem>
363                     
364                     <para>このオプションは,
365                         
366                         軸スケール (線形または対数)を設定守るために使用できます.
367                         
368                         値は文字列で, 以下の値のどれかを指定します:
369                         
370                         <literal>"nn"</literal>,
371                         
372                         <literal>"nl"</literal> , <literal>"ln"</literal> および
373                         
374                         <literal>"ll"</literal>. <literal>"l"</literal> は
375                         
376                         対数軸/目盛, <literal>"n"</literal>は通常の軸を意味します.
377                         
378                     </para>
379                     
380                 </listitem>
381                 
382             </varlistentry>
383             
384             <varlistentry>
385                 
386                 <term>style</term>
387                 
388                 <listitem>
389                     
390                     <para>
391                         
392                         このオプションは,曲線の描画方法を指定する際に使用できます.
393                         
394                         このオプションを指定する場合,
395                         
396                         値には曲線と同じ数のエントリを有するベクトルを指定します.
397                         
398                     </para>
399                     
400                     <itemizedlist>
401                         
402                         <listitem>
403                             
404                             <para>
405                                 
406                                 <literal>style(i)</literal> が正の場合,
407                                 
408                                 曲線は実線で描画され,
409                                 
410                                 <literal>style(i)</literal>は曲線の描画に使用される
411                                 
412                                 色の添字を定義します(<link linkend="getcolor">getcolor</link>参照).
413                                 
414                                 線のスタイルおよび太さはpolylineエンティティプロパティ
415                                 
416                                 (<link linkend="polyline_properties">polyline_properties</link>参照)
417                                 
418                                 により設定することができることに注意してください.
419                                 
420                             </para>
421                             
422                             <para>指定した曲線の点の間は区分線形補間が行われます.</para>
423                             
424                         </listitem>
425                         
426                         <listitem>
427                             
428                             <para>
429                                 
430                                 <literal>style(i)</literal>が負またはゼロの場合,
431                                 
432                                 指定した曲線の点はマーカにより描画されます,
433                                 
434                                 <literal>abs(style(i))</literal> は使用するマーカ id を定義します.
435                                 
436                                 マークの色および大きさはpolylineエンティティプロパティ
437                                 
438                                 (<link linkend="polyline_properties">polyline_properties</link>参照)
439                                 
440                                 により設定することができることに注意してください.
441                                 
442                             </para>
443                             
444                         </listitem>
445                         
446                     </itemizedlist>
447                     
448                 </listitem>
449                 
450             </varlistentry>
451             
452             <varlistentry>
453                 
454                 <term>strf</term>
455                 
456                 <listitem>
457                     
458                     <para>
459                         
460                         長さ <literal>"xyz"</literal> (デフォルトで
461                         
462                         <literal>strf= "081"</literal>)の文字列.
463                         
464                     </para>
465                     
466                     <variablelist>
467                         
468                         <varlistentry>
469                             
470                             <term>x</term>
471                             
472                             <listitem>
473                                 
474                                 <para>凡例の表示を制御します.</para>
475                                 
476                                 <variablelist>
477                                     
478                                     <varlistentry>
479                                         
480                                         <term>x=0</term>
481                                         
482                                         <listitem>
483                                             
484                                             <para>凡例なし.</para>
485                                             
486                                         </listitem>
487                                         
488                                     </varlistentry>
489                                     
490                                     <varlistentry>
491                                         
492                                         <term>x=1</term>
493                                         
494                                         <listitem>
495                                             
496                                             <para>凡例が表示されます.凡例は,
497                                                 
498                                                 オプションの引数 <literal>leg</literal>で指定されます.
499                                                 
500                                             </para>
501                                             
502                                         </listitem>
503                                         
504                                     </varlistentry>
505                                     
506                                 </variablelist>
507                                 
508                             </listitem>
509                             
510                         </varlistentry>
511                         
512                         <varlistentry>
513                             
514                             <term>y</term>
515                             
516                             <listitem>
517                                 
518                                 <para>指定した最小限の範囲に基づく実際の座標系の範囲の計算を
519                                     
520                                     制御します. 実際の範囲は指定した最小限の範囲よりも大きくすることができます.
521                                     
522                                 </para>
523                                 
524                                 <variablelist>
525                                     
526                                     <varlistentry>
527                                         
528                                         <term>y=0</term>
529                                         
530                                         <listitem>
531                                             
532                                             <para>
533                                                 
534                                                 計算せずに,以前のスケール(またはデフォルト)を
535                                                 
536                                                 プロットに使用します
537                                                 
538                                             </para>
539                                             
540                                         </listitem>
541                                         
542                                     </varlistentry>
543                                     
544                                     <varlistentry>
545                                         
546                                         <term>y=1</term>
547                                         
548                                         <listitem>
549                                             
550                                             <para>rect引数による</para>
551                                             
552                                         </listitem>
553                                         
554                                     </varlistentry>
555                                     
556                                     <varlistentry>
557                                         
558                                         <term>y=2</term>
559                                         
560                                         <listitem>
561                                             
562                                             <para>x, y データの最小値/最大値による</para>
563                                             
564                                         </listitem>
565                                         
566                                     </varlistentry>
567                                     
568                                     <varlistentry>
569                                         
570                                         <term>y=3</term>
571                                         
572                                         <listitem>
573                                             
574                                             <para>rect引数に基づき等軸スケールで構築</para>
575                                             
576                                         </listitem>
577                                         
578                                     </varlistentry>
579                                     
580                                     <varlistentry>
581                                         
582                                         <term>y=4</term>
583                                         
584                                         <listitem>
585                                             
586                                             <para>
587                                                 
588                                                 x, y データの最小値/最大値に基づき等軸スケールで構築
589                                                 
590                                             </para>
591                                             
592                                         </listitem>
593                                         
594                                     </varlistentry>
595                                     
596                                     <varlistentry>
597                                         
598                                         <term>y=5</term>
599                                         
600                                         <listitem>
601                                             
602                                             <para>rect引数に基づき見栄え良く軸を拡大</para>
603                                             
604                                         </listitem>
605                                         
606                                     </varlistentry>
607                                     
608                                     <varlistentry>
609                                         
610                                         <term>y=6</term>
611                                         
612                                         <listitem>
613                                             
614                                             <para>
615                                                 
616                                                 x, y データの最小値/最大値に基づき見栄え良く軸を拡大
617                                                 
618                                             </para>
619                                             
620                                         </listitem>
621                                         
622                                     </varlistentry>
623                                     
624                                     <varlistentry>
625                                         
626                                         <term>y=7</term>
627                                         
628                                         <listitem>
629                                             
630                                             <para>y=1に似ていますが,
631                                                 
632                                                 前のプロットが新しいスケールを用いて再描画されます
633                                                 
634                                             </para>
635                                             
636                                         </listitem>
637                                         
638                                     </varlistentry>
639                                     
640                                     <varlistentry>
641                                         
642                                         <term>y=8</term>
643                                         
644                                         <listitem>
645                                             
646                                             <para>y=2に似ていますが,
647                                                 
648                                                 前のプロットが新しいスケールを用いて再描画されます
649                                                 
650                                             </para>
651                                             
652                                         </listitem>
653                                         
654                                     </varlistentry>
655                                     
656                                 </variablelist>
657                                 
658                             </listitem>
659                             
660                         </varlistentry>
661                         
662                         <varlistentry>
663                             
664                             <term>z</term>
665                             
666                             <listitem>
667                                 
668                                 <para>
669                                     
670                                     プロットの周囲のフレームへの情報の表示を制御します.
671                                     
672                                     軸が指定された場合,目盛の数をオプションの引数
673                                     
674                                     <literal>nax</literal>により指定できます.
675                                     
676                                 </para>
677                                 
678                                 <variablelist>
679                                     
680                                     <varlistentry>
681                                         
682                                         <term>z=0</term>
683                                         
684                                         <listitem>
685                                             
686                                             <para>プロットの周囲に何も描画されません.</para>
687                                             
688                                         </listitem>
689                                         
690                                     </varlistentry>
691                                     
692                                     <varlistentry>
693                                         
694                                         <term>z=1</term>
695                                         
696                                         <listitem>
697                                             
698                                             <para>軸が描画され, y軸が左に表示されます.</para>
699                                             
700                                         </listitem>
701                                         
702                                     </varlistentry>
703                                     
704                                     <varlistentry>
705                                         
706                                         <term>z=2</term>
707                                         
708                                         <listitem>
709                                             
710                                             <para>プロットが目盛のない箱で囲まれます.</para>
711                                             
712                                         </listitem>
713                                         
714                                     </varlistentry>
715                                     
716                                     <varlistentry>
717                                         
718                                         <term>z=3</term>
719                                         
720                                         <listitem>
721                                             
722                                             <para>軸が描画され, y軸が右に表示されます.</para>
723                                             
724                                         </listitem>
725                                         
726                                     </varlistentry>
727                                     
728                                     <varlistentry>
729                                         
730                                         <term>z=4</term>
731                                         
732                                         <listitem>
733                                             
734                                             <para>
735                                                 
736                                                 フレームボックスの中心に軸が描画されます.
737                                                 
738                                             </para>
739                                             
740                                         </listitem>
741                                         
742                                     </varlistentry>
743                                     
744                                     <varlistentry>
745                                         
746                                         <term>z=5</term>
747                                         
748                                         <listitem>
749                                             
750                                             <para>
751                                                 
752                                                 点<literal>(0,0)</literal>で交差するように
753                                                 
754                                                 軸が描画されます.
755                                                 
756                                                 点<literal>(0,0)</literal>がフレーム内にない場合,
757                                                 
758                                                 グラフ上に軸は表示されません.
759                                                 
760                                             </para>
761                                             
762                                         </listitem>
763                                         
764                                     </varlistentry>
765                                     
766                                 </variablelist>
767                                 
768                             </listitem>
769                             
770                         </varlistentry>
771                         
772                     </variablelist>
773                     
774                 </listitem>
775                 
776             </varlistentry>
777             
778             <varlistentry>
779                 
780                 <term>leg</term>
781                 
782                 <listitem>
783                     
784                     <para>このオプションは曲線の凡例を設定する際に使用されます.
785                         
786                         <literal>"leg1@leg2@...."</literal>という形式の文字列とする
787                         
788                         必要があります.
789                         
790                         ただし, <literal>leg1</literal> , <literal>leg2</literal> , ...
791                         
792                         はそれぞれ最初の曲線,2番目の曲線,... の凡例です.
793                         
794                         デフォルトは
795                         
796                         <literal> " "</literal>です.
797                         
798                     </para>
799                     
800                     <para>曲線の凡例はx軸の下に描画されます.
801                         
802                         このオプションは柔軟ではないため,なるべく,
803                         
804                         <link linkend="captions">captions</link> または <link linkend="legend">legend</link> 関数を使用してください.
805                         
806                     </para>
807                     
808                 </listitem>
809                 
810             </varlistentry>
811             
812             <varlistentry>
813                 
814                 <term>rect</term>
815                 
816                 <listitem>
817                     
818                     <para>
819                         
820                         このオプションはプロット時に指定した最小限の範囲を設定する際に
821                         
822                         使用できます.
823                         
824                         このオプションが指定された場合,
825                         
826                         値は以下の4個のエントリを有する実数ベクトルとする必要があります:
827                         
828                     </para>
829                     
830                     <para>
831                         
832                         <literal>[xmin,ymin,xmax,ymax]</literal>.
833                         
834                         <literal>xmin</literal> および <literal>xmax</literal> は横座標の範囲を定義し,
835                         
836                         <literal>ymin</literal> および <literal>ymax</literal>は縦座標の範囲を定義します.
837                         
838                     </para>
839                     
840                     <para>
841                         
842                         この引数は,指定した<literal>rect</literal>引数に基づき軸境界を
843                         
844                         定義する方法を指定する<literal>frameflag</literal>オプションと共に
845                         
846                         使用することができます.
847                         
848                         <literal>frameflag</literal>オプションが指定されない場合,
849                         
850                         <literal>frameflag=7</literal>が仮定されます.
851                         
852                     </para>
853                     
854                     <para>軸境界も軸エンティティプロパティによりカスタマイズできます
855                         
856                         (<link linkend="axes_properties">axes_properties</link>参照).
857                         
858                     </para>
859                     
860                 </listitem>
861                 
862             </varlistentry>
863             
864             <varlistentry>
865                 
866                 <term>nax</term>
867                 
868                 <listitem>
869                     
870                     <para>
871                         
872                         このオプションは軸ラベルおよび目盛定義を指定する際に使用できます.
873                         
874                         値には4個の整数エントリ<literal>[nx,Nx,ny,Ny]</literal>を有する実数ベクトルを
875                         
876                         指定します.
877                         
878                     </para>
879                     
880                     <para>
881                         
882                         <literal>Nx</literal> はx軸で使用される主目盛の数
883                         
884                         (autoticksの場合は-1を指定)を指定し,
885                         
886                         <literal>nx</literal>は2つのx軸主目盛の間に描画される副目盛の
887                         
888                         数を指定します.
889                         
890                     </para>
891                     
892                     <para>
893                         
894                         <literal>Ny</literal> および <literal>ny</literal> は
895                         
896                         y軸の同様な情報を指定します.
897                         
898                     </para>
899                     
900                     <para>
901                         
902                         <literal>axesflag</literal> オプションが設定されない場合,
903                         
904                         <literal>nax</literal> オプションは
905                         
906                         <literal>axesflag</literal>オプションが9に設定されていると
907                         
908                         仮定します.
909                         
910                     </para>
911                     
912                 </listitem>
913                 
914             </varlistentry>
915             
916             <varlistentry>
917                 
918                 <term>frameflag</term>
919                 
920                 <listitem>
921                     
922                     <para>このオプションは指定された最小限の範囲に基づく実際の
923                         
924                         座標系範囲の計算を制御するために使用できます.
925                         
926                         実際の範囲は指定された最小限の範囲よりも大きくすることができます.
927                         
928                     </para>
929                     
930                     <variablelist>
931                         
932                         <varlistentry>
933                             
934                             <term>frameflag=0</term>
935                             
936                             <listitem>
937                                 
938                                 <para>計算せずに,以前のスケール(またはデフォルト)を
939                                     
940                                     プロットに使用します.
941                                     
942                                 </para>
943                                 
944                             </listitem>
945                             
946                         </varlistentry>
947                         
948                         <varlistentry>
949                             
950                             <term>frameflag=1</term>
951                             
952                             <listitem>
953                                 
954                                 <para>実際の範囲は
955                                     
956                                     <literal>rect</literal> オプションにより指定された範囲となります.
957                                     
958                                 </para>
959                                 
960                             </listitem>
961                             
962                         </varlistentry>
963                         
964                         <varlistentry>
965                             
966                             <term>frameflag=2</term>
967                             
968                             <listitem>
969                                 
970                                 <para>実際の範囲は 
971                                     
972                                     <literal>x</literal> および<literal>y</literal> データの最小値/最大値から
973                                     
974                                     計算されます.
975                                     
976                                 </para>
977                                 
978                             </listitem>
979                             
980                         </varlistentry>
981                         
982                         <varlistentry>
983                             
984                             <term>frameflag=3</term>
985                             
986                             <listitem>
987                                 
988                                 <para>
989                                     
990                                     実際の範囲は<literal>rect</literal>オプションにより指定された範囲となり,
991                                     
992                                     等軸スケールにするために拡大されます.
993                                     
994                                 </para>
995                                 
996                             </listitem>
997                             
998                         </varlistentry>
999                         
1000                         <varlistentry>
1001                             
1002                             <term>frameflag=4</term>
1003                             
1004                             <listitem>
1005                                 
1006                                 <para>実際の範囲は 
1007                                     
1008                                     <literal>x</literal> および<literal>y</literal> データの最小値/最大値から
1009                                     
1010                                     計算され,等軸スケールにするために拡大されます.
1011                                     
1012                                 </para>
1013                                 
1014                             </listitem>
1015                             
1016                         </varlistentry>
1017                         
1018                         <varlistentry>
1019                             
1020                             <term>frameflag=5</term>
1021                             
1022                             <listitem>
1023                                 
1024                                 <para>
1025                                     
1026                                     実際の範囲は<literal>rect</literal>オプションにより指定された範囲となり,
1027                                     
1028                                     軸ラベルの見栄えを良くするために拡大されます.
1029                                     
1030                                 </para>
1031                                 
1032                             </listitem>
1033                             
1034                         </varlistentry>
1035                         
1036                         <varlistentry>
1037                             
1038                             <term>frameflag=6</term>
1039                             
1040                             <listitem>
1041                                 
1042                                 <para>実際の範囲は 
1043                                     
1044                                     <literal>x</literal> および<literal>y</literal> データの最小値/最大値から
1045                                     
1046                                     計算され,軸ラベルの見栄えを良くするために拡大されます.
1047                                     
1048                                 </para>
1049                                 
1050                             </listitem>
1051                             
1052                         </varlistentry>
1053                         
1054                         <varlistentry>
1055                             
1056                             <term>frameflag=7</term>
1057                             
1058                             <listitem>
1059                                 
1060                                 <para>
1061                                     
1062                                     <literal>frameflag=1</literal>と似ていますが,
1063                                     
1064                                     前のプロットが新しいスケールを用いて再描画されます.
1065                                     
1066                                     カレントのグラフに前のプロットを追加するために使用されます.
1067                                     
1068                                 </para>
1069                                 
1070                             </listitem>
1071                             
1072                         </varlistentry>
1073                         
1074                         <varlistentry>
1075                             
1076                             <term>frameflag=8</term>
1077                             
1078                             <listitem>
1079                                 
1080                                 <para>
1081                                     
1082                                     <literal>frameflag=2</literal>と似ていますが,
1083                                     
1084                                     前のプロットが新しいスケールを用いて再描画されます.
1085                                     
1086                                     カレントのグラフに前のプロットを追加するために使用されます.
1087                                     
1088                                 </para>
1089                                 
1090                             </listitem>
1091                             
1092                         </varlistentry>
1093                         
1094                         <varlistentry>
1095                             
1096                             <term>frameflag=9</term>
1097                             
1098                             <listitem>
1099                                 
1100                                 <para>
1101                                     
1102                                     <literal>frameflag=8</literal> と似ていますが,
1103                                     
1104                                     範囲は軸ラベルの見栄えを良くするために拡大されます.
1105                                     
1106                                     これはデフォルト値です.
1107                                     
1108                                 </para>
1109                                 
1110                             </listitem>
1111                             
1112                         </varlistentry>
1113                         
1114                     </variablelist>
1115                     
1116                     <para>軸の境界も軸エンティティプロパティによりカスタマイズできます
1117                         
1118                         (s<link linkend="axes_properties">axes_properties</link>参照).
1119                         
1120                     </para>
1121                     
1122                 </listitem>
1123                 
1124             </varlistentry>
1125             
1126             <varlistentry>
1127                 
1128                 <term>axesflag</term>
1129                 
1130                 <listitem>
1131                     
1132                     <para>軸の描画方法を指定するためにこのオプションを指定することができます.
1133                         
1134                         値には 0 から 5の範囲の整数を指定します :
1135                         
1136                     </para>
1137                     
1138                     <variablelist>
1139                         
1140                         <varlistentry>
1141                             
1142                             <term>axesflag=0</term>
1143                             
1144                             <listitem>
1145                                 
1146                                 <para>プロットの周囲に何も描画されません (axes_visible=["off"
1147                                     
1148                                     "off"];box="off").
1149                                     
1150                                 </para>
1151                                 
1152                             </listitem>
1153                             
1154                         </varlistentry>
1155                         
1156                         <varlistentry>
1157                             
1158                             <term>axesflag=1</term>
1159                             
1160                             <listitem>
1161                                 
1162                                 <para>軸が描画され, y軸が左に表示されます
1163                                     
1164                                     (axes_visible=["on" "on"];box="on",y_location="left").
1165                                     
1166                                 </para>
1167                                 
1168                             </listitem>
1169                             
1170                         </varlistentry>
1171                         
1172                         <varlistentry>
1173                             
1174                             <term>axesflag=2</term>
1175                             
1176                             <listitem>
1177                                 
1178                                 <para>プロットは目盛のない箱で囲われます
1179                                     
1180                                     (axes_visible=["off" "off"];box="on").
1181                                     
1182                                 </para>
1183                                 
1184                             </listitem>
1185                             
1186                         </varlistentry>
1187                         
1188                         <varlistentry>
1189                             
1190                             <term>axesflag=3</term>
1191                             
1192                             <listitem>
1193                                 
1194                                 <para>軸が描画され, y軸が右に表示されます
1195                                     
1196                                     (axes_visible=["on"
1197                                     
1198                                     "on"];box="off",y_location="right").
1199                                     
1200                                 </para>
1201                                 
1202                             </listitem>
1203                             
1204                         </varlistentry>
1205                         
1206                         <varlistentry>
1207                             
1208                             <term>axesflag=4</term>
1209                             
1210                             <listitem>
1211                                 
1212                                 <para>軸がフレームの中心に描画され,箱は描画されません
1213                                     
1214                                     (axes_visible=["on" "on"];box="off",x_location="middle",
1215                                     
1216                                     y_location="middle").
1217                                     
1218                                 </para>
1219                                 
1220                             </listitem>
1221                             
1222                         </varlistentry>
1223                         
1224                         <varlistentry>
1225                             
1226                             <term>axesflag=5</term>
1227                             
1228                             <listitem>
1229                                 
1230                                 <para>
1231                                     
1232                                     <literal>axesflag=4</literal>に似た軸がフレームの中心に描画されます.
1233                                     
1234                                     違いは箱が描画されることです
1235                                     
1236                                     (axes_visible=["on" "on"];box="on",x_location="middle",y_location="middle").
1237                                     
1238                                 </para>
1239                                 
1240                             </listitem>
1241                             
1242                         </varlistentry>
1243                         
1244                         <varlistentry>
1245                             
1246                             <term>axesflag=9</term>
1247                             
1248                             <listitem>
1249                                 
1250                                 <para>軸が描画され, y軸が左に表示されます
1251                                     
1252                                     (axes_visible=["on" "on"];box="off",y_location="left"). 
1253                                     
1254                                     これがデフォルト値です
1255                                     
1256                                 </para>
1257                                 
1258                             </listitem>
1259                             
1260                         </varlistentry>
1261                         
1262                     </variablelist>
1263                     
1264                     <para>軸の特性も軸エンティティプロパティによりカスタマイズできます
1265                         
1266                         (<link linkend="axes_properties">axes_properties</link>参照).
1267                         
1268                     </para>
1269                     
1270                 </listitem>
1271                 
1272             </varlistentry>
1273             
1274         </variablelist>
1275         
1276     </refsection>
1277     
1278     <refsection>
1279         
1280         <title>その他の情報</title>
1281         
1282         <para>デフォルトで, 連続プロットは重ね書きされます. 前のプロットを
1283             
1284             消去するには,
1285             
1286             <literal>
1287                 
1288                 <link linkend="clf">clf()</link>
1289                 
1290             </literal>
1291             
1292             を使用してください.
1293             
1294         </para>
1295         
1296         <para>
1297             
1298             デモを参照するにはコマンド <literal>plot2d()</literal> を使用してください.
1299             
1300         </para>
1301         
1302         <para>その他に以下のような高レベルplot2d 関数が存在します:</para>
1303         
1304         <itemizedlist>
1305             
1306             <listitem>
1307                 
1308                 <para>
1309                     
1310                     plot2d2 は <literal>plot2d</literal> と同じですが,曲線は
1311                     
1312                     区分定数と仮定されます.
1313                     
1314                 </para>
1315                 
1316             </listitem>
1317             
1318             <listitem>
1319                 
1320                 <para>
1321                     
1322                     plot2d3 は<literal>plot2d</literal> と同じですが, 曲線は
1323                     
1324                     垂直棒グラフとしてプロットされます.
1325                     
1326                 </para>
1327                 
1328             </listitem>
1329             
1330             <listitem>
1331                 
1332                 <para>
1333                     
1334                     plot2d4 は <literal>plot2d</literal> と同じですが, 曲線は
1335                     
1336                     垂直な矢印をでプロットされます.
1337                     
1338                 </para>
1339                 
1340             </listitem>
1341             
1342         </itemizedlist>
1343         
1344     </refsection>
1345     
1346     <refsection>
1347         
1348         <title>例</title>
1349         
1350         <programlisting role="example"><![CDATA[ 
1351
1352 // x 初期化
1353
1354 x=[0:0.1:2*%pi]';
1355
1356 //簡単なプロット
1357
1358 plot2d(sin(x));
1359
1360  ]]></programlisting>
1361         
1362         <scilab:image>
1363             
1364             x=[0:0.1:2*%pi]';
1365             
1366             plot2d(sin(x));
1367             
1368         </scilab:image>
1369         
1370         <programlisting role="example"><![CDATA[ 
1371
1372 clf();
1373
1374 x=[0:0.1:2*%pi]';
1375
1376 plot2d(x,sin(x));
1377
1378 //複数のプロット
1379
1380  ]]></programlisting>
1381         
1382         <scilab:image>
1383             
1384             x=[0:0.1:2*%pi]';
1385             
1386             plot2d(x,sin(x));
1387             
1388         </scilab:image>
1389         
1390         <programlisting role="example"><![CDATA[ 
1391
1392 clf();
1393
1394 x=[0:0.1:2*%pi]';
1395
1396 plot2d(x,[sin(x) sin(2*x) sin(3*x)])
1397
1398  ]]></programlisting>
1399         
1400         <scilab:image>
1401             
1402             x=[0:0.1:2*%pi]';
1403             
1404             plot2d(x,[sin(x) sin(2*x) sin(3*x)])
1405             
1406         </scilab:image>
1407         
1408         <programlisting role="example"><![CDATA[ 
1409
1410 // フレームの次元を指定した複数プロット
1411
1412 clf();
1413
1414 plot2d(x,[sin(x) sin(2*x) sin(3*x)],rect=[0,0,6,0.5]);
1415
1416  ]]></programlisting>
1417         
1418         <scilab:image>
1419             
1420             x=[0:0.1:2*%pi]';
1421             
1422             plot2d(x,[sin(x) sin(2*x) sin(3*x)],rect=[0,0,6,0.5]);
1423             
1424         </scilab:image>
1425         
1426         <programlisting role="example"><![CDATA[ 
1427
1428 //凡例と目盛/スタイルを指定した複数プロット
1429
1430 clf();
1431
1432 plot2d(x,[sin(x) sin(2*x) sin(3*x)],..
1433
1434        [1,2,3],leg="L1@L2@L3",nax=[2,10,2,10],rect=[0,-2,2*%pi,2]);
1435
1436  ]]></programlisting>
1437         
1438         <scilab:image>
1439             
1440             x=[0:0.1:2*%pi]';
1441             
1442             plot2d(x,[sin(x) sin(2*x) sin(3*x)],..
1443             
1444             [1,2,3],leg="L1@L2@L3",nax=[2,10,2,10],rect=[0,-2,2*%pi,2]);
1445             
1446         </scilab:image>
1447         
1448         <programlisting role="example"><![CDATA[ 
1449
1450 // 等軸
1451
1452 clf();
1453
1454 plot2d(x,sin(x),1,frameflag= 4);
1455
1456  ]]></programlisting>
1457         
1458         <scilab:image>
1459             
1460             x=[0:0.1:2*%pi]';
1461             
1462             plot2d(x,sin(x),1,frameflag= 4);
1463             
1464         </scilab:image>
1465         
1466         <programlisting role="example"><![CDATA[ 
1467
1468 // スケール 
1469
1470 clf();
1471
1472 plot2d(x,sin(x),1,frameflag= 6);
1473
1474  ]]></programlisting>
1475         
1476         <scilab:image>
1477             
1478             x=[0:0.1:2*%pi]';
1479             
1480             plot2d(x,sin(x),1,frameflag= 6);
1481             
1482         </scilab:image>
1483         
1484         <programlisting role="example"><![CDATA[ 
1485
1486 // 前のプロット/スタイルでオートスケール
1487
1488 clf();
1489
1490 plot2d(x,sin(x),-1);
1491
1492 plot2d(x,2*sin(x),12); 
1493
1494 plot2d(2*x,cos(x),3);
1495
1496  ]]></programlisting>
1497         
1498         <scilab:image>
1499             
1500             x=[0:0.1:2*%pi]';
1501             
1502             plot2d(x,sin(x),-1);
1503             
1504             plot2d(x,2*sin(x),12); 
1505             
1506             plot2d(2*x,cos(x),3);
1507             
1508         </scilab:image>
1509         
1510         <programlisting role="example"><![CDATA[ 
1511
1512 // 軸を右に
1513
1514 clf();
1515
1516 plot2d(x,sin(x),leg="sin(x)");
1517
1518 a=gca(); // 軸エンティティのハンドル 
1519
1520 a.y_location ="right";
1521
1522  ]]></programlisting>
1523         
1524         <scilab:image>
1525             
1526             x=[0:0.1:2*%pi]';
1527             
1528             plot2d(x,sin(x),leg="sin(x)");
1529             
1530             a=gca(); // Handle on axes entity 
1531             
1532             a.y_location ="right"; 
1533             
1534         </scilab:image>
1535         
1536         <programlisting role="example"><![CDATA[ 
1537
1538  
1539
1540 // 軸の中心を (0,0) に
1541
1542 clf();
1543
1544 plot2d(x-4,sin(x),1,leg="sin(x)");
1545
1546 a=gca(); // 軸エンティティのハンドル
1547
1548 a.x_location = "origin"; 
1549
1550 a.y_location = "origin"; 
1551
1552 // plot2dで作成されたエンティティを操作 ...
1553
1554 a=gca();
1555
1556 a.isoview='on'; 
1557
1558 a.children // 軸の子の一覧.
1559
1560 // 2個のポリラインと1個の凡例からなる複合要素がある 
1561
1562 poly1= a.children(1).children(1); //ポリラインのハンドルをpoly1に保存
1563
1564 poly1.foreground = 4; // スタイルを変更する別の方法...
1565
1566 poly1.thickness = 3;  // ...曲線の太さを変更.
1567
1568 poly1.clip_state='off'; // クリッピングの制御
1569
1570 leg = a.children(2); // 凡例のハンドルをlegに保存
1571
1572 leg.font_style = 9; 
1573
1574 leg.line_mode = "on";
1575
1576 a.isoview='off';
1577
1578  ]]></programlisting>
1579         
1580         <scilab:image>
1581             
1582             
1583             
1584             // axis centered at (0,0) 
1585             
1586             clf();
1587             
1588             x=[0:0.1:2*%pi]';
1589             
1590             plot2d(x-4,sin(x),1,leg="sin(x)");
1591             
1592             a=gca(); // Handle on axes entity
1593             
1594             a.x_location = "origin"; 
1595             
1596             a.y_location = "origin"; 
1597             
1598             // Some operations on entities created by plot2d ...
1599             
1600             a=gca();
1601             
1602             a.isoview='on'; 
1603             
1604             a.children // list the children of the axes.
1605             
1606             // There are a compound made of two polylines and a legend 
1607             
1608             poly1= a.children(1).children(1); //store polyline handle into poly1 
1609             
1610             poly1.foreground = 4; // another way to change the style...
1611             
1612             poly1.thickness = 3;  // ...and the tickness of a curve.
1613             
1614             poly1.clip_state='off'; // clipping control
1615             
1616             leg = a.children(2); // store legend handle into leg
1617             
1618             leg.font_style = 9; 
1619             
1620             leg.line_mode = "on";
1621             
1622             a.isoview='off';
1623             
1624         </scilab:image>
1625         
1626     </refsection>
1627     
1628     <refsection role="see also">
1629         
1630         <title>参照</title>
1631         
1632         <simplelist type="inline">
1633             
1634             <member>
1635                 
1636                 <link linkend="plot">plot</link>
1637                 
1638             </member>
1639             
1640             <member>
1641                 
1642                 <link linkend="plot2d1">plot2d1</link>
1643                 
1644             </member>
1645             
1646             <member>
1647                 
1648                 <link linkend="plot2d2">plot2d2</link>
1649                 
1650             </member>
1651             
1652             <member>
1653                 
1654                 <link linkend="plot2d3">plot2d3</link>
1655                 
1656             </member>
1657             
1658             <member>
1659                 
1660                 <link linkend="plot2d4">plot2d4</link>
1661                 
1662             </member>
1663             
1664             <member>
1665                 
1666                 <link linkend="clf">clf</link>
1667                 
1668             </member>
1669             
1670             <member>
1671                 
1672                 <link linkend="xdel">xdel</link>
1673                 
1674             </member>
1675             
1676             <member>
1677                 
1678                 <link linkend="delete">delete</link>
1679                 
1680             </member>
1681             
1682         </simplelist>
1683         
1684     </refsection>
1685     
1686 </refentry>
1687