japanese translation updated.
[scilab.git] / scilab / modules / interpolation / help / ja_JP / interp1.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) 2008 - INRIA - Farid BELAHCENE
6  * 
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
12  *
13  -->
14
15 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="interp1" xml:lang="ja">
16
17 <refnamediv>
18     
19     <refname>interp1</refname>
20     
21     <refpurpose>一次元補間関数</refpurpose>
22     
23 </refnamediv>
24
25 <refsynopsisdiv>
26     
27     <title>呼び出し手順</title>
28     
29     <synopsis>[yp]=interp1(x, y,xp [, method,[extrapolation]])</synopsis>
30     
31 </refsynopsisdiv>
32
33 <refsection>
34     
35     <title>パラメータ</title>
36     
37     <variablelist>
38         
39         <varlistentry>
40             
41             <term>xp</term>
42             
43             <listitem>
44                 
45                 <para>実数スカラー, ベクトルまたは行列 (またはハイパー行列)</para>
46                 
47             </listitem>
48             
49         </varlistentry>
50         
51         <varlistentry>
52             
53             <term>x</term>
54             
55             <listitem>
56                 
57                 <para>実数ベクトル</para>
58                 
59             </listitem>
60             
61         </varlistentry>
62         
63         <varlistentry>
64             
65             <term>method</term>
66             
67             <listitem>
68                 
69                 <para>(オプションの) 補間方法を定義する文字列</para>
70                 
71             </listitem>
72             
73         </varlistentry>
74         
75         <varlistentry>
76             
77             <term>extrapolation</term>
78             
79             <listitem>
80                 
81                 <para>(オプションの) 文字列, または領域 [x1,xn] の外側の xp(j)の値について
82                     
83                     yp(j) の要素を定義する実数値.
84                     
85                 </para>
86                 
87             </listitem>
88             
89         </varlistentry>
90         
91         <varlistentry>
92             
93             <term>yp</term>
94             
95             <listitem>
96                 
97                 <para>ベクトルまたは行列 (またはハイパー行列)</para>
98                 
99             </listitem>
100             
101         </varlistentry>
102         
103     </variablelist>
104     
105 </refsection>
106
107 <refsection>
108     
109     <title>説明</title>
110     
111     <para>
112         
113         <literal>(x,y,xp)</literal>を指定すると, この関数は
114         
115         xp に対応する yp の要素を x および y により定義された
116         
117         (デフォルトでは線形)補間により計算します.
118         
119     </para>
120     
121     <para>
122         
123         <literal>yp</literal> がベクトルの場合,
124         
125         xp の長さは <literal>yp</literal> の長さに等しくなります.
126         
127         <literal>yp</literal> が行列の場合,
128         
129         <literal>xp</literal> は yp の各列の長さと同じ長さとなります.
130         
131         <literal>yp</literal> がハイパー行列の場合,
132         
133         <literal>xp</literal> の長さは<literal>yp</literal> の最初の次元と同じ
134         
135         になります.
136         
137     </para>
138     
139     <para>size(y)=[C,M1,M2,M3,...,Mj] かつ size(xp)=[N1,N2,N3,...,Nk] の場合,
140         
141         size(yp)=[N1,N2,..,Nk,M1,M2,...Mj] となり, x の長さは size(y,1) に等しくなります.
142         
143     </para>
144     
145     <para>
146         
147         <literal>method</literal> パラメータは補間の計算手法を設定します.
148         
149     </para>
150     
151     <variablelist>
152         
153         <varlistentry>
154             
155             <term>"linear"</term>
156             
157             <listitem>
158                 
159                 <para>
160                     
161                     補間は線形手法により定義されます ( <link linkend="interpln">interpln</link>参照)
162                     
163                 </para>
164                 
165             </listitem>
166             
167         </varlistentry>
168         
169         <varlistentry>
170             
171             <term>"spline"</term>
172             
173             <listitem>
174                 
175                 <para>補間は3次スプライン補間により定義されます (
176                     
177                     <link linkend="splin">splin</link> , <link linkend="interp">interp</link>参照)
178                     
179                 </para>
180                 
181             </listitem>
182             
183         </varlistentry>
184         
185         <varlistentry>
186             
187             <term>"nearest"</term>
188             
189             <listitem>
190                 
191                 <para>各 xp(j), yp(j) の値は, 
192                     
193                     xp(j)の最近傍にある x(i) に対応する y(i) の値を選択します.
194                     
195                 </para>
196                 
197             </listitem>
198             
199         </varlistentry>
200         
201     </variablelist>
202     
203     <para>
204         
205         <literal>extrapolation</literal> パラメータは捕外用,すなわち
206         
207         <literal>xp(i) </literal> が領域[x1,xn]内にない時
208         
209         の計算手法を設定します.
210         
211     </para>
212     
213     <variablelist>
214         
215         <varlistentry>
216             
217             <term>"extrap"</term>
218             
219             <listitem>
220                 
221                 <para>捕外が定義された手法により実行されます.
222                     
223                     yp=interp1(x,y,xp,method,"extrap")
224                     
225                 </para>
226                 
227             </listitem>
228             
229         </varlistentry>
230         
231         <varlistentry>
232             
233             <term>実数値</term>
234             
235             <listitem>
236                 
237                 <para>捕外用の実数値を選択できます.
238                     
239                     この場合, 区間 [x1,xn] の中にない xp(i) について yp(i) は
240                     
241                     この値とします.
242                     
243                     yi=interp1(x,y,xp,method, 0)
244                     
245                 </para>
246                 
247             </listitem>
248             
249         </varlistentry>
250         
251         <varlistentry>
252             
253             <term>デフォルトの動作</term>
254             
255             <listitem>
256                 
257                 <para>捕外は(スプライン手法の場合)定義された手法により行われます
258                     
259                     線形または最近傍手法の場合は nan となります.
260                     
261                     yp=interp1(x,y,xp,method)
262                     
263                 </para>
264                 
265             </listitem>
266             
267         </varlistentry>
268         
269     </variablelist>
270     
271 </refsection>
272
273 <refsection>
274     
275     <title>例</title>
276     
277     <programlisting role="example"><![CDATA[ 
278 x=linspace(0,3,20);
279 y=x^2;
280 xx=linspace(0,3,100);
281 yy1=interp1(x,y,xx,'linear');
282 yy2=interp1(x,y,xx,'spline');
283 yy3=interp1(x,y,xx,'nearest');
284 plot(xx,[yy1;yy2;yy3],x,y,'*')
285 xtitle('interpolation of square function')
286 legend(['linear','spline','nearest'],a=2)
287  ]]></programlisting>
288     
289     <scilab:image>
290         
291         x=linspace(0,3,20);
292         
293         y=x.^2;
294         
295         xx=linspace(0,3,100);
296         
297         yy1=interp1(x,y,xx,'linear');
298         
299         yy2=interp1(x,y,xx,'spline');
300         
301         yy3=interp1(x,y,xx,'nearest');
302         
303         plot(xx',[yy1;yy2;yy3]',x,y,'*')
304         
305         xtitle('interpolation of square function')
306         
307         legend(['linear','spline','nearest'],a=2)
308         
309     </scilab:image>
310     
311 </refsection>
312
313 <refsection role="see also">
314     
315     <title>参照</title>
316     
317     <simplelist type="inline">
318         
319         <member>
320             
321             <link linkend="interp">interp</link>
322             
323         </member>
324         
325         <member>
326             
327             <link linkend="interpln">interpln</link>
328             
329         </member>
330         
331         <member>
332             
333             <link linkend="splin">splin</link>
334             
335         </member>
336         
337     </simplelist>
338     
339 </refsection>
340
341 <refsection>
342     
343     <title>履歴</title>
344     
345     <revhistory>
346         
347         <revision>
348             
349             <revnumber>5.4.0</revnumber>
350             
351             <revremark>以前では, 入力引数の虚部は暗黙のうちに無視されていました.</revremark>
352             
353         </revision>
354         
355     </revhistory>
356     
357 </refsection>
358
359 </refentry>
360