chainer.dataset.concat_examples(batch, device=None, padding=None)[source]¶

データのリストを配列に結合する。

Dataset iterator はデータのリストを生成します。この各データが配列だった場合、この関数はその配列を新しく挿入された最初の軸（バッチディメンジョン）に添って結合し１つの配列にします。この基本的な動作は多次元配列からなるデータの場合も同様です。つまり全てのデータは対応する配列へ結合されます。

たとえば、 (x, y). という２次元配列のデータを考えます。その場合、この関数は x を１つの配列へ結合し、 y をもう一方へ結合します。そして, これらの２つの配列のタプルを返します。

別の例:  'x' と 'y', である別々の２つのエントリがあるディクショナリについて考えます。この関数は x をひとつの配列へ結合し、 y をもう一方の配列に結合します。そして、 x と y のエントリに配列の値が結合されたディクショナリを返します。

結合する配列が異なる形を持つ場合、動作は padding の値に依存します。 padding がNone (default)の場合、エラーが発生します。それ以外では、すべての配列の内容が入る最小限の形の配列が作成されます。この  padding  は、結果の配列の予備要素に用いられます。

TODO(beam2d): Add an example.