update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / 2d_plot / fec.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) INRIA
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="fec">
26     
27     <refnamediv>
28         
29         <refname>fec</refname>
30         
31         <refpurpose>三角メッシュ上に定義された関数の擬似カラープロット</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>fec(x,y,triangles,func,&lt;opt_args&gt;)
40             
41             fec(x,y,triangles,func,[strf,leg,rect,nax,zminmax,colminmax,colout,mesh])
42             
43         </synopsis>
44         
45     </refsynopsisdiv>
46     
47     <refsection>
48         
49         <title>引数</title>
50         
51         <variablelist>
52             
53             <varlistentry>
54                 
55                 <term>x,y</term>
56                 
57                 <listitem>
58                     
59                     <para>
60                         
61                         大きさ <literal>n</literal>のベクトル, 
62                         
63                         <literal>(x(i),y(i))</literal> は
64                         
65                         ノード  <literal>i</literal>の座標を定義します
66                         
67                     </para>
68                     
69                 </listitem>
70                 
71             </varlistentry>
72             
73             <varlistentry>
74                 
75                 <term>func</term>
76                 
77                 <listitem>
78                     
79                     <para>
80                         
81                         大きさ <literal>n</literal>のベクトル : <literal>func(i)</literal> 
82                         
83                         は,擬似カラープロットを行う関数のノード <literal>i</literal>における値を定義します.
84                         
85                     </para>
86                     
87                 </listitem>
88                 
89             </varlistentry>
90             
91             <varlistentry>
92                 
93                 <term>triangles</term>
94                 
95                 <listitem>
96                     
97                     <para>
98                         
99                         <literal>[Ntr,5]</literal> 行列.
100                         
101                         <literal>triangles</literal>の各行は,メッシュの三角形
102                         
103                         <literal>triangle(j) = [number,node1,node2,node3,flag]</literal>
104                         
105                         を定義します.
106                         
107                         <literal>node1,node2,node3</literal> は三角形を構成するノードの番号です.
108                         
109                         number は三角形の番号で,flag は fec 関数では使用されない整数です.
110                         
111                     </para>
112                     
113                 </listitem>
114                 
115             </varlistentry>
116             
117             <varlistentry>
118                 
119                 <term>&lt;opt_args&gt;</term>
120                 
121                 <listitem>
122                     
123                     <para>
124                         
125                         一連の命令 <literal>key1=value1, key2=value2</literal>,... を
126                         
127                         表し, この命令には以下のどれかを指定できます:
128                         
129                         strf, leg, rect, nax, zminmax, colminmax, colout, mesh
130                         
131                         (最初の4つについては<link linkend="plot2d">plot2d</link>を参照).
132                         
133                     </para>
134                     
135                 </listitem>
136                 
137             </varlistentry>
138             
139             <varlistentry>
140                 
141                 <term>strf,leg,rect,nax</term>
142                 
143                 <listitem>
144                     
145                     <para>see plot2d</para>
146                     
147                 </listitem>
148                 
149             </varlistentry>
150             
151             <varlistentry>
152                 
153                 <term>zminmax</term>
154                 
155                 <listitem>
156                     
157                     <para>要素 [zmin zmax]を有するベクトル (特にアニメーションの場合に有用)</para>
158                     
159                 </listitem>
160                 
161             </varlistentry>
162             
163             <varlistentry>
164                 
165                 <term>colminmax</term>
166                 
167                 <listitem>
168                     
169                     <para>2つの正の整数 [colmin colmax]のベクトル</para>
170                     
171                 </listitem>
172                 
173             </varlistentry>
174             
175             <varlistentry>
176                 
177                 <term>colout</term>
178                 
179                 <listitem>
180                     
181                     <para>要素数2の定数ベクトル [under_min_col upper_max_col]</para>
182                     
183                 </listitem>
184                 
185             </varlistentry>
186             
187             <varlistentry>
188                 
189                 <term>mesh</term>
190                 
191                 <listitem>
192                     
193                     <para>論理値スカラー, デフォルト値e %f (メッシュも表示させたい場合には true にしてください)</para>
194                     
195                 </listitem>
196                 
197             </varlistentry>
198             
199         </variablelist>
200         
201     </refsection>
202     
203     <refsection>
204         
205         <title>説明</title>
206         
207         <para>この関数は,線形三角有限要素解を描画する際や単に
208             
209             三角形分割により定義された関数を表示する際に有用です.
210             
211             ソフトウエア計算による色補間が行われるため,極めて高速という
212             
213             わけではありません.
214             
215         </para>
216         
217         <para>
218             
219             関数 <link linkend="colorbar">colorbar</link> は色スケールを
220             
221             参照するためにも使用できます(例の節を参照).
222             
223         </para>
224         
225         <para>    
226             
227             引数<literal>zminmax</literal> は(カレントのカラーマップにおける)最初と
228             
229             最後の色に関連するzの値を指定します.
230             
231             カラーマップが nc 個の色を有し,
232             
233             <emphasis>dz = (zmax-zmin)/nc</emphasis>とすると,
234             
235             <emphasis>zmin + (i-1)dz &lt;= z &lt; zmin + i dz</emphasis>となる
236             
237             三角形分割された部分は色<emphasis>i</emphasis>で塗りつぶされます.
238             
239             デフォルトでは,<emphasis>zmin = min(func)</emphasis> および
240             
241             <emphasis>zmax = max(func)</emphasis>となります.
242             
243             時間で変化するう関数の値でアニメーションを行いたい場合,
244             
245             zmin および zmax グローバルな最小値および最大値もしくはそれに近い値
246             
247         </para>
248         
249         <para>
250             
251             引数 <literal>colout</literal> により2つの極値領域
252             
253             <emphasis>{func &lt; zmin}</emphasis> および <emphasis>{func &gt; zmax}</emphasis>
254             
255             の色をユーザが選択できるようになります.
256             
257             <literal>under_min_col</literal> および
258             
259             <literal>upper_max_col</literal> の色は(独立で)以下と同じにすることができます:
260             
261         </para>
262         
263         <variablelist>
264             
265             <varlistentry>
266                 
267                 <term>-1</term>
268                 
269                 <listitem>
270                     
271                     <para>この場合,近いゾーンでは同じ色が使用されます
272                         
273                         (注意: 対応する極値が交差する場合,判別できません),
274                         
275                         これがデフォルトです.
276                         
277                     </para>
278                     
279                 </listitem>
280                 
281             </varlistentry>
282             
283             <varlistentry>
284                 
285                 <term>0</term>
286                 
287                 <listitem>
288                     
289                     <para>この場合,極値領域は塗られません.</para>
290                     
291                 </listitem>
292                 
293             </varlistentry>
294             
295             <varlistentry>
296                 
297                 <term>k</term>
298                 
299                 <listitem>
300                     
301                     <para>(k はカレントのカラーマップへの有効なインデックス)
302                         
303                         極値領域は色 kで塗られます.
304                         
305                     </para>
306                     
307                 </listitem>
308                 
309             </varlistentry>
310             
311         </variablelist>
312         
313         <para>
314             
315             完全なカラーマップを使用したくない場合,
316             
317             <emphasis>1 &lt;= colmin &lt; colmax &lt;= nc</emphasis>となるような
318             
319             <literal>colminmax</literal>引数を使用できます
320             
321             (nc はカレントのカラーマップの色の数).
322             
323             この場合,カラーマップの一部 [colmin,colmax]のみが使用されます.
324             
325             (デフォルトではカラーマップの全ての色が使用されます).
326             
327         </para>
328         
329         <para>
330             
331             以下のデモファイル<literal>demos/fec</literal>を参照ください:
332             
333         </para>
334         
335         <para>
336             
337             <literal>fec.ex1</literal> はメッシュおよびメッシュ上の関数
338             
339             に関する簡単なデモファイルで完全に Scilab 構文で構築されています.
340             
341         </para>
342         
343         <para>
344             
345             <literal>fec.ex2</literal> は,
346             
347             メッシュおよび関数値が外部のメッシュビルダ(amdba 型のメッシュ)
348             
349             および外部プログラムで計算される例です.
350             
351             ( ファイル <literal>macros.sci</literal>で提供される)一連のマクロを
352             
353             Scilabにデータファイルを読み込み,結果をプロットする際に使用することができます.
354             
355         </para>
356         
357     </refsection>
358     
359     <refsection>
360         
361         <title>例</title>
362         
363         <programlisting role="example"><![CDATA[ 
364
365 // 小規模な三角形分割を定義 (頂点:4, 三角形:2 )
366
367 x = [0 1 0 -1];
368
369 y = [0 0 1  1];
370
371 T = [1 1 2 3 1;
372
373      2 3 4 1 1];
374
375 z = [0 1 0 -1];  // 各頂点における関数の値
376
377 clf()
378
379 xset("colormap",jetcolormap(64))
380
381 subplot(1,2,1)
382
383   colorbar(-1,1)
384
385   fec(x,y,T,z,strf="040",mesh=%t)
386
387   xtitle("fec example (with the mesh)")
388
389 subplot(1,2,2)
390
391   colorbar(-1,1)
392
393   fec(x,y,T,z,strf="040")  // rmq:デフォルトでは mesh=%f 
394
395   xtitle("fec example (without the mesh)")
396
397 show_window()
398
399  ]]></programlisting>
400         
401         <scilab:image>
402             
403             x = [0 1 0 -1];
404             
405             y = [0 0 1  1];
406             
407             T = [1 1 2 3 1;
408             
409             2 3 4 1 1];
410             
411             z = [0 1 0 -1];  // values of the func at each vertices
412             
413             clf()
414             
415             xset("colormap",jetcolormap(64))
416             
417             subplot(1,2,1)
418             
419             colorbar(-1,1)
420             
421             fec(x,y,T,z,strf="040",mesh=%t)
422             
423             xtitle("fec example (with the mesh)")
424             
425             subplot(1,2,2)
426             
427             colorbar(-1,1)
428             
429             fec(x,y,T,z,strf="040")  // rmq: mesh=%f by default
430             
431             xtitle("fec example (without the mesh)")
432             
433             show_window()
434             
435         </scilab:image>
436         
437         <programlisting role="example"><![CDATA[ 
438
439 // 小規模な三角形分割を定義  (頂点:4, 三角形:2 )
440
441 x = [0 1 0 -1];
442
443 y = [0 0 1  1];
444
445 T = [1 1 2 3 1;
446
447      2 3 4 1 1];
448
449 z = [0 1 0 -1];  // 各頂点におけるfuncの値
450
451 // この例は zminmax の効果を示し, 前の例のデータを使用します
452
453 // (前の例を事前に実行している必要があります)
454
455 clf()
456
457 xset("colormap",jetcolormap(64))
458
459 colorbar(-0.5,0.5)  // カラーバーをマニュアルで設定する必要があることに注意 !
460
461 fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], mesh=%t)
462
463 xtitle("fec example : using zminmax argument")
464
465 show_window()
466
467  ]]></programlisting>
468         
469         <scilab:image>
470             
471             x = [0 1 0 -1];
472             
473             y = [0 0 1  1];
474             
475             T = [1 1 2 3 1;
476             
477             2 3 4 1 1];
478             
479             z = [0 1 0 -1];  // values of the func at each vertices
480             
481             // this example shows the effect of zminmax and uses the
482             
483             // previous example data (you have to execute the it before)
484             
485             clf()
486             
487             xset("colormap",jetcolormap(64))
488             
489             colorbar(-0.5,0.5)  // be careful colorbar must be set by hands !
490             
491             fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], mesh=%t)
492             
493             xtitle("fec example : using zminmax argument")
494             
495             show_window()
496             
497         </scilab:image>
498         
499         <programlisting role="example"><![CDATA[ 
500
501 // 小規模な三角形分割を定義  (頂点:4, 三角形:2 )
502
503 x = [0 1 0 -1];
504
505 y = [0 0 1  1];
506
507 T = [1 1 2 3 1;
508
509      2 3 4 1 1];
510
511 z = [0 1 0 -1];  // 各頂点におけるfuncの値
512
513 // この例は zminmax および colout の効果を示します.
514
515 // この例も最初の例のデータを使用します.
516
517 // (前の例を事前に実行している必要があります)
518
519 clf()
520
521 xset("colormap",jetcolormap(64))
522
523 subplot(2,2,1)
524
525   colorbar(-0.5,0.5)
526
527   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[0 0], mesh=%t)
528
529   xtitle("fec example : using zminmax and colout =[0 0]")
530
531 subplot(2,2,2)
532
533   colorbar(-0.5,0.5)
534
535   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[32 32], mesh=%t)
536
537   xtitle("fec example : using zminmax and colout =[32 32]")
538
539 subplot(2,2,3)
540
541   colorbar(-0.5,0.5)
542
543   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[-1 0], mesh=%t)
544
545   xtitle("fec example : using zminmax and colout =[-1 0]")
546
547 subplot(2,2,4)
548
549   colorbar(-0.5,0.5)
550
551   fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[0 -1], mesh=%t)
552
553   xtitle("fec example : using zminmax and colout =[0 -1]")
554
555 show_window()
556
557  ]]></programlisting>
558         
559         <scilab:image>
560             
561             // define a mini triangulation (4 vertices, 2 triangles)
562             
563             x = [0 1 0 -1];
564             
565             y = [0 0 1  1];
566             
567             T = [1 1 2 3 1;
568             
569             2 3 4 1 1];
570             
571             z = [0 1 0 -1];  // values of the func at each vertices
572             
573             // this example shows the effect of zminmax and colout. It uses
574             
575             // also the data of the first example (you have to execute the it before)
576             
577             clf()
578             
579             xset("colormap",jetcolormap(64))
580             
581             subplot(2,2,1)
582             
583             colorbar(-0.5,0.5)
584             
585             fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[0 0], mesh=%t)
586             
587             xtitle("fec example : using zminmax and colout =[0 0]")
588             
589             subplot(2,2,2)
590             
591             colorbar(-0.5,0.5)
592             
593             fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[32 32], mesh=%t)
594             
595             xtitle("fec example : using zminmax and colout =[32 32]")
596             
597             subplot(2,2,3)
598             
599             colorbar(-0.5,0.5)
600             
601             fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[-1 0], mesh=%t)
602             
603             xtitle("fec example : using zminmax and colout =[-1 0]")
604             
605             subplot(2,2,4)
606             
607             colorbar(-0.5,0.5)
608             
609             fec(x,y,T,z,strf="040", zminmax=[-0.5 0.5], colout=[0 -1], mesh=%t)
610             
611             xtitle("fec example : using zminmax and colout =[0 -1]")
612             
613             show_window()
614             
615         </scilab:image>
616         
617         <programlisting role="example"><![CDATA[ 
618
619 // 小規模な三角形分割を定義  (頂点:4, 三角形:2 )
620
621 x = [0 1 0 -1];
622
623 y = [0 0 1  1];
624
625 T = [1 1 2 3 1;
626
627      2 3 4 1 1];
628
629 z = [0 1 0 -1];  // 各頂点におけるfuncの値
630
631
632
633 // この例は colminmax の機能を示します:
634
635 // 2つのサブプロットに 2 つのカラーマップを使用します.
636
637 // この例も最初の例のデータを使用します.
638
639 clf()
640
641 xset("colormap",[hotcolormap(64);jetcolormap(64)])
642
643 subplot(1,2,1)
644
645   colorbar(-1,1,[1 64])
646
647   fec(x,y,T,z,strf="040", colminmax=[1 64], mesh=%t)
648
649   xtitle("fec using the hot colormap")
650
651 subplot(1,2,2)
652
653   colorbar(-1,1,[65 128])
654
655   fec(x,y,T,z,strf="040", colminmax=[65 128], mesh=%t)
656
657   xtitle("fec using the jet colormap")
658
659 show_window()
660
661  ]]></programlisting>
662         
663         <scilab:image>
664             
665             // define a mini triangulation (4 vertices, 2 triangles)
666             
667             x = [0 1 0 -1];
668             
669             y = [0 0 1  1];
670             
671             T = [1 1 2 3 1;
672             
673             2 3 4 1 1];
674             
675             z = [0 1 0 -1];  // values of the func at each vertices
676             
677             
678             
679             // this example shows a feature from colminmax:
680             
681             // playing with 2 colormaps for 2 subplots. It
682             
683             // uses also the data of the first example.
684             
685             clf()
686             
687             xset("colormap",[hotcolormap(64);jetcolormap(64)])
688             
689             subplot(1,2,1)
690             
691             colorbar(-1,1,[1 64])
692             
693             fec(x,y,T,z,strf="040", colminmax=[1 64], mesh=%t)
694             
695             xtitle("fec using the hot colormap")
696             
697             subplot(1,2,2)
698             
699             colorbar(-1,1,[65 128])
700             
701             fec(x,y,T,z,strf="040", colminmax=[65 128], mesh=%t)
702             
703             xtitle("fec using the jet colormap")
704             
705             show_window()
706             
707         </scilab:image>
708         
709     </refsection>
710     
711     <refsection role="see also">
712         
713         <title>参照</title>
714         
715         <simplelist type="inline">
716             
717             <member>
718                 
719                 <link linkend="colorbar">colorbar</link>
720                 
721             </member>
722             
723             <member>
724                 
725                 <link linkend="Sfgrayplot">Sfgrayplot</link>
726                 
727             </member>
728             
729             <member>
730                 
731                 <link linkend="Sgrayplot">Sgrayplot</link>
732                 
733             </member>
734             
735         </simplelist>
736         
737     </refsection>
738     
739 </refentry>
740