update banners
[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
12  * Copyright (C) 2012 - 2016 - Scilab Enterprises
13  *
14  * This file is hereby licensed under the terms of the GNU GPL v2.0,
15  * pursuant to article 5.3.4 of the CeCILL v.2.1.
16  * This file was originally licensed under the terms of the CeCILL v2.1,
17  * and continues to be available under such terms.
18  * For more information, see the COPYING file which you should have received
19  * along with this program.
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 scf(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