The `goog.math` Namespace

The `goog.math.Bezier` Class

Object representing a cubic bezier curve. … more

The `goog.math.Box` Class

Class for representing a box. A box is specified as a top, right, bottom, and left. A box is useful for representing margins and padding. … more

The `goog.math.Coordinate` Class

Class for representing coordinates and positions. … more

The `goog.math.Coordinate3` Class

Class for representing coordinates and positions in 3 dimensions. … more

The `goog.math.ExponentialBackoff` Class

… more

Constructs a two's-complement integer an array containing bits of the integer in 32-bit (signed) pieces, given in little-endian order (i.e., lowest-order bits in the first piece), and the sign of -1 or 0. See the from* functions below for other convenient ways of constructing Integers. The internal representation of an integer is an array of 32-bit signed pieces, along with a sign (0 or -1) that indicates the contents of all the other 32-bit pieces out to infinity. We use 32-bit pieces because these are the size of integers on which Javascript performs bit-operations. For operations like addition and multiplication, we split each number into 16-bit pieces, which can easily be multiplied within Javascript's floating-point representation without overflow or change in sign. … more

The `goog.math.Line` Class

Object representing a line. … more

The `goog.math.Long` Class

Constructs a 64-bit two's-complement integer, given its low and high 32-bit values as *signed* integers. See the from* functions below for more convenient ways of constructing Longs. The internal representation of a long is the two given signed, 32-bit values. We use 32-bit pieces because these are the size of integers on which Javascript performs bit-operations. For operations like addition and multiplication, we split each number into 16-bit pieces, which can easily be multiplied within Javascript's floating-point representation without overflow or change in sign. In the algorithms below, we frequently reduce the negative case to the positive case by negating the input(s) and then post-processing the result. Note that we must ALWAYS check specially whether those values are MIN_VALUE (-2^63) because -MIN_VALUE == MIN_VALUE (since 2^63 cannot be represented as a positive number, it overflows back into a negative). Not handling this case would often result in infinite recursion. … more

The `goog.math.Matrix` Class

Class for representing and manipulating matrices. The entry that lies in the i-th row and the j-th column of a matrix is typically referred to as the i,j entry of the matrix. The m-by-n matrix A would have its entries referred to as: [ a0,0 a0,1 a0,2 ... a0,j ... a0,n ] [ a1,0 a1,1 a1,2 ... a1,j ... a1,n ] [ a2,0 a2,1 a2,2 ... a2,j ... a2,n ] [ . . . . . ] [ . . . . . ] [ . . . . . ] [ ai,0 ai,1 ai,2 ... ai,j ... ai,n ] [ . . . . . ] [ . . . . . ] [ . . . . . ] [ am,0 am,1 am,2 ... am,j ... am,n ] … more

The `goog.math.Range` Class

A number range. … more

The `goog.math.RangeSet` Class

Constructs a new RangeSet, which can store numeric ranges. Ranges are treated as half-closed: that is, they are exclusive of their end value [start, end). New ranges added to the set which overlap the values in one or more existing ranges will be merged. … more

The `goog.math.Rect` Class

Class for representing rectangular regions. … more

The `goog.math.Size` Class

Class for representing sizes consisting of a width and height. Undefined width and height support is deprecated and results in compiler warning. … more

The `goog.math.Vec2` Class

Class for a two-dimensional vector object and assorted functions useful for manipulating points. … more

The `goog.math.Vec3` Class

Class for a three-dimensional vector object and assorted functions useful for manipulation. Inherits from goog.math.Coordinate3 so that a Vec3 may be passed in to any function that requires a Coordinate. … more

`.angle(x1, y1, x2, y2)`

Computes the angle between two points (x1,y1) and (x2,y2). Angle zero points in the +X direction, 90 degrees points in the +Y direction (down) and from there we grow clockwise towards 360 degrees.

x1 {number}: x of first point.
y1 {number}: y of first point.
x2 {number}: x of second point.
y2 {number}: y of second point.
returns {number}: Standardized angle in degrees of the vector from x1,y1 to x2,y2.

`.angleDifference(startAngle, endAngle)`

Computes the difference between startAngle and endAngle (angles in degrees).

startAngle {number}: Start angle in degrees.
endAngle {number}: End angle in degrees.
returns {number}: The number of degrees that when added to startAngle will result in endAngle. Positive numbers mean that the direction is clockwise. Negative numbers indicate a counter-clockwise direction. The shortest route (clockwise vs counter-clockwise) between the angles is used. When the difference is 180 degrees, the function returns 180 (not -180) angleDifference(30, 40) is 10, and angleDifference(40, 30) is -10. angleDifference(350, 10) is 20, and angleDifference(10, 350) is -20.

`.angleDx(degrees, radius)`

For a given angle and radius, finds the X portion of the offset.

degrees {number}: Angle in degrees (zero points in +X direction).
radius {number}: Radius.
returns {number}: The x-distance for the angle and radius.

`.angleDy(degrees, radius)`

For a given angle and radius, finds the Y portion of the offset.

degrees {number}: Angle in degrees (zero points in +X direction).
radius {number}: Radius.
returns {number}: The y-distance for the angle and radius.

`.average(var_args)`

Returns the arithmetic mean of the arguments.

var_args {...number}: Numbers to average.
returns {number}: The average of the arguments ({@code NaN} if no arguments were provided or any of the arguments is not a valid number).

`.clamp(value, min, max)`

Takes a number and clamps it to within the provided bounds.

value {number}: The input number.
min {number}: The minimum value to return.
max {number}: The maximum value to return.
returns {number}: The input number if it is within bounds, or the nearest number within the bounds.

The `goog.math.interpolator` Namespace

… more

`.isFiniteNumber(num)`

