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>