Simple Log Service:Arithmetic functions

Usage notes

The following conventions apply to all arithmetic functions in this topic:

• Function families — Functions whose names begin with op_ perform basic calculations. Functions whose names begin with mat_ perform mathematical calculations. MATH_PI and MATCH_E are mathematical constants that you pass to a function as a value.

• Overlapping operations — Some operations are available in both function families. For example, both op_abs and mat_fabs calculate an absolute value. Compare the example in each section to see the result that each function returns.

• Input types — The parameter table in each section lists the types that a parameter accepts. Most parameters accept a number or a numeric string. The value1 parameter of op_mul also accepts a string, a tuple, or a list.

• Angle units — mat_sin, mat_cos, and mat_tan accept the input value in radians, and mat_acos, mat_asin, and mat_atan return the result in radians. To convert degrees to radians, use mat_radians. To convert radians to degrees, use mat_degrees.

• Examples — Each example shows the raw log, the transformation rule that is applied to the log, and the result of the transformation.

Function list

The following table lists the arithmetic functions and mathematical constants by type.

op_sum

Calculates the sum of the input values.

• Syntax

op_sum(value1, value2, ...)

• Parameters

• Response

  The sum of the input values.

• Examples

  Calculate the total price from the course_price and goods_price fields.

• Raw log

course_price: 12
goods_price: 2

• Transformation rule

e_set("total_price", op_sum(v("course_price"), v("goods_price")))

• Result

course_price: 12
goods_price: 2
total_price: 14

op_abs

Calculates the absolute value of an input value.

• Syntax

op_abs(value)

• Parameters

• Response

  The absolute value of the input value.

• Examples

  Calculate the absolute value of the course_price field.

• Raw log

course_price: -4

• Transformation rule

e_set("op_abs", op_abs(v("course_price")))

• Result

course_price: -4
op_abs: 4

op_div_floor

Performs integer division on the input values.

• Syntax

op_div_floor(value1, value2)

• Parameters

• Response

  The integer part of the quotient of value1 divided by value2.

• Examples

  Calculate the unit price based on the course_price and count fields.

• Raw log

course_price: 4
count: 2

• Transformation rule

e_set("op_div_floor", op_div_floor(v("course_price"), v("count")))

• Result

course_price: 4
count: 2
op_div_floor: 2

op_div_true

Performs division on the input values.

• Syntax

op_div_true(value1, value2)

• Parameters

• Response

  The quotient of value1 divided by value2.

• Examples

  - Example 1: Calculate the unit price based on the fruit_price and count fields.

• Raw log

fruit_price: 9
count: 2

• Transformation rule

e_set("op_div_true", op_div_true(v("fruit_price"), v("count")))

• Result

fruit_price: 9
count: 2
op_div_true: 4.5

• Example 2: Calculate the acceleration and round the result. The formula is a = (one_speed-two_speed)/time.

• Raw log

one_speed: 9
two_speed: 2
time: 3

• Transformation rule

e_set("a", op_round(op_div_true(op_sub(v("one_speed"), v("two_speed")), v("time")), 2))

• Result

one_speed: 9
two_speed: 2
time: 3
a: 2.33

op_pow

Raises a value to a specified power.

• Syntax

op_pow(value1, value2)

• Parameters

• Response

  The value of value1 raised to the power of value2.

• Examples

  Calculate the value of course raised to the power of pow.

• Raw log

course: 100
pow: 2

• Transformation rule

e_set("pow_course", op_pow(v("course"), v("pow")))

• Result

course: 100
pow: 2
pow_course: 10000

op_mul

Multiplies the input values.

• Syntax

op_mul(value1, value2)

• Parameters

• Response

  - If value1 and value2 are numbers, the function returns the product of the two values.

• If value1 is a string, a tuple, or a list, the function returns a value of the same type that is repeated value2 times.

• Examples

  - Example 1: Calculate the total price based on the course and price fields.

• Raw log

course: 10
price: 23

• Transformation rule

e_set("total_price", op_mul(ct_int(v("course")), ct_int(v("price"))))

• Result

course: 10
price: 23
total_price: 230

• Example 2: Multiply the value of the course field by 3.

