japanese translation updated.
[scilab.git] / scilab / modules / elementary_functions / help / ja_JP / matrixmanipulation / resize_matrix.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 - Jean-Baptiste SILVY
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="resize_matrix" xml:lang="ja">
16     
17     <refnamediv>
18         
19         <refname>resize_matrix</refname>
20         
21         <refpurpose>
22             
23             行列またはハイパー行列をトリムまたは拡張(およびキャスト)
24             
25         </refpurpose>
26         
27     </refnamediv>
28     
29     <refsynopsisdiv>
30         
31         <title>呼び出し手順</title>
32         
33         <synopsis>
34             
35             resMat = resize_matrix(mat, nbRows, nbCols)
36             
37             
38             
39             resMat = resize_matrix(mat, nbRows, nbCols, resType)
40             
41             resMat = resize_matrix(mat, nbRows, nbCols, resType, padding)
42             
43             resMat = resize_matrix(mat, nbRows, nbCols,    ""  , padding)
44             
45             
46             
47             resMat = resize_matrix(mat, newSizes)
48             
49             resMat = resize_matrix(mat, newSizes, resType)
50             
51             resMat = resize_matrix(mat, newSizes, resType, padding)
52             
53             resMat = resize_matrix(mat, newSizes,    ""  , padding)
54             
55         </synopsis>
56         
57     </refsynopsisdiv>
58     
59     <refsection>
60         
61         <title>引数</title>
62         
63         <variablelist>
64             
65             <varlistentry>
66                 
67                 <term>mat</term>
68                 
69                 <listitem>
70                     
71                     <para>
72                         
73                         入力行列またはハイパー行列. 論理値, エンコードされた整数, 10進数 (実数または複素数),
74                         
75                         多項式, またはテキストがサポートされます.
76                         
77                     </para>
78                     
79                 </listitem>
80                 
81             </varlistentry>
82             
83             <varlistentry>
84                 
85                 <term>nbRows</term>
86                 
87                 <listitem>
88                     
89                     <para>
90                         
91                         大きさ変更後の行列の行数. 超過した行はトリムされます.
92                         
93                         足りない行は拡張されます.
94                         
95                     </para>
96                     
97                 </listitem>
98                 
99             </varlistentry>
100             
101             <varlistentry>
102                 
103                 <term>nbCols</term>
104                 
105                 <listitem>
106                     
107                     <para>
108                         
109                         大きさ変更後の行列の列数. 超過した列はトリムされます.
110                         
111                         足りない列は拡張されます.
112                         
113                     </para>
114                     
115                 </listitem>
116                 
117             </varlistentry>
118             
119             <varlistentry>
120                 
121                 <term>newSizes</term>
122                 
123                 <listitem>
124                     
125                     <para>
126                         
127                         <varname>mat</varname>の各次元方向の新しい大きさを指定するベクトル.
128                         
129                     </para>
130                     
131                     <para>
132                         
133                         <literal>size(mat)</literal>より短い場合, 1でパディングされます. 
134                         
135                         例: <literal>size(mat)==[ 4 3 3 2]</literal>となる <varname>mat</varname> が入力され,
136                         
137                         <literal>newSizes=[6 2]</literal>が指定された場合,
138                         
139                         <literal>newSizes = [6 2 1 1]</literal> が考慮されます.
140                         
141                     </para>
142                     
143                     <para>
144                         
145                         <varname>newSizes</varname> が <literal>size(mat)</literal>でなくなる場合, 
146                         
147                         新規次元が <varname>mat</varname>に追加され,パディングされます.
148                         
149                         例えば,<literal>size(mat)==[ 4 3 ]</literal>となるような <varname>mat</varname>が入力され,
150                         
151                         <literal>newSizes=[6 2 2]</literal>が指定された場合,
152                         
153                         結果は2ページのハイパー行列となります.
154                         
155                         2番目の次元は完全にパディングされます.
156                         
157                     </para>
158                     
159                     <para>
160                         
161                         <literal>newSizes = [nbRows, nbCols]</literal> は行列として使用できます.
162                         
163                     </para>
164                     
165                 </listitem>
166                 
167             </varlistentry>
168             
169             <varlistentry>
170                 
171                 <term>padding</term>
172                 
173                 <listitem>
174                     
175                     <para>
176                         
177                         <varname>mat</varname>と同じ型のオプションのスカラー,
178                         
179                         次元方向に大きさが増加した際に作成された要素に設定する内容を指定します.
180                         
181                         デフォルトのパディングは <literal>0</literal>
182                         
183                         (実数または複素数10進数,エンコードされた整数,多項式), または
184                         
185                         <literal>""</literal> (テキスト),<literal>%F</literal> (論理値)で行われます.
186                         
187                     </para>
188                     
189                     <para>
190                         
191                         <varname>mat</varname> および <varname>padding</varname> の型が一致しない場合, 
192                         
193                         scilabは<varname>padding</varname>の型を変換しようとします.
194                         
195                     </para>
196                     
197                     <para>
198                         
199                         多項式の場合, パティングの変数名は強制的に<varname>mat</varname>と同じとなります.
200                         
201                     </para>
202                     
203                 </listitem>
204                 
205             </varlistentry>
206             
207             <varlistentry>
208                 
209                 <term>resType</term>
210                 
211                 <listitem>
212                     
213                     <para>
214                         
215                         オプションのテキストで大きさが変更された行列が変換されるデータ型を指定します.
216                         
217                         "boolean", "constant", "string", "int8", "uint8", "int16", "uint16", "int32", および "uint32" 
218                         
219                         がサポートされます.
220                         
221                     </para>
222                     
223                     <para>多項式およびテキストのハイパー行列については型変換がサポートされません.</para>
224                     
225                 </listitem>
226                 
227             </varlistentry>
228             
229             <varlistentry>
230                 
231                 <term>resMat</term>
232                 
233                 <listitem>
234                     
235                     <para>大きさが変更され(変換され)た行列またはハイパー行列</para>
236                     
237                 </listitem>
238                 
239             </varlistentry>
240             
241         </variablelist>
242         
243     </refsection>
244     
245     <refsection>
246         
247         <title>説明</title>
248         
249         <para>
250             
251             大きさ<literal>[nbRows, nbCols]</literal> または <literal>newSizes</literal>の行列,
252             
253             大きさ<literal>newSizes</literal>のハイパー行列を作成します.
254             
255             新しい大きさのある次元が最初のものよりも小さい場合, 行列はトリムされます.
256             
257             大きさが増加した場合, 行列/ハイパー行列はパディングされます.
258             
259             次元の数を増やすことも可能です.
260             
261             Scilabは自動的に大きさが1(シングルトン)に設定された最高の次元を縮小します.
262             
263         </para>
264         
265         <para>
266             
267             結果の型は,上記の制限のもとに<literal>resType</literal>引数の指定により変更できます.
268             
269         </para>
270                 
271         
272     </refsection>
273     
274     <refsection>
275         
276         <title>例</title>
277         
278         <programlisting role="example"><![CDATA[
279 // 組込の例, 多項式を含む
280 resize_matrix
281
282 // 数値行列:
283 M = grand(4, 3, "uin", -9, 9)
284 resize_matrix(M, 3, 4)
285 resize_matrix(M, [3 4 2])
286 resize_matrix(M, [3 4 2], "", %i)
287 resize_matrix(M, [3 4 2], "string", %i)
288
289 // テキストの行列:
290 myMatString = ["Scilab", "the"; "Open Source", "Scientific"; "Software", "Package"]
291 resize_matrix( myMatString, 5, 3 )
292 // new sizesに等価な構文:
293 resize_matrix( myMatString, [5 3], "", "$" )    // カスタムパディング
294
295 // トリム, パディングとハイパー行列へのキャスト:
296 h = rand(2, 3, 2)*200
297 resize_matrix(h, [3 2 3], "int8")
298 resize_matrix(h, [3 2 3], "int8", -1)    // カスタムパディング
299 r = resize_matrix(h, [3 2 ] , "" , -1)   // 型変換せずにカスタムパディング
300 size(r)  // 最後の次元は縮小されました
301
302 // 多項式:
303 x = poly(0, "x");
304 P = (1-x)^grand(4, 2, "uin", 0, 3)
305 resize_matrix(P, 3, 3)
306 resize_matrix(P, [3 3 2])
307 resize_matrix(P, [3 3 2], "", %z)
308 //  => パディングの未知数はPのものに強制的に変更されました
309 //  => 多項式は変換できません
310  ]]></programlisting>
311         
312     </refsection>
313     
314     <refsection role="see also">
315         
316         <title>参照</title>
317         
318         <simplelist type="inline">
319             
320             <member>
321                 
322                 <link linkend="matrix">matrix</link>
323                 
324             </member>
325             
326             <member>
327                 
328                 <link linkend="size">size</link>
329                 
330             </member>
331             
332             <member>
333                 
334                 <link linkend="typeof">typeof</link>
335                 
336             </member>
337             
338             <member>
339                 
340                 <link linkend="double">double</link>
341                 
342             </member>
343             
344             <member>
345                 
346                 <link linkend="strtod">strtod</link>
347                 
348             </member>
349             
350             <member>
351                 
352                 <link linkend="strtod">string</link>
353                 
354             </member>
355             
356         </simplelist>
357         
358     </refsection>
359     
360     <refsection>
361         
362         <title>履歴</title>
363         
364         <revhistory>
365             
366             <revision>
367                 
368                 <revnumber>5.5.0</revnumber>
369                 
370                 <revremark>
371                     
372                     多項式とハイパー行列を利用可能になりました.
373                     
374                     カスタムパディングを指定可能となりました.
375                     
376                     新しい大きさをベクトルとして指定できます.
377                     
378                     resize_matrix に引数を付けない場合, 例(デモ)を表示します.
379                     
380                 </revremark>
381                 
382             </revision>
383             
384         </revhistory>
385         
386     </refsection>
387     
388 </refentry>
389