# mathematics

##### number

**mathematics**

none

none

A number is any element where all the items are a number (which can include a decimal point .) such as 123 or 413.21. Numbers can be stored in containers, for example: put 5 in :container

`show 214.32`

##### +

**mathematics**

number | number

number

Adds two numbers or numerical results of other primitives. Can be placed before or between the two items to be added. Similar to sum

`print 3 + 4 print + 3 4`

`make "container xpos + ypos`

##### –

**mathematics**

number | number

number

Subtracts two numbers or numerical results of other primitives. Similar to difference

`print 5 - 4`

`1`

##### *

**mathematics**

number | number

number

Multiplies two numbers or numerical results of other primitives. Similar to product

`print 6 * 3`

`18`

##### /

**mathematics**

number | number

number

Divides two numbers or numerical results of other primitives. Similar to quotient

`print 12 / 4`

`3`

##### ^

**mathematics**

number | number

number

Returns the first number to the power of the second number. Similar to power

`show 5 ^ 3`

`125`

##### %

**mathematics**

number | number

number

Returns the remainder from dividing the first number by the second number. Similar to remainder

`show 10 % 4`

`2`

##### arccos

**mathematics**

number

number

Returns the inverse cosine of the provided number. The number must be between -1 and 1.

`show arccos 0.2`

##### arcsin

**mathematics**

number

number

Returns the inverse sine of the provided number. The number must be between -1 and 1.

`show arcsin 4`

##### clamp

**mathematics**

number (number) | floor (number) | ceiling (number)

number

Clamp takes the inputted number, and if it is lower than the floor, or higher than the ceiling, it returns the floor or the ceiling respectively.

`print clamp 10 5 20`

`10`

`print clamp 1 5 20`

`5`

`print clamp 30 5 20`

`20`

##### cos

**mathematics**

input (number)

output (output)

Returns the cosine of the input. See sin

`show cos 120`

`-0.50000077735`

##### dec

**mathematics**

word

none

Decreases the value of the specified container (variable) by one. Note that the container (variable) specified by dec begins with a quote (“) not a colon. This is so that you can pass dec a container specified inside another container. See inc

`make "counter 10`

`dec "counter `

`print :counter`

`9`

`will decrement the container named counter by one.`

`make "fred 5`

`make "counter "fred`

`dec :counter `

`print :fred`

`4`

`will decrement the container specified by :counter ("fred) by one.`

##### difference

**mathematics**

number1 (number) | number2 (number)

number

Difference outputs the result of subtracting number 2 from number 1.

`show difference 5 1`

`4`

##### e

**mathematics**

none

number

Returns the constant e, which is 2.7182818284590452353

`show e`

##### fraction frac

**mathematics**

number

number

Returns the fractional part of a number. Similar to mod X 1 or X – int X. See mod, int

`show frac 3.14`

`0.14`

##### integer int

**mathematics**

number

number

Returns the integer value (rounded down) of the provided number.

`show integer 23.34`

`23`

##### intquotient

**mathematics**

number1 (number) | number2 (number)

number

Returns the integer of the quotient (division) of the two provided input numbers. See quotient, remainder

`show intquotient 22 7`

`3`

##### log

**mathematics**

number

number

Returns the log of the given number.

`show log 5`

`0.698970004336`

##### max

**mathematics**

number | number

number

Returns the greater of the two provided numbers. See min

`show max 4 6`

`6`

##### min

**mathematics**

number | number

number

Returns the lesser of the two provided numbers. See max

`show min 4 5`

`4`

##### mod

**mathematics**

numerator (number) | denominator (number)

Returns the floating-point remainder of the division of the supplied numerator by the denominator, as opposed the remainder primitive, which takes and returns integer (whole) values. See remainder

show mod 22 6.5

`2.5`

##### negative

**mathematics**

number

number

Returns the negative of the provided number. You can also negate containers or advisor returns by prefixing them with -, eg -:container or -advisor. See abs

`show negative 10`

`-10`

`show negative -20`

`20`

##### pi

**mathematics**

none

number

Returns 3.141592653589793

`show pi`

`3.141592653589793`

##### power

**mathematics**

number | number

number

Returns the power of the second number to the first number. Similar to ^.

`show power 5 5`

`125`

##### product

**mathematics**

number1 (number) | number2 (number)

number

Returns the product of (multiplies) its two inputs, similar to the * operator.

