コマンドラインでの cell 配列入力の指定

コマンドラインで cell 配列入力を指定するには、他の入力の型で使用する場合と同じメソッドを使用します。次のことが可能です。

cell 配列入力の例を fiaccel コマンドの -args オプションに指定します。
coder.CellType オブジェクトを fiaccel コマンドの -args オプションに指定します。coder.CellType オブジェクトを作成するには、coder.typeof を使用します。
coder.Constant を使用して定数の cell 配列入力を指定します。

コード生成の場合、cell 配列は同種または異種混合として分類されます。cell 配列のコード生成を参照してください。cell 配列の例を fiaccel または coder.typeof に指定すると、関数によって cell 配列の型が同種であるか異種混合であるかが判別されます。cell 配列要素のクラスとサイズが同じ場合、coder.typeof は同種 cell 配列型を返します。要素のクラスが異なる場合、coder.typeof は異種混合 cell 配列型を返します。一部の cell 配列では、同種であるか異種混合であるかの分類はあいまいです。たとえば、{1 [2 3]} の型に 1 行 2 列の異種混合型を使用できます。最初の要素は double で 2 番目の要素は 1 行 2 列の double です。また、この型を 1 行 3 列の同種型にして、その要素のクラスを double で、サイズを 1 行 :2 列にすることもできます。このようなあいまいなケースでは、coder.typeof はヒューリスティックな方法を使用して型を同種または異種混合として分類します。異なる分類が必要な場合は、coder.CellTypemakeHomogeneous メソッドまたは makeHeterogeneous メソッドを使用します。makeHomogeneous メソッドは型の同種コピーを作成します。makeHeterogeneous メソッドは型の異種混合コピーを作成します。

makeHomogeneous メソッドと makeHeterogeneous メソッドは分類を同種および異種混合としてそれぞれ永続的に割り当てます。これらのいずれかの方法を後で使用して分類が異なるコピーを作成することはできません。

例による cell 配列入力の指定

例によって cell 配列入力を指定するには、cell 配列の例を fiaccel コマンドの -args オプションに指定します。

以下に例を示します。

クラスが double の要素をもつ 1 行 3 列の cell 配列を指定するには、次のようにします。
```
fiaccel myfunction -args {{1 2 3}} -report
```
入力引数は、要素が 1 行 1 列の double をもつ 1 行 3 列の同種 cell 配列になります。
最初の要素にクラス char、2 番目の要素にクラス double をもつ 1 行 2 列の cell 配列を指定するには、次のようにします。
```
fiaccel myfunction -args {{'a', 1}} -report
```
入力引数は、最初の要素が 1 行 1 列の char、2 番目の要素が 1 行 1 列の double をもつ 1 行 2 列の異種混合 cell 配列になります。

cell 配列入力の型の指定

cell 配列入力の型を指定するには、coder.typeof を使用して coder.CellType オブジェクトを作成します。coder.CellType オブジェクトを、fiaccel コマンドの -args オプションに渡します。

以下に例を示します。

クラスが double の要素をもつ 1 行 3 列の cell 配列を指定するには、次のようにします。
```
t = coder.typeof({1 2 3});
fiaccel myfunction -args {t} -report
```
入力引数は、要素が 1 行 1 列の double をもつ 1 行 3 列の同種 cell 配列になります。
最初の要素にクラス char、2 番目の要素にクラス double をもつ 1 行 2 列の cell 配列を指定するには、次のようにします。
```
t = coder.typeof({'a', 1});
fiaccel myfunction -args {t}
```
入力引数は、最初の要素が 1 行 1 列の char、2 番目の要素が 1 行 1 列の double をもつ 1 行 2 列の異種混合 cell 配列になります。

また、高度な関数 coder.newtype を使用して coder.CellType オブジェクトを作成することもできます。

型の同種コピーの作成

coder.typeof が異種混合 cell 配列型を返すとき、同種の型が必要な場合は、makeHomogeneous メソッドを使用して、型の同種コピーを作成します。

次のコードは異種混合の型を作成します。

t = coder.typeof({1 [2 3]})

t = 

