MathSass

April 10, 2026 · View on GitHub

⚠️ This project is no longer maintained. This repository is archived and no longer accepting issues or pull requests. The devDependencies contain known security vulnerabilities, but these do not affect library users — only the dist/ directory is included when installed via npm. Consider using Sass's built-in math module (@use "sass:math") instead, which provides native implementations of these functions.

A Sass implementation of mathematical functions.

Install

Git

git clone git@github.com:terkel/mathsass.git && cd mathsass

Bower

bower install mathsass --save-dev

npm

npm install mathsass --save-dev

Usage

Import dist/_math.scss partial to the Sass document.

@import "path/to/dist/math";

.content {
    height: 200px;
    width: 200px / tan(60deg); // 115.47005px
}

If you installed via Npm the path will be: node_modules/mathsass/dist/math

If you installed via Bower the path will be: bower_components/mathsass/dist/math

Features

Constants

$E - Euler's constant (ネイピア数 [オイラー数])
$PI - π (円周率)
$LN2 - The natural logarithm of 2 (2 の自然対数)
$SQRT2 - The square root of 2 (2 の平方根)

Functions

Exponentiation

pow($base, $exp)

@debug pow(4, 2);   // 16
@debug pow(4, -2);  // 0.0625
@debug pow(4, 0.2); // 1.31951

Factorial

fact($x)

@debug fact(4); // 24
@debug fact(8); // 40320

Square root

sqrt($x)

@debug sqrt(2); // 1.41421
@debug sqrt(3); // 1.73205

Exponential function

exp($x)
frexp($x)
ldexp($x, $exp)

@debug exp(-1); // 0.36788
@debug exp(0);  // 1
@debug exp(1);  // 2.71828

Logarithms

log($x, $b: null)

@debug log(2);     // 0.69315
@debug log(10);    // 2.30259
@debug log(2, 10); // 0.30103

Trigonometric functions

sin($x) - Sine (正弦)
cos($x) - Cosine (余弦)
tan($x) - Tangent (正接)
csc($x) - Cosecant (余割)
sec($x) - Secant (正割)
cot($x) - Cotangent (余接)

If argument has deg unit, converted to rad.

@debug tan(0.5236); // 0.57735
@debug tan(30deg);  // 0.57735

Inverse trigonometric functions

asin($x) - Arcsine (逆正弦)
acos($x) - Arccosine (逆余弦)
atan($x) - Arctangent (逆正接)
atan2($y, $x) - Arctangent of the quotient of its arguments (引数の比率での逆正接)

@debug atan2(0, 0);       // 0
@debug atan2(0, -0.0);    // 3.14159
@debug atan2(-0.0, 0);    // 0
@debug atan2(-0.0, -0.0); // -3.14159

Greatest common divisor and least common multiple

gcd($a, $b) - Greatest common divisor (最大公約数)
lcm($a, $b) - Least common multiple (最小公倍数)

@debug gcd(54, 24); // 6
@debug lcm(30, 42); // 210

Helper functions

strip-unit($number)
deg-to-rad($deg, $unit: true)
rad-to-deg($rad, $unit: true)
unitless-rad($angle)

@debug rad-to-deg(1.0472);       // 60.00014deg
@debug deg-to-rad(60deg);        // 1.0472rad
@debug deg-to-rad(60deg, false); // 1.0472
@debug unitless-rad(60deg);      // 1.0472
@debug unitless-rad(1.0472rad);  // 1.0472