function subsetlin
subsetlin(
m: array,
idx:
number
| array
| matrix
,
flag?: 0 | 1,
): array | matrix

Extracts elements from an array or matrix based on linear indexing.

Extracts a subset of an array or matrix using linear indexing, either row-wise (default) or column-wise.

Examples

Example 1

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];
const c = [5,6,3];

Extract a single element

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, 1), [6]);

Subset by rows

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, [0,1,2,3]), [5, 6, 5, 7]);

Subset by columns

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, [0,1,2,3], 1), [5, 7, 6, 8]);

Extract a 2D subset (column-wise)

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, [[0,1,2], [2,3,4]], 1), [[5, 7, 6], [6, 8, 5]]);

Subset a vector

import { assertEquals } from "jsr:@std/assert";

const c = [5,6,3];

assertEquals(subsetlin(c, [0,1]), [5, 6]);

Extract a 2D subset from a vector

import { assertEquals } from "jsr:@std/assert";

const c = [5,6,3];

assertEquals(subsetlin(c, [[0,1], [1,2]]), [[5, 6], [6, 3]]);

Parameters

m: array

The array or matrix of elements.

idx:
number
| array
| matrix

Linear indexing values.

optional
flag: 0 | 1

Flag (0: row-wise, 1: column-wise). Defaults to 0.

Return Type

The subset of m based on idx.

Throws

If input arguments are missing.

subsetlin(
m: matrix,
idx:
number
| array
| matrix
,
flag?: 0 | 1,
): array | matrix

Extracts elements from an array or matrix based on linear indexing.

Extracts a subset of an array or matrix using linear indexing, either row-wise (default) or column-wise.

Examples

Example 1

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];
const c = [5,6,3];

Extract a single element

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, 1), [6]);

Subset by rows

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, [0,1,2,3]), [5, 6, 5, 7]);

Subset by columns

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, [0,1,2,3], 1), [5, 7, 6, 8]);

Extract a 2D subset (column-wise)

import { assertEquals } from "jsr:@std/assert";

const a = [[5,6,5],[7,8,-1]];

assertEquals(subsetlin(a, [[0,1,2], [2,3,4]], 1), [[5, 7, 6], [6, 8, 5]]);

Subset a vector

import { assertEquals } from "jsr:@std/assert";

const c = [5,6,3];

assertEquals(subsetlin(c, [0,1]), [5, 6]);

Extract a 2D subset from a vector

import { assertEquals } from "jsr:@std/assert";

const c = [5,6,3];

assertEquals(subsetlin(c, [[0,1], [1,2]]), [[5, 6], [6, 3]]);

Parameters

The array or matrix of elements.

idx:
number
| array
| matrix

Linear indexing values.

optional
flag: 0 | 1

Flag (0: row-wise, 1: column-wise). Defaults to 0.

Return Type

The subset of m based on idx.

Throws

If input arguments are missing.

Usage

import subsetlin from "matarrs/subsetlin.ts";