~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/graphics/help/ja_JP/3d_plot/plot3d3.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
11
11
 *
12
12
 -->
13
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="plot3d3">
14
 
  <refnamediv>
15
 
    <refname>plot3d3</refname>
16
 
    <refpurpose>矩形の小平面により定義される曲面のメッシュプロット</refpurpose>
17
 
  </refnamediv>
18
 
  <refsynopsisdiv>
19
 
    <title>呼び出し手順</title>
20
 
    <synopsis>plot3d3(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
21
 
      plot3d3(X,Y,Z, &lt;opt_args&gt;)
22
 
    </synopsis>
23
 
  </refsynopsisdiv>
24
 
  <refsection>
25
 
    <title>パラメータ</title>
26
 
    <variablelist>
27
 
      <varlistentry>
28
 
        <term>X, Y, Z:</term>
29
 
        <listitem>
30
 
          <para>データ構造を定義する実数行列.</para>
31
 
        </listitem>
32
 
      </varlistentry>
33
 
      <varlistentry>
34
 
        <term>vect</term>
35
 
        <listitem>
36
 
          <para>実数ベクトル.</para>
37
 
        </listitem>
38
 
      </varlistentry>
39
 
      <varlistentry>
40
 
        <term>&lt;opt_args&gt;</term>
41
 
        <listitem>
42
 
          <para>
43
 
            一連の命令<literal>key1=value1,
44
 
              key2=value2
45
 
            </literal>
46
 
            ,...を表し, <literal>key1</literal>,
47
 
            <literal>key2,...</literal> は以下のどれかとすることができます: theta,
48
 
            alpha ,leg,flag,ebox (以下の定義を参照).
49
 
          </para>
50
 
        </listitem>
51
 
      </varlistentry>
52
 
      <varlistentry>
53
 
        <term>theta, alpha</term>
54
 
        <listitem>
55
 
          <para>観測点の球座標を指定する実数値(単位:度).</para>
56
 
        </listitem>
57
 
      </varlistentry>
58
 
      <varlistentry>
59
 
        <term>leg</term>
60
 
        <listitem>
61
 
          <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
62
 
            "X@Y@Z"のようになります.
63
 
          </para>
64
 
        </listitem>
65
 
      </varlistentry>
66
 
      <varlistentry>
67
 
        <term>flag</term>
68
 
        <listitem>
69
 
          <para>大きさ4の実数ベクトル.
70
 
            <literal>flag=[vertical_color, horizontal_color,type,box]</literal>.
71
 
          </para>
72
 
          <variablelist>
73
 
            <varlistentry>
74
 
              <term>vertical_color</term>
75
 
              <listitem>
76
 
                <para>整数 (曲面の色), デフォルトは 3.</para>
77
 
                <para>縦方向のエッジを描画する際に使用される色を定義するカラーマップのインデックス.</para>
78
 
              </listitem>
79
 
            </varlistentry>
80
 
            <varlistentry>
81
 
              <term>horizontal_color</term>
82
 
              <listitem>
83
 
                <para>整数 (曲面の色), デフォルトは 4.</para>
84
 
                <para>水平方向のエッジを描画する際に使用される色を定義するカラーマップのインデックス.</para>
85
 
              </listitem>
86
 
            </varlistentry>
87
 
            <varlistentry>
88
 
              <term>type</term>
89
 
              <listitem>
90
 
                <para>整数 (スケール).</para>
91
 
                <variablelist>
92
 
                  <varlistentry>
93
 
                    <term>type=0:</term>
94
 
                    <listitem>
95
 
                      <para>プロットは
96
 
                        (前の<literal>param3d</literal>,
97
 
                        <literal>plot3d</literal>, <literal>contour</literal> または
98
 
                        <literal>plot3d1</literal>のコールで設定された)
99
 
                        カレントの3次元スケールで行われます.
100
 
                      </para>
101
 
                    </listitem>
102
 
                  </varlistentry>
103
 
                  <varlistentry>
104
 
                    <term>type=1:</term>
105
 
                    <listitem>
106
 
                      <para>
107
 
                        3次元ボックスのスケールがアスペクト比の最大値に基づき
108
 
                        自動的に調整され,
109
 
                        境界はオプションの引数<literal>ebox</literal>の値で
110
 
                        指定されます.
111
 
                      </para>
112
 
                    </listitem>
113
 
                  </varlistentry>
114
 
                  <varlistentry>
115
 
                    <term>type=2:</term>
116
 
                    <listitem>
117
 
                      <para>
118
 
                        3次元ボックスのスケールがアスペクト比の最大値に基づき
119
 
                        自動的に調整され,境界は指令したデータにより計算されます.
120
 
                      </para>
121
 
                    </listitem>
122
 
                  </varlistentry>
123
 
                  <varlistentry>
124
 
                    <term>type=3:</term>
125
 
                    <listitem>
126
 
                      <para>
127
 
                        オプション<literal>ebox</literal>で指定したボックス境界を有する
128
 
                        3次元等軸プロットで,<literal>type=1</literal>に似ています.
129
 
                      </para>
130
 
                    </listitem>
131
 
                  </varlistentry>
132
 
                  <varlistentry>
133
 
                    <term>type=4:</term>
134
 
                    <listitem>
135
 
                      <para>データで定義された境界に基づく3次元等軸プロットで,
136
 
                        <literal>type=2</literal>に似ています.
137
 
                      </para>
138
 
                    </listitem>
139
 
                  </varlistentry>
140
 
                  <varlistentry>
141
 
                    <term>type=5:</term>
142
 
                    <listitem>
143
 
                      <para>
144
 
                        オプション<literal>ebox</literal>で指定されたボックス境界で
145
 
                        定義された境界に基づく3次元拡張等軸プロットで,
146
 
                        <literal>type=1</literal>に似ています.
147
 
                      </para>
148
 
                    </listitem>
149
 
                  </varlistentry>
150
 
                  <varlistentry>
151
 
                    <term>type=6:</term>
152
 
                    <listitem>
153
 
                      <para>
154
 
                        データで定義された境界に基づく3次元拡張等軸プロットで,
155
 
                        <literal>type=2</literal>に似ています.
156
 
                        軸の境界は axes エンティティプロパティによりカスタマイズできる
157
 
                        ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
158
 
                      </para>
159
 
                    </listitem>
160
 
                  </varlistentry>
161
 
                </variablelist>
162
 
              </listitem>
163
 
            </varlistentry>
164
 
            <varlistentry>
165
 
              <term>box</term>
166
 
              <listitem>
167
 
                <para>整数 (プロットの周囲のフレーム).</para>
168
 
                <variablelist>
169
 
                  <varlistentry>
170
 
                    <term>box=0:</term>
171
 
                    <listitem>
172
 
                      <para>プロットの周囲に何も描画されません.</para>
173
 
                    </listitem>
174
 
                  </varlistentry>
175
 
                  <varlistentry>
176
 
                    <term>box=1:</term>
177
 
                    <listitem>
178
 
                      <para>実装されていません (box=0と同様).</para>
179
 
                    </listitem>
180
 
                  </varlistentry>
181
 
                  <varlistentry>
182
 
                    <term>box=2:</term>
183
 
                    <listitem>
184
 
                      <para>曲面の背後の軸のみが描画されます.</para>
185
 
                    </listitem>
186
 
                  </varlistentry>
187
 
                  <varlistentry>
188
 
                    <term>box=3:</term>
189
 
                    <listitem>
190
 
                      <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
191
 
                    </listitem>
192
 
                  </varlistentry>
193
 
                  <varlistentry>
194
 
                    <term>box=4:</term>
195
 
                    <listitem>
196
 
                      <para>
197
 
                        曲面を囲うボックスが描画され,キャプションと軸が追加されます.
198
 
                      </para>
199
 
                      <para>
200
 
                        軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
201
 
                        できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
202
 
                      </para>
203
 
                    </listitem>
204
 
                  </varlistentry>
205
 
                </variablelist>
206
 
              </listitem>
207
 
            </varlistentry>
208
 
          </variablelist>
209
 
        </listitem>
210
 
      </varlistentry>
211
 
      <varlistentry>
212
 
        <term>ebox</term>
213
 
        <listitem>
214
 
          <para>
215
 
            プロットの境界をベクトル
216
 
            <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します. 
217
 
            この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
218
 
            <literal>3</literal> または <literal>5</literal>に設定された場合,
219
 
            使用されます (対応する動作については上記参照). 
220
 
            <literal>flag</literal> が指定されない場合
221
 
            <literal>ebox</literal> は無視されます. 
222
 
          </para>
223
 
          <para>
224
 
            指定された場合, <literal>ebox</literal>引数は,
225
 
            <literal>data_bounds</literal>に基づいて動作し,
226
 
            axesエンティティのプロパティによりリセットすることも可能であることに
227
 
            注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
228
 
          </para>
229
 
        </listitem>
230
 
      </varlistentry>
231
 
    </variablelist>
232
 
  </refsection>
233
 
  <refsection>
234
 
    <title>説明</title>
235
 
    <para>
236
 
      <literal>plot3d3</literal> は矩形の小平面で定義される曲面の
237
 
      メッシュ状のプロットを行ないます.
238
 
      (X,Y,Z) は曲面を記述する3つの行列です.
239
 
      曲面は4角形のポリゴンで構成されます.
240
 
    </para>
241
 
    <para>
242
 
      小平面のX座標は
243
 
      X(i,j), X(i+1,j), X(i+1,j+1) および X(i,j+1)で指定されます. 同様に行列 Y および Z 
244
 
      はYおよびZ座標を有します.
245
 
    </para>
246
 
    <para>
247
 
      <literal>vect</literal>ベクトルは
248
 
      同じ(X,Y,Z)行列に複数の曲面がコード化される場合に使用されます.
249
 
      <literal>vect(j)</literal> はj番目の曲面が開始されるコードの場所の
250
 
      行番号です.詳細な説明は
251
 
      <literal>plot3d2</literal>を参照ください.
252
 
      mesh プロットと同様,編集可能な唯一利用可能なプロパティは
253
 
      <literal>visible</literal>オプションです
254
 
      (<link linkend="axes_properties">axes_properties</link>参照).
255
 
    </para>
256
 
  </refsection>
257
 
  <refsection>
258
 
    <title>例</title>
259
 
    <programlisting role="example"><![CDATA[ 
 
14
    <refnamediv>
 
15
        <refname>plot3d3</refname>
 
16
        <refpurpose>矩形の小平面により定義される曲面のメッシュプロット</refpurpose>
 
17
    </refnamediv>
 
18
    <refsynopsisdiv>
 
19
        <title>呼び出し手順</title>
 
20
        <synopsis>plot3d3(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
 
21
            plot3d3(X,Y,Z, &lt;opt_args&gt;)
 
22
        </synopsis>
 
23
    </refsynopsisdiv>
 
24
    <refsection>
 
25
        <title>パラメータ</title>
 
26
        <variablelist>
 
27
            <varlistentry>
 
28
                <term>X, Y, Z:</term>
 
29
                <listitem>
 
30
                    <para>データ構造を定義する実数行列.</para>
 
31
                </listitem>
 
32
            </varlistentry>
 
33
            <varlistentry>
 
34
                <term>vect</term>
 
35
                <listitem>
 
36
                    <para>実数ベクトル.</para>
 
37
                </listitem>
 
38
            </varlistentry>
 
39
            <varlistentry>
 
40
                <term>&lt;opt_args&gt;</term>
 
41
                <listitem>
 
42
                    <para>
 
43
                        一連の命令<literal>key1=value1,
 
44
                            key2=value2
 
45
                        </literal>
 
46
                        ,...を表し, <literal>key1</literal>,
 
47
                        <literal>key2,...</literal> は以下のどれかとすることができます: theta,
 
48
                        alpha ,leg,flag,ebox (以下の定義を参照).
 
49
                    </para>
 
50
                </listitem>
 
51
            </varlistentry>
 
52
            <varlistentry>
 
53
                <term>theta, alpha</term>
 
54
                <listitem>
 
55
                    <para>観測点の球座標を指定する実数値(単位:度).</para>
 
56
                </listitem>
 
57
            </varlistentry>
 
58
            <varlistentry>
 
59
                <term>leg</term>
 
60
                <listitem>
 
61
                    <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
 
62
                        "X@Y@Z"のようになります.
 
63
                    </para>
 
64
                </listitem>
 
65
            </varlistentry>
 
66
            <varlistentry>
 
67
                <term>flag</term>
 
68
                <listitem>
 
69
                    <para>大きさ4の実数ベクトル.
 
70
                        <literal>flag=[vertical_color, horizontal_color,type,box]</literal>.
 
71
                    </para>
 
72
                    <variablelist>
 
73
                        <varlistentry>
 
74
                            <term>vertical_color</term>
 
75
                            <listitem>
 
76
                                <para>整数 (曲面の色), デフォルトは 3.</para>
 
77
                                <para>縦方向のエッジを描画する際に使用される色を定義するカラーマップのインデックス.</para>
 
78
                            </listitem>
 
79
                        </varlistentry>
 
80
                        <varlistentry>
 
81
                            <term>horizontal_color</term>
 
82
                            <listitem>
 
83
                                <para>整数 (曲面の色), デフォルトは 4.</para>
 
84
                                <para>水平方向のエッジを描画する際に使用される色を定義するカラーマップのインデックス.</para>
 
85
                            </listitem>
 
86
                        </varlistentry>
 
87
                        <varlistentry>
 
88
                            <term>type</term>
 
89
                            <listitem>
 
90
                                <para>整数 (スケール).</para>
 
91
                                <variablelist>
 
92
                                    <varlistentry>
 
93
                                        <term>type=0:</term>
 
94
                                        <listitem>
 
95
                                            <para>プロットは
 
96
                                                (前の<literal>param3d</literal>,
 
97
                                                <literal>plot3d</literal>, <literal>contour</literal> または
 
98
                                                <literal>plot3d1</literal>のコールで設定された)
 
99
                                                カレントの3次元スケールで行われます.
 
100
                                            </para>
 
101
                                        </listitem>
 
102
                                    </varlistentry>
 
103
                                    <varlistentry>
 
104
                                        <term>type=1:</term>
 
105
                                        <listitem>
 
106
                                            <para>
 
107
                                                3次元ボックスのスケールがアスペクト比の最大値に基づき
 
108
                                                自動的に調整され,
 
109
                                                境界はオプションの引数<literal>ebox</literal>の値で
 
110
                                                指定されます.
 
111
                                            </para>
 
112
                                        </listitem>
 
113
                                    </varlistentry>
 
114
                                    <varlistentry>
 
115
                                        <term>type=2:</term>
 
116
                                        <listitem>
 
117
                                            <para>
 
118
                                                3次元ボックスのスケールがアスペクト比の最大値に基づき
 
119
                                                自動的に調整され,境界は指令したデータにより計算されます.
 
120
                                            </para>
 
121
                                        </listitem>
 
122
                                    </varlistentry>
 
123
                                    <varlistentry>
 
124
                                        <term>type=3:</term>
 
125
                                        <listitem>
 
126
                                            <para>
 
127
                                                オプション<literal>ebox</literal>で指定したボックス境界を有する
 
128
                                                3次元等軸プロットで,<literal>type=1</literal>に似ています.
 
129
                                            </para>
 
130
                                        </listitem>
 
131
                                    </varlistentry>
 
132
                                    <varlistentry>
 
133
                                        <term>type=4:</term>
 
134
                                        <listitem>
 
135
                                            <para>データで定義された境界に基づく3次元等軸プロットで,
 
136
                                                <literal>type=2</literal>に似ています.
 
137
                                            </para>
 
138
                                        </listitem>
 
139
                                    </varlistentry>
 
140
                                    <varlistentry>
 
141
                                        <term>type=5:</term>
 
142
                                        <listitem>
 
143
                                            <para>
 
144
                                                オプション<literal>ebox</literal>で指定されたボックス境界で
 
145
                                                定義された境界に基づく3次元拡張等軸プロットで,
 
146
                                                <literal>type=1</literal>に似ています.
 
147
                                            </para>
 
148
                                        </listitem>
 
149
                                    </varlistentry>
 
150
                                    <varlistentry>
 
151
                                        <term>type=6:</term>
 
152
                                        <listitem>
 
153
                                            <para>
 
154
                                                データで定義された境界に基づく3次元拡張等軸プロットで,
 
155
                                                <literal>type=2</literal>に似ています.
 
156
                                                軸の境界は axes エンティティプロパティによりカスタマイズできる
 
157
                                                ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
 
158
                                            </para>
 
159
                                        </listitem>
 
160
                                    </varlistentry>
 
161
                                </variablelist>
 
162
                            </listitem>
 
163
                        </varlistentry>
 
164
                        <varlistentry>
 
165
                            <term>box</term>
 
166
                            <listitem>
 
167
                                <para>整数 (プロットの周囲のフレーム).</para>
 
168
                                <variablelist>
 
169
                                    <varlistentry>
 
170
                                        <term>box=0:</term>
 
171
                                        <listitem>
 
172
                                            <para>プロットの周囲に何も描画されません.</para>
 
173
                                        </listitem>
 
174
                                    </varlistentry>
 
175
                                    <varlistentry>
 
176
                                        <term>box=1:</term>
 
177
                                        <listitem>
 
178
                                            <para>実装されていません (box=0と同様).</para>
 
179
                                        </listitem>
 
180
                                    </varlistentry>
 
181
                                    <varlistentry>
 
182
                                        <term>box=2:</term>
 
183
                                        <listitem>
 
184
                                            <para>曲面の背後の軸のみが描画されます.</para>
 
185
                                        </listitem>
 
186
                                    </varlistentry>
 
187
                                    <varlistentry>
 
188
                                        <term>box=3:</term>
 
189
                                        <listitem>
 
190
                                            <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
 
191
                                        </listitem>
 
192
                                    </varlistentry>
 
193
                                    <varlistentry>
 
194
                                        <term>box=4:</term>
 
195
                                        <listitem>
 
196
                                            <para>
 
197
                                                曲面を囲うボックスが描画され,キャプションと軸が追加されます.
 
198
                                            </para>
 
199
                                            <para>
 
200
                                                軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
 
201
                                                できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
 
202
                                            </para>
 
203
                                        </listitem>
 
204
                                    </varlistentry>
 
205
                                </variablelist>
 
206
                            </listitem>
 
207
                        </varlistentry>
 
208
                    </variablelist>
 
209
                </listitem>
 
210
            </varlistentry>
 
211
            <varlistentry>
 
212
                <term>ebox</term>
 
213
                <listitem>
 
214
                    <para>
 
215
                        プロットの境界をベクトル
 
216
                        <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します. 
 
217
                        この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
 
218
                        <literal>3</literal> または <literal>5</literal>に設定された場合,
 
219
                        使用されます (対応する動作については上記参照). 
 
220
                        <literal>flag</literal> が指定されない場合
 
221
                        <literal>ebox</literal> は無視されます. 
 
222
                    </para>
 
223
                    <para>
 
224
                        指定された場合, <literal>ebox</literal>引数は,
 
225
                        <literal>data_bounds</literal>に基づいて動作し,
 
226
                        axesエンティティのプロパティによりリセットすることも可能であることに
 
227
                        注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
 
228
                    </para>
 
229
                </listitem>
 
230
            </varlistentry>
 
231
        </variablelist>
 
232
    </refsection>
 
233
    <refsection>
 
234
        <title>説明</title>
 
235
        <para>
 
236
            <literal>plot3d3</literal> は矩形の小平面で定義される曲面の
 
237
            メッシュ状のプロットを行ないます.
 
238
            (X,Y,Z) は曲面を記述する3つの行列です.
 
239
            曲面は4角形のポリゴンで構成されます.
 
240
        </para>
 
241
        <para>
 
242
            小平面のX座標は
 
243
            X(i,j), X(i+1,j), X(i+1,j+1) および X(i,j+1)で指定されます. 同様に行列 Y および Z 
 
244
            はYおよびZ座標を有します.
 
245
        </para>
 
246
        <para>
 
247
            <literal>vect</literal>ベクトルは
 
248
            同じ(X,Y,Z)行列に複数の曲面がコード化される場合に使用されます.
 
249
            <literal>vect(j)</literal> はj番目の曲面が開始されるコードの場所の
 
250
            行番号です.詳細な説明は
 
251
            <literal>plot3d2</literal>を参照ください.
 
252
            mesh プロットと同様,編集可能な唯一利用可能なプロパティは
 
253
            <literal>visible</literal>オプションです
 
254
            (<link linkend="axes_properties">axes_properties</link>参照).
 
255
        </para>
 
256
    </refsection>
 
257
    <refsection>
 
258
        <title>例</title>
 
259
        <programlisting role="example"><![CDATA[ 
260
260
u = linspace(-%pi/2,%pi/2,40);
261
261
v = linspace(0,2*%pi,20);
262
262
X = cos(u)'*cos(v);
267
267
e.visible='off';
268
268
e.visible='on'; // メッシュビューに戻す
269
269
 ]]></programlisting>
270
 
  </refsection>
271
 
  <refsection role="see also">
272
 
    <title>参照</title>
273
 
    <simplelist type="inline">
274
 
      <member>
275
 
        <link linkend="plot3d2">plot3d2</link>
276
 
      </member>
277
 
      <member>
278
 
        <link linkend="plot3d">plot3d</link>
279
 
      </member>
280
 
      <member>
281
 
        <link linkend="param3d">param3d</link>
282
 
      </member>
283
 
    </simplelist>
284
 
  </refsection>
 
270
    </refsection>
 
271
    <refsection role="see also">
 
272
        <title>参照</title>
 
273
        <simplelist type="inline">
 
274
            <member>
 
275
                <link linkend="plot3d2">plot3d2</link>
 
276
            </member>
 
277
            <member>
 
278
                <link linkend="plot3d">plot3d</link>
 
279
            </member>
 
280
            <member>
 
281
                <link linkend="param3d">param3d</link>
 
282
            </member>
 
283
        </simplelist>
 
284
    </refsection>
285
285
</refentry>