Cartography
Cartography is the module in Pirivision that converts Compass records (SQL queries, MQTT topics, REST endpoints, Excel sheets) into KPI widgets. Visualizations suitable for industrial monitoring screens — such as line charts, pie charts, gauges, data grids, and maps — are created in this module.
A widget created once can be placed on any dashboard in the Horizon or Atlas module.
flowchart LR
A["Port<br/>Data Source"] --> B["Compass<br/>Query"]
B --> C["Cartography<br/>KPI Widget"]
C --> D["Horizon / Atlas<br/>Dashboard"]Supported Chart Groups and Types
Cartography supports six chart groups and a total of 23 different chart types.
Cartesian
X-Y axis based time series and comparison charts.
| Chart Type | Description |
|---|---|
| Line Series | Line chart — time series trend |
| Area Series | Area chart — filled area trend |
| Spline Series | Smoothed line chart |
| Column Series | Vertical bar chart |
| Bar Series | Horizontal bar chart |
| Step Line Series | Stepped line chart |
| Stacked Area Series | Stacked area chart |
| Stacked Line Series | Stacked line chart |
| Stacked Column Series | Stacked vertical bar |
| Stacked Bar Series | Stacked horizontal bar |
| Stacked Column 100 Series | 100% normalized stacked vertical bar |
| Stacked Bar 100 Series | 100% normalized stacked horizontal bar |
| Stacked Line 100 Series | 100% normalized stacked line |
| Range Column Series | Min-max range bar |
| Waterfall Series | Waterfall chart — cumulative value changes |
Circular
Ratio and distribution visualizations.
| Chart Type | Description |
|---|---|
| Pie Series | Pie chart |
| Doughnut Series | Doughnut chart |
| Radial Bar Series | Radial bar chart |
Gauge
Instantaneous value monitoring — temperature, pressure, OEE, etc.
| Chart Type | Description |
|---|---|
| Radial Gauge | Circular needle gauge |
| Linear Gauge | Horizontal / vertical progress bar |
Text (KPI Card)
Single value or static text display.
| Chart Type | Description |
|---|---|
| Static Text | Fixed text content — heading card, note |
| Dynamic Text | KPI card showing the value from the query dynamically |
DataGrid
| Chart Type | Description |
|---|---|
| Table | Multi-column, sortable, and filterable data table |
Other
| Chart Type | Description |
|---|---|
| Two-Column List | Label-value pair list |
What You Can Do in Cartography
| Action | Description |
|---|---|
| Create Widget | Generate a KPI widget from a Compass record using 23 chart types |
| Multiple Series | Multiple Compass records / series in a single chart |
| Axis Configuration | X/Y axis title, format, type (DateTime/Category/Numeric/Log), secondary axis |
| Conditional Formatting | Assign color, icon, background based on threshold values |
| General Design | Chart title, legend, background, zoom, tooltip |
| Card Design | Card background, border, shadow, padding, info card (Markdown) |
| Folder Organization | Organize widgets into folders, search by name/description/tag |
| Edit | Update an existing widget step by step |
| Color Palette | Apply pre-defined color sets in the Series Design step with one click → My Color Palettes |
| Tagging | Group and filter widgets with color-coded labels → Tags |
Widget Creation Flow (Summary)
Cartography works through a multi-step wizard. Each chart type goes through different steps; the wizard enforces step order via CartographyInsertGuard.
| Step | Screen | For Which Types |
|---|---|---|
| 1 | Group Selection | All |
| 2 | Chart Type Selection | All |
| 3 | Compass Entry Selection | All except Static Text |
| 4 | Axis Configuration | Cartesian, Circular, Dynamic Text |
| 4 | Axis Design (Gauge) | Radial Gauge, Linear Gauge |
| 4 | Data Configuration | Two-Column List |
| 5 | Series Design | Cartesian (except Range Column and Static Text), Circular |
| 6 | Add Series | Cartesian (except Range Column, Waterfall) |
| 7 | General Design | All (except Gauge) |
| 8 | Card Design | All |
| 9 | Display Options | All |
→ Widget Creation — Step-by-Step Guide
Guides
Widget Creation — Sub-Flows
The Cartography wizard follows a different flow for each chart group/type. Each chart has its own sub-flow:
| Flow | Covered Chart Types | Sub-Flow Page |
|---|---|---|
| Standart Cartesian | Line, Area, Spline, Column, Bar, Step Line | Standart Flow |
| Stacked Cartesian | Stacked Area/Line/Column/Bar + 100% variants (7 charts) | Stacked Flow |
| Range Column | Range Column | Range Column Flow |
| Waterfall | Waterfall | Waterfall Flow |
| Circular | Pie, Doughnut, Radial Bar | Circular Steps |
| Radial Gauge | Radial Gauge | Radial Gauge Flow |
| Linear Gauge | Linear Gauge | Linear Gauge Flow |
| Static Text | Static Text | Static Text Flow |
| Dynamic Text | Dynamic Text | Dynamic Text Flow |
| DataGrid | Table | DataGrid Steps |
| Other | Two-Column List | Two-Column List Steps |
→ Widget Creation — Overview and Sub-Flow Selection Guide
Widget Management
| Guide | Description |
|---|---|
| Edit Widget | Reopen an existing widget and update any step |
| Move Widget | Move a widget or folder to a different folder |
| Duplicate Widget | Copy a widget with the same settings |
| Delete Widget | Remove a widget or folder; dashboard impact |
Prerequisite
At least one record (SQL query, MQTT topic, REST endpoint, or Excel sheet) must have been defined and tested in the Compass module before using Cartography. A Compass record is not required for Static Text widgets.
→ Compass
Next Step
After widgets are created, they are placed on a dashboard in Horizon (quick operator panel) or Atlas (advanced, shareable dashboard).