rsyncrosim (version 2.0.1)

chartCriteria: Retrieves chart variables

Description

Retrieves the available variables for charting, or the variables that are set for an existing chart.

Usage

chartCriteria(ssimObject, chart = NULL, variable = NULL, filter = NULL)
# S4 method for SsimObject
chartCriteria(ssimObject, chart = NULL, variable = NULL, filter = NULL)

Value

A data.frame or list of variables, filter columns, and filter values.

Arguments

ssimObject

Project or Chart object

chart

character or integer. Either the name or ID of an existing chart. If NULL and a Project is provided as the first argument, then will return the available variables for charting.

variable

character. The name of a charting variable. If provided, then will return a list of the available filter columns for that variable. Default is NULL.

filter

character. The name of a filter column for a specified variable. If provided, then will return a list of values that pertain to the specified filter. If the filter column is used to disaggregate the chart data (using the chartDisagg function), one panel will be created for each of these values. If you would like to omit values from the chart, you can also add or remove values by the specified filter column using the chartInclude function. Default is NULL.

Details

Example arguments:

• If ssimObject is SyncroSim Project and chart is NULL: Returns a data.frame of available variables for creating a new chart.

• If ssimObject is SyncroSIm Chart or chart is not NULL: Returns a data.frame of variables in use by the specified chart.

• If variable is not NULL: Returns a list of filter columns that belong to the given variable.

• If variable and filter are not NULL: Returns a dataframe of value IDs and names that belong to the given variable and filter.

Examples

if (FALSE) {
# Create a chart object
myChart <- chart(myProject, chart = "New Chart")

# Retrieve variables that can be used to create new charts
chartCriteria(myProject)

# Retrieve variables being used by existing chart
chartCriteria(myChart)
}