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