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.
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.
Time and order
Cumulative calculations
g_cumrunlen(G;S;O;X)
Returns the cumulative run length within a given group.

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.
  - Using g_functions
    Provides an overview of basic functionality of g_functions in 1010data.
  - Creating a selection column
    All g_functions contain an optional S parameter, or a selection column, to tell the g_function whether to include or exclude a row in its calculations.
  - Summarizations
  - Statistics
  - Time and order
    - g_asof(G;S;O;X;Y;TX;TY;BA;L)
      Returns the position of the row within a given group where all the values in one or more columns most closely match the values in another specified set of columns.
    - g_enum(G;S;O;X)
      Returns the enumeration of unique values across one or more columns within a given group.
    - g_fill(G;S;O;X;D)
      Returns the value of the nearest non-N/A value before or after the current row within a given group.
    - g_first(G;S;O;X)
      Returns the first non-N/A value within a given group.
    - g_first1(G;S;O)
      Returns a boolean value indicating whether this is the first row in a given group.
    - g_forecast(G;S;O;X;VV;M;OPTS;R)
      Shows fitted values and forecasts future values of a time series X using the model object in the M argument. (Available as of version 19.14)
    - g_interp(G;S;O;X;N)
      Returns interpolations for N/A values in a given group.
    - g_last(G;S;O;X)
      Returns the last non-N/A value within a given group.
    - g_last1(G;S;O)
      Returns a boolean value indicating whether this is the last row in a given group.
    - g_lst(G;S;O;X)
      Returns a list value for each group, in the specified order. (Available as of version 15.21)
    - g_lstpkg(G;S;O;X)
      Returns a list value for each group, in the specified order. (Available as of version 15.21)
    - g_pick(G;S;O;X;Y)
      Returns the value corresponding to a specific position in a particular column within a given group.
    - g_pkg(G;S;O;K;X)
      Returns a package value for each group, in the specified order. (Available as of version 15.21)
    - g_position(G;S;O;X;Y)
      Returns the position of the first row within a given group where all the values in one or more columns match the values in another specified set of columns.
    - g_runs(G;S;O;X)
      Returns the number of times that a value has changed from row to row within a given group.
    - g_splice(G;S;O;X;D;N)
      Returns a concatenated list of values ordered in a specified manner within a given group.
    - g_stl(G;S;O;X;NP;OPTS;R)
      Performs a time-series decomposition on the column X using the STL (Seasonal-Trend decomposition using LOESS). (Available as of version 19.00)
    - Shifting and windows
    - Ranking
    - Cumulative calculations
      - g_cumand(G;S;O;X)
        Returns a boolean value indicating whether all values up to and including a particular row within a given group are true.
      - g_cumcnt(G;S;O)
        Returns the cumulative count within a given group.
      - g_cumfreq(G;S;O;X)
        Returns the cumulative frequency of values within a given group.
      - g_cumhi(G;S;O;X)
        Returns the highest value for a given group at the point of the current row being evaluated.
      - g_cumlo(G;S;O;X)
        Returns the cumulative minimum within a given group.
      - g_cumor(G;S;O;X)
        Returns a boolean value indicating whether any value up to and including a particular row within a given group is true.
      - g_cumprod(G;S;O;X)
        Returns the cumulative product within a given group.
      - g_cumrunlen(G;S;O;X)
        Returns the cumulative run length within a given group.
      - g_cumsum(G;S;O;X)
        Returns the cumulative sum within a given group.
      - g_cumsum_clamp(G;S;O;X;F;C)
        Returns the cumulative sum within a given group, "clamping" it so that it is never less than or greater than a given value.
    - Moving calculations
  - Conditional
  - Modeling
  - Matrix functions
  - Signal processing
  - Miscellaneous
- 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.
- 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.

`g_cumrunlen(G;S;O;X)`

Returns the cumulative run length within a given group.

Function type

Vector only

Syntax

g_cumrunlen(G;S;O;X)
t_cumrunlen(X)

Input

Argument	Type	Description
`G`	any	A space- or comma-separated list of column names Rows are in the same group if their values for all of the columns listed in `G` are the same. If `G` is omitted, all rows are considered to be in the same group. If any of the columns listed in `G` contain N/A, the N/A value is considered a valid grouping value.
`S`	integer	The name of a column in which every row evaluates to a 1 or 0, which determines whether or not that row is selected to be included in the calculation If `S` is omitted, all rows will be considered by the function (subject to any prior row selections). If any of the values in `S` are neither 1 nor 0, an error is returned.
`O`	integer	A space- or comma-separated list of column names that determine the row order within a particular group If `O` is omitted, the order is the current display order of the table. If any of the values in `O` are N/A, an error is returned.
`X`	integer	A column name Note: This column can only contain a `1` or `0` value (or is a computed column that evaluates to such) for every row.

Return Value

For every row in each group defined by G and ordered by O (and for those rows where S=1, if specified), g_cumrunlen returns an integer value equal to the number of successive rows in the same group, up to and including this row, where X=1.

The count resets to 0 wherever X=0.

Sample Usage

<base table="pub.doc.samples.ref.func.g_func_time_series_and_or"/>
<willbe name="g_cumrunlen_1" value="g_cumrunlen(state;include;order;value)"/>
<willbe name="g_cumrunlen_2" value="g_cumrunlen(state city;include;order;value)"/>

Additional Information

The t_ version of this function defaults the G argument and omits the S argument. The default for G is set at table load time based on the organization of the table.