create_plot_insight

string

default:"Area Chart"

required

Area Chart. Area Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

The element’s position and size. The position refers to the top-left corner of the rectangle representing the insight element, while the size is given by its width and height. For reference, the entire insight is 12 units wide and 9 units high, and the origin (0, 0) of the x/y coordinates is in its top-left corner.

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

Time unit to specify the discretization period.Values must be one of the following:MILLISECOND SECOND MINUTE HOUR DAY YEAR_DAY MONTH_DAY WEEK_DAY WEEK WEEK_OF_YEAR MONTH QUARTER YEAR

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

string

Chart markers foregroundColor.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

object

Stat configuration. For example, for a max stat it would be: { "stat": "max" } For stats that require a param like “countWhere” or “percentOfRowsWhere” it would be: { "stat": "countWhere", "params": { "value": "categoryName" } }

Properties

string

Stat kind.Values must be one of the following:sum mean variance standardDeviation skewness kurtosis min p25 p50 p75 max nNulls precision count cumSum nodeCount rForeground rForegroundColor rForegroundX uniqueValues valueCount countWhere percentOfRowsWhere

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

Theme color palette applied to the chart.Values must be one of the following:Horus Osiris Re Blues Greens Oranges Purples Reds Viridis Magma Plasma Red-Blue Blue-Orange Red-Grey Red-Yellow-Blue Red-Yellow-Green graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

Aggregation method to apply to the column. Only for values with AGGREGATED_COLUMN kind.Values must be one of the following:SUM AVG VARIANCE STDEV MIN P25 P50 P75 MAX MODE UNIQUE_VALUES LIST LIST_UNIQUE CONCATENATE COUNT ELEMENT_COUNT ELEMENT_MIN ELEMENT_MAX ELEMENT_SUM ELEMENT_AVG ELEMENT_VARIANCE ELEMENT_STDEV

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Bar Chart"

required

Bar Chart. Bar Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

object

Bars paddings in Bar charts. Defines the inner & outer paddings for bars in Bar charts.

Properties

number

Inner padding between bars.

number

Outer padding for bars.

string

Chart description.

string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.Values must be one of the following:

horizontal
vertical

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

string

Chart markers foregroundColor.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Box Plot Chart"

required

Box Plot Chart. Box Plot Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

required

Defines the metrics to be drawn in BoxPlot charts.Values must be one of the following:

quartiles
quartiles+IQR
quartiles+min/max
mean+standardDeviation

string

Chart description.

string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.Values must be one of the following:

horizontal
vertical

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

string

Chart markers foregroundColor.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Bubble Chart"

required

Bubble Chart. Bubble Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

string

Chart markers foregroundColor.

boolean

Hides chart size legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart size legend title.

[number, object]

Nodes size in scatterplot charts. Can define a fixed value or a min & max value in px to map nodes size.

Options

number
object

number

number.

number

Nodes opacity in scatterplot charts.

object

Metrics shown in scatterplot charts. Defines if regression line, RSquared or Pearson coefficient metrics are displayed.

Properties

boolean

Whether to show a regression line.

boolean

Whether to show RSquared metric.

boolean

Whether to show Pearson coefficient metric.

object

required

Slot value that maps bubble size in scatterplot charts. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

[array, array]

Selection applied to the column that maps bubble size in scatterplot charts. It can be an array with the categories selected in categorical columns, or an array with the range of the selection for quantitative or date columns.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

Fields in tooltip. A list of fields to show in tooltip for Scatterplot charts.

Array items

string

Each item in array.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

string

default:"Bubble Colored Chart"

required

Bubble Colored Chart. Bubble Colored Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date.

string

array[string]

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Hides chart color legend title.

boolean

Hides chart size legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

string

Chart size legend title.

[number, object]

Nodes size in scatterplot charts. Can define a fixed value or a min & max value in px to map nodes size.

Options

number
object

number

number.

number

Nodes opacity in scatterplot charts.

object

Metrics shown in scatterplot charts. Defines if regression line, RSquared or Pearson coefficient metrics are displayed.

Properties

boolean

Whether to show a regression line.

boolean

Whether to show RSquared metric.

boolean

Whether to show Pearson coefficient metric.

object

required

Slot value that maps bubble size in scatterplot charts. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

[array, array]

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

Fields in tooltip. A list of fields to show in tooltip for Scatterplot charts.

Array items

string

Each item in array.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

string

default:"Grouped Bar Chart"

required

Grouped Bar Chart. Grouped Bar Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

object

