japanese translation updated.
[scilab.git] / scilab / modules / elementary_functions / help / ja_JP / matrixmanipulation / flipdim.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="flipdim" xml:lang="ja">
16     
17     <refnamediv>
18         
19         <refname>flipdim</refname>
20         
21         <refpurpose>指定した次元に沿って x ブロック要素を反転</refpurpose>
22         
23     </refnamediv>
24     
25     <refsynopsisdiv>
26         
27         <title>呼び出し手順</title>
28         
29         <synopsis>y = flipdim(x, dim [,sb])</synopsis>
30         
31     </refsynopsisdiv>
32     
33     <refsection>
34         
35         <title>引数</title>
36         
37         <variablelist>
38             
39             <varlistentry>
40                 
41                 <term>x, y</term>
42                 
43                 <listitem>
44                     
45                     <para>任意の型, 同じ大きさのスカラー, ベクトル, 行列またはハイパー行列</para>
46                     
47                 </listitem>
48                 
49             </varlistentry>
50             
51             <varlistentry>
52                 
53                 <term>dim</term>
54                 
55                 <listitem>
56                     
57                     <para>正の整数, 反転させる次元の番号</para>
58                     
59                 </listitem>
60                 
61             </varlistentry>
62             
63             <varlistentry>
64                 
65                 <term>sb</term>
66                 
67                 <listitem>
68                     
69                     <para>正の整数, 交換するブロックの大きさ</para>
70                     
71                 </listitem>
72                 
73             </varlistentry>
74             
75         </variablelist>
76         
77     </refsection>
78     
79     <refsection>
80         
81         <title>説明</title>
82         
83         <para>
84             
85             任意の型のスカラー/ベクトル/配列/ハイパー行列 <literal>x</literal>と
86             
87             2つの正の整数<literal>dim</literal>および<literal>sb</literal>を指定すると,
88             
89             この関数は大きさ<literal>sb</literal>のブロック要素により
90             
91             <literal>x</literal>の次元番号 <literal>dim</literal>
92             
93             に沿って x の要素を反転します.
94             
95             (<literal>x</literal> および <literal>y</literal> は同じ大きさとなります)
96             
97         </para>
98         
99         <para>
100             
101             オプションパラメータ<literal>sb</literal> (Size Block) により,
102             
103             ブロックの大きさ <literal>sb*size(x,2)</literal>
104             
105             (<literal>dim=1</literal>) または <literal>size(x,1)*sb</literal> (<literal>dim=2</literal>)
106             
107             での反転が可能となります.
108             
109         </para>
110         
111     </refsection>
112     
113     <refsection>
114         
115         <title>例</title>
116         
117         <programlisting role="example"><![CDATA[ 
118 // 例 1: x の要素を最初の次元に沿って反転
119 x=[1 2 3 4; 5 6 7 8];
120 dim=1;
121 y=flipdim(x,dim)
122
123 // 例2: x の要素を2番目の次元に沿って反転
124 dim=2;
125 y=flipdim(x,dim)
126
127 // 例3: x の要素を3番目の次元に沿って反転
128 x=matrix(1:48,[3 2,4,2]);
129 dim=3;
130 y=flipdim(x,dim)
131
132 // 例4: 最初の例を複素数に
133 x = [1+%i 2*%i 3 4; 5 6-%i 7 8*%pi*%i]
134 dim = 1
135 y = flipdim(x, dim)
136
137 // 整数エンコードされた数値
138 x = int16(grand(4, 3, 2, "uin", -9, 9))
139 y = flipdim(x, 1)
140
141 // 論理値:
142 x = (grand(3, 4, "uin", -9, 9) > 0)
143 y = flipdim(x, 2)
144
145 // テキスト:
146 x = matrix(strsplit("a":"x", 1:23), 4, 6);
147 x = x+x
148 flipdim(x, 2)
149
150 // 多項式:
151 x = inv_coeff(grand(3, 9, "uin", 0, 3), 2)
152 flipdim(x, 1)
153
154 // 有理数:
155 n = inv_coeff(grand(3, 9, "uin", 0, 3), 2);
156 d = inv_coeff(grand(3, 9, "uin", 0, 3), 2);
157 r = n./d
158 flipdim(r, 2)
159  ]]></programlisting>
160         
161         <para>
162             
163             <literal>sb</literal>の使用例:
164             
165         </para>
166         
167         <programlisting role="example"><![CDATA[
168 X = [0 1 2 3 4 5 6 7 8 9 10 11];
169 flipdim(X, 2, 2) // => [10 11   8 9   6 7   4 5   2 3   0 1] // ブロックサイズ = 2.
170 flipdim(X, 2, 3) // => [9 10 11   6 7 8   3 4 5   0 1 2]
171 flipdim(X, 2, 4) // => [8 9 10 11   4 5 6 7   0 1 2 3]
172 flipdim(X, 2, 6) // => [6 7 8 9 10 11   0 1 2 3 4 5]
173
174 // sbがxの指定した次元を分割しない場合はエラー.
175 y = flipdim(x, 2, 5); // size(X) = [1 12] および sb=5 は 12を割り切れない.
176  ]]></programlisting>
177         
178     </refsection>
179     
180     <refsection>
181         
182         <title>履歴</title>
183         
184         <revhistory>
185             
186             <revision>
187                 
188                 <revnumber>5.5.0</revnumber>
189                 
190                 <revremark>
191                     
192                     10進数から任意の型に拡張: 論理値, 整数, 文字列, 多項式および有理数.
193                     
194                     <literal>x</literal>ブロック毎に反転するために,
195                     
196                     新しい入力引数 <literal>sb</literal>が追加されました.
197                     
198                 </revremark>
199                 
200             </revision>
201             
202         </revhistory>
203         
204     </refsection>
205     
206 </refentry>
207