Skip to content
Ubiquev1.0.4
functiondownsiderisk
downsiderisk(
x: number,
mar?: number,
dim?: 0 | 1
): number

Downside Risk.

Root mean squared shortfall from Minimum Acceptable Return (MAR): sqrt(mean(min(x - MAR, 0)^2)), with all observations in the denominator.

Examples

Downside risk with default MAR

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

const x = [0.003, 0.026, 0.015, -0.009, 0.014, 0.024, 0.015, 0.066, -0.014, 0.039];
assertAlmostEquals(downsiderisk(x), 0.0052630789467763076, 1e-14);

Downside risk with custom MAR

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

assertAlmostEquals(downsiderisk([0.02, -0.01, 0.03, -0.02], 0.01), 0.018027756377319945, 1e-14);

Downside risk with higher MAR

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

assertAlmostEquals(downsiderisk([0.1, -0.2, 0.05, -0.1], 0), 0.1118033988749895, 5.5901699437494745e-14);

Parameters

x: number

array of values

optional
mar: number

minimum acceptable return (def: 0)

optional
dim: 0 | 1

dimension 0: row, 1: column (def: 0)

Return Type

number

Downside Risk

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

Downside Risk.

Root mean squared shortfall from Minimum Acceptable Return (MAR): sqrt(mean(min(x - MAR, 0)^2)), with all observations in the denominator.

Examples

Downside risk with default MAR

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

const x = [0.003, 0.026, 0.015, -0.009, 0.014, 0.024, 0.015, 0.066, -0.014, 0.039];
assertAlmostEquals(downsiderisk(x), 0.0052630789467763076, 1e-14);

Downside risk with custom MAR

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

assertAlmostEquals(downsiderisk([0.02, -0.01, 0.03, -0.02], 0.01), 0.018027756377319945, 1e-14);

Downside risk with higher MAR

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

assertAlmostEquals(downsiderisk([0.1, -0.2, 0.05, -0.1], 0), 0.1118033988749895, 5.5901699437494745e-14);

Parameters

array of values

optional
mar: number

minimum acceptable return (def: 0)

optional
dim: 0 | 1

dimension 0: row, 1: column (def: 0)

Return Type

number

Downside Risk

downsiderisk(
x: matrix,
mar?: number,
dim?: 0 | 1
): array | matrix

Downside Risk.

Root mean squared shortfall from Minimum Acceptable Return (MAR): sqrt(mean(min(x - MAR, 0)^2)), with all observations in the denominator.

Examples

Downside risk with default MAR

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

const x = [0.003, 0.026, 0.015, -0.009, 0.014, 0.024, 0.015, 0.066, -0.014, 0.039];
assertAlmostEquals(downsiderisk(x), 0.0052630789467763076, 1e-14);

Downside risk with custom MAR

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

assertAlmostEquals(downsiderisk([0.02, -0.01, 0.03, -0.02], 0.01), 0.018027756377319945, 1e-14);

Downside risk with higher MAR

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

assertAlmostEquals(downsiderisk([0.1, -0.2, 0.05, -0.1], 0), 0.1118033988749895, 5.5901699437494745e-14);

Parameters

array of values

optional
mar: number

minimum acceptable return (def: 0)

optional
dim: 0 | 1

dimension 0: row, 1: column (def: 0)

Return Type

Downside Risk