Bars paddings in Bar charts. Defines the inner & outer paddings for bars in Bar charts.

Properties

number

Inner padding between bars.

number

Outer padding for bars.

string

Chart description.

string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.Values must be one of the following:

horizontal
vertical

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Heat Map Chart"

required

Heat Map Chart. Heat Map Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

object

required

Slot value used to apply color to each cell in Heatmap charts. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

Color legend title in Heatmap charts.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the Y axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Defines if the discretization in the Y axis uses quantiles.

boolean

Hides chart color legend title in Heatmap charts.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

string

Chart sorting applied to chart in the y axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the y axis.Values must be one of the following:

ASC
DESC

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Line Chart"

required

Line Chart. Line Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

string

Chart markers foregroundColor.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

object

Line dash pattern. Configures the dash pattern for lines in line charts.

Properties

[null, array]

Default dash pattern for lines. It is represented as an array of stroke and gap lengths.

Options

null
array

null

null.

object

Custom dash pattern. Allows setting a specific dash pattern for the selected categories.

Pattern properties

[null, array]

The custom dash pattern for the selected category. It is represented as an array of stroke and gap lengths.

Options

null
array

null

null.

object

Line markers. Configures the markers for lines in line charts.

Properties

object

Line marker. Configures a line marker.

Properties

string

The shape of the marker.Values must be one of the following:

circle
square
triangle

string

The color of the marker.

number

The area of the marker in pixels.

object

Custom line markers. Allows setting a specific line marker for the selected categories.

Pattern properties

object

Line marker. Configures a line marker.

Properties

string

The shape of the marker.Values must be one of the following:

circle
square
triangle

string

The color of the marker.

number

The area of the marker in pixels.

object

Line width settings. Specifies the width of the lines in line charts.

Properties

number

Default line width.

object

Custom line width. Allows setting a specific line width for the selected categories.

Pattern properties

[number, null]

The custom line width for the selected category.

string

Defines how to represent null values in line charts.Values must be one of the following:

interpolated
gap
zero

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

boolean

Defines if zero values should be represented as null in line charts.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Multiple Line Chart"

required

Multiple Line Chart. Multiple Line Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

object

Line dash pattern. Configures the dash pattern for lines in line charts.

Properties

[null, array]

Default dash pattern for lines. It is represented as an array of stroke and gap lengths.

Options

null
array

null

null.

object

Custom dash pattern. Allows setting a specific dash pattern for the selected categories.

Pattern properties

[null, array]

The custom dash pattern for the selected category. It is represented as an array of stroke and gap lengths.

Options

null
array

null

null.

object

Line markers. Configures the markers for lines in line charts.

Properties

object

Line marker. Configures a line marker.

Properties

string

The shape of the marker.Values must be one of the following:

circle
square
triangle

string

The color of the marker.

number

The area of the marker in pixels.

object

Custom line markers. Allows setting a specific line marker for the selected categories.

Pattern properties

object

Line marker. Configures a line marker.

Properties

string

The shape of the marker.Values must be one of the following:

circle
square
triangle

string

The color of the marker.

number

The area of the marker in pixels.

object

Line width settings. Specifies the width of the lines in line charts.

Properties

number

Default line width.

object

Custom line width. Allows setting a specific line width for the selected categories.

Pattern properties

[number, null]

The custom line width for the selected category.

string

Defines how to represent null values in line charts.Values must be one of the following:

interpolated
gap
zero

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

boolean

Defines if zero values should be represented as null in line charts.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Scatterplot Chart"

required

Scatterplot Chart. Scatterplot Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

string

Chart markers foregroundColor.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

[number, object]

Nodes size in scatterplot charts. Can define a fixed value or a min & max value in px to map nodes size.

Options

number
object

number

number.

number

Nodes opacity in scatterplot charts.

object

Metrics shown in scatterplot charts. Defines if regression line, RSquared or Pearson coefficient metrics are displayed.

Properties

boolean

Whether to show a regression line.

boolean

Whether to show RSquared metric.

boolean

Whether to show Pearson coefficient metric.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

Fields in tooltip. A list of fields to show in tooltip for Scatterplot charts.

Array items

string

Each item in array.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

string

default:"Scatterplot Colored Chart"

required

Scatterplot Colored Chart. Scatterplot Colored Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date.

string

array[string]

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

[number, object]

Nodes size in scatterplot charts. Can define a fixed value or a min & max value in px to map nodes size.

Options

number
object

number

number.

number

Nodes opacity in scatterplot charts.

object

