GetMultiSeriesProperties: Retrieve time series properties for a potential multiseries...

View source: R/MultiSeries.R

GetMultiSeriesPropertiesR Documentation

Retrieve time series properties for a potential multiseries datetime partition column

Description

Multiseries time series projects use multiseries id columns to model multiple distinct series within a single project. This function returns the time series properties (time step and time unit) of this column if it were used as a datetime partition column with the specified multiseries id columns, running multiseries detection automatically if it had not previously been successfully ran.

Usage

GetMultiSeriesProperties(
  project,
  dateColumn,
  multiseriesIdColumns,
  crossSeriesGroupByColumns = NULL,
  maxWait = 600
)

Arguments

project

character. Either (1) a character string giving the unique alphanumeric identifier for the project, or (2) a list containing the element projectId with this identifier.

dateColumn

character. The name of the column containing the date that defines the time series.

multiseriesIdColumns

character. Optional. The Series ID to demarcate the series. If not specified, DataRobot will attempt to automatically infer the series ID.

crossSeriesGroupByColumns

character. Optional. Column to split a cross series into further groups. For example, if every series is sales of an individual product, the cross series group could be e product category with values like "men's clothing", "sports equipment", etc. Requires multiseries with useCrossSeries enabled.

maxWait

integer. if a multiseries detection task is run, the maximum amount of time to wait for it to complete before giving up.

Value

A named list which contains:

  • timeSeriesEligible logical. Whether or not the series is eligible to be used for time series.

  • crossSeriesEligible logical. Whether or not the cross series group by column is eligible for cross-series modeling. Will be NULL if no cross series group by column is used.

  • crossSeriesEligibilityReason character. The type of cross series eligibility (or ineligibility).

  • timeUnit character. For time series eligible features, the time unit covered by a single time step, e.g. "HOUR", or NULL for features that are not time series eligible.

  • timeStep integer. Expected difference in time units between rows in the data. Will be NULL for features that are not time series eligible.

See Also

Other MultiSeriesProject functions: RequestCrossSeriesDetection(), RequestMultiSeriesDetection(), as.dataRobotMultiSeriesProperties()

Examples

## Not run: 
  projectId <- "59a5af20c80891534e3c2bde"
  GetMultiSeriesProperties(projectId,
                           dateColumn = "myFeature",
                           multiseriesIdColumns = "Store")

## End(Not run)


datarobot documentation built on May 29, 2024, 4:36 a.m.