Project

MathSass

0.06
Repository is archived
No release in over 3 years
Low commit activity in last 3 years
A Sass implementation of mathematical functions.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

>= 3.2
 Project Readme

MathSass

⚠️ 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

References

…and Wikipedia articles:

Credits

Originally created with help from @kaminaly and @pilssalgi.

License

Copyright (c) 2013 Takeru Suzuki Licensed under the MIT license.