Metrics shown in scatterplot charts. Defines if regression line, RSquared or Pearson coefficient metrics are displayed.

Properties

boolean

Whether to show a regression line.

boolean

Whether to show RSquared metric.

boolean

Whether to show Pearson coefficient metric.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

Fields in tooltip. A list of fields to show in tooltip for Scatterplot charts.

Array items

string

Each item in array.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type number or date.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

string

default:"Seasonal Decomposition Chart"

required

Seasonal Decomposition Chart. Seasonal Decomposition Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

[object, object, object]

required

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

number

required

Seasonality interval for Seasonal Decomposition plot.

string

expanded segment in Seasonal Decomposition plot.

object

required

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type date.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

boolean

Defines if zero values should be represented as null in line charts.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Segmented Area Chart"

required

Segmented Area Chart. Segmented Area Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Segmented Bar Chart"

required

Segmented Bar Chart. Segmented Bar Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

object

Bars paddings in Bar charts. Defines the inner & outer paddings for bars in Bar charts.

Properties

number

Inner padding between bars.

number

Outer padding for bars.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Segmented Line Chart"

required

Segmented Line Chart. Segmented Line Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

object

Line dash pattern. Configures the dash pattern for lines in line charts.

Properties

[null, array]

Default dash pattern for lines. It is represented as an array of stroke and gap lengths.

Options

null
array

null

null.

object

Custom dash pattern. Allows setting a specific dash pattern for the selected categories.

Pattern properties

[null, array]

The custom dash pattern for the selected category. It is represented as an array of stroke and gap lengths.

Options

null
array

null

null.

object

Line markers. Configures the markers for lines in line charts.

Properties

object

Line marker. Configures a line marker.

Properties

string

The shape of the marker.Values must be one of the following:

circle
square
triangle

string

The color of the marker.

number

The area of the marker in pixels.

object

Custom line markers. Allows setting a specific line marker for the selected categories.

Pattern properties

object

Line marker. Configures a line marker.

Properties

string

The shape of the marker.Values must be one of the following:

circle
square
triangle

string

The color of the marker.

number

The area of the marker in pixels.

object

Line width settings. Specifies the width of the lines in line charts.

Properties

number

Default line width.

object

Custom line width. Allows setting a specific line width for the selected categories.

Pattern properties

[number, null]

The custom line width for the selected category.

string

Defines how to represent null values in line charts.Values must be one of the following:

interpolated
gap
zero

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

boolean

Defines if zero values should be represented as null in line charts.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Stacked Area Chart"

required

Stacked Area Chart. Stacked Area Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

object

required

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Stacked Bar Chart"

required

Stacked Bar Chart. Stacked Bar Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

object

Bars paddings in Bar charts. Defines the inner & outer paddings for bars in Bar charts.

Properties

number

Inner padding between bars.

number

Outer padding for bars.

string

Chart description.

string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.Values must be one of the following:

horizontal
vertical

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Stacked 100% Area Chart"

required

Stacked 100% Area Chart. Stacked 100% Area Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

string

Chart description.

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

string

Interpolation method used for line or area chart.Values must be one of the following:linear monotone cardinal natural step step-before step-after

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

object

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Stacked 100% Bar Chart"

required

Stacked 100% Bar Chart. Stacked 100% Bar Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

array[object]

Comments that can be added to the chart. Any text can be added as annotation at certain abscissa point.

Array items

string

Alignment of the annotation.Values must be one of the following:

start
center
end

string

Text of the comment.

object

Annotations shape. Annotations shape configuration.

Properties

string

Annotation shape type.Values must be one of the following:

arrow

string

Annotation endpoint type for arrow shape.Values must be one of the following:

line
solid
none

string

Annotation shape line style.Values must be one of the following:

solid
dashed

string

Annotation shape line color.

array[number]

Annotation shape line dash.

Array items

number

Each item in array.

number

Annotation shape line width.

number

Annotation shape endpoint position x for arrow shape.

number

Annotation shape endpoint position y for arrow shape.

object

Annotations style. Annotation label style configuration.

Properties

string

Annotation label color.

number

Annotation label font size in pixels.

string

Annotation label font style.Values must be one of the following:

bold
italic
normal

[object, object, object]

X axis value. X axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in X axis.

[number, string]

required

Annotation value in X axis.

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in X axis.

[object, object, object, object]

Y axis value. Y axis value where the annotation is placed.

Options

Value annotation placed over a value in the axis
Stat value annotation placed over a stat value in the axis
Stat annotation placed over a calculated stat in the axis
Value annotation placed relative to canvas dimensions

