Skip to main content

Troubleshooting Guide

This guide helps diagnose and resolve common issues with Lookout+ systems. Due to the safety-critical nature of maritime operations, many issues require professional support.

Safety First

When in doubt, contact Greenroom support. Never compromise vessel safety while troubleshooting system issues.

Emergency Contacts​

  • Greenroom Support: support@greenroomrobotics.com
  • Critical Issues: Use emergency escalation procedures
  • Documentation: Record all issues and steps taken

Video Feeds​

Camera feed not showing
  • Check if you've changed anything with your network setup
  • Review camera IP addresses and pipeline configuration
  • Verify RTSP URL format and credentials
  • ⚠️ Contact Greenroom Support for persistent issues
Poor video quality or intermittent feed
  • Check network bandwidth and congestion
  • Verify camera compression settings haven't changed
  • Test direct camera connection bypassing network switches
  • Monitor system resource usage (CPU/memory)
  • ⚠️ Contact Greenroom Support for optimization
Authentication failures
  • Verify camera username and password in pipeline settings
  • Check for recent camera firmware updates
  • Test authentication directly with camera web interface
  • ⚠️ Contact Camera Manufacturer/Integrator for support
Multi-camera sync issues
  • Check all cameras have synchronized time sources
  • Verify network latency between cameras
  • Monitor for frame rate inconsistencies
  • ⚠️ Contact Greenroom Support for synchronization problems

Detection​

Detection Performance​

Detections not showing
  • Check if "Existence Probability" filter is set too high → Lower this
  • Verify cameras have clear view of target areas
  • ⚠️ Contact Greenroom Support if detections completely absent
Too many false detections
  • Increase "Existence Probability" threshold in detection filter
  • Check for environmental factors (waves, birds, debris)
  • Verify camera is stable and properly mounted
  • Consider adjusting detection sensitivity for conditions
Detection boxes flashing
  • Increase "Last Seen" duration in detection filter
  • Your detector is running slow due to system load
  • ⚠️ Contact Greenroom Support for performance optimization
Old detection boxes showing on video feed
  • Lower "Last Seen" duration in detection filter
  • Check for objects that have actually moved away
Detection confidence scores inconsistent
  • Check lighting conditions and camera exposure
  • Verify weather conditions aren't affecting visibility
  • Monitor for camera vibration or mounting issues
  • ⚠️ Contact Greenroom Support for model retraining
Detection/classification performance generally poor
  • Check lighting and weather conditions
  • Verify objects are within optimal detection range
  • ⚠️ Contact Greenroom Support - Lookout needs more training with your environmental conditions and recordings
Alert system not working
  • Check alert configuration and thresholds
  • Verify notification delivery methods
  • Test alert triggers with known conditions
  • Confirm alert system isn't disabled or muted

Detection Chips Issues​

Detection chips not appearing
  • Verify detection chips panel is enabled in UI layout
  • Confirm detection chips feature is enabled (beta feature)
  • ⚠️ Contact Greenroom Support to enable detection chips capability
Detection chips panel empty
  • Check if detection confidence thresholds are too high
  • Verify objects are being detected in main display
  • Confirm chips retention time isn't set too low
  • Check system performance isn't affecting chip generation

Geolocation​

Relative bearing mode (Lookout+ Assist)
  • Verify camera field of view settings are correct
  • Check camera orientation and mounting angles
  • Confirm objects appear at consistent relative positions
Absolute bearing mode (Lookout+ Augment)
  • Check GPS position data quality and availability
  • Verify compass calibration and magnetic deviation
  • Confirm integration between GPS and compass systems
Objects appearing in wrong positions (Lookout+ Nav)
  • Verify waterline offset is correctly configured (negative value for height above water)
  • Check INS calibration and orientation
  • Confirm camera calibration hasn't changed
  • ⚠️ Contact Greenroom Support for calibration verification
