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