string

required

Annotation kind.Values must be one of the following:

VALUE

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT_VALUE

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.

[number, string]

required

Annotation value in Y axis.

string

required

Annotation kind.Values must be one of the following:

STAT

boolean

Whether to hide the annotation value in the label.

string

required

Annotation stat in Y axis.Values must be one of the following:max mean median min q1 q3

string

required

Annotation kind.Values must be one of the following:

POSITION

number

required

Annotation position in Y axis.

object

Bars paddings in Bar charts. Defines the inner & outer paddings for bars in Bar charts.

Properties

number

Inner padding between bars.

number

Outer padding for bars.

string

Chart description.

string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.Values must be one of the following:

horizontal
vertical

string

Chart footer text.

[string, object]

Chart size. Chart width & height if customized, undefined if in “Fit to screen” mode.

Options

string
object

string

string.Values must be one of the following:

automatic

string

Chart subtitle.

string

Chart title.

object

required

Slot value used to map color in the chart. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or date.

string

array[string]

required

Categories of the color variable.

Array items

string

Each item in array.

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

[object, object, object]

Discretization configuration for a slot (x, y or color). There is different kind of discretization configurations depending on column type:

For quantitative ones a single count defining the number of bins is enough
For categorical ones we need the count of categories & its top (DESC) or bottom (ASC) direction
For dates we need a date period & a count of periods.

Options

object
object
object

number

required

Number of bins in the axis.

number

required

Number of bins in the axis.

string

required

Get top (DESC) or bottom (ASC) categories for categorical variables in the axis.Values must be one of the following:

ASC
DESC

number

required

Number of time units that sets the size of the discretization.

string

required

boolean

Defines if the period is a recurrent one (i.e. WEEK_DAY).

boolean

Defines if the discretization in the X axis uses a exact or pretty number of bins.

boolean

Defines if the discretization in the X axis uses quantiles.

boolean

Hides chart color legend title.

boolean

Hides chart X axis title.

boolean

Hides chart Y axis title.

object

Chart value labels. Show & configure value labels in some charts.

Properties

string

Column for node labels in scatterplot charts.

object

Style configurations for value labels in bar charts. Set position & alignment configuration for value labels in bar charts.

Properties

string

Value labels position in bar charts.Values must be one of the following:

inside
outside

string

Value labels alignment in horizontal bar charts.Values must be one of the following:

left
middle
right

string

Format for value labels.

string

Format for absolute value labels.

string

Format for value count labels.

string

Format for percentage change labels.

number

Margin between node labels in scatterplot charts.

boolean

Whether to show value labels.

boolean

Whether to show absolute value labels.

boolean

Whether to show value count labels.

boolean

Whether to show percentage change labels.

boolean

Whether to show total value labels in stacked bar charts.

array[string]

Metrics to show as value labels in boxplot charts.

Array items

string

Each item in array.

string

Chart color legend title.

string

Sorting applied to categories of the color variable (segmentsColumn).Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Sorting direction applied to categories of the color variable (segmentsColumn).Values must be one of the following:

ASC
DESC

string

Sorting mode applied to categories of the color variable (segmentsColumn). CUSTOM does not apply any sorting criteria.Values must be one of the following:

SORT
CUSTOM

string

Chart sorting applied to chart in the x axis.Values must be one of the following:XAXIS YAXIS YAXIS_SEGMENT SELECTION ORDINAL ALPHANUM

string

Chart sorting direction applied to chart in the x axis.Values must be one of the following:

ASC
DESC

object

required

Properties

string

object

Stat parameters.

Properties

string

Value for the stat parameter.

string

default:"graphext"

required

Theme applied to the chart.Values must be one of the following:graphext dark excel fivethirtyeight ggplot2 googlecharts latimes powerbi quartz urbaninstitute vox

string

default:"dark"

Theme mode applied to the chart.Values must be one of the following:

dark
light

Defines if tooltip is enabled.

object

required

Slot value represented in the x axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean, number or date, as well as listIndex.

string

object

X Axis config options. Configuration options specific to X axis, including base axis properties and label display controls.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

string

Axis labels orientation mode. Controls how axis labels are oriented. auto (rotates only when needed), rotate (always rotated), or none (never rotated).Values must be one of the following:

auto
rotate
none

number

Labels rotation in degrees.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart X axis title.

object

required

Slot value represented in the y axis. SlotValues could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts variables of type category, boolean or number, as well as nodeCount or a metric.