coder.CellType
   1x2 heterogeneous cell 
      f0: 1x1 double
      f1: 1x2 double

型の同種コピーを作成するには、次を使用します。

t = makeHomogeneous(t)

t = 

coder.CellType
   1×2 locked homogeneous cell 
      base: 1×:2 double

あるいは、次の表記法を使用します。

t = makeHomogeneous(coder.typeof({1 [2 3]}))

t = 

coder.CellType
   1×2 locked homogeneous cell 
      base: 1×:2 double

同種としての分類はロックされています (永続的)。後で makeHeterogeneous メソッドを使用して型の異種混合コピーを作成することはできません。

型の要素に char や double などの異なるクラスがある場合、makeHomogeneous を使用して型の同種コピーを作成することはできません。

型の異種混合コピーの作成

coder.typeof が同種 cell 配列型を返すとき、異種混合の型が必要な場合は、makeHeterogeneous メソッドを使用して、型の異種混合コピーを作成します。

次のコードは同種の型を作成します。

t = coder.typeof({1 2 3})

t = 

coder.CellType
   1x3 homogeneous cell 
      base: 1x1 double

異種混合の型を作成するには、次を使用します。

t = makeHeterogeneous(t)

t = 

coder.CellType
   1×3 locked heterogeneous cell 
      f1: 1×1 double
      f2: 1×1 double
      f3: 1×1 double

あるいは、次の表記法を使用します。

t = makeHeterogeneous(coder.typeof({1 2 3}))

t = 

coder.CellType
   1×3 locked heterogeneous cell 
      f1: 1×1 double
      f2: 1×1 double
      f3: 1×1 double

異種混合としての分類はロックされています (永続的)。後で makeHomogeneous メソッドを使用して型の同種コピーを作成することはできません。

型が可変サイズの場合、makeHeterogeneous を使用してその異種混合コピーを作成することはできません。

可変サイズの cell 配列入力の指定

可変サイズの cell 配列入力は次の方法で指定できます。

coder.typeof の呼び出しでは、次のようにします。
たとえば、最初の次元が固定、2 番目の次元の上限が 5 である可変サイズの cell 配列を指定する場合は、次のようにします。
```
t = coder.typeof({1}, [1 5], [0 1])
```
```
t = 

coder.CellType
   1x:5 homogeneous cell 
      base: 1x1 double
```
クラスが同じでサイズが異なる要素の場合、coder.typeof のサイズと可変次元の引数を使用して、可変サイズの同種 cell 配列型を作成できます。たとえば、次のコードではサイズと可変次元の引数を使用しません。このコードは異種混合 cell 配列に型を作成します。
```
t = coder.typeof({1 [2 3]})
```
```
t = 

coder.CellType
   1x2 heterogeneous cell 
      f0: 1x1 double
      f1: 1x2 double
```
次のコードでは、サイズと次元の引数を使用して、可変サイズの同種型 cell 配列の型を作成します。
```
t = coder.typeof({1 [2 3]}, [1 5], [0 1])
```
```
t = 

coder.CellType
   1×:5 locked homogeneous cell 
      base: 1×:2 double
```
coder.resize を使用します。
たとえば、最初の次元が固定、2 番目の次元の上限が 5 である可変サイズの cell 配列を指定する場合は、次のようにします。
```
t = coder.typeof({1});
t = coder.resize(t, [1 5], [0,1])
```
```
t = 

coder.CellType
   1x5 homogeneous cell 
      base: 1x1 double
```
coder.resize を異種混合 cell 配列型と共に使用することはできません。

定数の cell 配列入力の指定

cell 配列入力を定数として指定するには、fiaccel コマンドの -args オプションと共に関数 coder.Constant を使用します。以下に例を示します。

fiaccel myfunction -args {coder.Constant({'red',1,'green',2,'blue',3})} -report

入力は 1 行 6 列の異種混合 cell 配列になります。要素のサイズとクラスは次のとおりです。

1 行 3 列 char
1 行 1 列 double
1 行 5 列 char
1 行 1 列 double
1 行 4 列 char
1 行 1 列 double

参考

coder.CellType | coder.typeof | coder.resize | coder.newtype

詳細

cell 配列のコード生成