QGIS live maps: controls and troubleshooting
Operator-provisioned pilot. The live connector requires scoped access, a configured bridge and a qualified application version. There is no general public installer yet. The public CRS exercise can be tried without a server or connector.
Read the controls
Section titled “Read the controls”- Connect live map attaches the configured asset. It does not publish the QGIS project to the server.
- Pin current snapshot keeps an exact revision for comparison. A pin deliberately does not follow later publications.
- Pause / resume controls automatic following; Refresh now requests a current read.
- Rescale live colors updates the live layer’s presentation range. It does not alter source values, change coordinates or publish a revision.
The qualified workflow is one-way: ResInsight publishes scalar maps and QGIS consumes them. Contours are generated locally from the delivered raster. Editing QGIS layers does not write back into ResInsight or recreate a reservoir model.
Diagnose a surprising result
Section titled “Diagnose a surprising result”| Symptom | Check and next action |
|---|---|
| Revision advanced but colors look unchanged | Compare the numerical range, inspect layer visibility and select Rescale live colors if you want a new range. |
| Pin stays old | Expected. Pin a newer snapshot explicitly if that is what you want. |
| Map seems missing or misplaced | Check source, layer and project CRS separately. Do not fix this by guessing a CRS label. |
| Unknown-CRS import is refused | Obtain reliable source metadata or use the dedicated unreferenced synthetic project. |
| No live updates | Check pause state, source publication status, bridge connectivity and current access. Refresh once; ask the deployment operator to inspect the connection if it remains unavailable. |
| Another QGIS window behaves differently | Check each window’s profile, configured asset, follow/pin mode and loaded plugin version. |
| Conversion is rejected | Read the reported reason: datum change, unsupported CRS, missing vertical metadata or grid bounds can require a different qualified workflow. |
An old visible layer is not proof of current authorization or connectivity. Check the connector’s status. A permission change can prevent future reads, but cannot recall copies already downloaded.
What happens in the background
Section titled “What happens in the background”The ResInsight adapter periodically checks for a consistent changed export. After the server commits a revision, a native stream wakes the consumer bridge. QGIS waits for a small HTTP long-poll notice, then a background worker downloads and checks the exact snapshot and prepares contours. The GUI thread applies prepared layers through QGIS APIs.
This keeps downloading and preparation off the GUI thread, but those operations still use CPU and memory. Layer application also takes some GUI time. Small-fixture testing is not a guarantee of responsiveness for arbitrarily large maps or many clients.