• Raw log

course: "abc"

• Transformation rule

e_set("course", op_mul(v("course"), 3))

• Result

course: "abcabcabc"

op_neg

Reverses the sign of an input value.

• Syntax

op_neg(value)

• Parameters

• Response

  The input value with its sign reversed.

• Examples

  - Raw log

course: -100

• Transformation rule

e_set("account", op_neg(v("course")))

• Result

course: -100
account: 100

op_mod

Performs a modulo operation on the input values.

• Syntax

op_mod(value1, value2)

• Parameters

• Response

  The remainder of value1 divided by value2.

• Examples

  - Raw log

course: 4
count: 3

• Transformation rule

e_set("op_mod", op_mod(v("course"), v("count")))

• Result

course: 4
count: 3
op_mod: 1

op_sub

Subtracts one input value from another.

• Syntax

op_sub(value1, value2)

• Parameters

• Response

  The result of value1 minus value2.

• Examples

  Calculate the result of subtracting the count_apple value from the count value.

• Raw log

count: 6
count_apple: 3

• Transformation rule

e_set("sub_number", op_sub(v("count"),v("count_apple")))

• Result

count: 6
count_apple: 3
sub_number: 3

op_round

Rounds an input value.

• Syntax

op_round(value, number)

• Parameters

• Response

  The rounded value.

• Examples

  Round the value of the price field to one decimal place.

• Raw log

price: 4.56

• Transformation rule

e_set("round_price", op_round(v("price"),1))

• Result

price: 4.56
round_price: 4.6

mat_ceil

Rounds an input value up to the nearest integer.

• Syntax

mat_ceil(value)

• Parameters

• Response

  The smallest integer that is greater than or equal to the specified value.

• Examples

  - Raw log

price: 4.1

• Transformation rule

e_set("mat_ceil", mat_ceil(v("price")))

• Result

price: 4.1
mat_ceil: 5

mat_exp

Calculates an exponential function with base e.

• Syntax

mat_exp(value)

• Parameters

• Response

  e raised to the power of the input value.

• Examples

  - Raw log

number: 2

• Transformation rule

e_set("e_x", mat_exp(v("number")))

• Result

number: 2
e_x: 7.38905609893065

mat_fabs

Calculates the absolute value of an input value.

• Syntax

mat_fabs(value)

• Parameters

• Response

  The absolute value of the input value.

• Examples

  - Raw log

course_price: -10

• Transformation rule

e_set("mat_fabs", mat_fabs(v("course_price")))

• Result

course_price: -10
mat_fabs: 10.0

mat_floor

Rounds an input value down to the nearest integer.

• Syntax

mat_floor(value)

• Parameters

• Response

  The largest integer that is less than or equal to the specified value.

• Examples

  - Raw log

course_price: 4.9

• Transformation rule

e_set("mat_floor", mat_floor(v("course_price")))

• Result

course_price: 4.9
mat_floor: 4

mat_log

Calculates the logarithm of an input value.

• Syntax

mat_log(value1,value2)

• Parameters

• Response

  The logarithm of the input value.

• Examples

  - Raw log

number1: 100
number2: 10

• Transformation rule

e_set("mat_log", mat_log(v("number1"),v("number2")))

• Result

number1: 100
number2: 10
mat_log: 2.0

mat_log10

Calculates the base-10 logarithm of an input value.

• Syntax

mat_log10(value)

• Parameters

• Response

  The base-10 logarithm of the input value.

• Examples

  - Raw log

number: 100

• Transformation rule

e_set("number2", mat_log10(v("number")))

• Result

number: 100
number2: 2.0

mat_sqrt

Calculates the square root of an input value.

• Syntax

mat_sqrt(value)

• Parameters

• Response

  The square root of the input value.

• Examples

  - Raw log

number1: 100

• Transformation rule

e_set("sqrt_account", mat_sqrt(v("number1")))

• Result

number1: 100
sqrt_account: 10.0

mat_degrees

Converts radians to degrees.

• Syntax

mat_degrees(value)

• Parameters

• Response

  The result in degrees.

• Examples

  - Raw log

num: 1

• Transformation rule

e_set("mat_degrees", mat_degrees(v("num")))

