This topic describes all the functions you can use in Medecision Analytics's dashboard formula editor.

Note:

For information about the functions for custom tables and fields , see Data Functions for Custom Tables and Fields.

Functions in this reference are organized in to sections as follows:

Most of the functions have one or more of the following properties and are so marked:

Aggregative functions operate on a table column and typically return a numeric value. They are marked with (A) next to their names. Most of the statistical functions are aggregative.

Multipass compatible functions are marked with (M) next to their names. The Multipass Declaration - ([Dimension], Aggregation) is a group by statement that is used with aggregative functions to group the result set by one column and return a list. For example, the formula AVG([Brand], SUM([Cost])) calculates the average of total cost per brand.

These functions are marked with (EC) next to their names. All other functions are supported for both ElastiCube and Live models.

Convention:

Function names are not case sensitive. For example, the average function can be entered as Avg, avg etc. The function selector in the dashboard editor always supplies function names in upper case for example, AVG. The upper case convention will be followed below.

Important note:

TheAnalytical Engine requires that every measure defined in the formula editor be aggregative. For example, instead of DDiff([Discharge Time], [Admission Time]), use **AVG**(DDIFF([Discharge Time], [Admission Time])).

The examples here do not always include a wrapping aggregation function, even though one will be required by the formula editor. (The example screen shots do include a wrapping aggregation function - because otherwise, they wouldn't work.)

Average (A)(M)

The basic form calculates the average of a given database column (aggregation). The (M) form calculates the average of a given table column grouped by another field.

Syntax (Basic form)

AVG(<numeric field>)

Arguments

Example:

AVG([Score])

Returns the average (mean) of the given Score column.

Syntax (Multipass form)

AVG(<group-by field>, <aggregation_fn>(<numeric field>))

Arguments

Example:

AVG([Product], SUM([Sales]))

Returns the average (mean) of the total sales per product.

Notice that \

here, is SUM.

Count (A) (M)

The basic form counts the number of unique values within the given values. The (M) form Returns the number of unique values from all aggregated members.

Syntax (Basic form)

COUNT(<numeric field>)

Arguments

Example:

COUNT([Category ID])

Returns the number of different category IDs within the given list of items.

Syntax (Mutipass form)

COUNT( <group-by-field>, <aggregation> )

Arguments

Example:

TBD: How do you set this up in E-Commerce?

COUNT(..., ...)

Returns....

Count All (A)

Returns the actual item count of the given list of items, including duplicates.

Syntax

DUPCOUNT(<numeric field>)

Arguments

Example:

DUPCOUNT([Category ID])

Returns the actual count of category IDs in the list of items.

Largest (A)

Returns the k-th largest value in a field.

Syntax

LARGEST(<numeric field>, <k>)

Arguments

Example:

LARGEST([Total Sales], 3)

Returns the third-largest Total Sales value.

Maximum (A) (M)

The basic form returns the maximum value in a numeric field column. The (M) form returns the maximal value from all aggregated members.

Syntax (Basic form)

MAX(<numeric field>)

Arguments

Example:

MAX([Total Revenue])

Returns the item with the maximum Total Revenue.

Syntax (Multipass form)

MAX(<group-by-field>, <aggregation>)

Arguments

Example:

TBD: How do you set this up in E-Commerce?

MAX( , )

Returns....

Median (A)

Calculates the median of the given values. The median of a set of data is the middlemost number in the set. The median is also the number that is halfway into the set.

Syntax

MEDIAN(<numeric field>)

Arguments

Example:

MEDIAN([Total Revenue])

Returns the item whose Total Revenue is the middlemost number in the set.

Minimum (A) (M)

The basic form returns the minimum value in a numeric field column. The (M) form returns the minimal value from all aggregated members.

Syntax (Basic form)

MIN(<numeric field>)

Arguments

Example:

MIN([Total Revenue])

Returns the item with the minimum Total Revenue.

Syntax (Multipass form)

MIN(<group-by-field>, <aggregation>)

Arguments

Example:

TBD: How do you set this up in E-Commerce?

MIN( , )

Returns....

Mode (A)

Returns the most frequently occurring value from a column.

Note:

If there is more than one mode value, the Mode function returns one of them randomly.

Syntax

MODE(<numeric field>)

Arguments

Example:

MODE([Country ID])

Returns the country ID that is the most frequently occurring in the list of items.

Contribution

Calculates the percentage of the total.

Syntax

CONTRIBUTION(<numeric field>)

Arguments

Example:

CONTRIBUTION([Total Sales])

Returns the percentage of total sales per group (e.g., per day or per product) out of total sales (for all days or all products).

Percentile (M)

The basic form returns the k-th percentile value from the given field, where k is any number between 0..1 (inclusive). The (M) form returns the k-th percentile value from the given numeric expression per .

Syntax (Basic form)

PERCENTILE(<numeric field>, <k>)

Arguments

Example:

PERCENTILE([Total Sales], 0.9)

Returns the 90th percentile of Total Sales.

Syntax (Multipass form)

PERCENTILE(<group-by-field>, <aggregation>, <k>)

Arguments

Example:

PERCENTILE([Brand],[Total Sales], 0.9)

Returns the 90th percentile of Total Sales grouped by Brand.

Quartile(M)

The basic form returns the k-th quaetile value from the given field, where k is any number between 0..4 (inclusive). It can return minimum value, first quartile, second quartile, third quartile, and max value.

The (M) form returns the k-th percentile value from the given numeric expression per .

Syntax (Basic form)

QUARTILE(<numeric field>, <k>)

Arguments

Example:

QUARTILE([Total Sales], 1)

Returns the first quartile of Total Sales.

Syntax (Multipass form)

QUARTILE(<group-by-field>, <aggregation>), <k>)

Arguments

Example:

QUARTILE([Brand],[Total Sales], 1)

Returns the first quartile of Total Sales grouped by Brand.

Rank

Returns the rank of a value in a list of values.

Syntax