`show product 4 5`

`20`

##### quotient

**mathematics**

number1 (number) | number2 (number)

number

Returns the first number divided by the second number, similar to using the / operator. See intquotient, remainder

`show quotient 22 7`

`3.142857142857143`

##### radarccos

**mathematics**

number

number

Outputs the inverse cosine of its input in radians.

`show radarccos 0.5`

`0.87758256189`

##### radarcsin

**mathematics**

number

number

Outputs the inverse sine of its input in radians.

`show radarcsin 0.5`

`0.479425538604`

##### radarctan

**mathematics**

number

number

Outputs the inverse tangent of its input in radians.

`show radarctan 0.5`

`0.463647609001`

##### radcos

**mathematics**

number

number

Outputs the cosine of the input in radians.

`show radcos 0.5`

##### radsin

**mathematics**

number

number

Outputs the sine of the input in radians.

`show radsin 0.5`

##### radtan

**mathematics**

number

number

Outputs the tangent of the input in radians.

`show radtan 0.5`

##### random

**mathematics**

maximum (number)

number

Returns a random integer (whole number) between 0 and the specified maximum, but not including that maximum. So, for example, random 2 returns one of two numbers, 0 or 1. random 8 returns one of 8 numbers, between zero and 7. Note that random and its input must be isolated from other expressions using brackets () if you don’t want a random number based on that expression, for example, unless you want random 15 + 10 to return a number between 0 and 34, you need to use (random 15) + 10 to return a number between 10 and 24

`show random 16`

`3`

`show 1 + random 15`

`4`

`show (random 15) + 1`

`4`

##### randomboolean randbool

**mathematics**

none

boolean

Randomly returns TRUE or FALSE.

`show randomboolean`

##### remainder

**mathematics**

numerator (number) | denominator (number)

integer (number)

Returns the integer remainder of the division of the numerator by the denominator. The numerator and denominator are converted to integers if they are not provided as integers. For floating-point calculations, use mod

`show remainder 22 7`

`1`

##### round

**mathematics**

number

number

Takes a number and returns it rounded to the nearest whole number, up or down (whichever is closer).

`print round 4.6`

`5`

`print round 1.2`

`1`

##### sequence

**mathematics**

[from | to | count] (list)

list (list)

Similar to range but outputs a list of numbers starting with the first parameter, then takes a number of equally-spaced steps specified by the third parameter to reach the number given in the second parameter. See range

`show sequence [1 10 6]`

`[1 2.5 4 5.5 7 8.5 10]`

##### sqrt

**mathematics**

number

number

Returns the square root of the provided number.

`show sqrt 16`

`4`

##### sum

**mathematics**

number1 (number) | number2 (number)

result (number)

Sums (adds) the two provided numbers.

`show sum 2 2`

`4`

##### tan

**mathematics**

number

number

Returns the tangent of the supplied number. See arctan

`print tan 5`

`0.087489`

##### truncate

**mathematics**

number | decimalplaces (number)

number

Returns the input rounded to the specified number of decimal places.

`print truncate 10.4325 2`

`10.43`

##### vectoradd

**mathematics**

vector (list) | vector (list)

list

Add two vectors giving a new vector.

`vectoradd [0 1 0] [1 0 1]`

`[1 1 1]`

##### vectorcross

**mathematics**

vector (list) | vector (list)

list

Returns vector perpendicular to the two provided vectors.

`show vectorcross [0 .2 0] [0 0.5 0.5]`

`[0.1 0 0]`

##### vectordot

**mathematics**

vector (list) | vector (list)

number

Returns the “dot” product of two vectors.

`show vectordot [0 0.12 0.12] [0.5 0 0.5]`

`0.06`

##### vectornormal

**mathematics**

vector (list)

list

Returns a “normal” vector of length 1.

`show vectornormal [20 20 20]`

`[0.5773502691896257 0.5773502691896257 0.5773502691896257]`

##### vectormultiply

**mathematics**

vector (list) | amount (number)

list

Multiply vector by given amount.

`show vectormultiply [0.5 0.5 0.5] 2`

`[1 1 1]`

##### vectorsub

**mathematics**

vector1 (list) | vector2 (list)

list

Subtract vector1 from vector2, giving a new vector.

`show vectorsub [0 1 0] [1 0 1]`

`[1 -1 1]`