Returns whether the supplied number is finite and not NaN.

num {number}: The number to test.
returns {boolean}: Whether {@code num} is a finite number.

`.isInt(num)`

Returns whether the supplied number represents an integer, i.e. that is has no fractional component. No range-checking is performed on the number.

num {number}: The number to test.
returns {boolean}: Whether {@code num} is an integer.

`.lerp(a, b, x)`

Performs linear interpolation between values a and b. Returns the value between a and b proportional to x (when x is between 0 and 1. When x is outside this range, the return value is a linear extrapolation).

a {number}: A number.
b {number}: A number.
x {number}: The proportion between a and b.
returns {number}: The interpolated value between a and b.

`.longestCommonSubsequence(array1, array2, opt_compareFn, opt_collectorFn)`

JavaScript implementation of Longest Common Subsequence problem. http://en.wikipedia.org/wiki/Longest_common_subsequence Returns the longest possible array that is subarray of both of given arrays.

array1 {Array.<Object>}: First array of objects.
array2 {Array.<Object>}: Second array of objects.
opt_compareFn {Function=}: Function that acts as a custom comparator for the array ojects. Function should return true if objects are equal, otherwise false.
opt_collectorFn {Function=}: Function used to decide what to return as a result subsequence. It accepts 2 arguments: index of common element in the first array and index in the second. The default function returns element from the first array.
returns {Array.<Object>}: A list of objects that are common to both arrays such that there is no common subsequence with size greater than the length of the list.

`.modulo(a, b)`

The % operator in JavaScript returns the remainder of a / b, but differs from some other languages in that the result will have the same sign as the dividend. For example, -1 % 8 == -1, whereas in some other languages (such as Python) the result would be 7. This function emulates the more correct modulo behavior, which is useful for certain applications such as calculating an offset index in a circular list.

a {number}: The dividend.
b {number}: The divisor.
returns {number}: a % b where the result is between 0 and b (either 0 <= x < b or b < x <= 0, depending on the sign of b).

`.nearlyEquals(a, b, opt_tolerance)`

Tests whether the two values are equal to each other, within a certain tolerance to adjust for floating pount errors.

a {number}: A number.
b {number}: A number.
opt_tolerance {number=}: Optional tolerance range. Defaults to 0.000001. If specified, should be greater than 0.
returns {boolean}: Whether {@code a} and {@code b} are nearly equal.

`.randomInt(a)`

Returns a random integer greater than or equal to 0 and less than {@code a}.

a {number}: The upper bound for the random integer (exclusive).
returns {number}: A random integer N such that 0 <= N < a.

`.sign(x)`

Returns the sign of a number as per the "sign" or "signum" function.

x {number}: The number to take the sign of.
returns {number}: -1 when negative, 1 when positive, 0 when 0.

`.standardAngle(angle)`

Standardizes an angle to be in range [0-360). Negative angles become positive, and values greater than 360 are returned modulo 360.

angle {number}: Angle in degrees.
returns {number}: Standardized angle.

`.standardDeviation(var_args)`

Returns the sample standard deviation of the arguments. For a definition of sample standard deviation, see e.g. http://en.wikipedia.org/wiki/Standard_deviation

var_args {...number}: Number samples to analyze.
returns {number}: The sample standard deviation of the arguments (0 if fewer than two samples were provided, or {@code NaN} if any of the samples is not a valid number).

`.sum(var_args)`

Returns the sum of the arguments.

var_args {...number}: Numbers to add.
returns {number}: The sum of the arguments (0 if no arguments were provided, {@code NaN} if any of the arguments is not a valid number).

The `goog.math.tdma` Namespace

… more

`.toDegrees(angleRadians)`

Converts radians to degrees.

angleRadians {number}: Angle in radians.
returns {number}: Angle in degrees.

`.toRadians(angleDegrees)`

Converts degrees to radians.

angleDegrees {number}: Angle in degrees.
returns {number}: Angle in radians.

`.uniformRandom(a, b)`

Returns a random number greater than or equal to {@code a} and less than {@code b}.

a {number}: The lower bound for the random number (inclusive).
b {number}: The upper bound for the random number (exclusive).
returns {number}: A random number N such that a <= N < b.

The goog.math Namespace

.angle(x1, y1, x2, y2)

.angleDifference(startAngle, endAngle)

.angleDx(degrees, radius)

.angleDy(degrees, radius)

.average(var_args)

.clamp(value, min, max)

.isFiniteNumber(num)

.isInt(num)

.lerp(a, b, x)

.longestCommonSubsequence(array1, array2, opt_compareFn, opt_collectorFn)

.modulo(a, b)

.nearlyEquals(a, b, opt_tolerance)

.randomInt(a)

.sign(x)

.standardAngle(angle)

.standardDeviation(var_args)

.sum(var_args)

.toDegrees(angleRadians)

.toRadians(angleDegrees)

.uniformRandom(a, b)

The `goog.math` Namespace

`.angle(x1, y1, x2, y2)`

`.angleDifference(startAngle, endAngle)`

`.angleDx(degrees, radius)`

`.angleDy(degrees, radius)`

`.average(var_args)`

`.clamp(value, min, max)`

`.isFiniteNumber(num)`

`.isInt(num)`

`.lerp(a, b, x)`

`.longestCommonSubsequence(array1, array2, opt_compareFn, opt_collectorFn)`

`.modulo(a, b)`

`.nearlyEquals(a, b, opt_tolerance)`

`.randomInt(a)`

`.sign(x)`

`.standardAngle(angle)`

`.standardDeviation(var_args)`

`.sum(var_args)`

`.toDegrees(angleRadians)`

`.toRadians(angleDegrees)`

`.uniformRandom(a, b)`