RANK(<numeric field>, [DESC/ASC], [Rank Type], [<group-by field 1>,... , <group-by field n>])

Arguments

[\

,... , ] | The group-by field must be presented in the widget

Example:

RANK([Total Cost], "ASC", "1224", [Product], [Years])

The rank of the total annual cost per each product, sorted in ascending order.

Limitation

When the Rank function is used in Pivot tables, it may skip ranks when used with Group By (Columns) due to the query limit. To fix this issue, increase your Pivot Query LIMIT (contact your CSM if you require assistance with this):

Standard Deviation (Population)

Returns the Standard Deviation of the given values (Population). Standard deviation is the square root of the average squared deviation from the mean. The standard deviation of a population gives researchers the amount of dispersion of data for an entire population.

Syntax

STDEVP(<numeric field>)

Arguments

Example:

STDEVP([Cost])

Returns the Standard Deviation of the given values in the population.

Standard Deviation (Sample)

Returns the Standard Deviation of the given values in a sample. Standard deviation is the square root of the unbiased average squared deviation from the mean. A standard deviation of a sample estimates the amount of dispersion in a given data set, based on a random sample.

Syntax

STDEV(<numeric field>)

Arguments

Example:

STDEV([Cost])

Returns the Standard Deviation of the given values in the sample.

Variance (Population)

Returns the Variance of the given values (Population). Variance is the average squared deviation from the mean, based on an entire population of survey respondents.

Syntax

VARP(<numeric field>)

Arguments

Example:

VARP([Cost])

Returns the Standard Deviation of the given values in the population.

Variance (Sample)

Returns the Variance of the given values (Sample). Variance is the average squared deviation from the mean, based on a random sample of population of survey respondents.

Syntax

VARP(<numeric field>)

Arguments

Example:

VAR([Cost])

Returns the Standard Deviation of the given values in the population.

Correlation (A) (M)(EC)

The basic form returns the correlation coefficient of two numeric fields. The (M) form returns the correlation coefficient of two fields aggregations grouped by another field.

Syntax (Basic form)

CORREL(<numeric field a>, <numeric field b>)

Arguments

Example:

CORREL([Revenue], [Cost])

Returns the correlation between revenue and cost.

Syntax (Multipass form)

CORREL(<group-by field>, <aggregation a>, <aggregation b>)

Arguments

Example:

CORREL([Products], AVG([Revenue]), AVG([Cost]))

Returns the correlation between the average of revenue and cost per product.

Covariance (Population) (A) (M)(EC)

The basic form returns the population covariance of and . The (M) form returns the population covariance of two fields aggregations, grouped by another field.

Syntax (Basic form)

COVARP(<numeric field a>, <numeric field b>)

Arguments

Example:

COVARP([Revenue], [Cost])

Returns the population covariance of revenue and cost.

Syntax (Multipass form)

COVARP(<group-by field>, <aggregation a>, <aggregation b>)

Arguments

Example:

COVARP([Products], AVG([Revenue]), AVG([Cost]))

Returns the population covariance of the average revenue and the average cost per product.

Covariance (Sample) (A) (M)(EC)

The basic form returns the sample covariance of and . The (M) form returns the sample covariance of two fields aggregations, grouped by another field.

Syntax (Basic form)

COVAR(<numeric field a>, <numeric field b>)

Arguments

Example:

COVAR([Revenue], [Cost])

Returns the sample covariance of revenue and cost.

Syntax (Multipass form)

COVAR(<group-by field>, <aggregation a>, <aggregation b>)

Arguments

Example:

COVAR([Products], AVG([Revenue]), AVG([Cost]))

Returns the sample covariance of the average revenue and the average cost per product.

Skewness (Population) (A) (EC)

Returns the skewness of the distribution of a given value in the population.

Syntax

SKEWP(<numeric field>)

Arguments

Example:

SKEWP([Revenue])

Returns the skewness of the distribution of Revenue in the population.

Skewness (Sample) (A) (EC)

Returns the skewness of the distribution of a given value in a sample.

Syntax

SKEW(<numeric field>)

Arguments

Example:

SKEW([Revenue])

Returns the skewness of the distribution of Revenue in the sample.

Slope (A) (EC)

Returns the slope of a linear regression line through the provided series of x and y values.

Syntax

SLOPE(<numeric field a>, <numeric field b>)

Arguments

Example:

SLOPE([month.int], [Total Sales])

Returns the slope of the regression line that represents a trend of items sold for each month.

Non-aggregative Functions

Exponential Distribution (EC)

Returns the exponential distribution for a given value and a supplied distribution parameter mean.

Syntax

EXPONDIST(<numeric field>, <mean>, <cumulative (true/false)>)

Arguments

Example:

EXPONDIST(COUNT([Leads]), (Mean([Leads]), ALL([Leads])), False)

Returns the exponential distribution density of the number of leads per country.

Intercept (EC)

Returns the intercept of a linear regression line through the provided series of x and y values.

Syntax

INTERCEPT(<numeric not datetime>, <numeric field>)

Arguments

Example:

INTERCEPT([month.int], [Total Sales])

Returns the intercept of the regression line that represents the trend of items sold for each month.

Normal Distribution (EC)

Returns the Normal distribution for a given value, a supplied distribution mean and standard deviation.

Syntax

NORMDIST(<numeric field>, <mean>, <standard deviation>, <cumulative (true/false)>)

Arguments

Example:

NORMDIST(SUM([Score]), (MEAN([Score]), ALL([Score])), (STDEV([Score]), ALL([Score])), False)

Returns the normal probability density of a given student score.

Poisson Distribution (EC)

Returns the Poisson distribution for a given value and a supplied distribution mean.

Syntax

POISSONDIST(<numeric field>, <mean>, <cumulative (true/false)>)

Arguments

Example:

POISSONDIST(SUM([Score]), (MEAN([Score]), ALL([Score])), False)

Returns the Poisson probability density of a given number of scores.

T Distribution (EC)

