This actor joins matrices into a single matrix by tiling.
It reads N*M input matrices from the input port, where N is
the value of the <i>rows</i> parameter, and M is
the value of the <i>columns</i> parameter. The matrices
read are arranged left-to-right,
top-to-bottom, in a raster scan pattern.
For example, if <i>rows</i> = <i>columns</i> = 2, then on
each firing, four matrices, A, B, C, D, will be read from
the input channel. Assuming A is the first one read, then
the output matrix will be a matrix arranged as follows:
<pre>
A B
C D
</pre>
The size of the output depends on the matrices in the top row
and left column. That is, in the above examples, the number of
columns in the output will equal the sum of the number of columns
in A and B. The number of rows will equal the sum of the number
of rows in A and C. The matrices are tiled in raster-scan order,
first A, then B, then C, and then D. Gaps are zero filled,
and overlaps are overwritten, where later matrices in the raster-scan
order overwrite earlier matrices. For example, if B has more rows
than A, then the bottom rows of B will be overwritten by rows of D.
<p>
Edward Lee
$Id: MatrixJoin.java 70398 2014-10-22 23:44:32Z cxh $
Ptolemy II 6.1
Yellow (eal)
Red (neuendor)
The number of matrices to arrange left to right on the output.
This is an integer that defaults to 1.
The number of matrices to arrange top to bottom on the output.
This is an integer that defaults to 1.