Programmer Guide/Command Reference/EVAL/vsubn: Difference between revisions
From STX Wiki
< Programmer Guide | Command Reference | EVAL
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 3: | Line 3: | ||
;Usage: '''<code><var>vsubn(x</var> {, <var>o</var> {, <var>n</var>}})</code>''' | ;Usage: '''<code><var>vsubn(x</var> {, <var>o</var> {, <var>n</var>}})</code>''' | ||
:;<var>x</var>: source vector or matrix | :;<var>x</var>: source vector or matrix | ||
:;<var>o</var>: offset, 0 <= ''o'' < <code>nrow(''x'')</code> | :;<var>o</var>: offset, 0 <= ''o'' < <code>nrow(''x'')</code> (default=0) | ||
:;<var>n</var>: length, ''n'' > 0 and ''o''+''n'' <= <code>nrow(''x'')</code> | :;<var>n</var>: length, ''n'' > 0 and ''o''+''n'' <= <code>nrow(''x'')</code> (default=<code>nrow(''x'')-''o''</code> | ||
;Result: A numerical object with <code>ncol(''x'')</code> columns and ''n'' rows, consisting of the rows ''o'' to ''o''+''n''-1 of the argument ''x''. | ;Result: A numerical object with <code>ncol(''x'')</code> columns and ''n'' rows, consisting of the rows ''o'' to ''o''+''n''-1 of the argument ''x''. | ||
;See also: [[Programmer_Guide/Command_Reference/EVAL/ | ;See also: [[Programmer_Guide/Command_Reference/EVAL/vsubc|vsubc]], [[Programmer_Guide/Command_Reference/EVAL/select|select]], [[Programmer_Guide/Command_Reference/EVAL/vvset|vv]] | ||
Example: | Example: | ||
<pre> | <pre> | ||
#a := eval vv(1,2,3,4,5) | #a := eval vv(1,2,3,4,5) | ||
#b := eval | #b := eval vmcol($#a, vv(5,4,3,2,1)) | ||
#c := | #c := vsubn($#a,3) | ||
// -> $#c | // -> vector: $#c = { 4 , 5 } | ||
// | #d := eval vsubn($#b, 1 , 3) | ||
// -> matrix: $#d[*,0] = { 2 , 3 , 4 }, $#d[*,1] = { 4 , 3 , 2 } | |||
#e := eval vsubn($#a, 2, 1) | |||
// -> scalar: $#e = 2, this is equivalent to $#a[2] | |||
#f := eval vsubn($#b, 2, 1) | |||
// -> vector (!!): $#f = { 3 , 3 }, this is equivalent to $#b[2,*] | |||
</pre> | </pre> | ||
[[Programmer_Guide/Command_Reference/EVAL#Functions|<function list>]] | [[Programmer_Guide/Command_Reference/EVAL#Functions|<function list>]] | ||
Revision as of 09:09, 6 April 2011
Extract rows from a vector or matrix.
- Usage
vsubn(x {, o {, n}})- x
- source vector or matrix
- o
- offset, 0 <= o <
nrow(x)(default=0) - n
- length, n > 0 and o+n <=
nrow(x)(default=nrow(x)-o
- Result
- A numerical object with
ncol(x)columns and n rows, consisting of the rows o to o+n-1 of the argument x. - See also
- vsubc, select, vv
Example:
#a := eval vv(1,2,3,4,5)
#b := eval vmcol($#a, vv(5,4,3,2,1))
#c := vsubn($#a,3)
// -> vector: $#c = { 4 , 5 }
#d := eval vsubn($#b, 1 , 3)
// -> matrix: $#d[*,0] = { 2 , 3 , 4 }, $#d[*,1] = { 4 , 3 , 2 }
#e := eval vsubn($#a, 2, 1)
// -> scalar: $#e = 2, this is equivalent to $#a[2]
#f := eval vsubn($#b, 2, 1)
// -> vector (!!): $#f = { 3 , 3 }, this is equivalent to $#b[2,*]