• Result

num: 1
mat_degrees: 57.29577951308232

mat_radians

Converts degrees to radians.

• Syntax

mat_radians(value)

• Parameters

• Response

  The result in radians.

• Examples

  - Raw log

rad: 30

• Transformation rule

e_set("mat_radians", mat_radians(v("rad")))

• Result

rad: 30
mat_radians: 0.5235987755982988

mat_sin

Calculates the sine of an input value in radians.

• Syntax

mat_sin(value)

• Parameters

• Response

  The sine of the input value.

• Examples

  - Raw log

sin: 90

• Transformation rule

e_set("mat_sin", mat_sin(v("sin")))

• Result

sin: 90
mat_sin: 0.8939966636005579

mat_cos

Calculates the cosine of an input value in radians.

• Syntax

mat_cos(value)

• Parameters

• Response

  The cosine of the input value.

• Examples

  - Raw log

cos: 30

• Transformation rule

e_set("mat_cos", mat_cos(v("cos")))

• Result

cos: 30
mat_cos: 0.15425144988758405

mat_tan

Calculates the tangent of an input value in radians.

• Syntax

mat_tan(value)

• Parameters

• Response

  The tangent of the input value.

• Examples

  - Raw log

tan: 30

• Transformation rule

e_set("mat_tan", mat_tan(v("tan")))

• Result

tan: 30
mat_tan: 1.6197751905438615

mat_acos

Calculates the arccosine of an input value. The result is in radians.

• Syntax

mat_acos(value)

• Parameters

• Response

  The arccosine of the input value, in radians.

• Examples

  - Raw log

acos: 1

• Transformation rule

e_set("mat_acos", mat_acos(v("acos")))

• Result

acos: 1
mat_acos: 0.0

mat_asin

Calculates the arcsine of an input value. The result is in radians.

• Syntax

mat_asin(value)

• Parameters

• Response

  The arcsine of the input value, in radians.

• Examples

  - Raw log

asin: 1

• Transformation rule

e_set("mat_asin", mat_asin(v("asin")))

• Result

asin: 1
mat_asin: 1.5707963267948966

mat_atan

Calculates the arctangent of an input value. The result is in radians.

• Syntax

mat_atan(value)

• Parameters

• Response

  The arctangent of the input value, in radians.

• Examples

  - Raw log

atan: 1

• Transformation rule

e_set("mat_atan", mat_atan(v("atan")))

• Result

atan: 1
mat_atan: 0.7853981633974483

mat_atan2

Calculates the arctangent of the specified coordinates.

• Syntax

mat_atan2(x,y)

• Parameters

• Response

  The arctangent of the specified coordinates.

• Examples

  - Raw log

atan1: 1
atan2: 2

• Transformation rule

e_set("mat_atan2", mat_atan2(v("atan1"),v("atan2")))

• Result

atan1: 1
atan2: 2
mat_atan2: 0.4636476090008061

mat_atanh

Calculates the inverse hyperbolic tangent of an input value.

• Syntax

mat_atanh(value)

• Parameters

• Response

  The inverse hyperbolic tangent of the input value.

• Examples

  - Raw log

atanh: 0.5

• Transformation rule

e_set("mat_atanh", mat_atanh(v("atanh")))

• Result

atanh: 0.5
mat_atanh: 0.5493061443340548

mat_hypot

Calculates the Euclidean norm of the input values.

• Syntax

mat_hypot(value1,value2)

• Parameters

• Response

  The Euclidean norm of the input values.

• Examples

  - Raw log

hypot1: 1
hypot2: 2

• Transformation rule

e_set("mat_hypot", mat_hypot(v("hypot1"),v("hypot2")))

• Result

hypot1: 1
hypot2: 2
mat_hypot: 2.23606797749979

MATH_PI

The mathematical constant pi.

• Raw log

a: 2

• Transformation rule

e_set("result", op_sum(v("a"), MATH_PI))

• Result

a: 2
result: 5.141592653589793

MATCH_E

The mathematical constant e.

• Raw log

a: 2

• Transformation rule

e_set("result", op_sum(v("a"), MATCH_E))

• Result

a: 2
result: 4.718281828459045