Returns Student's T-distribution for a given value and a supplied number of degrees of freedom.

Syntax

TDIST(<numeric field>, <degrees_freedom>, <cumulative (true/false)>)

Arguments

Example:

TDIST(SUM([Score]), (COUNT([Score])-1), TRUE)

Returns the student's T-distribution of a given score, with degrees of freedom = one less than the number of data items.

Aggregative Functions

Sum (A)(M)

The basic form calculates the sum of a given database column (aggregation). The (M) form calculates the sum off a given table column grouped by another field.

Syntax (Basic form)

SUM(<numeric field>)

Arguments

Example:

SUM([Cost])

Returns the total Cost across all items in the Cost column.

Syntax (Multipass form)

SUM(<group-by field>, <aggregation>)

Arguments

Example:

SUM([Product],[Sales])

Returns the total Sales values grouped by Product.

Non-aggregative Functions

Note:

Most of the following functions takes a single argument that is either a numeric constant or a numeric aggregative field function result such as SUM(), AVG() etc. Compositions of mathematical functions also work when they are well defined, such as LN(COSH()). However, compositions like LN(COS()) will fail when COS() is less than or equal to zero.

The dashboard functions all have the same syntactic form:

<function_name>(<numeric field>)

or

<function_name>(<numeric field>, <number>)

\

is typically like ABS, SIN, LOG10 and more as shown in the list of functions below.

The argument, is a numeric value or an aggregative function of a database column such as SUM, AVG, STDEV and so on. You can also pick aggregation functions from the function editor:

The shown functions, Sum ... Standard Deviation are all aggregative.

The argument appears MOD, POWER, QUOTIENT and ROUND.

In the following list, functions labeled (EC) are for ElastiCube only.

Non-aggregative Functions

Absolute Value

Returns the absolute value of Returns the absolute value of its argument.

Mathematical Equivalent

f(x) = |x|

Syntax

ABS(<numeric field>)

Arguments

Example:

ABS([Cost])

When the value is 2 or -2 the absolute result is 2.

ACOS

Returns the angle, in radians, whose cosine is the given numeric expression. Also referred to as arccosine, arcos, cos-1.

Mathematical Equivalent

f(x) = cos-1x

Syntax

ACOS(<numeric field>)

Arguments

Examples:

ACOS([Total Revenue])

Returns the angle, in radians, whose cosine is the given total revenue.

ACOS(0.5)=>π/3=60°

To convert radians to degrees, use

Value(degrees) = Value(radians)*180/π

