Programmer Guide/Command Reference/EVAL/select: Difference between revisions

From STX Wiki
Jump to navigationJump to search
m (1 revision: Initial import)
No edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
=====select=====
Conditional merge of selected elements of two vectors and/or scalars.
;Usage: <code>select(<var>x</var>, <var>t</var>, <var>yl</var>, <var>yh</var>)</code>
:;<var>x</var>: condition vector; must be a vector!
:;<var>t</var>: threshold
:;<var>yl</var>: result if <code>''x''[''i''] &le; ''t''{[''i'']}</code>
:;<var>yh</var>: result if <code>''x''[''i''] > ''t''{[''i'']}</code>
:Note: ''t'', ''yl'' and ''yh'' must be numbers or vectors with the same length as ''x''
;Result: A vector ''r'' with ...
::<code>''r''[i] = ''yl''{[''i'']}</code> if <code>''x''[''i''] &le; ''t''{[''i'']}</code> and
::<code>''r''[i] = ''yh''{[''i'']}</code> if <code>''x''[''i''] > ''t''{[''i'']}</code>
:The result r has the same length as ''x''.


The <code>select</code> subcommand performs a conditional assignment. The arguments <var>x</var> and <var>t</var> are compared and the result <var>yl</var> (<var>x</var> <= <var>t</var>) or <var>yh</var> (<var>x</var> > <var>t</var>) is assigned. The result type is the same as <var>x</var>. This is a subcommand of the <code>[[Programmer Guide/Command Reference/EVAL/EVAL|EVAL]]</code> command.
;See also: [[../vsubc|vsubc]], [[../limit|limit, limitlow, limithigh]]


{|
[[../#Functions|<function list>]]
|-
|Usage:
|select(x, <var>t</var>, <var>y1</var>, <var>yh</var>)
|-
|Parameters:
|{|
|-
|<var>x</var>
|The input (vector)
|-
|t
|The threshold value (vector or scalar)
|-
|y1
|The result if x[i] <= <var>t</var>|<var>t</var>[i] (vector or scalar)
|-
|yh
|The result if x[i] > <var>t</var>|<var>t</var>[i] (vector or scalar)
|}


 
Example:
|
<pre>
|-
#a := eval vv(1,2,3,4,5,4,3,2,1)
|Return Type:
#b := eval fill(9,0,1)
|The same as x.
#c := eval select($#a,3,0,$#a)
|}
// -> $#c = { 0 , 0 , 0 , 4 , 5 , 4 , 0 , 0 , 0 }
#d := eval select($#a, $#b , $#b , $#a)
// -> $#d = { 1 , 2 , 3 , 4 , 5 , 5 , 6 , 7 , 8 }
#e := eval select($#b%2, 0, $#b, -1)
// -> $#d = { 0 , -1 , 2 , -1 , 4 , -1 , 6 , -1 , 8 }
</pre>

Latest revision as of 16:46, 1 October 2015

Conditional merge of selected elements of two vectors and/or scalars.

Usage
select(x, t, yl, yh)
x
condition vector; must be a vector!
t
threshold
yl
result if x[i] ≤ t{[i]}
yh
result if x[i] > t{[i]}
Note: t, yl and yh must be numbers or vectors with the same length as x
Result
A vector r with ...
r[i] = yl{[i]} if x[i] ≤ t{[i]} and
r[i] = yh{[i]} if x[i] > t{[i]}
The result r has the same length as x.
See also
vsubc, limit, limitlow, limithigh

<function list>

Example:

#a := eval vv(1,2,3,4,5,4,3,2,1)
#b := eval fill(9,0,1)
#c := eval select($#a,3,0,$#a)
// -> $#c = { 0 , 0 , 0 , 4 , 5 , 4 , 0 , 0 , 0 } 
#d := eval select($#a, $#b , $#b , $#a)
// -> $#d = { 1 , 2 , 3 , 4 , 5 , 5 , 6 , 7 , 8 }
#e := eval select($#b%2, 0, $#b, -1)
// -> $#d = { 0 , -1 , 2 , -1 , 4 , -1 , 6 , -1 , 8 }

Navigation menu

Personal tools