Home
Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
Row functions
Row functions are vector functions that return computational outputs for row inputs, as opposed to column outputs. Row inputs are defined as a space- or comma-separated list of column names.
r_sum(C;S)
Returns the sum of values across a given set of columns.

Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
- All 1010data Functions
  1010data provides a whole range of functions that can provide information and act on your data.
- Time/Date functions
  The time/date functions are vector functions that operate on columns containing time-related data and return specific information about the date/time for each row.
- Group functions (g_functions)
  Group functions, or g_functions, are used to perform operations, such as summarizations, on rows that have the same values in a set of given columns.
- Math functions
  Math functions are vector functions that perform mathematical operations on one or more columns and return a column of results based on the operation.
- Matrix functions
- Categorization functions
  Categorization functions are vector functions that organize data and determine logical groupings. These functions can be used for conditionalizing results and/or bucketing value ranges.
- String functions
  String functions are vector functions that manipulate vectors of strings to provide information about a string or substring, concatenate and split strings, or transform strings based on specified criteria.
- List functions
  List functions are scalar functions that return lists, subsets of lists, and combinations of lists, among other functionality. Lists, along with packages, are compound scalar data types that facilitate programmatic interaction with scalar data values and variables.
- Data-handling functions
  Data-handling functions are vector functions that return a hash value based on an input column or columns.
- Row functions
  Row functions are vector functions that return computational outputs for row inputs, as opposed to column outputs. Row inputs are defined as a space- or comma-separated list of column names.
  - r_and(C;S)
    Returns a boolean value indicating whether all the values in a given set of columns are true.
  - r_avg(C;S)
    Returns the average of values across a given set of columns.
  - r_cnt(C;S)
    Returns the number of columns within a given set of columns.
  - r_first(C;S)
    Returns the first valid (non-N/A) value across a given set of columns.
  - r_hi(C;S)
    Returns the maximum of values across a given set of columns.
  - r_last(C;S)
    Returns the last valid (non-N/A) value across a given set of columns.
  - r_lo(C;S)
    Returns the minimum of values across a given set of columns.
  - r_mapjson(C;S;X;O)
    Returns a string containing a JSON representation of a package for each row in a table. (Available as of version 15.21)
  - r_maplst(C;S;X)
    Returns a list for each row in a table, in the order the columns appear in the table. (Available as of version 15.21)
  - r_mappkg(C;S;X)
    Returns a package value for each row in a table. (Available as of version 15.21)
  - r_mapstring(C;S;X;D)
    Returns a string consisting of a list of elements, each of which is the result of evaluating an expression on the current column, concatenated together using the specified delimiter.
  - r_md5sum(C;S)
    Returns the MD5 hash of data across a given set of columns.
  - r_mean(C;S)
    Returns the mean of values across a given set of columns.
  - r_nacnt(C;S)
    Returns the number of columns that have N/A values across a given set of columns.
  - r_or(C;S)
    Returns a boolean value indicating whether any of the values in a given set of columns are true.
  - r_over(C;S;A;X)
    Returns the result of evaluating the expression X for each value in the specified columns. (Available as of version 15.21)
  - r_pick(C;S;I)
    Returns the value of the column at the specified index within a given set of columns.
  - r_position(C;S;X)
    Returns the index of the first column in a given set of columns that matches a specified value.
  - r_prod(C;S)
    Returns the product of values across a given set of columns.
  - r_splice(C;S;D)
    Returns a string consisting of a list of elements across a given set of columns, concatenated together using the specified delimiter.
  - r_std(C;S)
    Returns the standard deviation of values across a given set of columns.
  - r_sum(C;S)
    Returns the sum of values across a given set of columns.
  - r_valcnt(C;S)
    Returns the number of columns that have valid (non-N/A) values across a given set of columns.
  - r_var(C;S)
    Returns the variance of values across a given set of columns.
  - r_summ(C;S)
    Returns the element-wise sum of matrix values across a given set of columns. (Available as of prod-9)
  - r_prodm(C;S)
    Returns the element-wise product (Hadamard product) of matrix values across a given set of columns. (Available as of prod-9)
- SQL compatibility functions
  SQL compatibility functions are functions that treat null values as SQL nulls.
- Financial functions
- System functions
  System functions are special functions in 1010data that return information about users, tables, and other system objects.
- Object functions
  The object functions can be used to check the existence, type, and accessibility of objects such as folders, tables, and queries on the 1010data Insights Platform.
- Miscellaneous functions
  This category of functions contains special functions that don't neatly fit into other categories of functions.

`r_sum(C;S)`

Returns the sum of values across a given set of columns.

Function type

Vector only

Syntax

r_sum(C;S)

Input

Argument Type Description

C

any numeric type

A space- or comma-separated list of column names

C may also be a string expression (in single quotes) constituting a pattern for matching columns. For instance, 'foo*' specifies all columns that begin with "foo".

If C is omitted, the values in all of the columns are included.

N/A values in C are ignored.

S

integer

A boolean column or an expression in rcv_/rcn_/rct_ which determines whether or not that column is selected to be included in the calculation. See System variables for more information about rcv_/rcn_/rct_.

If S is omitted, all columns will be considered by the function (subject to any prior column selections).

Return Value

For each row of the table, r_sum returns a decimal value corresponding to the sum of the non-N/A values in the columns specified by C.

If all the values in the columns specified by C are N/A, the result is 0.

Sample Usage


`c1`	`c2`	`c3`	`c4`	`r_sum(;)`	`r_sum(c1 c2;)`
2	5	7	2	16	7
7	7	4	1	19	14
NA	0	9	3	12	0
NA	NA	NA	NA	0	0

Example

In the following example, the column this_and_that displays the results of adding the values in the columns thisone and thatone. The column all_that displays the results of adding the values in all the columns that begin with "that", which in this example are thatone and thatotherone.

<table cols="thisone,thatone,thatotherone">
  1,2,3;
  4,5,6;
  7,8,9;
</table>  
<willbe name="this_and_that" value="r_sum(thisone thatone;)"/> 
<willbe name="all_that" value="r_sum('that*';)"/>