For a detailed example of how to use ACOS to determine the distance between two points using latitude and longitude (for logistical purposes such as delivery service, flights, the distance between customers, etc.), see [here](https://community.Medecision Analytics.com/t5/knowledge/calculate-distance-between- two-points-using-latitude-and/ta-p/9496).

ASIN

Returns the angle, in radians, whose sine is the given numeric expression. Also referred to as arcsin, arsin, sine-1.

Mathematical Equivalent

f(x) = sin-1x

Syntax

ASIN(<numeric field>)

Arguments

Examples:

ASIN([Total Revenue])

Returns the angle, in radians, whose sine is the given total revenue.

ASIN(0.5)=>π/6=30°

To convert radians to degrees, use

Value(degrees) = Value(radians)*180/π

ATAN

Returns the angle in radians whose tangent is the given numeric expression. Also referred to as arctan, tan-1.

Mathematical Equivalent

f(x) = tan-1x

Syntax

ATAN(<numeric field>)

Arguments

Examples:

ATAN([Total Revenue])

Returns the angle in radians whose tangent is the given total revenue.

ATAN(1.0)=>π/4=45°

To convert radians to degrees, use

Value(degrees) = Value(radians)*180/π

CEILING

Returns the smallest integer greater or equal to the argument.

Mathematical Equivalent

f(x) = ⌈x⌉

Syntax

CEILING(<numeric field>)

Arguments

Examples:

CEILING([Total Cost])

For example, when the cost is 83.2 it is rounded up to 84.

CEILING(2.3)=>3

CEILING(-2.3)=>2

COS

Returns the trigonometric cosine of the given angle (in radians).

Mathematical Equivalent

f(x) = cos x

Syntax

COS(<numeric field>)

Arguments

Examples:

COS([Average Angle])

Returns the trigonometric cosine of the average angle.

COS(1.0472)=>0.5

1.0472 radian=π/3 = 60°

To convert degrees to radians, use

Value(Radians) = Value(degrees) * π/180

COT

Returns the cotangent of the argument, where the argument is in radians.

Mathematical Equivalent

f(x) = cot x

Syntax

COT(<numeric field>)

Arguments

Examples:

COT([Average Angle])

Returns the trigonometric cotangent of the average angle.

COT(0.7854)=>1.0

0.7854 radian=π/4 is 45°

To convert degrees to radians, use

Value(Radians) = Value(degrees) * π/180

EXP

Returns e (base of natural logarithms) raised to the power of the argument.

Mathematical Equivalent

f(x) = ex

Syntax

EXP(<numeric field>)

Arguments

Examples:

EXP([Sales])

Returns the exponential value of sales.

EXP(2.0)=>7.389

FlLOOR

Returns the largest integer less than or equal to the argument.

Mathematical Equivalent

f(x) = ⌊x⌋

Syntax

FLOOR(<numeric field>)

Arguments

Examples:

FLOOR([Revenue])

For example, when the revenue is 88.6 it is rounded down to 88.

FLOOR(2.3)=>2

FLOOR(-2.3)=>-3

LN

Returns the natural (base e) logarithm of the argument.

Mathematical Equivalent

f(x) = ln x = loge x

Syntax

LN(<numeric field>)

Arguments

Examples:

LN([Cost])

Returns the natural (base e) logarithm of the cost.

LN(2.0)=>0.693

LOG10

Returns the base 10 logarithm of the argument.

Mathematical Equivalent

f(x) = log10 x

Syntax

LOG10(<numeric field>)

Arguments

Example:

LOG10([Revenue])

Returns the base-10 logarithm of the revenue.

LOG10(2.0)=>0.301

MOD

Returns the remainder after a number is divided by a divisor. In this implementation of MOD, the sign of both arguments is ignored, treating them both as positive numbers.

Mathematical Equivalent

f(x) = x mod n where n is the divisor

Syntax

MOD(<numeric field>, <divisor>)

Arguments

Example:

MOD([Cost], 10)

Returns 5 when the cost is 255, (5 is the remainder after 255 divided by 10).

POWER

Returns the results of the given value raised to a supplied power.

Mathematical Equivalent

f(x, a) = xa

Syntax

Power(<numeric field>, <power>)

Arguments

Examples:

POWER([Revenue], 2)

Returns the value of the revenue raised by the power of 2.

POWER(3, 2.5)=>15.5884

QUOTIENT

Returns the integer portion of a division.

Mathematical Equivalent

f(x, a) = ⌊x/a⌋

Syntax

QUOTIENT(<numeric value>, <divisor>)

Arguments

Example:

QUOTIENT([Cost], 2)

For example, this returns 2 when the cost is 5, (2 is the integer portion of 5 divided by 2).

ROUND

Returns number rounded to a specified number of digits.

ROUND(<numeric field>, <num_digits>)

Arguments

Examples:

ROUND([Revenue], 2)

Returns the revenue value rounded to two decimal places.

ROUND(7.245, 2) =>7.25

and then

ROUND(ROUND(7.245, 2), 1) => 7.3

but

ROUND(7.245, 1)=>7.2

So take care with ROUND.

SIN

Returns the sine of the argument, where the argument is in radians.

Mathematical Equivalent

f(x) = sin x

Syntax

SIN(<numeric field>)

Arguments

Examples:

SIN([Average Angle])

Returns the sine of the average angle.

SIN(0.5236)=>0.5

0.5236 radian = π/6 is30°

To convert degrees to radians, use

Value(Radians) = Value(degrees) * π/180

SQRT

Returns the square root of the given value.

Syntax

SQRT(<numeric field>)

Arguments

Example:

SQRT([Cost])

Returns the square root of cost.

TAN

Returns the tangent of the argument, where the argument is in radians.

Mathematical Equivalent

f(x) = tan x

Syntax

TAN(<numeric field>)

Arguments

Examples:

TAN([Average Angle])

Returns the trigonometric tangent of the average angle.

TAN(0.7854)=>1.0

0.7854 radian = π/4 is 45°

To convert degrees to radians, use

Value(Radians) = Value(degrees) * π/180

Mathematical Functions Supported by ElastiCube Only

COSH (EC)

Returns the hyperbolic cosine of the argument.

Mathematical Equivalent

f(x) = cosh x

Syntax

COSH(<numeric field>)

Arguments

Examples:

COSH([Total Revenue])

Returns the hyperbolic cosine of the total revenue.

SINH (EC)

Returns the hyperbolic sine of the argument.

Mathematical Equivalent

f(x) = sinh x

Syntax

SINH(<numeric field>)

Arguments

Examples:

SINH([Total Revenue])

Returns the hyperbolic sine of the total revenue.

TANH (EC)

Returns the hyperbolic tangentof the argument.

Mathematical Equivalent

f(x) = tanh x

Syntax

TANH(<numeric field>)

Arguments

Examples:

TANH([Total Revenue])

Returns the hyperbolic tangeent of the total revenue.

Second Difference

sdiff()

Returns the difference between and in seconds.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

SDIFF(<end time>, <start time>)

Arguments

Example:

SDIFF([Landing Time], [Leaving Time])

Returns the difference in seconds from the time of landing on the page to the time of leaving the page.

Here is an example of using the SDIFF function to return the number of seconds between a create date and the update date:

Syntax

SDIFF(NOW(), <start time>)

Arguments

Example:

SDIFF(NOW(), [Leaving Time])

Returns the difference in seconds between the time of landing on the page and now.

Minute Difference

mndiff()

Returns the difference between and in minutes.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

MNDIFF(<end time>, <start time>)

Arguments

Example:

MNDIFF([Landing Time], [Payment Completed Time])

Returns the difference in minutes from the time of landing on the page to the time of leaving the page.

Here is an example of using the MNDIFF function to return the number of minutes between a create date and the update date:

Syntax

MNDIFF(NOW(), <start time>)

Arguments

Example:

MNDIFF(NOW(), [Payment Completed Time])

Returns the difference in minutes between the time of landing on the page and now.

Hour Difference

hdiff()

Returns the difference between and in hours. Returns whole numbers.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

HDIFF(<end time>, <start time>)

Arguments

Example:

HDIFF([Attendance time],[Check in time])

Returns the difference in hours between the check-in time to the Emergency Room and time of attendance by the doctor. Returns whole numbers.

Here is an example of using the HDIFF function to return the number of hours between a create date and the update date:

Syntax

HDIFF(NOW(), <start time>)

Arguments

Example:

HDIFF(NOW(),[Check in time])

Returns the difference in hours between the check-in time to the Emergency Room and now. Returns whole numbers.

Day Difference

ddiff()

Returns the difference between and in days.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

DDiff(<end time>, <start time>)

Arguments

Example:

DDIFF([Discharge Time], [Admission Time])

Returns the difference in days from the time of admission to hospital to the time of patient discharge.

Here is an example of using the DDIFF function to return the number of days between a create date and the update date:

Syntax

DDiff(NOW(), <start time>)

Arguments

Example:

DDIFF(NOW(), [Admission Time])

Returns the difference in days between the time of admission to hospital and now.

Month Difference

mdiff()

Returns the difference between and in months. Returns whole numbers.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

MDIFF(<end time>, <start time>)

Arguments

Example:

MDIFF([Departure Time], [Arrival Time])

Returns the difference in months from the time a ship departs from its departure port to the time of arrival in its destination port. Returns whole numbers.

Here is an example of using the MDIFF function to return the number of months between a create date and the update date:

Syntax

MDIFF(NOW(), <start time>)

Arguments

Example:

MDIFF(NOW(), [Arrival Time])

Returns the difference in months between the time a ship departs from its departure port and now. Returns whole numbers.

Quarter Difference

qdiff()

Returns the difference between and in quarters. Returns whole numbers.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

QDIFF(<end time>, <start time>)

Arguments

Example:

QDIFF([StartSemester], [EndSemester])

Returns the difference in quarters from the first academic semester to the graduation semester. Returns whole numbers.

Syntax

QDIFF(NOW(), <start time>)

Arguments

Example:

QDIFF(NOW(), [EndSemester])

Returns the difference in quarters between the first academic semester and now. Returns whole numbers.

Year Difference

ydiff()

Returns the difference between and in years. Returns whole numbers.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

YDIFF(<end time>, <start time>)

Arguments

Example:

YDIFF([membership end], [membership start])

Returns the difference in years from the start of the membership to the end of the membership. Returns whole numbers.

Syntax

YDIFF(NOW(), <start time>)

Arguments

Example:

YDIFF(NOW(), [transaction date])

Returns the difference in years between the transaction date and now. Returns whole numbers.

Here is an example of the YDiff function being used with NOW():

Past Week Difference

diffpastweek()

Returns the difference between this week's data and the data from the previous week.

Use this function when the time resolution used in your widget is day or week. Otherwise, it does not display correct data.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

DIFFPASTWEEK(<numeric field>)

Arguments

Example:

DIFFPASTWEEK([Total Sales])

Returns the difference between this week's sales and previous week's sales, for the displayed time resolution.

For day resolution : (sales in current day - sales in same day one week back)

For week resolution : (sales in current week - sales in previous week)

Past Month Difference

diffpastmonth()

Returns the difference between this month's data and the data from the previous month.

Use this function when the time resolution used in your widget is 'month'. Otherwise, it does not display correct data.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

DIFFPASTMONTH(<numeric field>)

Arguments

Example:

DIFFPASTMONTH([Total Sales])

Returns the difference between this month's sales and previous month's sales, for the displayed time resolution.

For day resolution: (sales in current day - sales in same day one month back)

Past Quarter Difference

diffpastquarter()

Returns the difference between this quarter's data and the data from the previous quarter.

Use this function when the time resolution used in your widget is 'month or 'quarter''. Otherwise, it does not display correct data.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

DIFFPASTQUARTER(<numeric field>)

Arguments

Example:

DIFFPASTQUARTER([Total Sales])

Returns the difference between this quarter's sales and previous quarter's sales, for the displayed time resolution.

For month resolution: (sales in current month - sales in same month one quarter back)

For quarter resolution: (sales in current quarter- sales in previous quarter)

Past Year Difference

diffpastyear()

Returns the difference between this year's data and the data from the previous year. All time resolutions in the widget are available for this function (year, quarter, month, week, day).

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

DIFFPASTYEAR(<numeric field>)

Arguments

Example:

DIFFPASTYEAR([Total Sales])

Returns the difference between this year's sales and previous year's sales, for the displayed time resolution.

For month resolution: (sales in current month - sales in same month one year back)

For quarter resolution: (sales in current quarter - sales in the same quarter one year back)

For week resolution: (sales in current week - sales in same week one year back)

Past Period Difference

diffpastperiod()

Returns the difference between this period's data and the data from the previous period.

Formula: (current value - compared value).

Accepts any time resolution (day, week, etc.).

The active time resolution is determined by the lowest time resolution of the widget elements from the filters and slicers. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

DIFFPASTPERIOD(<numeric field>)

Arguments

Example:

DIFFPASTPERIOD([Total Sales])

Returns the difference between this period's sales and the previous period's sales.

Growth

growth()

Calculates growth over time. Growth compares the results of two calculations, each based on a different time period, and the result is the union of all results, where at least one valid result is returned. ±100 will indicates that only one valid result was returned.

Formula: (current value - compared value) / compared value.

Accepts any time resolution (day, week, etc.) in the widget.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

GROWTH(<numeric field>)

Arguments

Example:

GROWTH([Total Quantity])

If this month your Total Quantity is 12, and last month it was 10, your Growth for this month is 20% (0.2). Calculation: (12 - 10) / 10 = 0.2

If this year your Total Quantity is 80, and last year it was 100, your Growth for this year is -20% ( -0.2). Calculation: (80 - 100) / 100 = -0.2

Growth Rate

growthrate()

Calculates growth over time. Growth compares the results of two calculations, each based on a different time period, and the result is the union of all results, where at least one valid result is returned. ±100 will indicates that only one valid result was returned.

Formula:****(current value - compared value) / compared value.

Accepts any time resolution (day, week, etc.).

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

GROWTHRATE(<numeric field>)

Arguments

Example:

GROWTHRATE([Total Quantity])

If this month your Total Quantity is 12, and last month it was 10, your Growth Rate for this month is 12/10 = 120% (1.2). Calculation: 12 / 10 = 1.2

If this year your Total Quantity is 80, and last year it was 100, your Growth for this year is 80/100 = 80% ( 0.8). Calculation: 80 / 100 = 0.8

Growth Past Week

growthpastweek()

Calculates the growth from the past week to the current week. Growth compares the results of two calculations, each based on a different time period, and the result is the union of all results, where at least one valid result is returned. ±100 will indicates that only one valid result was returned.

Use this function when the time resolution in your widget is weeks or days. Otherwise, it does not display any data.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

GROWTHPASTWEEK(<numeric field>)

Arguments

Example:

GROWTHPASTWEEK([Total Sales])

Calculates the difference between this week's sales and previous week's sales, for the displayed time resolution.

For day resolution : (sales in current day - sales in same day one week back) / sales in same day one week back

For week resolution : (sales in current week - sales in previous week / sales in previous week)

Growth Past Month

growthpastmonth()

Calculates the growth from the past month to the current month. Growth compares the results of two calculations, each based on a different time period, and the result is the union of all results, where at least one valid result is returned. ±100 will indicates that only one valid result was returned.\ Use this function when the time resolution in your widget is month or day. Otherwise, it does not display any data.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

GROWTHPASTMONTH(<numeric field>)

Arguments

Example:

GROWTHPASTMONTH([Total Sales])

Calculates the difference between this month's sales and previous month's sales, for the displayed time resolution.

For day resolution : (sales in current day - sales in same day one month back) / sales in same day one month back

Growth Past Quarter

growthpastquarter()

Calculates the growth from the past quarter to the current quarter. Growth compares the results of two calculations, each based on a different time period, and the result is the union of all results, where at least one valid result is returned. ±100 will indicates that only one valid result was returned.

Use this function when the time resolution in your widget is month or quarter. Otherwise, it does not display any data.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

GROWTHPASTQUARTER(<numeric field>)

Arguments

Example:

GROWTHPASTQUARTER([Total Sales])

Calculates the difference between this quarter's sales and previous quarter's sales, for the displayed time resolution.

For month resolution: (sales in current month - sales in same month one quarter back) / sales in same month one quarter back

For quarter resolution: (sales in current quarter - sales in previous quarter) / sales in previous quarter

Growth Past year

Calculates the growth from the past year to the current year. Growth compares the results of two calculations, each based on a different time period, and the result is the union of all results, where at least one valid result is returned. ±100 will indicates that only one valid result was returned.

Use this function when the time resolution in your widget is week, month, quarter, year.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

GROWTHPASTYEAR(<numeric field>)

Arguments

Example:

GROWTHPASTYEAR([Total Sales])

Calculates the difference between this year's sales and previous year's sales, for the displayed time resolution.

For week resolution: (sales in current week - sales in same week one year back / sales in same week one year back)

For month resolution: (sales in current month - sales in same month one year back / sales in same month one year back)

Past Day

pastday()

Returns the value for the previous day. Accepts the time resolution day.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

PASTDAY(<numeric field>, <Numeric of periods>)

Arguments

Example:

PASTDAY([Total Sales], 2)

If you are looking at a specific day, you will see the value for 2 days prior to the day specified.

Past Week

pastweek()

Returns the value for the same period in the previous week. Accepts the time resolutions day, week.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

ASTWEEK(<numeric field>, <number of periods>)

Arguments

Example:

PASTWEEK([Total Sales], 2)

Returns the Total Sales value two weeks back for the displayed time resolution.

If you are looking at a specific day, you will see the value of the same day two weeks back.

Past Month

pastmonth()

Returns the value for the same period in the previous month. Accepts the time resolutions day, month.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

PASTMONTH(<numeric field>, <number of periods>)

Arguments

Example:

PASTMONTH([Total Sales], 2)

Returns the Total Sales value two months back for the displayed time resolution.

If you are looking at a specific day, you will see the value of the same day two months back.

Past Quarter

pastquarter()

Returns the value for the same period in the previous quarter. Accepts the time resolutions day, month, quarter.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

PASTQUARTER(<numeric field>, <number of periods>)

Arguments

Example:

PASTQUARTER([Total Sales], 2)

Returns the Total Sales value two quarters back for the displayed time resolution.

If you are looking at a specific day, you will see the value of the same day two quarters back. If you are looking at a specific month, you will see the value of the same month two quarters back.

Past Year

pastyear()

Returns the value for the same period in the previous year. Accepts any time resolution (day, week, etc.).

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null. The formula calculation succeeds if both the presentation scope calculation and past date scope calculation return values. Otherwise, it returns null.

Syntax

PASTYEAR(<numeric field>, <number of periods>)

Arguments

Example:

PASTYEAR([Total Sales], 2)

Returns the Total Sales value two years back for the displayed time resolution.

If you are looking at a specific day, you will see the value of the same day two years back. If you are looking at a specific month, you will see the value of the same month two years back.

Week to Date Average

wtdavg()

Returns the running average starting from the beginning of the week up to the current day. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Returns null if the active time resolution is years, quarters, or months.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

WTDAVG(<numeric field>)

Arguments

Example:

WTDAVG([Total Sales])

Returns the running average of Total Sales starting from the beginning of the week up to the desired day.

Week to Date Sum

wtdsum()

Returns the running total starting from the beginning of the week up to the current day or week. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Returns null if the active time resolution is years, quarters, or months.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

WTDSUM(<numeric field>)

Arguments

Example:

WTDSUM([Total Sales])

Returns the running total of Total Sales starting from the beginning of the week up to the current day.

Month to Date Average

mtdavg()

Returns the running average starting from the beginning of the month up to the current day. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Use this function when the active time resolution in your widget is 'days'. Returns null if the active time resolution is quarters or years or weeks.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

MTDAVG(<numeric field>)

Arguments

Example:

MTDAVG([Total Quantity])

Returns the running Total Quantity average starting from the beginning of the month up to the current day.

Month to Date Sum

mtdsum()

Returns the running total starting from the beginning of the month up to the current day. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Use this function when the active time resolution in your widget is 'days'. Returns null if the active time resolution is quarters or years or weeks.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

MTDSUM(<numeric field>)

Arguments

Example:

MTDSUM([Total Quantity])

Returns the running total of Total Sales starting from the beginning of the month up to the current day.

Quarter to Date Average

qtdavg()

Returns the running average starting from the beginning of the quarter up to the current day or month. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Returns null if the active time resolution is weeks.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

QTDAVG(<numeric field>)

Arguments

Example:

QTDAVG([Total Sales])

Returns the running average of Total Sales starting from the beginning of the quarter up to the desired day or month.

Quarter to Date Sum

qtdsum()

Returns the running total starting from the beginning of the quarter up to the current day or month. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Returns null if the active time resolution is weeks.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

QTDSUM(<numeric field>)

Arguments

Example:

QTDSUM([Total Sales])

Returns the running total of Total Sales starting from the beginning of the quarter up to the current day or month.

Year to Date Average

ytdavg()

Returns the running average starting from the beginning of the year up to the current day, week, month, quarter or year. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Returns null if the query is invalid or returns no result.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

YTDAVG(<numeric field>)

Arguments

Example:

YTDAVG([Total Sales])

Returns the running average of Total Sales starting from the beginning of the week up to the desired day, week, month, quarter or year.

Year to Date Sum

ytdsum()

Returns the running total starting from the beginning of the year up to the current day, week, month, quarter or year. The formula gets the active date scope from the filters and presentation scope, and can calculate over future dates.

Returns null if the query is invalid or returns no result.

The active time resolution is determined by the minimum date level of the date dimension used for presentation and filtering. If there is no active time resolution, the formula returns null.

Syntax

YTDSUM(<numeric field>)

Arguments

Example:

YTDSUM([Total Sales])

Returns the running total of Total Sales starting from the beginning of the year up to the current day, week, month, quarter or year.

These functions only work as part of a measured value, not by themselves. See Measured Values for more information.

All

Note:

The information below for the ALL() function is the minimal information needed for those looking for a quick reference. See Measured Values for more complete information.

Changes the scope of a measure calculation to ignore a dimension being used in the widget for presentation or as a filter.

This function can only work as part of a measured value, not by itself.

Note:

The All function is a way to ignore a filter while calculating the results of the formula. It does not eliminate the filter applied on the dimension itself.

Syntax

ALL(<any data type>)

Arguments

Example:

(SUM([Items]),**ALL**([Years in Date]))

When used for a widget that has a filter to show last year's data, this formula will ignore the filter in the calculation.

Here is an example of a widget using the All function to ignore the grouping by Date filtering:

Here is an example of a widget using the All function to ignore grouping according to the values in the Age Range, (a text column):

Previous

Returns the Time period Member in which is N periods back from the current member.

This function can only work as part of a measured value, not by itself.

This function works will all time resolutions. However, en sure that the active time resolution in the widget matches the time resolution in the function.

Example:

(SUM([Quantity]),**PREV**([Months in Date]))

For this function the active time resolution must be "months".

Syntax

((<numeric field>), PREV(<time field>, <N>))

Arguments

Example:PREV

(SUM[Quantity],**PREV**([Months in Date],**2**))

This formula returns the Total Quantity value for the month that occurred two months ago.

In the following example, the first column is the date (grouped by year), the next 2 columns are different ways to get the same total revenue for each year, column 4 uses Prev to return the values from the previous year, and column 5 uses Prev with the optional field to return the values from 2 years prior:

Here, PREV overrides the default yearly group-by filtering for the Revenue , and causes the Revenue to be filtered according to the previous year, (or earlier, based on the optional field).

Next

Returns the value for the time-period member in which is N periods after the current member.

This function can only work as part of a measured value, not by itself.

This function works will all time resolutions. However, make sure that the active time resolution in the widget matches the time resolution in the function.

Example:

(SUM([Quantity]),**NEXT**([Weeks in Date]))

For this function the active time resolution must be "weeks".

Syntax

((<numeric field>), NEXT(<time field>, <N>))

Arguments

Example:

(SUM([Quantity]),**NEXT**([Months in Date],**2**))

This formula returns the total quantity value for the month that is two months ahead.

In the following example, the first column is the date (grouped by year), the next 2 columns are different ways to get the same total revenue for each year. Column 4 uses Next to return the values from the following year, and column 5 uses Next with the optional field to return the values for 2 years later:

Here, NEXT overrides the default yearly group-by filtering for the Revenue , and causes the Revenue to be filtered according to the following year, (or later, based on the optional field).

Now

Returns the value for the current time period. The NOW function receives a date dimension and its level and returns all the members in that dimension which match the current query execution time.

This function can only work as part of a measured value, not by itself.

Use this function when the time resolution in your widget is day, month, quarter, year.

Syntax

((<numeric field>), NOW(<time field>))

Arguments

Example:

(SUM([Quantity]),**NOW**([Months in Date]))

This formula returns the total quantity value for the current month.

Here is an example of a widget using the Now function to only return the values for the current year, (2023):

These functions are supported for both ElastiCube and Live models.

CASE

Returns the of the first that evaluates as true. If no condition is true, the for the ELSE is returned, (if defined).

Syntax

(WHEN <condition> THEN <result expression> [...] [ELSE <result expression>] END)

Arguments

Example:

{put in code block}CASE WHEN SUM([Sales]) < 100 THEN 1 WHEN SUM([Sales]) < 1000 THEN 2 ELSE 3 END

Returns '1' when the Total Sales value is between 100 and 1000. Returns '2' if the Total Sales value is above 1000. Returns '3' in any other case (meaning, when Total Sales are below 100).

IF

Returns \

when the is true, and it returns \

when the is false. Nested conditional statements are supported.

Syntax

IF(<condition>, <numeric expression 1>, <numeric expression 2>)

Arguments

Example:

IF(COUNT([Sales])>100, SUM([Sales])*1.1, SUM([Sales]))

If the number of unique values within the Sales values is larger than 100, the function will return the Total Sales x 1.1 (sales increase of 10%). Otherwise

Here is an example of a widget that uses the If function. In column 3 it indicates that the number of sales (revenue records) for Brand ID 1 is less than 4 by displaying the numeric value "0". In column 4 it indicates that the number of sales*2 (which equals 6) is greater than 4 by displaying the numeric value "999":

Note:

Row level operations are only supported on aggregations, with the exception of arithmetic operators* on fields inside aggregations. For example, Sin(Sum(cost)) is valid, but Sum(Sin(cost)) is not valid. The products of these operations are called calculated facts because they are calculated in query time, but they are only allowed on dimensions that are known to be used for aggregation. The Calculated Dimension feature, which enables performing operations over dimensions that are used in pivots, such as subString(“age range”, 1, 2), is not supported.

Arithmetic Calculated Fact - Applying operations on fields on formulas is supported only for arithmetic operations, such as “+”, “-”,”/”,””.

Therefore, please note the following limitations and potential workaround for the IF formula.

Limitations:

Workaround:

Add a custom column with the IF formula with the non-aggregated parameters.

IsNull

Returns true if the expression does not contain data (Null), where the dimensions used in the query for presentation return any data.

Syntax

ISNULL(<numeric field>)

Arguments

Example:

Can be used as a condition when writing conditional statements.

Now

When the NOW function is used without any arguments it returns the query execution time (according to the Medecision Analytics server).

The NOW function can also effectively act as the Date parameter in the DATEDIFF functions (Day Difference, Hour Difference, Minutes Difference, Month Difference, Quarter Difference, Second Difference, Year Difference). See how to use these functions in the Time-Related Functions section above.

Syntax

NOW()

For example, here is the NOW() function being used by the YDIFFfunction:

Running Sum

Returns the running total of the measure by the defined dimension according to the current sorting order in the widget.

By default, RSUM accumulates a measure by the sorting order of the dimension. To accumulate by another order, the relevant measure should be added as an additional column and sorted.

Syntax

RSUM (<numeric field>),

RSUM (<numeric field>, <continuous>)

Arguments

Limitations

Usually, when sorting by value (measure) where there are multiple slicers, the widget is sorted by both value and all slicers other than the last slicer.

When adding filters such that only one row remains for each slicer, the table is sorted only by value and is not sorted by slicer:

RSUM is highly dependent on the sorting. Therefore, when there is only one row per slicer, and the widget’s sorting is lost, the continuous RSUM column and other values columns do not match.

Note:

Filtering the RSUM column by Values will filter the dimensions and recalculate the RSUM from the first filtered value.

Example:

RSUM([Total Revenue], FALSE)

Returns the running total of the Total Revenue measure.

These functions are only supported for ElastiCubes.

Ordering (EC)

Returns the numeric order position of rows sorted into ascending or descending order, breaking ties with further arguments.

The expressions must be aggregated by applying the MIN/MAX functions.

Syntax

ORDERING(<expression1>, <expression2>)

Arguments

Example:

ORDERING(MIN([Sales Person Name]), MIN([Days in Transaction_Date]), -1*SUM([Sales]))

Rdouble (EC)

Returns a numeric result for a given R expression and a list of numeric values.

The R expression is passed to the running Rserve.

Syntax

{use code block} RDOUBLE(<R expression>, [<ordering>], <numeric value 1>, [<numeric value 2>, ..., <numeric value n>])

RDOUBLE(<recycle>, <R expression>, [<ordering>], <numeric value 1>, [<numeric value 2>, ..., <numeric value n>])

Argument

| Optional. Defines the sort order in which numeric data is sent to R. The argument of the Ordering parameter can be an index in your data source or you can use the ORDERING() function to determine the order of your fields. This function arranges the values of the arguments into ascending or descending order, breaking ties by further arguments. Example: 'ORDERING([Total Sales], -1*[COUNT Salesman], MIN())' For more information about the ORDERING() function, click Ordering (EC).\ | Optional. Controls whether the results from R should be recycled (cached), so that consequent queries will not have to be recalculated unless they or the data have changed. Generally, this behavior is automatically managed by the ElastiCube automatically. However, since R code might have non-deterministic components to it (such as randomality functions or date-specific functions), the ElastiCube cannot rely on a data-set and function that has not changed not to return a different result in multiple executions. TRUE (default) - Results will be cached for unchanged functions and data. FALSE - Results will not be cached. Use this option if your R code contains randomality or other non-deterministic content.

Example:

RDOUBLE("m <- log(matrix(unlist(args), ncol=2)); kmeans(m,3)$cluster", [Total Cost], [Total Revenue])

Returns the k-means cluster (R expression) of the args: [Total Cost] and [Total Revenue].

For additional discussion on using RDouble and how to do advanced forecasting with R, see [here](https://community.Medecision Analytics.com/t5/knowledge/advanced- forecasting-with-r/ta-p/8719).

Rint (EC)

Returns an integer result for a given R expression and a list of numeric values.

The R expression is passed to the running Rserve.

Syntax

{use code block} RINT(<R expression>, [<Ordering>], <numeric value 1>, [<numeric value 2>, ..., <numeric value n>])

RINT(<recycle>, [<Ordering>], <R expression>, <numeric value 1>, [<numeric value 2>, ..., <numeric value n>])

Arguments

| Optional. Defines the sort order in which numeric data is sent to R. The argument of the Ordering parameter can be an index in your data source or you can use the ORDERING() function to determine the order of your fields. This function arranges the values of the arguments into ascending or descending order, breaking ties by further arguments. Example: 'ORDERING([Total Sales], -1*[COUNT Salesman], MIN())' For more information about the ORDERING() function, click Ordering (EC).\ | Optional. Controls whether the results from R should be recycled (cached), so that consequent queries will not have to be recalculated unless they or the data have changed. Generally, this behavior is automatically managed by the ElastiCube automatically. However, since R code might have non-deterministic components to it (such as randomality functions or date-specific functions), the ElastiCube cannot rely on a data-set and function that has not changed not to return a different result in multiple executions. TRUE (default) - Results will be cached for unchanged functions and data. FALSE - Results will not be cached. Use this option if your R code contains randomality or other non-deterministic content.

Example:

RINT("m <- log(matrix(unlist(args), ncol=2)); kmeans(m,3)$cluster", [Total Cost], [Total Revenue])

Returns the k-means cluster (R expression) of the args: [Total Cost] and [Total Revenue]

For additional discussion on using RInt and how R works with Medecision Analytics, see [here](https://community.Medecision Analytics.com/t5/knowledge/so-how-exactly-does-r-work- with-Medecision Analytics/ta-p/8817).