update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / 2d_plot / contour2d.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: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="contour2d">
26     
27     <refnamediv>
28         
29         <refname>contour2d</refname>
30         
31         <refpurpose>2次元プロット上に曲面の等高線を描画</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>
40             
41             contour2d(x, y, z, nz, [style, strf, leg, rect, nax])
42             
43             contour2d(x, y, z, nz, &lt;opt_args&gt;)
44             
45         </synopsis>
46         
47     </refsynopsisdiv>
48     
49     <refsection>
50         
51         <title>引数</title>
52         
53         <variablelist>
54             
55             <varlistentry>
56                 
57                 <term>x,y</term>
58                 
59                 <listitem>
60                     
61                     <para>
62                         大きさ <literal>n1</literal> および <literal>n2</literal> 
63                         
64                         の実数行ベクトル: グリッド.
65                     </para>
66                     
67                 </listitem>
68                 
69             </varlistentry>
70             
71             <varlistentry>
72                 
73                 <term>z</term>
74                 
75                 <listitem>
76                     
77                     <para>
78                         大きさ<literal>(n1,n2)</literal>の実数行列, 
79                         
80                         グリッドにおける関数の値または曲面<literal>z=f(x,y)</literal>を定義する
81                         
82                         Scilab関数. 
83                         
84                     </para>
85                     
86                 </listitem>
87                 
88             </varlistentry>
89             
90             <varlistentry>
91                 
92                 <term>nz</term>
93                 
94                 <listitem>
95                     
96                     <para>等高線の値または等高線の数.</para>
97                     
98                     <variablelist>
99                         
100                         <varlistentry>
101                             
102                             <term>
103                                 
104                                 <literal>nz</literal> が整数の場合,
105                                 
106                             </term>
107                             
108                             <listitem>
109                                 
110                                 <para>
111                                     
112                                     この値は,
113                                     
114                                     以下のように <literal>zmin</literal>から
115                                     
116                                     <literal>zmax</literal> の範囲で等間隔に並んだ
117                                     
118                                     等高線の数を指定します:
119                                     
120                                 </para>
121                                 
122                                 <programlisting role="no-scilab-exec"><![CDATA[
123
124 z= zmin + (1:nz)*(zmax-zmin)/(nz+1) 
125
126  ]]></programlisting>
127                                 
128                                 <para>
129                                     
130                                     <note>
131                                         
132                                         <literal>zmin</literal> および <literal>zmax</literal>
133                                         
134                                         の等高線は描画されない
135                                         
136                                         (一般にこれらは点となります)が,
137                                         
138                                         これらは以下のコマンドにより追加できる
139                                         
140                                         ことに注意してください.
141                                         
142                                     </note>
143                                     
144                                 </para>
145                                 
146                                 <programlisting role="no-scilab-exec"><![CDATA[
147
148 [im,jm] = find(z == zmin); // または zmax
149
150 plot2d(x(im)',y(jm)',-9,"000")
151
152  ]]></programlisting>
153                                 
154                             </listitem>
155                             
156                         </varlistentry>
157                         
158                         <varlistentry>
159                             
160                             <term>
161                                 
162                                 <literal>nz</literal> がベクトルの場合, 
163                                 
164                             </term>
165                             
166                             <listitem>
167                                 
168                                 <para>
169                                     
170                                     <literal>nz(i)</literal> は,
171                                     
172                                     <literal>i</literal>番目の等高線の値を指定します.
173                                     
174                                 </para>
175                                 
176                             </listitem>
177                             
178                         </varlistentry>
179                         
180                     </variablelist>
181                     
182                 </listitem>
183                 
184             </varlistentry>
185             
186             <varlistentry>
187                 
188                 <term>&lt;opt_args&gt;</term>
189                 
190                 <listitem>
191                     
192                     <para>
193                         
194                         一連の命令 <literal>key1=value1,key2=value2</literal>,...を表します.
195                         
196                         ただし, <literal>key1</literal>,<literal>key2,...</literal>には以下のどれかを
197                         
198                         指定できます:
199                         
200                         <literal>style</literal>,
201                         
202                         <literal>leg</literal>, <literal>rect</literal>,
203                         
204                         <literal>nax</literal>, <literal>strf</literal> または
205                         
206                         <literal>axesflag</literal> および
207                         
208                         <literal>frameflag</literal>
209                         
210                         (<link linkend="plot2d">plot2d</link>参照)
211                         
212                     </para>
213                     
214                 </listitem>
215                 
216             </varlistentry>
217             
218             <varlistentry>
219                 
220                 <term>style, strf, leg, rect, nax</term>
221                 
222                 <listitem>
223                     
224                     <para>
225                         
226                         <link linkend="plot2d">plot2d</link>参照. 引数 <literal>style</literal> は,
227                         
228                         等高線で使用される破線の形式または色を指定します.
229                         
230                         その大きさは等高線の数と同じとする必要があります.
231                         
232                     </para>
233                     
234                 </listitem>
235                 
236             </varlistentry>
237             
238         </variablelist>
239         
240     </refsection>
241     
242     <refsection>
243         
244         <title>説明</title>
245         
246         <para>
247             
248             <literal>contour2d</literal> は,
249             
250             曲面<literal>z=f(x,y)</literal>の等高線を2次元プロットに描画します.
251             
252             <literal>f(x,y)</literal>の値は,
253             
254             <varname>x</varname> および <varname>y</varname>で指定されるグリッド点において
255             
256             行列<varname>z</varname>で指定します.
257             
258         </para>
259         
260         <para>
261             
262             等高線上に印字される浮動小数点数のフォーマットを
263             
264             <code>xset("fpf",string)</code>により変更することができます.
265             
266             ただし, <literal>string</literal> にはC言語の構文で
267             
268             (例えば <code>string="%.3f"</code>)でフォーマットを指定します.
269             
270             デフォルトのフォーマットに戻すには <code>string=""</code>と
271             
272             してください.
273             
274             出力を抑制するには, <code>string=" "</code>を使用してください.
275             
276             この最後の機能は, <link linkend="legends">legends</link>と組み合わせて
277             
278             等高線の数値を通常の等高線上ではなく,凡例に表示する場合に有用です.
279             
280             (例を参照)
281             
282         </para>
283         
284         <para>
285             
286             オプションの引数 <varname>style</varname>,
287             
288             <varname>strf</varname>, <varname>leg</varname>,
289             
290             <varname>rect</varname>, <varname>nax</varname>
291             
292             は,一連の命令<literal>key1=value1, key2=value2</literal>,...により
293             
294             指定できます.ただし, key は <literal>style</literal>,<literal>strf</literal>,
295             
296             <literal>leg</literal>,<literal>rect</literal>,<literal>nax</literal>
297             
298             とすることが可能です.
299             
300             この場合, 順番には特別な意味はありません.
301             
302         </para>
303         
304         <para>
305             
306             3次元曲面に等高線を描画するには,<literal>contour</literal> を使用してください.
307             
308         </para>
309         
310     </refsection>
311     
312     <refsection>
313         
314         <title>例</title>
315         
316         <scilab:image>contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11]);</scilab:image>
317         
318     </refsection>
319     
320     <refsection>
321         
322         <title>例</title>
323         
324         <programlisting role="example"><![CDATA[
325
326 contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11])
327
328  ]]></programlisting>
329         
330         <scilab:image>
331             
332             contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11]);
333             
334         </scilab:image>
335         
336         <programlisting role="example"><![CDATA[
337
338 clf()
339
340 // 等高線の出力形式を変更
341
342 xset("fpf","%.2f")
343
344 contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11])
345
346   ]]></programlisting>
347         
348         <scilab:image>
349             
350             xset("fpf","%.2f")
351             
352             contour2d(1:10,1:10,rand(10,10),5,rect=[0,0,11,11])
353             
354         </scilab:image>
355         
356         <programlisting role="example"><![CDATA[
357
358 // 等高線の値を凡例に表示
359
360 // いくつかの裏技を使用していることに注意してください...
361
362 x = linspace(0,4*%pi,80);
363
364 z = cos(x')*cos(x);
365
366 clf(); f=gcf();
367
368 xset("fpf"," ")
369
370 // 裏技 1: これにより等高線の値は
371
372 //         等高線上に描画されなくなります
373
374 f.color_map=jetcolormap(7);
375
376 // 裏技2: 等高線とインターフェイスをとることなく凡例を右に表示するために
377
378 // xmax 値を十分に大きくした rect を使用します.
379
380 contour2d(x,x,z,-0.75:0.25:0.75,frameflag=3,rect=[0,0,5*%pi,4*%pi])
381
382 // 裏技3: legendsを使用 (より実用的なlegend関数は等高線の一つの値が
383
384 //         2つの曲線により構成される場合に動作しないことに注意してください.
385
386 legends(string(-0.75:0.25:0.75),1:7,"lr");
387
388 xtitle("Some level curves of the function cos(x)cos(y)")
389
390  ]]></programlisting>
391         
392         <scilab:image localized="true">
393             
394             x = linspace(0,4*%pi,80);
395             
396             z = cos(x')*cos(x);
397             
398             
399             
400             clf(); f=gcf();
401             
402             xset("fpf"," ")
403             
404             
405             
406             f.color_map=jetcolormap(7);
407             
408             
409             
410             contour2d(x,x,z,-0.75:0.25:0.75,frameflag=3,rect=[0,0,5*%pi,4*%pi])
411             
412             
413             
414             legends(string(-0.75:0.25:0.75),1:7,"lr");
415             
416             xtitle("Some level curves of the function cos(x)cos(y)")
417             
418         </scilab:image>
419         
420     </refsection>
421     
422     <refsection role="see also">
423         
424         <title>参照</title>
425         
426         <simplelist type="inline">
427             
428             <member>
429                 
430                 <link linkend="contour">contour</link>
431                 
432             </member>
433             
434             <member>
435                 
436                 <link linkend="contour2di">contour2di</link>
437                 
438             </member>
439             
440             <member>
441                 
442                 <link linkend="plot2d">plot2d</link>
443                 
444             </member>
445             
446         </simplelist>
447         
448     </refsection>
449     
450 </refentry>
451