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 |
||
(2 intermediate revisions by 2 users not shown) | |||
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: | ;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 <code>vmrow</code> is faster and uses less memory than the nested command. | ;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. | ||
;See also: [[ | :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: [[../vv|vv]], [[../vvset|vvget]], [[../vvset|vvset]], [[../vvcat|vvcat]], [[../vmcol|vmcol]], [[../vsubn|vsubn]], [[../vsubc|vsubc]] | |||
[[../#Functions|<function list>]] | |||
Example: | Example: | ||
#a := eval vv(1,2,3,4,5) | |||
#a := eval vv(1,2,3,4,5) | #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 4 rows and 5 columns: | ||
// -> $#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 | |||
Latest revision as of 12:05, 21 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