Skip to content

Create plot insight

UIinterface

Create a new insight from the Plot section.

Usage


The following are the step's expected inputs and outputs and their specific types.

Step signature
create_plot_insight({"param": value})

where the object {"param": value} is optional in most cases and if present may contain any of the parameters described in the corresponding section below.

Parameters


relative: boolean

Sets the visualization type to absolute or relative.


relativeCount: string

Sets the relativeCount mode.

Must be one of: "none", "relative", "x", "y"


segments: array[string]

Categories of the categorical column that are used to build the chart.


selectedChart: string

Useful to choose the chart kind to display in the UI.

Must be one of: "Area Chart", "Bar Chart", "Box Plot Chart", "Grouped Bar Chart", "Heat Map Chart", "Line Chart", "Multiple Line Chart", "Scatterplot Chart", "Seasonal Decomposition Chart", "Segmented Area Chart", "Segmented Bar Chart", "Segmented Line Chart", "Stacked Area Chart", "Stacked Bar Chart", "Stacked 100% Area Chart", "Stacked 100% Bar Chart"


title: string

Title of the insight.


xColumn: string

Column represented in the x axis.


yColumn: string

Column represented in the y axis.


annotations: array[object]

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

Items in annotations

at: number | string

Abscissa point where the annotation is placed.


label: string

Text of the comment.


barPaddings: object

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

Items in barPaddings

inner: number

Inner padding between bars.


outer: number

Outer padding for bars.


boxPlotStat: string

Defines the metrics to be drawn in a BoxPlot chart.

Must be one of: "quartiles", "quartiles+IQR", "quartiles+min/max", "mean+standardDeviation"


bucketSizeCount: number

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


bucketsSizeInterval: string

Time unit to specify the bucket size.

Must be one of: "MILLISECOND", "SECOND", "MINUTE", "HOUR", "DAY", "WEEK", "MONTH", "QUARTER", "YEAR"


chartDescription: string

Chart description.


chartDirection: string

Defines the direction in which the chart is drawn. Defines if Bar or BoxPlot charts will be drawn horizontally or vertically.

Must be one of: "horizontal", "vertical"


chartFooter: string

Chart footer text.


chartSubtitle: string

Chart subtitle.


chartTitle: string

Chart title.


elements: 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.

Items in elements

kind: string

Specify the type of element.

Must be one of: "TITLE", "DESCRIPTION", "CHART", "GRAPH", "STATS", "LEGEND", "LEGEND_COLOR_SCALE"


text: string

The text shown for this insight element.


layout: 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.

Items in layout

x: 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.

Range: -1 ≤ x ≤ 11


y: 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.

Range: 0 ≤ y ≤ 11


w: integer

The width of the element (in increments of 1).

Range: 1 ≤ w ≤ 12


h: integer

The height of the element (in increments of 1).

Range: 1 ≤ h ≤ 9


column: 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.


filterMode: boolean

Defines if the categories must filter or not. If "true", the categories of the categoricalColumn will act as filters.


hideLegendTitle: boolean

Hides chart legend title.


hideXTitle: boolean

Hides chart X axis title.


hideYTitle: boolean

Hides chart Y axis title.


legendTitle: string

Chart legend title.


nBinsX: number

Number of bins in the x axis.


nBinsY: number

Number of bins in the y axis.


recurrentPeriod: string

Time unit to specify the period for Recurrent Patterns aggregation.

Must be one of: "MILLISECOND", "SECOND", "MINUTE", "HOUR", "MONTH_DAY", "WEEK_DAY", "WEEK", "MONTH", "QUARTER", "YEAR"


replayDisabled: string | boolean = False

Indicates if the insight can replay its original state or not.

Must be one of: "drillDown", "directSelectionInGraph", "nonPersistedColumn", True, False


seasonalityInterval: number

Seasonality interval for Seasonal Decomposition plot.


segmentExpanded: string

expanded segment in Seasonal Decomposition plot.


segmentsColumn: string

Categories are created from this column.


selection: string

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


sortX: string

Chart sorting applied to chart in the x axis.

Must be one of: "XAXIS", "YAXIS", "SELECTION", "ORDINAL", "ALPHABET"


sortXDirection: string

Chart sorting direction applied to chart in the x axis.

Must be one of: "ASC", "DESC"


sortY: string

Chart sorting applied to chart in the y axis.

Must be one of: "XAXIS", "YAXIS", "SELECTION", "ORDINAL", "ALPHABET"


sortYDirection: string

Chart sorting direction applied to chart in the y axis.

Must be one of: "ASC", "DESC"


stat: string

Stat kind.

Must be one of: "sum", "mean", "variance", "standardDeviation", "skewness", "kurtosis", "min", "p25", "p50", "p75", "max", "nNulls", "precision", "count", "cumSum", "nodeCount", "rForeground", "valueCount"


statsToShow: array[string]

Stats than can be added to the chart. Only mean, p25, p50 & p75 stats can be added.

Items in statsToShow

item: string

Must be one of: "mean", "p25", "p50", "p75"


theme: string = "graphext"

Theme applied to the chart.

Must be one of: "graphext", "dark", "excel", "fivethirtyeight", "ggplot2", "googlecharts", "latimes", "powerbi", "quartz", "urbaninstitute", "vox"


themeColorPalette: string

Theme color palette applied to the chart when the theme is graphext.

Must be one of: "Horus", "Osiris", "Re"


themeMode: string = "dark"

Theme mode applied to the chart.

Must be one of: "dark", "light"


xAxisConfig: object

Axis config options. X or Y axes config options.

Items in xAxisConfig

includeZero: boolean

Whether to include zero in the axe or not.


isLogarithmic: boolean

Whether to use a logarithmic scale.


xDomain: array[number] | array[string]

Chart X scale domain for Scatterplot charts. Scatterplot charts need to define axes scales domain.


xTitle: string

Chart X axis title.


yAxisConfig: object

Axis config options. X or Y axes config options.

Items in yAxisConfig

includeZero: boolean

Whether to include zero in the axe or not.


isLogarithmic: boolean

Whether to use a logarithmic scale.


yDomain: array[number] | array[string]

Chart Y scale domain for Scatterplot charts. Scatterplot charts need to define axes scales domain.


yTitle: string

Chart Y axis title.


zoomX: array[number] | array[string]

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


zoomY: array[number] | array[string]

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