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 reference axis of the relative mode.

Must be one of: "none", "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: "Bar Chart", "Box Plot Chart", "Heat Map Chart", "Line Chart", "Relative Evolution Chart", "Seasonal Decomposition Chart", "Segmented Bar Chart", "Segmented Line 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.


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.


hideXTitle: boolean

Hides chart X axis title.


hideYTitle: boolean

Hides chart Y axis title.


nBinsX: number

Number of bins in the x axis.


nBinsY: number

Number of bins in the y axis.


range: array[number | string]

Selection Range. This type is useful for quantitative columns, in which a selection of values in range can be made.


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", "rForeground"


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"


xTitle: string

Chart X axis title.


yTitle: string

Chart Y axis title.


zoomX: {{ no such element: dict object['type'] }}

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


zoomY: {{ no such element: dict object['type'] }}

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