update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / 3d_plot / plot3d3.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  * 
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="plot3d3">
26     
27     <refnamediv>
28         
29         <refname>plot3d3</refname>
30         
31         <refpurpose>矩形の小平面により定義される曲面のメッシュプロット</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>plot3d3(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
40             
41             plot3d3(X,Y,Z, &lt;opt_args&gt;)
42             
43         </synopsis>
44         
45     </refsynopsisdiv>
46     
47     <refsection>
48         
49         <title>引数</title>
50         
51         <variablelist>
52             
53             <varlistentry>
54                 
55                 <term>X, Y, Z:</term>
56                 
57                 <listitem>
58                     
59                     <para>データ構造を定義する実数行列.</para>
60                     
61                 </listitem>
62                 
63             </varlistentry>
64             
65             <varlistentry>
66                 
67                 <term>vect</term>
68                 
69                 <listitem>
70                     
71                     <para>実数ベクトル.</para>
72                     
73                 </listitem>
74                 
75             </varlistentry>
76             
77             <varlistentry>
78                 
79                 <term>&lt;opt_args&gt;</term>
80                 
81                 <listitem>
82                     
83                     <para>
84                         
85                         一連の命令<literal>key1=value1,
86                             
87                             key2=value2
88                             
89                         </literal>
90                         
91                         ,...を表し, <literal>key1</literal>,
92                         
93                         <literal>key2,...</literal> は以下のどれかとすることができます: theta,
94                         
95                         alpha ,leg,flag,ebox (以下の定義を参照).
96                         
97                     </para>
98                     
99                 </listitem>
100                 
101             </varlistentry>
102             
103             <varlistentry>
104                 
105                 <term>theta, alpha</term>
106                 
107                 <listitem>
108                     
109                     <para>観測点の球座標を指定する実数値(単位:度).</para>
110                     
111                 </listitem>
112                 
113             </varlistentry>
114             
115             <varlistentry>
116                 
117                 <term>leg</term>
118                 
119                 <listitem>
120                     
121                     <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
122                         
123                         "X@Y@Z"のようになります.
124                         
125                     </para>
126                     
127                 </listitem>
128                 
129             </varlistentry>
130             
131             <varlistentry>
132                 
133                 <term>flag</term>
134                 
135                 <listitem>
136                     
137                     <para>大きさ4の実数ベクトル.
138                         
139                         <literal>flag=[vertical_color, horizontal_color,type,box]</literal>.
140                         
141                     </para>
142                     
143                     <variablelist>
144                         
145                         <varlistentry>
146                             
147                             <term>vertical_color</term>
148                             
149                             <listitem>
150                                 
151                                 <para>整数 (曲面の色), デフォルトは 3.</para>
152                                 
153                                 <para>縦方向のエッジを描画する際に使用される色を定義するカラーマップのインデックス.</para>
154                                 
155                             </listitem>
156                             
157                         </varlistentry>
158                         
159                         <varlistentry>
160                             
161                             <term>horizontal_color</term>
162                             
163                             <listitem>
164                                 
165                                 <para>整数 (曲面の色), デフォルトは 4.</para>
166                                 
167                                 <para>水平方向のエッジを描画する際に使用される色を定義するカラーマップのインデックス.</para>
168                                 
169                             </listitem>
170                             
171                         </varlistentry>
172                         
173                         <varlistentry>
174                             
175                             <term>type</term>
176                             
177                             <listitem>
178                                 
179                                 <para>整数 (スケール).</para>
180                                 
181                                 <variablelist>
182                                     
183                                     <varlistentry>
184                                         
185                                         <term>type=0:</term>
186                                         
187                                         <listitem>
188                                             
189                                             <para>プロットは
190                                                 
191                                                 (前の<literal>param3d</literal>,
192                                                 
193                                                 <literal>plot3d</literal>, <literal>contour</literal> または
194                                                 
195                                                 <literal>plot3d1</literal>のコールで設定された)
196                                                 
197                                                 カレントの3次元スケールで行われます.
198                                                 
199                                             </para>
200                                             
201                                         </listitem>
202                                         
203                                     </varlistentry>
204                                     
205                                     <varlistentry>
206                                         
207                                         <term>type=1:</term>
208                                         
209                                         <listitem>
210                                             
211                                             <para>
212                                                 
213                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
214                                                 
215                                                 自動的に調整され,
216                                                 
217                                                 境界はオプションの引数<literal>ebox</literal>の値で
218                                                 
219                                                 指定されます.
220                                                 
221                                             </para>
222                                             
223                                         </listitem>
224                                         
225                                     </varlistentry>
226                                     
227                                     <varlistentry>
228                                         
229                                         <term>type=2:</term>
230                                         
231                                         <listitem>
232                                             
233                                             <para>
234                                                 
235                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
236                                                 
237                                                 自動的に調整され,境界は指令したデータにより計算されます.
238                                                 
239                                             </para>
240                                             
241                                         </listitem>
242                                         
243                                     </varlistentry>
244                                     
245                                     <varlistentry>
246                                         
247                                         <term>type=3:</term>
248                                         
249                                         <listitem>
250                                             
251                                             <para>
252                                                 
253                                                 オプション<literal>ebox</literal>で指定したボックス境界を有する
254                                                 
255                                                 3次元等軸プロットで,<literal>type=1</literal>に似ています.
256                                                 
257                                             </para>
258                                             
259                                         </listitem>
260                                         
261                                     </varlistentry>
262                                     
263                                     <varlistentry>
264                                         
265                                         <term>type=4:</term>
266                                         
267                                         <listitem>
268                                             
269                                             <para>データで定義された境界に基づく3次元等軸プロットで,
270                                                 
271                                                 <literal>type=2</literal>に似ています.
272                                                 
273                                             </para>
274                                             
275                                         </listitem>
276                                         
277                                     </varlistentry>
278                                     
279                                     <varlistentry>
280                                         
281                                         <term>type=5:</term>
282                                         
283                                         <listitem>
284                                             
285                                             <para>
286                                                 
287                                                 オプション<literal>ebox</literal>で指定されたボックス境界で
288                                                 
289                                                 定義された境界に基づく3次元拡張等軸プロットで,
290                                                 
291                                                 <literal>type=1</literal>に似ています.
292                                                 
293                                             </para>
294                                             
295                                         </listitem>
296                                         
297                                     </varlistentry>
298                                     
299                                     <varlistentry>
300                                         
301                                         <term>type=6:</term>
302                                         
303                                         <listitem>
304                                             
305                                             <para>
306                                                 
307                                                 データで定義された境界に基づく3次元拡張等軸プロットで,
308                                                 
309                                                 <literal>type=2</literal>に似ています.
310                                                 
311                                                 軸の境界は axes エンティティプロパティによりカスタマイズできる
312                                                 
313                                                 ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
314                                                 
315                                             </para>
316                                             
317                                         </listitem>
318                                         
319                                     </varlistentry>
320                                     
321                                 </variablelist>
322                                 
323                             </listitem>
324                             
325                         </varlistentry>
326                         
327                         <varlistentry>
328                             
329                             <term>box</term>
330                             
331                             <listitem>
332                                 
333                                 <para>整数 (プロットの周囲のフレーム).</para>
334                                 
335                                 <variablelist>
336                                     
337                                     <varlistentry>
338                                         
339                                         <term>box=0:</term>
340                                         
341                                         <listitem>
342                                             
343                                             <para>プロットの周囲に何も描画されません.</para>
344                                             
345                                         </listitem>
346                                         
347                                     </varlistentry>
348                                     
349                                     <varlistentry>
350                                         
351                                         <term>box=1:</term>
352                                         
353                                         <listitem>
354                                             
355                                             <para>実装されていません (box=0と同様).</para>
356                                             
357                                         </listitem>
358                                         
359                                     </varlistentry>
360                                     
361                                     <varlistentry>
362                                         
363                                         <term>box=2:</term>
364                                         
365                                         <listitem>
366                                             
367                                             <para>曲面の背後の軸のみが描画されます.</para>
368                                             
369                                         </listitem>
370                                         
371                                     </varlistentry>
372                                     
373                                     <varlistentry>
374                                         
375                                         <term>box=3:</term>
376                                         
377                                         <listitem>
378                                             
379                                             <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
380                                             
381                                         </listitem>
382                                         
383                                     </varlistentry>
384                                     
385                                     <varlistentry>
386                                         
387                                         <term>box=4:</term>
388                                         
389                                         <listitem>
390                                             
391                                             <para>
392                                                 
393                                                 曲面を囲うボックスが描画され,キャプションと軸が追加されます.
394                                                 
395                                             </para>
396                                             
397                                             <para>
398                                                 
399                                                 軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
400                                                 
401                                                 できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
402                                                 
403                                             </para>
404                                             
405                                         </listitem>
406                                         
407                                     </varlistentry>
408                                     
409                                 </variablelist>
410                                 
411                             </listitem>
412                             
413                         </varlistentry>
414                         
415                     </variablelist>
416                     
417                 </listitem>
418                 
419             </varlistentry>
420             
421             <varlistentry>
422                 
423                 <term>ebox</term>
424                 
425                 <listitem>
426                     
427                     <para>
428                         
429                         プロットの境界をベクトル
430                         
431                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します. 
432                         
433                         この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
434                         
435                         <literal>3</literal> または <literal>5</literal>に設定された場合,
436                         
437                         使用されます (対応する動作については上記参照). 
438                         
439                         <literal>flag</literal> が指定されない場合
440                         
441                         <literal>ebox</literal> は無視されます. 
442                         
443                     </para>
444                     
445                     <para>
446                         
447                         指定された場合, <literal>ebox</literal>引数は,
448                         
449                         <literal>data_bounds</literal>に基づいて動作し,
450                         
451                         axesエンティティのプロパティによりリセットすることも可能であることに
452                         
453                         注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
454                         
455                     </para>
456                     
457                 </listitem>
458                 
459             </varlistentry>
460             
461         </variablelist>
462         
463     </refsection>
464     
465     <refsection>
466         
467         <title>説明</title>
468         
469         <para>
470             
471             <literal>plot3d3</literal> は矩形の小平面で定義される曲面の
472             
473             メッシュ状のプロットを行ないます.
474             
475             (X,Y,Z) は曲面を記述する3つの行列です.
476             
477             曲面は4角形のポリゴンで構成されます.
478             
479         </para>
480         
481         <para>
482             
483             小平面のX座標は
484             
485             X(i,j), X(i+1,j), X(i+1,j+1) および X(i,j+1)で指定されます. 同様に行列 Y および Z 
486             
487             はYおよびZ座標を有します.
488             
489         </para>
490         
491         <para>
492             
493             <literal>vect</literal>ベクトルは
494             
495             同じ(X,Y,Z)行列に複数の曲面がコード化される場合に使用されます.
496             
497             <literal>vect(j)</literal> はj番目の曲面が開始されるコードの場所の
498             
499             行番号です.詳細な説明は
500             
501             <literal>plot3d2</literal>を参照ください.
502             
503             mesh プロットと同様,編集可能な唯一利用可能なプロパティは
504             
505             <literal>visible</literal>オプションです
506             
507             (<link linkend="axes_properties">axes_properties</link>参照).
508             
509         </para>
510         
511     </refsection>
512     
513     <refsection>
514         
515         <title>例</title>
516         
517         <programlisting role="example"><![CDATA[ 
518
519 u = linspace(-%pi/2,%pi/2,40);
520
521 v = linspace(0,2*%pi,20);
522
523 X = cos(u)'*cos(v);
524
525 Y = cos(u)'*sin(v);
526
527 Z = sin(u)'*ones(v);
528
529 plot3d3(X,Y,Z);
530
531 e=gce(); // カレントのエンティティを取得
532
533 e.visible='off';
534
535 e.visible='on'; // メッシュビューに戻す
536
537  ]]></programlisting>
538         
539         <scilab:image>u = linspace(-%pi/2,%pi/2,40);
540             
541             v = linspace(0,2*%pi,20);
542             
543             X = cos(u)'*cos(v);
544             
545             Y = cos(u)'*sin(v);
546             
547             Z = sin(u)'*ones(v);
548             
549             plot3d3(X,Y,Z);
550             
551         </scilab:image>
552         
553     </refsection>
554     
555     <refsection role="see also">
556         
557         <title>参照</title>
558         
559         <simplelist type="inline">
560             
561             <member>
562                 
563                 <link linkend="plot3d2">plot3d2</link>
564                 
565             </member>
566             
567             <member>
568                 
569                 <link linkend="plot3d">plot3d</link>
570                 
571             </member>
572             
573             <member>
574                 
575                 <link linkend="param3d">param3d</link>
576                 
577             </member>
578             
579         </simplelist>
580         
581     </refsection>
582     
583 </refentry>
584