function range
range(x: number): number

Range of values.

Calculates the range (difference between maximum and minimum values) of an array or matrix. Provides a measure of data spread or variability.

Examples

Simple range

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

assertEquals(range([1, 5, 3]), 4);

Range with negative values

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

assertEquals(range([-2, 0, 3]), 5);

Matrix range along rows (default dim=0)

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

assertEquals(range([[1, 4], [2, 8]]), [3, 6]);

Parameters

x: number

Input number, array, or matrix

Return Type

number

Range values (max - min)

Throws

When input is invalid

range(
x: array,
dim?: 0 | 1,
): number

Range of values.

Calculates the range (difference between maximum and minimum values) of an array or matrix. Provides a measure of data spread or variability.

Examples

Simple range

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

assertEquals(range([1, 5, 3]), 4);

Range with negative values

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

assertEquals(range([-2, 0, 3]), 5);

Matrix range along rows (default dim=0)

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

assertEquals(range([[1, 4], [2, 8]]), [3, 6]);

Parameters

x: array

Input number, array, or matrix

optional
dim: 0 | 1

Dimension along which to compute range. Default is 0

Return Type

number

Range values (max - min)

Throws

When input is invalid

range(
x: matrix,
dim?: 0 | 1,
): array

Range of values.

Calculates the range (difference between maximum and minimum values) of an array or matrix. Provides a measure of data spread or variability.

Examples

Simple range

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

assertEquals(range([1, 5, 3]), 4);

Range with negative values

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

assertEquals(range([-2, 0, 3]), 5);

Matrix range along rows (default dim=0)

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

assertEquals(range([[1, 4], [2, 8]]), [3, 6]);

Parameters

Input number, array, or matrix

optional
dim: 0 | 1

Dimension along which to compute range. Default is 0

Return Type

Range values (max - min)

Throws

When input is invalid

Usage

import range from "stats/range.ts";