where¶

Purpose¶

Returns elements of either a or b depending on condition

Format¶

c = where(condition, a, b)¶

Parameters:	condition (NxK matrix) – Binary matrix where a 1 indicates an element should be selected from `a` and a 0 indicates an element should be selected from `b`. a (Scalar, Nx1 vector, 1xK matrix or NxK matrix) – The elements to return where `condition` equals 1. b (Scalar, Nx1 vector, 1xK matrix or NxK matrix) – The elements to return where `condition` equals 0.
Returns:	c (NxK matrix) – The combined data.

Examples¶

Basic usage¶

condition = { 1 0 0,
              0 1 0 };

a = { 1 2 3,
      4 5 6 };
b = { 10 20 30,
      40 50 60 };

c = where(condition, a, b);

The code above assigns c to be equal to:

 1       20       30
40        5       60

Vectors and scalars will be expanded to fit the dimensions of the larger inputs.

condition = { 1 0 0,
              0 1 0 };

a = { 1 2 3 };
b = { 10,
      40 };

c = where(condition, a, b);

As we see in the result below, the row vector a has been broadcast as if it was a 2x3 matrix with the same elements in each row, while the column vector b has been broadcast as if it was a 2x3 matrix with the same elements in each column.

 1       10       10
40        2       40

Remarks¶

To return the elements with the greatest (or least) magnitude among two matrices, use maxv() (or minv()).
To replace elements according to a binary matrix or vector, use missex().