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.
Matrix functions
mateq(X;Y)
Returns a boolean value indicating the equivalence of the two given matrices. (Available as of prod-9)

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
  - g_matrix(G;S;O;X;T)
    Returns a matrix model consisting of the data from the specified columns within a given group. (Available as of prod-9)
  - g_prodm(G;S;X)
    Returns the element-wise product (Hadamard product) of matrix values within a given group. (Available as of prod-9)
  - g_summ(G;S;X)
    Returns the element-wise sum of matrix values within a given group. (Available as of prod-9)
  - matacos(X)
    Returns the arccosine (in radians) of matrix X. (Available as of version 13.29)
  - matasin(X)
    Returns the arcsine (in radians) of matrix X. (Available as of version 13.29)
  - matatan(X)
    Returns the arctangent (in radians) of matrix X. (Available as of version 13.29)
  - matcos(X)
    Returns the cosine of matrix X. (Available as of version 13.29)
  - matcosh(X)
    Returns the hyperbolic cosine of matrix X. (Available as of version 13.29)
  - matdivide(X;Y)
    Returns the element-wise division of the two given matrices. (Available as of prod-9)
  - mateq(X;Y)
    Returns a boolean value indicating the equivalence of the two given matrices. (Available as of prod-9)
  - matexp(X)
    Returns the matrix exponential of matrix X. (Available as of version 13.29)
  - matgamma(X)
    Returns the gamma function of matrix X. (Available as of version 13.29)
  - matinv(X)
    Returns the inverse of the given matrix. (Available as of prod-9)
  - matlgamma(X)
    Returns the natural log of the gamma function of matrix X. (Available as of version 13.29)
  - matlog(X)
    Returns the logarithm of matrix X. (Available as of version 13.29)
  - matminus(X;Y)
    Returns the element-wise difference of the two given matrices. (Available as of prod-9)
  - matmul(X;Y)
    Returns the matrix multiplication of the two given matrices. (Available as of prod-9)
  - matplus(X;Y)
    Returns the element-wise sum of the two given matrices. (Available as of prod-9)
  - matrint(X)
    Rounds values in a matrix to integers. (Available as of version 13.29)
  - matsin(X)
    Returns the sine of matrix X. (Available as of version 13.29)
  - matsinh(X)
    Returns the hyperbolic sine of matrix X. (Available as of version 13.29)
  - matt(X)
    Returns the transpose of the given matrix. (Available as of prod-9)
  - mattan(X)
    Returns the tangent of matrix X. (Available as of version 13.29)
  - mattanh(X)
    Returns the hyperbolic tangent of matrix X. (Available as of version 13.29)
  - mattimes(X;Y)
    Returns the element-wise product (Hadamard product) of the two given matrices. (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)
  - r_summ(C;S)
    Returns the element-wise sum of matrix values across a given set of columns. (Available as of prod-9)
- 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.
- 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.

`mateq(X;Y)`

Returns a boolean value indicating the equivalence of the two given matrices. (Available as of prod-9)

Function type

Vector only

Syntax

mateq(X;Y)

Input

Argument	Type	Description
`X`	matrix model	A column name The column specified by this parameter must contain matrix models generated by the 1010data Matrix Functions.
`Y`	matrix model	A column name The column specified by this parameter must contain matrix models generated by the 1010data Matrix Functions.

Return Value

Returns an integer value of 1 if the matrices specified by X and Y are equal; otherwise, returns 0.

Example

Consider the following example:

<table cols="name, data_1, data_2, data_3, data_4" title="mateq example">
John,8,0,5,1;
John,2,0,1,1;
Mary,3,1,2,2;
Mary,4,1,2,2;
John,5,2,3,1;
John,6,2,3,1;
Mary,7,3,4,2;
Mary,1,3,0,2
</table>
<willbe name="matrix_0" value="g_matrix(name;;;data_1 data_2 data_3 data_4;0)"/>
<willbe name="matrix_1" value="g_matrix(name;;;data_1 data_2 data_3 data_4;1)"/>
<willbe name="mat1_eq_mat0" value="mateq(matrix_1;matrix_0)"/>
<willbe name="mat1_plus_mat1" value="matplus(matrix_1;matrix_1)"/>
<willbe name="mat1_times_2" value="mattimes(matrix_1;2)"/>
<willbe name="plus_eq_times" value="mateq(mat1_plus_mat1;mat1_times_2)"/>

For every row, the value in mat1_eq_mat0 shows that the matrices in matrix_0 and matrix_1 are not equivalent.

However, mat1_plus_mat1 contains the result of adding matrix_1 to itself; clicking on the > character in the first row of the mat1_plus_mat1 column displays the matrix model for those rows where name is John.

mat1_times_2 contains the result of multiplying all of the elements in matrix_1 by 2; clicking on the > character in the first row of the mat1_times_2 column displays the matrix model for those rows where name is John.

The value in plus_eq_times shows that the matrices in mat1_plus_mat1 and mat1_times_2 are equal.