5bc8ddcf68f570a278889ad784e0540f3997cffc
[scilab.git] / scilab / modules / graphics / help / ja_JP / 2d_plot / polarplot.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) INRIA
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <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="polarplot">
17     <refnamediv>
18         <refname>polarplot</refname>
19         <refpurpose>極座標プロット</refpurpose>
20     </refnamediv>
21     <refsynopsisdiv>
22         <title>呼び出し手順</title>
23         <synopsis>polarplot(theta,rho,[style,strf,leg,rect])
24             polarplot(theta,rho,&lt;opt_args&gt;)
25         </synopsis>
26     </refsynopsisdiv>
27     <refsection role="parameters">
28         <title>引数</title>
29         <variablelist>
30             <varlistentry>
31                 <term>rho</term>
32                 <listitem>
33                     <para>ベクトル, 半径の値</para>
34                 </listitem>
35             </varlistentry>
36             <varlistentry>
37                 <term>theta</term>
38                 <listitem>
39                     <para>rho と同じ大きさのベクトル , 角度の値.</para>
40                 </listitem>
41             </varlistentry>
42             <varlistentry>
43                 <term>&lt;opt_args&gt;</term>
44                 <listitem>
45                     <para>
46                         一連の命令 <literal>key1=value1, key2=value2</literal>, ... ただし, keys は
47                         <literal>style</literal>,<literal>leg</literal>,<literal>rect</literal>,<literal>strf</literal>
48                         または <literal>frameflag</literal>とすることができます
49                     </para>
50                 </listitem>
51             </varlistentry>
52             <varlistentry>
53                 <term>style</term>
54                 <listitem>
55                     <para>
56                         大きさ ncの実数行ベクトル. 曲線<literal>i</literal>に適用されるスタイルは
57                         <literal>style(i)</literal>で定義されます.デフォルトのスタイルは
58                         <literal>1:nc</literal> (1は最初の曲線e, 2 は2番目,
59                         など.)です.
60                     </para>
61                     <variablelist>
62                         <varlistentry>
63                             <term>-</term>
64                             <listitem>
65                                 <para>
66                                     <literal>style(i)</literal> が負の場合, 曲線は
67                                     ID <literal>abs(style(i))+1</literal>のマーカにより描画されます;
68                                     マーカIDを参照するには<literal>xset()</literal>を使用してください.
69                                 </para>
70                             </listitem>
71                         </varlistentry>
72                         <varlistentry>
73                             <term>-</term>
74                             <listitem>
75                                 <para>
76                                     <literal>style(i)</literal> が厳密に正の場合, 色ID <literal>style(i)</literal>
77                                     を有する実線または破線ID <literal>style(i)</literal>を有する破線が使用されます;
78                                     色IDを参照するには,<literal>xset()</literal>を使用してください.
79                                 </para>
80                             </listitem>
81                         </varlistentry>
82                         <varlistentry>
83                             <term>-</term>
84                             <listitem>
85                                 <para>
86                                     曲線が1つだけ描画される場合,<literal>style</literal>は
87                                     大きさ2の行ベクトル<literal>[sty,pos]</literal>とすることができます.
88                                     ただし,<literal>sty</literal>はスタイルを指定するために使用され,
89                                     <literal>pos</literal>は1から6の範囲の整数で,関数
90                                     <literal>plot2d</literal>を複数回コールして複数の曲線をプロットし,
91                                     各曲線にキャプションを付加したい場合に有用です.
92                                 </para>
93                             </listitem>
94                         </varlistentry>
95                     </variablelist>
96                 </listitem>
97             </varlistentry>
98             <varlistentry>
99                 <term>strf</term>
100                 <listitem>
101                     <para>
102                         長さ3の文字列 <literal>"xy0"</literal>.
103                     </para>
104                     <variablelist>
105                         <varlistentry>
106                             <term>default</term>
107                             <listitem>
108                                 <para>
109                                     デフォルト値: <literal>"030"</literal>.
110                                 </para>
111                             </listitem>
112                         </varlistentry>
113                         <varlistentry>
114                             <term>x</term>
115                             <listitem>
116                                 <para>キャプションの表示を制御,</para>
117                                 <variablelist>
118                                     <varlistentry>
119                                         <term>x=0</term>
120                                         <listitem>
121                                             <para>キャプションなし.</para>
122                                         </listitem>
123                                     </varlistentry>
124                                     <varlistentry>
125                                         <term>x=1</term>
126                                         <listitem>
127                                             <para>キャプションは表示されます.
128                                                 オプションの引数<literal>leg</literal>により指定されます.
129                                             </para>
130                                         </listitem>
131                                     </varlistentry>
132                                 </variablelist>
133                             </listitem>
134                         </varlistentry>
135                         <varlistentry>
136                             <term>y</term>
137                             <listitem>
138                                 <para>フレームの計算を制御します.frameflagと同じ.</para>
139                                 <variablelist>
140                                     <varlistentry>
141                                         <term>y=0</term>
142                                         <listitem>
143                                             <para>(他の高レベルプロット関数への前のコールにより設定された)
144                                                 カレントの境界が使用されます.複数のプロットを
145                                                 重ねる際に便利です.
146                                             </para>
147                                         </listitem>
148                                     </varlistentry>
149                                     <varlistentry>
150                                         <term>y=1</term>
151                                         <listitem>
152                                             <para>
153                                                 オプションの引数 <literal>rect</literal> はプロット境界を
154                                                 指定する際に使用されます.
155                                             </para>
156                                         </listitem>
157                                     </varlistentry>
158                                     <varlistentry>
159                                         <term>y=2</term>
160                                         <listitem>
161                                             <para>
162                                                 プロットの境界は<literal>x</literal> および
163                                                 <literal>y</literal>の最小/最大値により計算されます.
164                                             </para>
165                                         </listitem>
166                                     </varlistentry>
167                                     <varlistentry>
168                                         <term>y=3</term>
169                                         <listitem>
170                                             <para>
171                                                 <literal>y=1</literal>と同じですが,等軸スケールとなります..
172                                             </para>
173                                         </listitem>
174                                     </varlistentry>
175                                     <varlistentry>
176                                         <term>y=4</term>
177                                         <listitem>
178                                             <para>
179                                                 <literal>y=2</literal> と同じですが,等軸スケールとなります.
180                                             </para>
181                                         </listitem>
182                                     </varlistentry>
183                                     <varlistentry>
184                                         <term>y=5</term>
185                                         <listitem>
186                                             <para>
187                                                 <literal>y=1</literal> と同じですが, <literal>plot2d</literal> は
188                                                 プロットの境界および軸の目盛を変更でき,
189                                                 見栄えの良いグラデーションを生成することができます.
190                                                 ズームボタンをアクティブにする時,このモードが使用されます.
191                                             </para>
192                                         </listitem>
193                                     </varlistentry>
194                                     <varlistentry>
195                                         <term>y=6</term>
196                                         <listitem>
197                                             <para>
198                                                 <literal>y=2</literal>と同じですが, <literal>plot2d</literal>は
199                                                 グラデーションの見栄えを良くするために
200                                                 プロットの境界と軸のメモリを変更できます.
201                                                 zoom関数がアクティブになった場合,このモードが使用されます.
202                                             </para>
203                                         </listitem>
204                                     </varlistentry>
205                                     <varlistentry>
206                                         <term>y=7</term>
207                                         <listitem>
208                                             <para>
209                                                 <literal>y=5</literal>と同じですが,
210                                                 新規プロットのスケールはカレントのスケールにマージされます.
211                                             </para>
212                                         </listitem>
213                                     </varlistentry>
214                                     <varlistentry>
215                                         <term>y=8</term>
216                                         <listitem>
217                                             <para>
218                                                 <literal>y=6</literal>と同じですが,
219                                                 新規プロットのスケールはカレントのスケールにマージされます.
220                                             </para>
221                                         </listitem>
222                                     </varlistentry>
223                                 </variablelist>
224                             </listitem>
225                         </varlistentry>
226                     </variablelist>
227                 </listitem>
228             </varlistentry>
229             <varlistentry>
230                 <term>leg</term>
231                 <listitem>
232                     <para>
233                         文字列. 引数<literal>strf</literal>の最初の文字が1の場合に
234                         使用されます.<literal>leg</literal> は <literal>"leg1@leg2@...."</literal>
235                         という形式で, <literal>leg1</literal>,
236                         <literal>leg2</literal>,などは,それぞれ最初の曲線のキャプション,
237                         2番目の曲線のキャプション, などです.
238                         デフォルトは <literal>""</literal>です.
239                     </para>
240                 </listitem>
241             </varlistentry>
242             <varlistentry>
243                 <term>rect</term>
244                 <listitem>
245                     <para>
246                         この引数は引数<literal>strf</literal>の2番目の文字が1,3または5の
247                         場合に使用されます. この引数は大きさ4の行ベクトルで,フレームの次元を指定します:
248                         <literal>rect=[xmin,ymin,xmax,ymax]</literal>.
249                     </para>
250                 </listitem>
251             </varlistentry>
252         </variablelist>
253     </refsection>
254     <refsection role="description">
255         <title>説明</title>
256         <para>polarplot は,角度 theta に対して半径 rho をプロットする極座標プロット
257             を作成します.
258             theta はx軸からベクトルradius (単位:ラジアン)までの角度です;
259             rho はデータ空間単位で指定されたベクトルradiusの長さです.
260             rhoの値が負の場合,対応する曲線の点が原点対称に折り返されます.
261         </para>
262     </refsection>
263     <refsection role="examples">
264         <title>例1</title>
265         <programlisting role="example"><![CDATA[
266 t= 0:.01:2*%pi;
267 clf();polarplot(sin(7*t),cos(8*t))
268  ]]></programlisting>
269         <scilab:image>
270             t= 0:.01:2*%pi;
271             polarplot(sin(7*t),cos(8*t))
272         </scilab:image>
273     </refsection>
274     <refsection role="examples">
275         <title>例2</title>
276         <programlisting role="example"><![CDATA[
277 t= 0:.01:2*%pi;
278 clf();polarplot([sin(7*t') sin(6*t')],[cos(8*t') cos(8*t')],[1,2])
279  ]]></programlisting>
280         <scilab:image>
281             t= 0:.01:2*%pi;
282             clf();polarplot([sin(7*t') sin(6*t')],[cos(8*t') cos(8*t')],[1,2])
283         </scilab:image>
284     </refsection>
285     <refsection role="examples">
286         <title>例3</title>
287         <programlisting role="example"><![CDATA[
288 t = 0:0.01:2*%pi;
289 polarplot(t, -1 + sin(t));
290  ]]></programlisting>
291         <scilab:image>
292             t = 0:0.01:2*%pi;
293             polarplot(t, -1 + sin(t));
294         </scilab:image>
295     </refsection>
296     <refsection role="examples">
297         <title>例4</title>
298         <programlisting role="example"><![CDATA[
299   clf()
300   theta = [0:0.02:2*%pi]';
301   rho = 1+0.2*cos(theta.^2);
302   polarplot(theta,rho,style=5)
303   isoview()
304   gca().data_bounds = [-1.2,-1.2;1.2,01.2];
305  ]]></programlisting>
306         <scilab:image>
307             theta = [0:0.02:2*%pi]';
308             rho = 1+0.2*cos(theta.^2);
309             polarplot(theta,rho,style=5)
310             isoview()
311             gca().data_bounds = [-1.2,-1.2;1.2,01.2];
312         </scilab:image>
313     </refsection>
314 </refentry>