string

object

Y Axis config options. Configuration options specific to Y axis, including base axis properties.

Properties

boolean

Whether to hide grid lines in the axe or not.

boolean

Whether to include zero in the axe or not.

boolean

Whether to use a logarithmic scale.

string

Axis labels numeric format.

number

Maximum width in pixels for axis labels before truncating with ellipsis.

object

Axis ticks configuration. An object for axis tick configuration.

Properties

[number, string, object]

Ticks count. Equivalent to Vega axes tickCount prop.

Options

number
string
object

number

number.

string

string.Values must be one of the following:millisecond second minute hour day week month year

string

required

Interval unit.Values must be one of the following:millisecond second minute hour day week month year

number

required

Step.

array[['string', 'number']]

Ticks values. Equivalent to Vega axes values prop.

Array items

[string, number]

Each item in array.

string

Chart Y axis title.

[array, array]

Selection applied to chart in the x axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

[array, array]

Selection applied to chart in the y axis. The chart will be zoom in over this selection.

Options

array
array

array[number]

array.

Array items

number

Each item in array.

string

default:"Table Chart"

required

Table Chart. Table Chart.

array[object]

Type and appearance of an insight’s elements. A list in which each item is an object configuring the appearance of a particular insight element.

Array items

string

Specify the type of element.Values must be one of the following:TITLE DESCRIPTION CHART GRAPH STATS LEGEND LEGEND_COLOR_SCALE TABLE_CHART

string

The text shown for this insight element.

object

Properties

integer

Horizontal position of the element’s top-left corner. In increments of 1; 0 being the left-most and 8 the right-most position.Values must be in the following range:

-1 ≤ x ≤ 11

integer

Vertical position of the element’s top-left corner. In increments of 1; 0 being the top-most and 11 the bottom-most position.Values must be in the following range:

0 ≤ y ≤ 11

integer

The width of the element (in increments of 1).Values must be in the following range:

1 ≤ w ≤ 12

integer

The height of the element (in increments of 1).Values must be in the following range:

1 ≤ h ≤ 9

string

Name of the column containing the data to be used in this insight element. Required if the element is of type CHART or STATS.

string

Theme mode applied to the whole insight.Values must be one of the following:

dark
light

boolean

Defines if the cross-filters mode is set to auto.

boolean

Defines if the cross-filters and significant variables should ignore null values.

string

Insight default layout.Values must be one of the following:

plot
all

array[string]

Insight default layout elements.

Array items

string

Each item in array.Values must be one of the following:

title
description
filters

boolean

required

Defines if the cross-filters mode is set to relative.

[string, boolean]

default:"false"

Indicates if the insight can replay its original state or not.Values must be one of the following:

drillDown
directSelectionInGraph
nonPersistedColumn
True
False

string

A filter query. See Advanced query filters for more information.

string

required

Title of the insight.

string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.Values must be one of the following:

horizontal
vertical

integer

Total number of selected rows in the dataset.Values must be in the following range:

0 ≤ selectedRows < inf

object

Width of the columns in the table. Each object represents a column in the table and its corresponding width settings. For example: { "COLUMN-column1": 300 } Will set the width of the ‘column1’ to 300 pixels.

Item properties

number

One or more additional parameters.

object

Discretizations for columns used in group by in the summary table. Each object represents a dataset column and its corresponding discretization settings. For example:

{
"COLUMN-column1": { nBins: 10 }
}

Will try to discretize the ‘column1’ in 10 bins.

Item properties

object

One or more additional parameters. Configuration for the selected column.

Properties

integer

Number of bins to discretize the column.Values must be in the following range:

0 ≤ count < inf

string

Period to discretize the column.Values must be one of the following:MILLISECOND SECOND MINUTE HOUR YEAR_DAY MONTH_DAY WEEK_DAY WEEK WEEK_OF_YEAR MONTH QUARTER YEAR

boolean

Defines if the period is recurrent.

object

Defines if the discretization for columns used in group by in the summary table uses exact or pretty number of bins. Each object represents a dataset column and its corresponding configuration to use exact or pretty number of bins. For example:

{
"COLUMN-column1": true
}

Will try to discretize the ‘column1’ using an exact number of bins.

Item properties

boolean

One or more additional parameters.

object

Defines if the discretization for columns used in group by in the summary table uses quantiles. Each object represents a dataset column and its corresponding configuration to use quantiles. For example:

{
"COLUMN-column1": true
}

Will try to discretize the ‘column1’ using quantiles.

