Remove all the authors from the documentation. This has been done for the following...
[scilab.git] / scilab / modules / graphics / help / ja_JP / 3d_plot / plot3d1.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) ENPC - Jean-Philippe Chancelier
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <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" version="5.0-subset Scilab" xml:lang="ja" xml:id="plot3d1">
14   <info>
15     <pubdate>$LastChangedDate$</pubdate>
16   </info>
17   <refnamediv>
18     <refname>plot3d1</refname>
19     <refpurpose>曲面の3次元白黒またはカラープロット</refpurpose>
20   </refnamediv>
21   <refsynopsisdiv>
22     <title>呼び出し手順</title>
23     <synopsis>plot3d1(x,y,z,[theta,alpha,leg,flag,ebox])
24       plot3d1(xf,yf,zf,[theta,alpha,leg,flag,ebox])
25       
26       plot3d1(x,y,z,&lt;opts_args&gt;)
27       plot3d1(xf,yf,zf,&lt;opts_args&gt;)
28     </synopsis>
29   </refsynopsisdiv>
30   <refsection>
31     <title>パラメータ</title>
32     <variablelist>
33       <varlistentry>
34         <term>x,y</term>
35         <listitem>
36           <para>大きさ n1 および n2 の行ベクトル(x軸およびy軸座標
37             ). これらの座標は単調である必要があります.
38           </para>
39         </listitem>
40       </varlistentry>
41       <varlistentry>
42         <term>z</term>
43         <listitem>
44           <para>
45             大きさ (n1,n2)の行列. <literal>z(i,j)</literal> は点(x(i),y(j))における
46             曲面の値です.
47           </para>
48         </listitem>
49       </varlistentry>
50       <varlistentry>
51         <term>xf,yf,zf</term>
52         <listitem>
53           <para>大きさ (nf,n)の行列. 曲面を描画する際に使用される小平面を定義します.
54             <literal>n</literal>個の小平面があります. 各小平面
55             <literal>i</literal> は<literal>nf</literal>個の点を有するポリゴンで定義されます.
56             i番目の小平面の点のx軸,y軸,z軸座標はそれぞれ<literal>xf(:,i)</literal>, 
57             <literal>yf(:,i)</literal> および  <literal>zf(:,i)</literal>により指定されます.
58           </para>
59         </listitem>
60       </varlistentry>
61       <varlistentry>
62         <term>&lt;opt_args&gt;</term>
63         <listitem>
64           <para>
65             一連の命令<literal>key1=value1,
66               key2=value2
67             </literal>
68             ,...を表し, <literal>key1</literal>,
69             <literal>key2,...</literal> は以下のどれかとすることができます: theta,
70             alpha ,leg,flag,ebox (以下の定義を参照).
71           </para>
72         </listitem>
73       </varlistentry>
74       <varlistentry>
75         <term>theta, alpha</term>
76         <listitem>
77           <para>観測点の球座標を指定する実数値(単位:度).</para>
78         </listitem>
79       </varlistentry>
80       <varlistentry>
81         <term>leg</term>
82         <listitem>
83           <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
84             "X@Y@Z"のようになります.
85           </para>
86         </listitem>
87       </varlistentry>
88       <varlistentry>
89         <term>flag</term>
90         <listitem>
91           <para>大きさ3の実数ベクトル.
92             <literal>flag=[mode,type,box]</literal>.
93           </para>
94           <variablelist>
95             <varlistentry>
96               <term>mode</term>
97               <listitem>
98                 <para>整数 (曲面の色).</para>
99                 <variablelist>
100                   <varlistentry>
101                     <term>mode&gt;0</term>
102                     <listitem>
103                       <para>
104                         曲面は色<literal>"mode"</literal>で塗られます ;
105                         小平面の境界はカレントの線種と色で描画されます.
106                       </para>
107                     </listitem>
108                   </varlistentry>
109                   <varlistentry>
110                     <term>mode=0:</term>
111                     <listitem>
112                       <para>曲面のメッシュが描画されます.</para>
113                     </listitem>
114                   </varlistentry>
115                   <varlistentry>
116                     <term>mode&lt;0:</term>
117                     <listitem>
118                       <para>
119                         曲面は色<literal>"-mode"</literal>で塗られます ;
120                         小平面の境界は描画されません.
121                       </para>
122                       <para>曲面の色の取り扱いは,
123                         surfaceエンティティプロパティによる
124                         <literal>color_mode</literal>および
125                         <literal>color_flag</literal>オプションを用いて
126                         行われることに注意してください (<link linkend="surface_properties">surface_properties</link>参照).
127                       </para>
128                     </listitem>
129                   </varlistentry>
130                 </variablelist>
131               </listitem>
132             </varlistentry>
133             <varlistentry>
134               <term>type</term>
135               <listitem>
136                 <para>整数 (スケール).</para>
137                 <variablelist>
138                   <varlistentry>
139                     <term>type=0:</term>
140                     <listitem>
141                       <para>プロットは
142                         (前の<literal>param3d</literal>,
143                         <literal>plot3d</literal>, <literal>contour</literal> または
144                         <literal>plot3d1</literal>のコールで設定された)
145                         カレントの3次元スケールで行われます.
146                       </para>
147                     </listitem>
148                   </varlistentry>
149                   <varlistentry>
150                     <term>type=1:</term>
151                     <listitem>
152                       <para>
153                         3次元ボックスのスケールがアスペクト比の最大値に基づき
154                         自動的に調整され,
155                         境界はオプションの引数<literal>ebox</literal>の値で
156                         指定されます.
157                       </para>
158                     </listitem>
159                   </varlistentry>
160                   <varlistentry>
161                     <term>type=2:</term>
162                     <listitem>
163                       <para>
164                         3次元ボックスのスケールがアスペクト比の最大値に基づき
165                         自動的に調整され,境界は指令したデータにより計算されます.
166                       </para>
167                     </listitem>
168                   </varlistentry>
169                   <varlistentry>
170                     <term>type=3:</term>
171                     <listitem>
172                       <para>
173                         オプション<literal>ebox</literal>で指定したボックス境界を有する
174                         3次元等軸プロットで,<literal>type=1</literal>に似ています.
175                       </para>
176                     </listitem>
177                   </varlistentry>
178                   <varlistentry>
179                     <term>type=4:</term>
180                     <listitem>
181                       <para>データで定義された境界に基づく3次元等軸プロットで,
182                         <literal>type=2</literal>に似ています.
183                       </para>
184                     </listitem>
185                   </varlistentry>
186                   <varlistentry>
187                     <term>type=5:</term>
188                     <listitem>
189                       <para>
190                         オプション<literal>ebox</literal>で指定されたボックス境界で
191                         定義された境界に基づく3次元拡張等軸プロットで,
192                         <literal>type=1</literal>に似ています.
193                       </para>
194                     </listitem>
195                   </varlistentry>
196                   <varlistentry>
197                     <term>type=6:</term>
198                     <listitem>
199                       <para>
200                         データで定義された境界に基づく3次元拡張等軸プロットで,
201                         <literal>type=2</literal>に似ています.
202                         軸の境界は axes エンティティプロパティによりカスタマイズできる
203                         ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
204                       </para>
205                     </listitem>
206                   </varlistentry>
207                 </variablelist>
208               </listitem>
209             </varlistentry>
210             <varlistentry>
211               <term>box</term>
212               <listitem>
213                 <para>整数 (プロットの周囲のフレーム).</para>
214                 <variablelist>
215                   <varlistentry>
216                     <term>box=0:</term>
217                     <listitem>
218                       <para>プロットの周囲に何も描画されません.</para>
219                     </listitem>
220                   </varlistentry>
221                   <varlistentry>
222                     <term>box=1:</term>
223                     <listitem>
224                       <para>実装されていません (box=0と同様).</para>
225                     </listitem>
226                   </varlistentry>
227                   <varlistentry>
228                     <term>box=2:</term>
229                     <listitem>
230                       <para>曲面の背後の軸のみが描画されます.</para>
231                     </listitem>
232                   </varlistentry>
233                   <varlistentry>
234                     <term>box=3:</term>
235                     <listitem>
236                       <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
237                     </listitem>
238                   </varlistentry>
239                   <varlistentry>
240                     <term>box=4:</term>
241                     <listitem>
242                       <para>
243                         曲面を囲うボックスが描画され,キャプションと軸が追加されます.
244                       </para>
245                       <para>
246                         軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
247                         できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
248                       </para>
249                     </listitem>
250                   </varlistentry>
251                 </variablelist>
252               </listitem>
253             </varlistentry>
254           </variablelist>
255         </listitem>
256       </varlistentry>
257       <varlistentry>
258         <term>ebox</term>
259         <listitem>
260           <para>
261             プロットの境界をベクトル
262             <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します. 
263             この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
264             <literal>3</literal> または <literal>5</literal>に設定された場合,
265             使用されます (対応する動作については上記参照). 
266             <literal>flag</literal> が指定されない場合
267             <literal>ebox</literal> は無視されます. 
268           </para>
269           <para>
270             指定された場合, <literal>ebox</literal>引数は,
271             <literal>data_bounds</literal>に基づいて動作し,
272             axesエンティティのプロパティによりリセットすることも可能であることに
273             注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
274           </para>
275         </listitem>
276       </varlistentry>
277     </variablelist>
278   </refsection>
279   <refsection>
280     <title>説明</title>
281     <para>
282       <literal>plot3d1</literal> は曲面のzのレベルに基づく色の曲面を
283       プロットします.
284       この特別なプロット関数は,<literal>plot3d</literal>の後で
285       <literal>color_flag=1</literal>を設定することにより有効にすることができます.
286       (
287       <link linkend="surface_properties">surface_properties</link>参照)
288     </para>
289     <para>
290       コマンド <literal>plot3d1()</literal> によりデモを参照できます.
291     </para>
292   </refsection>
293   <refsection>
294     <title>例</title>
295     <programlisting role="example"><![CDATA[ 
296 // z=f(x,y) によりプロットする
297 t=[0:0.3:2*%pi]'; z=sin(t)*cos(t'); 
298 plot3d1(t,t,z) 
299 // genfac3d により計算された小平面を用いて同様にプロット
300 [xx,yy,zz]=genfac3d(t,t,z); 
301 clf(); 
302 plot3d1(xx,yy,zz) 
303 // 複数のプロット 
304 clf(); 
305 plot3d1([xx xx],[yy yy],[zz 4+zz]) 
306 // 視点とキャプションを指定してプロット
307 clf() ;
308 plot3d1(1:10,1:20,10*rand(10,20),35,45,"X@Y@Z",[2,2,3]) 
309 // グリッドを指定せずにプロット 
310 clf() 
311 plot3d1(1:10,1:20,10*rand(10,20),35,45,"X@Y@Z",[-2,2,3]) 
312 // eval3dp により計算される小平面により球をプロット
313 deff("[x,y,z]=sph(alp,tet)",["x=r*cos(alp).*cos(tet)+orig(1)*ones(tet)";.. 
314 "y=r*cos(alp).*sin(tet)+orig(2)*ones(tet)";.. 
315 "z=r*sin(alp)+orig(3)*ones(tet)"]); 
316 r=1; orig=[0 0 0]; 
317 [xx,yy,zz]=eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,20)); 
318 clf() 
319
320 plot3d(xx,yy,zz)
321 e=gce();
322 e.color_flag=1;
323 scf(2);
324 plot3d1(xx,yy,zz) // 2つのグラフィックは同じ
325  ]]></programlisting>
326   </refsection>
327   <refsection role="see also">
328     <title>参照</title>
329     <simplelist type="inline">
330       <member>
331         <link linkend="plot3d">plot3d</link>
332       </member>
333       <member>
334         <link linkend="gca">gca</link>
335       </member>
336       <member>
337         <link linkend="gce">gce</link>
338       </member>
339       <member>
340         <link linkend="scf">scf</link>
341       </member>
342       <member>
343         <link linkend="clf">clf</link>
344       </member>
345     </simplelist>
346   </refsection>
347 </refentry>