update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / 3d_plot / plot3d1.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) ENPC - Jean-Philippe Chancelier
8
9  * 
10
11  * This file must be used under the terms of the CeCILL.
12
13  * This source file is licensed as described in the file COPYING, which
14
15  * you should have received as part of this distribution.  The terms
16
17  * are also available at    
18
19  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
20
21  *
22
23  -->
24
25 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="plot3d1">
26     
27     <refnamediv>
28         
29         <refname>plot3d1</refname>
30         
31         <refpurpose>曲面の3次元白黒またはカラープロット</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>plot3d1(x,y,z,[theta,alpha,leg,flag,ebox])
40             
41             plot3d1(xf,yf,zf,[theta,alpha,leg,flag,ebox])
42             
43             
44             
45             plot3d1(x,y,z,&lt;opts_args&gt;)
46             
47             plot3d1(xf,yf,zf,&lt;opts_args&gt;)
48             
49         </synopsis>
50         
51     </refsynopsisdiv>
52     
53     <refsection>
54         
55         <title>パラメータ</title>
56         
57         <variablelist>
58             
59             <varlistentry>
60                 
61                 <term>x,y</term>
62                 
63                 <listitem>
64                     
65                     <para>大きさ n1 および n2 の行ベクトル(x軸およびy軸座標
66                         
67                         ). これらの座標は単調である必要があります.
68                         
69                     </para>
70                     
71                 </listitem>
72                 
73             </varlistentry>
74             
75             <varlistentry>
76                 
77                 <term>z</term>
78                 
79                 <listitem>
80                     
81                     <para>
82                         
83                         大きさ (n1,n2)の行列. <literal>z(i,j)</literal> は点(x(i),y(j))における
84                         
85                         曲面の値です.
86                         
87                     </para>
88                     
89                 </listitem>
90                 
91             </varlistentry>
92             
93             <varlistentry>
94                 
95                 <term>xf,yf,zf</term>
96                 
97                 <listitem>
98                     
99                     <para>大きさ (nf,n)の行列. 曲面を描画する際に使用される小平面を定義します.
100                         
101                         <literal>n</literal>個の小平面があります. 各小平面
102                         
103                         <literal>i</literal> は<literal>nf</literal>個の点を有するポリゴンで定義されます.
104                         
105                         i番目の小平面の点のx軸,y軸,z軸座標はそれぞれ<literal>xf(:,i)</literal>, 
106                         
107                         <literal>yf(:,i)</literal> および  <literal>zf(:,i)</literal>により指定されます.
108                         
109                     </para>
110                     
111                 </listitem>
112                 
113             </varlistentry>
114             
115             <varlistentry>
116                 
117                 <term>&lt;opt_args&gt;</term>
118                 
119                 <listitem>
120                     
121                     <para>
122                         
123                         一連の命令<literal>key1=value1,
124                             
125                             key2=value2
126                             
127                         </literal>
128                         
129                         ,...を表し, <literal>key1</literal>,
130                         
131                         <literal>key2,...</literal> は以下のどれかとすることができます: theta,
132                         
133                         alpha ,leg,flag,ebox (以下の定義を参照).
134                         
135                     </para>
136                     
137                 </listitem>
138                 
139             </varlistentry>
140             
141             <varlistentry>
142                 
143                 <term>theta, alpha</term>
144                 
145                 <listitem>
146                     
147                     <para>観測点の球座標を指定する実数値(単位:度).</para>
148                     
149                 </listitem>
150                 
151             </varlistentry>
152             
153             <varlistentry>
154                 
155                 <term>leg</term>
156                 
157                 <listitem>
158                     
159                     <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
160                         
161                         "X@Y@Z"のようになります.
162                         
163                     </para>
164                     
165                 </listitem>
166                 
167             </varlistentry>
168             
169             <varlistentry>
170                 
171                 <term>flag</term>
172                 
173                 <listitem>
174                     
175                     <para>大きさ3の実数ベクトル.
176                         
177                         <literal>flag=[mode,type,box]</literal>.
178                         
179                     </para>
180                     
181                     <variablelist>
182                         
183                         <varlistentry>
184                             
185                             <term>mode</term>
186                             
187                             <listitem>
188                                 
189                                 <para>整数 (曲面の色).</para>
190                                 
191                                 <variablelist>
192                                     
193                                     <varlistentry>
194                                         
195                                         <term>mode&gt;0</term>
196                                         
197                                         <listitem>
198                                             
199                                             <para>
200                                                 
201                                                 曲面は色<literal>"mode"</literal>で塗られます ;
202                                                 
203                                                 小平面の境界はカレントの線種と色で描画されます.
204                                                 
205                                             </para>
206                                             
207                                         </listitem>
208                                         
209                                     </varlistentry>
210                                     
211                                     <varlistentry>
212                                         
213                                         <term>mode=0:</term>
214                                         
215                                         <listitem>
216                                             
217                                             <para>曲面のメッシュが描画されます.</para>
218                                             
219                                         </listitem>
220                                         
221                                     </varlistentry>
222                                     
223                                     <varlistentry>
224                                         
225                                         <term>mode&lt;0:</term>
226                                         
227                                         <listitem>
228                                             
229                                             <para>
230                                                 
231                                                 曲面は色<literal>"-mode"</literal>で塗られます ;
232                                                 
233                                                 小平面の境界は描画されません.
234                                                 
235                                             </para>
236                                             
237                                             <para>曲面の色の取り扱いは,
238                                                 
239                                                 surfaceエンティティプロパティによる
240                                                 
241                                                 <literal>color_mode</literal>および
242                                                 
243                                                 <literal>color_flag</literal>オプションを用いて
244                                                 
245                                                 行われることに注意してください (<link linkend="surface_properties">surface_properties</link>参照).
246                                                 
247                                             </para>
248                                             
249                                         </listitem>
250                                         
251                                     </varlistentry>
252                                     
253                                 </variablelist>
254                                 
255                             </listitem>
256                             
257                         </varlistentry>
258                         
259                         <varlistentry>
260                             
261                             <term>type</term>
262                             
263                             <listitem>
264                                 
265                                 <para>整数 (スケール).</para>
266                                 
267                                 <variablelist>
268                                     
269                                     <varlistentry>
270                                         
271                                         <term>type=0:</term>
272                                         
273                                         <listitem>
274                                             
275                                             <para>プロットは
276                                                 
277                                                 (前の<literal>param3d</literal>,
278                                                 
279                                                 <literal>plot3d</literal>, <literal>contour</literal> または
280                                                 
281                                                 <literal>plot3d1</literal>のコールで設定された)
282                                                 
283                                                 カレントの3次元スケールで行われます.
284                                                 
285                                             </para>
286                                             
287                                         </listitem>
288                                         
289                                     </varlistentry>
290                                     
291                                     <varlistentry>
292                                         
293                                         <term>type=1:</term>
294                                         
295                                         <listitem>
296                                             
297                                             <para>
298                                                 
299                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
300                                                 
301                                                 自動的に調整され,
302                                                 
303                                                 境界はオプションの引数<literal>ebox</literal>の値で
304                                                 
305                                                 指定されます.
306                                                 
307                                             </para>
308                                             
309                                         </listitem>
310                                         
311                                     </varlistentry>
312                                     
313                                     <varlistentry>
314                                         
315                                         <term>type=2:</term>
316                                         
317                                         <listitem>
318                                             
319                                             <para>
320                                                 
321                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
322                                                 
323                                                 自動的に調整され,境界は指令したデータにより計算されます.
324                                                 
325                                             </para>
326                                             
327                                         </listitem>
328                                         
329                                     </varlistentry>
330                                     
331                                     <varlistentry>
332                                         
333                                         <term>type=3:</term>
334                                         
335                                         <listitem>
336                                             
337                                             <para>
338                                                 
339                                                 オプション<literal>ebox</literal>で指定したボックス境界を有する
340                                                 
341                                                 3次元等軸プロットで,<literal>type=1</literal>に似ています.
342                                                 
343                                             </para>
344                                             
345                                         </listitem>
346                                         
347                                     </varlistentry>
348                                     
349                                     <varlistentry>
350                                         
351                                         <term>type=4:</term>
352                                         
353                                         <listitem>
354                                             
355                                             <para>データで定義された境界に基づく3次元等軸プロットで,
356                                                 
357                                                 <literal>type=2</literal>に似ています.
358                                                 
359                                             </para>
360                                             
361                                         </listitem>
362                                         
363                                     </varlistentry>
364                                     
365                                     <varlistentry>
366                                         
367                                         <term>type=5:</term>
368                                         
369                                         <listitem>
370                                             
371                                             <para>
372                                                 
373                                                 オプション<literal>ebox</literal>で指定されたボックス境界で
374                                                 
375                                                 定義された境界に基づく3次元拡張等軸プロットで,
376                                                 
377                                                 <literal>type=1</literal>に似ています.
378                                                 
379                                             </para>
380                                             
381                                         </listitem>
382                                         
383                                     </varlistentry>
384                                     
385                                     <varlistentry>
386                                         
387                                         <term>type=6:</term>
388                                         
389                                         <listitem>
390                                             
391                                             <para>
392                                                 
393                                                 データで定義された境界に基づく3次元拡張等軸プロットで,
394                                                 
395                                                 <literal>type=2</literal>に似ています.
396                                                 
397                                                 軸の境界は axes エンティティプロパティによりカスタマイズできる
398                                                 
399                                                 ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
400                                                 
401                                             </para>
402                                             
403                                         </listitem>
404                                         
405                                     </varlistentry>
406                                     
407                                 </variablelist>
408                                 
409                             </listitem>
410                             
411                         </varlistentry>
412                         
413                         <varlistentry>
414                             
415                             <term>box</term>
416                             
417                             <listitem>
418                                 
419                                 <para>整数 (プロットの周囲のフレーム).</para>
420                                 
421                                 <variablelist>
422                                     
423                                     <varlistentry>
424                                         
425                                         <term>box=0:</term>
426                                         
427                                         <listitem>
428                                             
429                                             <para>プロットの周囲に何も描画されません.</para>
430                                             
431                                         </listitem>
432                                         
433                                     </varlistentry>
434                                     
435                                     <varlistentry>
436                                         
437                                         <term>box=1:</term>
438                                         
439                                         <listitem>
440                                             
441                                             <para>実装されていません (box=0と同様).</para>
442                                             
443                                         </listitem>
444                                         
445                                     </varlistentry>
446                                     
447                                     <varlistentry>
448                                         
449                                         <term>box=2:</term>
450                                         
451                                         <listitem>
452                                             
453                                             <para>曲面の背後の軸のみが描画されます.</para>
454                                             
455                                         </listitem>
456                                         
457                                     </varlistentry>
458                                     
459                                     <varlistentry>
460                                         
461                                         <term>box=3:</term>
462                                         
463                                         <listitem>
464                                             
465                                             <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
466                                             
467                                         </listitem>
468                                         
469                                     </varlistentry>
470                                     
471                                     <varlistentry>
472                                         
473                                         <term>box=4:</term>
474                                         
475                                         <listitem>
476                                             
477                                             <para>
478                                                 
479                                                 曲面を囲うボックスが描画され,キャプションと軸が追加されます.
480                                                 
481                                             </para>
482                                             
483                                             <para>
484                                                 
485                                                 軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
486                                                 
487                                                 できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
488                                                 
489                                             </para>
490                                             
491                                         </listitem>
492                                         
493                                     </varlistentry>
494                                     
495                                 </variablelist>
496                                 
497                             </listitem>
498                             
499                         </varlistentry>
500                         
501                     </variablelist>
502                     
503                 </listitem>
504                 
505             </varlistentry>
506             
507             <varlistentry>
508                 
509                 <term>ebox</term>
510                 
511                 <listitem>
512                     
513                     <para>
514                         
515                         プロットの境界をベクトル
516                         
517                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します. 
518                         
519                         この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
520                         
521                         <literal>3</literal> または <literal>5</literal>に設定された場合,
522                         
523                         使用されます (対応する動作については上記参照). 
524                         
525                         <literal>flag</literal> が指定されない場合
526                         
527                         <literal>ebox</literal> は無視されます. 
528                         
529                     </para>
530                     
531                     <para>
532                         
533                         指定された場合, <literal>ebox</literal>引数は,
534                         
535                         <literal>data_bounds</literal>に基づいて動作し,
536                         
537                         axesエンティティのプロパティによりリセットすることも可能であることに
538                         
539                         注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
540                         
541                     </para>
542                     
543                 </listitem>
544                 
545             </varlistentry>
546             
547         </variablelist>
548         
549     </refsection>
550     
551     <refsection>
552         
553         <title>説明</title>
554         
555         <para>
556             
557             <literal>plot3d1</literal> は曲面のzのレベルに基づく色の曲面を
558             
559             プロットします.
560             
561             この特別なプロット関数は,<literal>plot3d</literal>の後で
562             
563             <literal>color_flag=1</literal>を設定することにより有効にすることができます.
564             
565             (
566             
567             <link linkend="surface_properties">surface_properties</link>参照)
568             
569         </para>
570         
571         <para>
572             
573             コマンド <literal>plot3d1()</literal> によりデモを参照できます.
574             
575         </para>
576         
577     </refsection>
578     
579     <refsection>
580         
581         <title>例</title>
582         
583         
584         
585         <programlisting role="example"><![CDATA[
586
587 // z=f(x,y) によりプロットする
588
589 t=[0:0.3:2*%pi]';
590
591 z=sin(t)*cos(t');
592
593 plot3d1(t,t,z)
594
595  ]]></programlisting>
596         
597         <scilab:image>
598             
599             t=[0:0.3:2*%pi]';
600             
601             z=sin(t)*cos(t');
602             
603             plot3d1(t,t,z)
604             
605         </scilab:image>
606         
607         <programlisting role="example"><![CDATA[
608
609 // genfac3d により計算された小平面を用いて同様にプロット
610
611 t=[0:0.3:2*%pi]';
612
613 z=sin(t)*cos(t');
614
615 [xx,yy,zz]=genfac3d(t,t,z);
616
617 plot3d1(xx,yy,zz)
618
619  ]]></programlisting>
620         
621         <scilab:image>
622             
623             t=[0:0.3:2*%pi]';
624             
625             z=sin(t)*cos(t');
626             
627             [xx,yy,zz]=genfac3d(t,t,z);
628             
629             plot3d1(xx,yy,zz)
630             
631         </scilab:image>
632         
633         <programlisting role="example"><![CDATA[
634
635 // 複数のプロット 
636
637 t=[0:0.3:2*%pi]';
638
639 z=sin(t)*cos(t');
640
641 [xx,yy,zz]=genfac3d(t,t,z);
642
643 plot3d1([xx xx],[yy yy],[zz 4+zz])
644
645  ]]></programlisting>
646         
647         <scilab:image>
648             
649             t=[0:0.3:2*%pi]';
650             
651             z=sin(t)*cos(t');
652             
653             [xx,yy,zz]=genfac3d(t,t,z);
654             
655             plot3d1([xx xx],[yy yy],[zz 4+zz])
656             
657         </scilab:image>
658         
659         <programlisting role="example"><![CDATA[
660
661 // 視点とキャプションを指定してプロット
662
663 plot3d1(1:10,1:20,10*rand(10,20),35,45,"X@Y@Z",[2,2,3])
664
665  ]]></programlisting>
666         
667         <scilab:image>
668             
669             plot3d1(1:10,1:20,10*rand(10,20),35,45,"X@Y@Z",[2,2,3])
670             
671         </scilab:image>
672         
673         
674         
675         <programlisting role="example"><![CDATA[
676
677 // グリッドを指定せずにプロット 
678
679 plot3d1(1:10,1:20,10*rand(10,20),35,45,"X@Y@Z",[-2,2,3])
680
681  ]]></programlisting>
682         
683         <scilab:image>
684             
685             plot3d1(1:10,1:20,10*rand(10,20),35,45,"X@Y@Z",[-2,2,3])
686             
687         </scilab:image>
688         
689         <programlisting role="example"><![CDATA[
690
691 // eval3dp により計算される小平面により球をプロット
692
693 deff("[x,y,z]=sph(alp,tet)",["x=r*cos(alp).*cos(tet)+orig(1)*ones(tet)";..
694
695 "y=r*cos(alp).*sin(tet)+orig(2)*ones(tet)";..
696
697 "z=r*sin(alp)+orig(3)*ones(tet)"]);
698
699 r=1; orig=[0 0 0];
700
701 [xx,yy,zz]=eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,20));
702
703 plot3d(xx,yy,zz)
704
705 e=gce();
706
707 e.color_flag=1;
708
709 scf(2);
710
711 plot3d1(xx,yy,zz) // 2つのグラフィックは同じ
712
713  ]]></programlisting>
714         
715         <scilab:image>
716             
717             deff("[x,y,z]=sph(alp,tet)",["x=r*cos(alp).*cos(tet)+orig(1)*ones(tet)";..
718             
719             "y=r*cos(alp).*sin(tet)+orig(2)*ones(tet)";..
720             
721             "z=r*sin(alp)+orig(3)*ones(tet)"]);
722             
723             r=1; orig=[0 0 0];
724             
725             [xx,yy,zz]=eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,20));
726             
727             plot3d(xx,yy,zz)
728             
729         </scilab:image>
730         
731     </refsection>
732     
733     <refsection role="see also">
734         
735         <title>参照</title>
736         
737         <simplelist type="inline">
738             
739             <member>
740                 
741                 <link linkend="plot3d">plot3d</link>
742                 
743             </member>
744             
745             <member>
746                 
747                 <link linkend="gca">gca</link>
748                 
749             </member>
750             
751             <member>
752                 
753                 <link linkend="gce">gce</link>
754                 
755             </member>
756             
757             <member>
758                 
759                 <link linkend="scf">scf</link>
760                 
761             </member>
762             
763             <member>
764                 
765                 <link linkend="clf">clf</link>
766                 
767             </member>
768             
769         </simplelist>
770         
771     </refsection>
772     
773 </refentry>
774