resize_matrix

引数

mat

入力行列またはハイパー行列. 論理値, エンコードされた整数, 10進数 (実数または複素数), 多項式, またはテキストがサポートされます.

nbRows

大きさ変更後の行列の行数. 超過した行はトリムされます. 足りない行は拡張されます.

nbCols

大きさ変更後の行列の列数. 超過した列はトリムされます. 足りない列は拡張されます.

newSizes

matの各次元方向の新しい大きさを指定するベクトル.

size(mat)より短い場合, 1でパディングされます. 例: size(mat)==[ 4 3 3 2]となる mat が入力され, newSizes=[6 2]が指定された場合, newSizes = [6 2 1 1] が考慮されます.

newSizes が size(mat)でなくなる場合, 新規次元が matに追加され,パディングされます. 例えば,size(mat)==[ 4 3 ]となるような matが入力され, newSizes=[6 2 2]が指定された場合, 結果は2ページのハイパー行列となります. 2番目の次元は完全にパディングされます.

newSizes = [nbRows, nbCols] は行列として使用できます.

padding

matと同じ型のオプションのスカラー, 次元方向に大きさが増加した際に作成された要素に設定する内容を指定します. デフォルトのパディングは 0 (実数または複素数10進数,エンコードされた整数,多項式), または "" (テキスト),%F (論理値)で行われます.

mat および padding の型が一致しない場合, scilabはpaddingの型を変換しようとします.

多項式の場合, パティングの変数名は強制的にmatと同じとなります.

resType

オプションのテキストで大きさが変更された行列が変換されるデータ型を指定します. "boolean", "constant", "string", "int8", "uint8", "int16", "uint16", "int32", および "uint32" がサポートされます.

多項式およびテキストのハイパー行列については型変換がサポートされません.

resMat

大きさが変更され(変換され)た行列またはハイパー行列

説明

大きさ[nbRows, nbCols] または newSizesの行列, 大きさnewSizesのハイパー行列を作成します. 新しい大きさのある次元が最初のものよりも小さい場合, 行列はトリムされます. 大きさが増加した場合, 行列/ハイパー行列はパディングされます. 次元の数を増やすことも可能です. Scilabは自動的に大きさが1(シングルトン)に設定された最高の次元を縮小します.

結果の型は,上記の制限のもとにresType引数の指定により変更できます.

例

// 組込の例, 多項式を含む
resize_matrix
// 数値行列:
M = grand(4, 3, "uin", -9, 9)
resize_matrix(M, 3, 4)
resize_matrix(M, [3 4 2])
resize_matrix(M, [3 4 2], "", %i)
resize_matrix(M, [3 4 2], "string", %i)
// テキストの行列:
myMatString = ["Scilab", "the"; "Open Source", "Scientific"; "Software", "Package"]
resize_matrix( myMatString, 5, 3 )
// new sizesに等価な構文:
resize_matrix( myMatString, [5 3], "", "$" )    // カスタムパディング
// トリム, パディングとハイパー行列へのキャスト:
h = rand(2, 3, 2)*200
resize_matrix(h, [3 2 3], "int8")
resize_matrix(h, [3 2 3], "int8", -1)    // カスタムパディング
r = resize_matrix(h, [3 2 ] , "" , -1)   // 型変換せずにカスタムパディング
size(r)  // 最後の次元は縮小されました
// 多項式:
x = poly(0, "x");
P = (1-x)^grand(4, 2, "uin", 0, 3)
resize_matrix(P, 3, 3)
resize_matrix(P, [3 3 2])
resize_matrix(P, [3 3 2], "", %z)
//  => パディングの未知数はPのものに強制的に変更されました
//  => 多項式は変換できません

参照

• matrix — ベクトルまたは行列を異なる大きさの行列に成形する
• size — オブジェクトの大きさ
• typeof — オブジェクトの型
• double — 整数から倍精度表現に変換
• strtod — 文字列を倍精度実数に変換.
• string — 文字列を倍精度実数に変換.

履歴