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-inmathmodule (@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.31951Factorial
fact($x)
@debug fact(4); // 24
@debug fact(8); // 40320Square root
sqrt($x)
@debug sqrt(2); // 1.41421
@debug sqrt(3); // 1.73205Exponential function
exp($x)frexp($x)ldexp($x, $exp)
@debug exp(-1); // 0.36788
@debug exp(0); // 1
@debug exp(1); // 2.71828Logarithms
log($x, $b: null)
@debug log(2); // 0.69315
@debug log(10); // 2.30259
@debug log(2, 10); // 0.30103Trigonometric 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.57735Inverse 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.14159Greatest 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); // 210Helper 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.0472References
- adambom/Sass-Math · GitHub
- Team-Sass/Sassy-math · GitHub
- Math - JavaScript | MDN
- 404 Blog Not Found:javascript - Mathを再発明してみた
- C言語による最新アルゴリズム事典
…and Wikipedia articles:
- Exponentiation, 冪乗 (累乗)
- Factorial, 階乗
- Square root, 平方根
- Exponential function, 指数関数
- Logarithm, 対数
- Trigonometric functions, 三角関数
- Inverse trigonometric functions, 逆三角関数
- Greatest common divisor, 最大公約数
- Least common multiple, 最小公倍数
- Degree (angle), 度 (角度)
- Radian, ラジアン
Credits
Originally created with help from @kaminaly and @pilssalgi.
License
Copyright (c) 2013 Takeru Suzuki Licensed under the MIT license.