PAGE LAYOUT
Toolbar (top right)
- Serial number drop-down and 3D VISUAL HELP button on one row.
- REFRESH, RESET VIEW, SHOW ALL PATHS, and REALTIME DATA buttons.
3D viewport
- Interactive Three.js scene with ground grid, axis tripod, oil platform reference, and colored well paths.
- Status text and path detail overlay in the upper-left corner.
- Loading overlay while survey data is fetched and rendered.
Footer hint
- Short reminder of mouse controls below the viewport.
SERIAL NUMBER
Select the instrument serial number from the drop-down in the toolbar. Survey paths and the 3D scene reload for that unit.
Changing the serial fetches new path data and restores the saved camera view for that serial when available.
3D VISUAL HELP
Opens this help document in a new browser tab.
REFRESH
Reloads survey path data from the server for the current serial, bypassing cached data when you need the latest trajectories. Use after new drilling or when the scene looks out of date.
RESET VIEW
Resets the camera to a default framing of the rendered paths. Use if the 3D view appears blank, the camera is lost off-scene, or after switching serial when the view does not look correct.
SHOW ALL PATHS
Toggles a pinned list of survey details for every rendered path in the overlay panel. When ON, hover detail is disabled and all path summaries stay visible.
Click again to turn OFF and return to hover-only detail.
REALTIME DATA
Opens a live realtime instrument data popup window for the selected serial number.
MOUSE CONTROLS
Mouse wheel
Zoom in and out.
Left drag
Rotate the camera around the scene.
Right drag
Pan the camera.
Hover path
When SHOW ALL PATHS is off, move the pointer over a colored path line to display survey detail in the overlay (depth range, connections, time span, end azimuth and inclination). Detail text uses the path color.
Moving the pointer off the viewport clears hover detail unless SHOW ALL PATHS is pinned ON.
SCENE ELEMENTS
Surface grid
Horizontal reference grid representing the surface plane. World units match hole depth in feet.
Axis tripod
RGB axis lines at the grid corner: red X, green Y (up), blue Z.
Oil platform
Reference structure above the surface for spatial context.
Well paths
Colored 3D lines from survey points in RWPacketData. Each path may show connection marker dots along the trajectory at regular depth intervals. Up to 20 distinct high-contrast colors distinguish multiple paths.
PATH DETAIL OVERLAY
The upper-left panel inside the viewport shows:
Status line
Load state, serial, path count, and error messages.
Path detail (on hover or SHOW ALL PATHS)
Path index, start/end depth (ft), connection count, packet time range, and end azimuth/inclination (degrees).
DATA AND CACHE
Path data is loaded from engine.x?=visual3d_data for the selected serial.
Survey points are grouped into paths and rendered in the browser using WebGL.
Camera position and target are saved per serial in browser storage so your view returns when you revisit the same unit. REFRESH updates path geometry; camera restore uses cached view when valid.
TIPS
- Select the correct serial before interpreting path colors and depths.
- Use RESET VIEW if you cannot see paths after load.
- Hover individual paths to compare depth spans and end orientation.
- Use SHOW ALL PATHS when presenting or comparing every trajectory at once.
- Click REFRESH after significant new survey data is recorded.