Bearing accuracy problems
  • Check compass calibration (Lookout+ Augment)
  • Verify GPS position accuracy
  • Look for magnetic interference sources
  • ⚠️ Contact Greenroom Support for bearing calibration
GPS/INS integration failures (Lookout+ Nav)
  • Check NMEA data connections and format
  • Verify INS is providing valid position and attitude data
  • Confirm timing synchronization between sensors
  • ⚠️ Contact Greenroom Support for sensor integration issues
Transform tree errors
  • Check vessel offsets configuration in Advanced Settings
  • Verify baselink reference point is correctly set
  • Confirm all sensor positions are properly defined
  • ⚠️ Contact Greenroom Support for coordinate system issues
No "range" is shown
  • Confirm you have Lookout+ Nav license (range only available in Nav version)
  • Range will not be shown for objects in the sky
  • ⚠️ Contact Greenroom Support for other range display issues
Range is inaccurate
  • Your calibration may be off - check waterline offset configuration
  • Check for INS attitude errors or drift
  • Camera array may have shifted pointing angle
  • Confirm vessel loading hasn't changed significantly
  • ⚠️ Contact Greenroom Support for re-calibration

Data Fusion​

Lookout+ Nav Exclusive

Data fusion is only available with Lookout+ Nav. This feature requires the advanced sensor suite and processing capabilities of the Nav version.

Track Association Issues​

Overlapping bounding boxes from different sources
  • Association angle tolerance may be too high or there may be calibration issues
  • Try increasing angle tolerance
  • ⚠️ Contact Greenroom Support for calibration issues
AIS data not correlating with camera detections
  • Check AIS data feed connectivity and format
  • Verify AIS position accuracy and update rate
  • Confirm vessels are within camera field of view
  • Check for AIS transmission delays
ARPA radar tracks not fusing
  • Verify ARPA data interface and connectivity
  • Check radar calibration and bearing accuracy
  • Confirm radar and camera coordinate systems aligned
  • ⚠️ Contact Greenroom Support for radar integration
Synthetic data source issues
  • Check MIS-SIM simulator connectivity
  • Verify synthetic data format and timing
  • Confirm simulation parameters match real environment
Track continuity problems
  • Check association parameters and timing windows
  • Verify sensor synchronization and data rates
  • Monitor for dropped data or communication issues
  • ⚠️ Contact Greenroom Support for tracking optimization
Back-projection not working
  • Verify AIS/ARPA data feeds are active and valid
  • Check position prediction algorithms are functioning
  • Confirm objects should be visible to cameras given conditions
  • Verify "Last Seen" indicators show appropriate source information

System Performance​

Resource Usage Issues​

High CPU or memory usage
  • Monitor detection pipeline performance
  • Check for multiple unnecessary processes
  • Verify system meets minimum hardware requirements
  • Consider reducing video resolution or frame rate temporarily
  • ⚠️ Contact Greenroom Support for performance optimization
Slow detection response times
  • Check system resource availability
  • Monitor network latency and bandwidth
  • Verify detection models are optimized for hardware
  • ⚠️ Contact Greenroom Support for processing optimization
UI responsiveness problems
  • Try accessing from different browser or device
  • Check network connectivity to Lookout+ system
  • Clear browser cache and reload interface
  • Verify system isn't under heavy processing load
Storage space warnings
  • Check log file sizes and rotation settings
  • Review data retention policies
  • Clear old recordings if storage is full
  • ⚠️ Contact Greenroom Support for storage management
Recording system issues
  • Storage problems: Free up disk space, check write performance, verify disk health
  • Quality issues: Reduce quality settings, verify system timing, check sensor connectivity
  • Playback problems: Update Foxglove Studio, verify file permissions, check computer resources
  • File corruption: Use MCAP tools for recovery or retrieve from backup systems
  • ⚠️ Contact Greenroom Support for persistent recording problems

Configuration Issues​