Item properties

boolean

One or more additional parameters.

integer

The index of the first row shown in the table.Values must be in the following range:

0 ≤ tableFirstIndex < inf

array[object]

Format for the numeric values in the table. Each object represents a column in the dataset and its corresponding format settings. We use the Python format specification mini-language to specify the format. For example:

{ "COLUMN-column1": ",.2f" }

Will format the ‘column1’ with two decimal places (e.g., 1,234.56).

Array items

object

Each item in array. Configuration for the selected column.

Item properties

string

One or more additional parameters.

boolean

Whether to hide the index row in the table.

array[object]

Variables to group by to generate a summary table. If provided, tableValues should also be defined to specify the desired aggregation for each value.

Array items

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts any variables from dataset.

string

object

Parameters for the aggregation method. Only for values with AGGREGATED_COLUMN kind. For example, for the aggregation ‘COUNT_WHERE’, the parameter should include the category to count. { "value": "category1" }

Properties

string

Value for the aggregation method.

boolean

Whether the column is ordinal.

string

Custom name for the column.

boolean

Whether the label is custom. If true, the label will be show without any transformation. If false, the label may be transformed.

boolean

Whether to hide the column subtitle (e.g., Value Count).

string

Semantic type of the column.Values must be one of the following:list boolean category currency date number sex text url list[boolean] list[date] list[number] list[url] list[category]

string

Type of the column.Values must be one of the following:categorical quantitative date text id url

integer

How many rows per page are shown in the table.Values must be in the following range:

1 ≤ tableRowsPerPage ≤ 100

object

Sorting criteria for a table. Defines a column to sort the table with a specific sorting direction.

Properties

string

Sorting direction applied to the table.Values must be one of the following:

ASC
DESC

string

Id of the table column to sort the table by.

array[object]

Custom styles for the table. Each item represents a column in the dataset and its corresponding style settings. For example:

[
{
"slotValueId": "COLUMN-column1",
"query": "FUZZY('positive')",
"style": {
"property": "graphextPill",
"value": "#FF0000"
}
}
]

Will apply a custom pill style with red color to the cells that match the query.

Array items

string

Slot value id.

string

Custom graphext query to apply the style. Each cell will be evaluated with the query, and if it returns true, the style will be applied.

array[string]

Categories for cell coloring. Each item in the array represents a category in the column that will be used to color the cells in the table.

Array items

string

Each item in array.

object

Style configuration. Each style is an object with property and value fields.

Properties

string

Style property to customize each cell:

backgroundColor: will change the background color
color: will change the text color
graphextPill: will apply a custom pill style.

Values must be one of the following:

backgroundColor
color
graphextPill

string

Color in hexadecimal format (e.g., #FF0000).

object

Totals to show as a footer in the table. Each object represents a column in the dataset and the totals to show for the selected column For example:

{
"column1": ["sum", "mean", "variance"]
}

Will show the sum, mean and variance of the column1 (if column1 is shown in the table).

Item properties

array[string]

One or more additional parameters. Totals to show for the selected column.

Array items

string

Each item in array.Values must be one of the following:sum mean variance standardDeviation skewness kurtosis min p25 p50 p75 max nNulls precision count mode median uniqueValues

array

required

Aggregations if tableRows is provided, basic columns if not. If tableRows is defined, tableValues will be the definition of desired aggregations. Each object represents a column in the dataset and its aggregation. Those aggregations will reduce all the values of the column to a single value, applying the selected aggregation method If tableRows is not defined, tableValues will represent the columns to show in the table.

Array items

object

The value for a slot, defined by its kind & its name with some extra column props. SlotValueData could be of kind column, aggregated column, listIndex, nodeCount or metric.

Properties

string

The kind of then slot value.Values must be one of the following:

AGGREGATED_COLUMN
COLUMN
LIST_INDEX
NODE_COUNT
METRIC

string

The name of the slot value. Accepts any variables from dataset, as well as nodeCount or a metric.

string

object

Properties

string

Value for the aggregation method.

boolean

Whether the column is ordinal.

string

Custom name for the column.

boolean

Whether the label is custom. If true, the label will be show without any transformation. If false, the label may be transformed.

boolean

Whether to hide the column subtitle (e.g., Value Count).

string

Type of the column.Values must be one of the following:categorical quantitative date text id url

Analyse

Report

Prepare

Usage

Inputs & Outputs

Configuration

​Usage

​Inputs & Outputs

​Configuration

Usage

Inputs & Outputs

Configuration