Programmer Guide/Command Reference/EVAL/vmrow: Difference between revisions
From STX Wiki
< Programmer Guide | Command Reference | EVAL
Jump to navigationJump to search
No edit summary |
No edit summary |
||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
Create a matrix by merging columns of source vectors and/or matrices into the rows of the result. | Create a matrix by merging columns of source vectors and/or matrices into the rows of the result. | ||
;Usage: '''<code><var> | ;Usage: '''<code><var>vmrow(x1</var> {, <var>x2</var> {, .. }})</code>''' | ||
:;<var>x1</var>, <var>x2</var>, ..: source vectors and/or matrices with the same number of rows | :;<var>x1</var>, <var>x2</var>, ..: source vectors and/or matrices with the same number of rows | ||
;Result: A matrix with <code>nrow(''x1'')</code> columns. The columns of the arguments are merged from left to right into the rows of the result matrix. Note: <code>vmrow(a,b,c)</code> returns the same result as <code>trn(vmcol(a,b,c))</code> but vmrow is faster and uses less memory. | ;Result: A matrix with <code>nrow(''x1'')</code> columns. The columns of the arguments are merged from left to right into the rows of the result matrix. Note: <code>vmrow(a,b,c)</code> returns the same result as <code>trn(vmcol(a,b,c))</code>, but <code>vmrow</code> is faster and uses less memory than the nested command. | ||
;See also: [[Programmer_Guide/Command_Reference/EVAL/vv|vv]], [[Programmer_Guide/Command_Reference/EVAL/vvset|vvget]], [[Programmer_Guide/Command_Reference/EVAL/vvset|vvset]], [[Programmer_Guide/Command_Reference/EVAL/vvcat|vvcat]], [[Programmer_Guide/Command_Reference/EVAL/vmcol|vmcol]], [[Programmer_Guide/Command_Reference/EVAL/vsubn|vsubn]], [[Programmer_Guide/Command_Reference/EVAL/vsubc|vsubc]] | ;See also: [[Programmer_Guide/Command_Reference/EVAL/vv|vv]], [[Programmer_Guide/Command_Reference/EVAL/vvset|vvget]], [[Programmer_Guide/Command_Reference/EVAL/vvset|vvset]], [[Programmer_Guide/Command_Reference/EVAL/vvcat|vvcat]], [[Programmer_Guide/Command_Reference/EVAL/vmcol|vmcol]], [[Programmer_Guide/Command_Reference/EVAL/vsubn|vsubn]], [[Programmer_Guide/Command_Reference/EVAL/vsubc|vsubc]] | ||
Line 11: | Line 11: | ||
#b := eval init(5,2,0) | #b := eval init(5,2,0) | ||
#c := eval vmcol($#a, $#b, $#a) | #c := eval vmcol($#a, $#b, $#a) | ||
// -> $#c is a matrix with | // -> $#c is a matrix with 4 rows and 5 columns: | ||
// $#c[*,*] = $#a, #c[1,*] = $#b[*,0], $#c[2,*] = $#b[*,1], $#c[3,*] = $#a | // $#c[*,*] = $#a, #c[1,*] = $#b[*,0], $#c[2,*] = $#b[*,1], $#c[3,*] = $#a | ||
</pre> | </pre> | ||
[[Programmer_Guide/Command_Reference/EVAL#Functions|<function list>]] | [[Programmer_Guide/Command_Reference/EVAL#Functions|<function list>]] |
Revision as of 08:43, 6 April 2011
Create a matrix by merging columns of source vectors and/or matrices into the rows of the result.
- Usage
vmrow(x1 {, x2 {, .. }})
- x1, x2, ..
- source vectors and/or matrices with the same number of rows
- Result
- A matrix with
nrow(x1)
columns. The columns of the arguments are merged from left to right into the rows of the result matrix. Note:vmrow(a,b,c)
returns the same result astrn(vmcol(a,b,c))
, butvmrow
is faster and uses less memory than the nested command. - See also
- vv, vvget, vvset, vvcat, vmcol, vsubn, vsubc
Example:
#a := eval vv(1,2,3,4,5) #b := eval init(5,2,0) #c := eval vmcol($#a, $#b, $#a) // -> $#c is a matrix with 4 rows and 5 columns: // $#c[*,*] = $#a, #c[1,*] = $#b[*,0], $#c[2,*] = $#b[*,1], $#c[3,*] = $#a