Calibration Problems​

Waterline offset errors
  • Verify measurements are accurate (height above water)
  • Check sign is correct (negative for above water)
  • Confirm vessel loading conditions match calibration
  • Test with known objects at measured distances
Camera calibration drift
  • Check for physical changes to camera mounting
  • Verify camera housing hasn't been impacted
  • Look for loose mounting hardware
  • ⚠️ Contact Greenroom Support for recalibration
Sensor integration failures
  • Check all sensor connections and power
  • Verify NMEA data format and baud rates
  • Confirm timing synchronization between systems
  • ⚠️ Contact Greenroom Support for integration issues

Access and Interface Issues​

Cannot access Advanced Settings
  • Verify user permissions and authentication
  • Check browser compatibility and JavaScript enablement
  • Try accessing from system console directly
  • ⚠️ Contact Greenroom Support for access issues
Settings changes not taking effect
  • Verify settings were properly saved
  • Check if system restart is required
  • Confirm no conflicting settings exist
  • Monitor logs for configuration errors

Environmental & Operational​

Poor performance in fog or rain
  • Understand this is expected limitation for optical systems
  • Switch to thermal/IR cameras if available
  • Adjust detection thresholds for conditions
  • Consider radar or AIS data as primary source during poor visibility
Night operation problems
  • Verify IR/thermal cameras are functioning properly
  • Check for adequate lighting in critical areas
  • Adjust detection sensitivity for low-light conditions
High sea state effects
  • Understand platform motion affects accuracy
  • Verify camera mounts are secure and stable
  • Check INS performance in rough conditions
  • Consider operational limitations in extreme conditions

Integration Issues​

Lookout+ not communicating with GAMA
  • Check network connectivity between systems
  • Ensure GAMA computer is started and running before Lookout is powered on
  • ⚠️ Contact Greenroom Support for integration troubleshooting
Object data not appearing in GAMA
  • Check detection confidence thresholds in Lookout+
  • Verify filtering settings aren't blocking data
  • Confirm GAMA is configured to receive Lookout+ data
  • Monitor data flow and error logs

Emergency Procedures​

Critical Reminder

As stated in our Disclaimer, Lookout+ is a decision-support tool, not a safety-critical system. The master must assess all factors and follow your vessel's established safety procedures. Lookout+ guidance supports but does not replace your judgment.

System Unresponsive​

Safe restart procedures:

  1. Ensure vessel safety is not compromised
  2. Note current system state and any error messages
  3. Attempt graceful shutdown through UI
  4. If necessary, perform hardware restart
  5. ⚠️ Contact Greenroom Support immediately

Critical Failures​

When to stop operations (decision inputs for operator assessment):

  • 🚨 Total system failure during critical navigation
  • 🚨 Safety system integration loss (collision avoidance)
  • 🚨 Multiple sensor failures affecting core functionality
  • 🚨 Suspected calibration corruption affecting accuracy

Emergency escalation:

  1. 🚨 Immediate: Follow your vessel's safety procedures - do not delay safety decisions awaiting support response
  2. 🚨 Critical: Contact Greenroom support when safe to do so
  3. Document: Record all symptoms and error messages
  4. Preserve: Maintain system logs for analysis

Log preservation:

  • Preserve system logs during critical failures
  • Note exact timing of issues
  • Record environmental conditions during problems
  • Document all troubleshooting steps taken

Pre-Support Information​

Before contacting Greenroom support, gather:

  • 📋 Error messages and exact timing of issues
  • 📋 Environmental conditions during problems
  • 📋 Recent changes to system or vessel configuration
  • 📋 Troubleshooting steps already attempted
Proactive Monitoring

Regular monitoring and maintenance prevent many issues. Establish routine checks for system health, calibration accuracy, and performance metrics.

Support

When in doubt, contact Greenroom support rather than attempting complex troubleshooting that might compromise system integrity or vessel safety.