mathematics


+

Takes:   number | number

Returns:   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


Takes:   number | number

Returns:   number

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

print 5 - 4
1


*

Takes:   number | number

Returns:   number

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

print 6 * 3
18


/

Takes:   number | number

Returns:   number

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

print 12 / 4
3


^

Takes:   number | number

Returns:   number

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

show 5 ^ 3
125


%

Takes:   number | number

Returns:   number

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

show 10 % 4
2


abs

Takes:   number

Returns:   absolute-number

Returns the absolute (non-negative) value of the input provided.

pr abs -54
54


arccos

Takes:   number

Returns:   number

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

show arccos 0.2


arcsin

Takes:   number

Returns:   number

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

show arcsin 4


arctan

Takes:   number

Returns:   number

Returns the arctangent (inverse) of number in degrees.

print arctan 50
88.854199


clamp

Takes:   number (number) | floor (number) | ceiling (number)

Returns:   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

Takes:   input (number)

Returns:   output (output)

Returns the cosine of the input. See sin

show cos 120
-0.50000077735


dec

Takes:   word

Returns:   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

Takes:   number1 (number) | number2 (number)

Returns:   number

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

show difference 5 1
4


e

Takes:   none

Returns:   number

Returns the constant e, which is 2.7182818284590452353

show e


fraction frac

Takes:   number

Returns:   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

Takes:   number

Returns:   number

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

show integer 23.34
23


intquotient

Takes:   number1 (number) | number2 (number)

Returns:   number

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

show intquotient 22 7
3


ln

Takes:   number

Returns:   number

Returns the natural logarithm of the given input

show ln 100


log

Takes:   number

Returns:   number

Returns the log of the given number.

show log 5

0.698970004336


max

Takes:   number | number

Returns:   number

Returns the greater of the two provided numbers. See min

show max 4 6
6


min

Takes:   number | number

Returns:   number

Returns the lesser of the two provided numbers. See max

show min 4 5
4


mod

Takes:   numerator (number) | denominator (number)

Returns:   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

Takes:   number

Returns:   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

Takes:   none

Returns:   number

Returns 3.141592653589793

show pi
3.141592653589793


power

Takes:   number | number

Returns:   number

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

show power 5 5
125


product

Takes:   number1 (number) | number2 (number)

Returns:   number

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

show product 4 5
20


quotient quo

Takes:   number1 (number) | number2 (number)

Returns:   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

Takes:   number

Returns:   number

Outputs the inverse cosine of its input in radians.

show radarccos 0.5

0.87758256189


radarcsin

Takes:   number

Returns:   number

Outputs the inverse sine of its input in radians.

show radarcsin 0.5

0.479425538604


radarctan

Takes:   number

Returns:   number

Outputs the inverse tangent of its input in radians.

show radarctan 0.5

0.463647609001


radcos

Takes:   number

Returns:   number

Outputs the cosine of the input in radians.

show radcos 0.5


radsin

Takes:   number

Returns:   number

Outputs the sine of the input in radians.

show radsin 0.5


radtan

Takes:   number

Returns:   number

Outputs the tangent of the input in radians.

show radtan 0.5


random rd

Takes:   maximum (number)

Returns:   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

Takes:   none

Returns:   boolean

Randomly returns TRUE or FALSE.

show randomboolean


remainder re

Takes:   numerator (number) | denominator (number)

Returns:   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

Takes:   number

Returns:   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

Takes:   [from | to | count] (list)

Returns:   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]


sin

Takes:   degrees

Returns:   sine of degrees

Returns the sine of degrees.

print sin 90


sqrt

Takes:   number

Returns:   number

Returns the square root of the provided number.

show sqrt 16
4


sum

Takes:   number1 (number) | number2 (number)

Returns:   result (number)

Sums (adds) the two provided numbers.

show sum 2 2
4


tan

Takes:   number

Returns:   number

Returns the tangent of the supplied number. See arctan

print tan 5
0.087489


truncate

Takes:   number | decimalplaces (number)

Returns:   number

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

print truncate 10.4325 2
10.43


vectoradd

Takes:   vector (list) | vector (list)

Returns:   list

Add two vectors giving a new vector.

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


vectorcross

Takes:   vector (list) | vector (list)

Returns:   list

Returns vector perpendicular to the two provided vectors.

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

[0.1 0 0]


vectordot

Takes:   vector (list) | vector (list)

Returns:   number

Returns the “dot” product of two vectors.

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

0.06


vectornormal

Takes:   vector (list)

Returns:   list

Returns a “normal” vector of length 1.

show vectornormal [20 20 20]
[0.5773502691896257 0.5773502691896257 0.5773502691896257]


vectormultiply

Takes:   vector (list) | amount (number)

Returns:   list

Multiply vector by given amount.

show vectormultiply [0.5 0.5 0.5] 2
[1 1 1]


vectorsub

Takes:   vector1 (list) | vector2 (list)

Returns:   list

Subtract vector1 from vector2, giving a new vector.

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

[1 -1 1]