PIRIVISION Handbook
From Data to Dashboard in 5 steps.
Pirivision ingests industrial IoT data from various sources and makes it observable through dashboard automation. This handbook walks through the entire flow — from Port to Atlas — module by module.
Ecosystem
Platform Flow
Before You Start
If you are using Pirivision for the first time, go through the modules in order: Port → Compass → Cartography → Horizon / Atlas. Each module builds on the output of the previous one; therefore, a query must exist in Compass before starting Cartography, and a widget must exist in Cartography before starting Horizon/Atlas.
flowchart LR
A[Port<br/>Data Source] --> B[Compass<br/>Query]
B --> C[Cartography<br/>Chart / KPI]
C --> D[Horizon<br/>Page / Board]
D --> E[Atlas<br/>Dashboard]| Module | Purpose |
|---|---|
| Port | Add data sources and manage connection settings. |
| Compass | Make the data source ready to use together with a query. |
| Cartography | Build the content from Compass into the appropriate chart format. |
| Horizon | Divide charts into pages and prepare them for viewing. |
| Atlas | Make the dashboard viewable from a single central location. |
Guides
Port — Data Sources
| Data Source | Connection Type | Add | Edit |
|---|---|---|---|
| PostgreSQL | Relational database | Test & Save | Test and Update |
| MSSQL | Relational database | Test & Save | Test and Update |
| MySQL | Relational database | Test & Save | Test and Update |
| MQTT | Real-time broker | Save | Update |
| REST API | Web service | Test & Save | Test and Update |
| Excel Offline | File upload | Save | Update |
| Management | All data sources | — | Move · Duplicate · Delete |
Compass — Creating Records
| Guide | Description |
|---|---|
| Compass Overview | Module introduction, supported record types, what you can do in Compass |
| Create PostgreSQL Query / Edit | Writing queries with standard SQL |
| Create MSSQL (T-SQL) Query / Edit | T-SQL dialect differences, TOP / OFFSET FETCH |
| Create MySQL Query / Edit | MySQL/MariaDB dialect notes |
| MQTT Topic Selection / Edit | Topic selection in the broker and live data |
| Define REST Endpoint / Edit | Path, query string, header definitions |
| Excel Sheet Selection / Edit | Sheet selection and preview |
| Move / Duplicate / Delete | Management actions |
Cartography — Creating KPI Widgets
| Guide | Description |
|---|---|
| Cartography Overview | Module introduction, 23 chart types, 6 groups |
| Widget Creation — Overview | Map of the 9-step wizard and step conditions |
| Standart Cartesian Flow | Line/Area/Spline/Column/Bar/StepLine — full 9 steps |
| Stacked Cartesian Flow | Stacked* types — Stack By column |
| Range Column Flow | Min/max range bar |
| Waterfall Flow | Cumulative gains/losses |
| Circular Steps | Pie/Doughnut/Radial Bar |
| Radial Gauge Flow / Linear Gauge Flow | Single instant value gauge |
| Static Text Flow / Dynamic Text Flow | Markdown / live KPI |
| DataGrid Steps | Multi-column table |
| Two-Column List Steps | Label-value list |
| Edit | Reopen and update an existing widget |
| Move / Duplicate / Delete | Management actions |
Horizon — Boards and Dashboards
| Guide | Description |
|---|---|
| Horizon Overview | Module introduction, V1 layout engine, list screen |
| Create Board | New board setup, form fields, canvas |
| Widget Placement | Drag-and-drop, resize, 20 widget limit |
| Global Filters | Control Compass global variables from the panel |
| Captain AI | Natural language chat, board snapshot + XLSX packaging |
| Export | PNG snapshot, XLSX export, download flow |
| Share | User-based sharing, permission model |
| Move / Duplicate / Delete | Management actions |
Atlas — Advanced Dashboard
| Guide | Description |
|---|---|
| Atlas Overview | Module introduction, V2 layout, routes, Horizon comparison |
| Create Dashboard | New dashboard setup, title, background |
| Widget Placement | V2 proportional grid, auto-placement, resize |
| Responsive Behavior | Auto-scaling, scroll threshold, mobile/tablet |
| Public Share | Token-based public link, link management, security |
| User Share | Username-based sharing, permission model |
| Embed (iframe) | Embed a public link into an external page via iframe |
| Move / Duplicate / Delete | Management actions |
AI — Artificial Intelligence Assistants
| Guide | Description |
|---|---|
| AI Overview | Comparison of Makinist and CaptainAI, shared Langflow dependency |
| Makinist | AI assistant that generates SQL from natural language in the Compass SQL editor |
| CaptainAI | AI assistant that chats using board snapshot + XLSX context on the Horizon board |
Recommended First-Use Order
- Add a data source in Port.
- Create a query in Compass.
- Create a chart / KPI in Cartography.
- Prepare a page or board in Horizon.
- Organize the dashboard view in Atlas.
Tip
After adding your first data source, run a small test query on the Compass side. This lets you catch connection, permission, and schema problems early.