Skip to main content

Terra Oracle AI Scanner - User Guide

Terra Oracle AI Scanner – Complete User Guide

Table of Contents

System Overview

The Terra Oracle AI Scanner is a hardware soil analysis device that mounts to vehicles (ATVs or other vehicles) for high-precision field scanning. This user guide covers the web-based interface that controls the Scanner and manages agricultural scanning operations. The interface provides real-time sensor monitoring, scan management, data visualization, and system administration tools.

The Scanner features:

  • Plug-and-Play Design: Easy mounting on ATVs with wireless operation
  • Multiple Integrated Sensors: Gamma radiation, optical, GPS, environmental sensors
  • IP67-Rated Housing: Waterproof and dust-resistant for harsh field conditions
  • Wireless Connectivity: Connects to tablets/smartphones via Wi-Fi
  • Built-in Work Light: For night operations

The web interface consists of 6 main sections accessible via the sidebar:

  • Dashboard - Main scanning interface and real-time monitoring
  • Database - Scan management and data download
  • Sensors - Individual sensor monitoring and calibration
  • System Status - Hardware health monitoring
  • Settings - System configuration
  • Power - System shutdown/reboot controls

User Workflow: From Setup to Data Download

Phase 1: Hardware Scanner Setup

1.1 Mount the Scanner

  1. Mount the Scanner to your ATV or other vehicle using the plug-and-play mounting system
  2. Connect Power using the supplied cable to your vehicle’s 12V battery
  3. Verify Mounting - Ensure the Scanner is securely attached and level
  4. Power On the Scanner hardware unit

1.2 Connect to Scanner Interface

  1. Enable Wi-Fi on your tablet or smartphone
  2. Connect to the Scanner’s wireless network
  3. Open Web Browser and navigate to the Scanner’s IP address at 10.10.10.1
  4. Optional Internet Connection - For satellite or OpenStreetMap layers, also connect to your local mobile internet network (e.g., 5G)
  5. Verify Connection - Confirm all sensors show online status in the header

Phase 2: Create and Start a New Scan

2.1 Access the Dashboard

  1. Open your web browser and navigate to the scanner’s web interface
  2. The Dashboard page opens by default, showing the main scanning interface
Scanner dashboard default view with map and sensor widgets

2.2 Create a New Scan

  1. Click the “New Scan” button in the Recent Scans widget (right sidebar)
  2. Fill out the scan details in the modal dialog:
    • Client: Enter the client/customer name
    • Farm: Enter the farm name
    • Field: Enter the specific field identifier
  3. Click “Create Scan” to initialize the new scan
New Scan modal with Client, Farm, and Field inputs

2.3 Navigate to Starting Point

Drive your vehicle with the mounted Scanner to the designated starting point of your field. The system provides up to 8,000 data points per hectare for ultra-high-resolution mapping.

The main map interface will display:

  • Real-time GPS position (white arrow marker when moving, location pin when stationary)
  • Grid overlay for navigation reference
  • Satellite or street map background (configurable)
  • Current GPS fix status and satellite count

2.4 Start Scanning

  1. Once positioned at the starting point, click the large green “Start” button
  2. The interface will:
    • Enter fullscreen mode automatically
    • Collapse the sidebar for maximum map visibility
    • Begin real-time data collection
    • Show colored circles on the map representing scan data points
Initiate scan from main map interface

2.5 Monitor During Scanning

The interface provides real-time feedback from the Scanner’s integrated sensors:

GPS Position: Live tracking with directional arrow showing vehicle movement.
GPS position while scanning
Speed Warning: Alerts if moving too fast (configurable in Settings).
Speed warning during scanning

Multi-Sensor Data: Real-time charts displaying:

  • Gamma Ray Detector: Full spectrum radiation analysis for soil composition
  • Optical Indices: NDVI, NDRE, EVI, SAVI, GNDVI, PRI, NCPI, MSAVI2, TCARI
  • Optical Sensor: UV, Visible, and Near-IR wavelength data (410-940nm)
  • Environmental Sensors: Temperature, humidity, and barometric pressure
Real-time sensor panels during scanning: Gamma, Optical Indices, and Optical Sensor
  • Route Visualization: Colored data points showing scan coverage and soil data intensity

2.6 Stop Scanning

  1. When scanning is complete, click the red “Stop” button
  2. The system will:
    • Save all collected data
    • Exit fullscreen mode
    • Show the completed scan data on the map

Phase 3: Download Scan Data

3.1 Via Database Page

  1. Navigate to Database in the sidebar
  2. Find your completed scan in the table
  3. Options for data download:
    • Single scan: Click the “Download” button for a specific scan
    • Multiple scans:
      • Check the boxes next to desired scans
      • Click “Download Selected” button

Database page with scan list and download actions

3.2 Via View Scan Page

  1. From the Database page, click “View” for any scan
  2. Review scan details including:
    • Client/Farm/Field information
    • Scan start/stop times
    • Current status
  3. Click “Download Scan Data” button

View Scan page with scan details and Download Scan Data button

3.3 Via Dashboard (Recent Scans)

Recent Scans widget in Dashboard
  1. In the Dashboard’s Recent Scans widget
  2. Hover over any scan to reveal action buttons
  3. Click the “Download” button

Phase 4: Upload to Terra Oracle AI Portal

4.1 Access the Portal

Upload Scan Data dialog in Terra Oracle AI Portal
  1. Navigate to the Terra Oracle AI Portal (web-based interface)
  2. Log in to your Terra Oracle AI account
  3. Select the appropriate project or field location

4.2 Upload Scan Data

Terra Oracle AI Portal scans page
  1. Upload Files: Use the portal’s upload interface to submit your downloaded scan data
  2. Add Calibration Data: If you have soil samples, upload the corresponding laboratory analysis results
  3. Verify Upload: Confirm all scan data has been successfully transferred

4.3 AI Processing and Results

Field Intelligence view with Terra Oracle AI Advisor panel

The Terra Oracle AI system will:

  1. Process Data: Advanced AI engine analyzes the multi-sensor data including gamma radiation spectrum, optical data, and environmental parameters
  2. Generate Insights: Create comprehensive soil analysis reports with actionable agronomic recommendations
  3. Create VRA Maps: Generate Variable Rate Application maps for precise fertilizer application
  4. Integration: Automatically transfer results to John Deere Operations Center (if configured)

Detailed Feature Guide

Dashboard Features

Map Controls

  • Zoom: Use mouse wheel or navigation controls
  • Fullscreen: Button in top-right corner or automatic during scanning
  • Layer Selection: Choose between Satellite, OpenStreetMap, or None
  • Grid Toggle: Show/hide navigation grid
  • Route Toggle: Show/hide scan data visualization
Zoom and fullscreen controls
Grid toggle panel
Layer selection panel

Map Settings Panel

Access via the gear icon in the top-right:

  • Visualization Source: Choose data type to display (NDVI, Gamma, etc.)
  • Circle Diameter: Adjust size of data point visualization (1-100 meters)
  • Grid Size: Modify navigation grid spacing
  • Show Route/Grid: Toggle visibility options
Map settings panel in dashboard

Real-time Charts

The Scanner’s integrated sensors provide continuous data streams:

  1. Gamma Ray Detector

    • Current and summed radiation counts for soil composition analysis
    • Full spectrum channel-by-channel analysis
    • Critical for detecting soil minerals and nutrients
Gamma Ray Detector chart

  1. Optical Indices

    • Selectable vegetation indices: NDVI, NDRE, EVI, SAVI, GNDVI, PRI, NCPI, MSAVI2, TCARI
    • Real-time value tracking over time for crop health assessment
    • Color-coded visualization for immediate field insights
Optical Indices chart

  1. Optical Sensor

    • Full wavelength spectrum (410-940nm) from the Scanner’s optical sensors
    • UV, Visible, and Near-IR regions clearly marked with spectral gradients
    • Three integrated temperature sensors for calibration accuracy
    • Real-time spectroscopic analysis for soil properties
Optical Sensor chart

Database Management

Scan Operations

  • View: Detailed scan information and timeline
  • Download: Export scan data files
  • Resume: Continue a previously paused scan
  • Delete: Remove scans (with confirmation)

Batch Operations

  • Select All: Choose multiple scans at once
  • Download Selected: Bulk data export
  • Delete Selected: Bulk removal (with confirmation)

Search and Filter

  • Built-in search functionality
  • Sortable columns
  • Date range filtering

Sensors Page

Sensors page overview

Individual sensor monitoring for:

GPS Sensor (Integrated in Scanner)

  • Real-time Location: High-precision Lat/Long coordinates from the Scanner’s built-in GPS
  • Navigation Data: Vehicle speed, heading, elevation tracking
  • Satellite Information: 3D/2D fix status, satellite count, HDOP/VDOP/PDOP accuracy
  • Live Map: Current Scanner position with selectable base layers (Satellite/OpenStreetMap)
GPS sensor view

Optical Sensor (Scanner Hardware)

  • Multi-Spectral Analysis: Real-time wavelength readings across UV, Visible, and Near-IR spectrum
  • Temperature Monitoring: Three integrated sensor temperature readings for calibration
  • Vegetation Indices: Live NDVI and other optical index calculations
  • Environmental Integration: Combined with barometric pressure and humidity data
Optical spectroscopy sensor view

Gamma Ray Detector (Scanner Hardware)

  • Full Spectrum Analysis: Multi-channel radiation detection for soil composition
  • Count Rates: Current and accumulated radiation readings
  • Soil Mineral Detection: Advanced gamma spectroscopy for nutrient analysis
  • Real-time Processing: Immediate feedback during field scanning operations
Gamma Ray Detector detailed chart

System Status

Scanner hardware and computing system health monitoring:

  • CPU: Processing utilization and temperature of the Scanner’s internal computer
  • Memory: RAM usage charts and available capacity for data processing
  • Storage: Internal storage usage for scan data and system files
  • Thermal Management: Temperature monitoring and throttling warnings for field conditions
  • Overall Health: System-wide status summary for the Scanner hardware
  • Environmental Conditions: Monitoring for the IP67-rated Scanner housing performance
System Status page overview

Settings Configuration

Settings page overview

Display Settings

  • Time Zone: Automatic or manual selection
  • Date Format: Multiple international formats
  • Measurement System: Metric or Imperial units
Display settings panel

Map Settings

  • Default Layer: Satellite, OpenStreetMap, or None
  • Grid Display: Default grid visibility and size
  • Route Display: Default scan visualization settings
  • Scanner Circle: Default diameter for data points
Map settings configuration

Speed Monitoring

  • Speed Warning: Enable/disable speed alerts
  • Speed Limit: Configurable threshold for scanning speed
  • Unit Display: Automatic conversion based on measurement system
Speed monitoring settings

Support Tools

  • Support File: Download diagnostic information for technical support
Support tools settings

Power Management

Scanner hardware control options:

  • Reboot: Restart the Scanner’s internal computing system
  • Shutdown: Safely power down the Scanner device (can be restarted by power cycling)

Tips for Optimal Use

Before Scanning

  1. Physical Setup: Ensure Scanner is properly mounted and powered from vehicle battery
  2. Sensor Status: Verify all sensors show “Online” status in the web interface header
  3. GPS Fix: Confirm GPS has a good 3D fix with multiple satellites visible
  4. System Health: Check Scanner hardware status in System Status page
  5. Speed Configuration: Set appropriate speed warnings for your scanning requirements
  6. Wi-Fi Connection: Verify stable wireless connection between tablet/smartphone and Scanner

During Scanning

  1. Vehicle Speed: Maintain consistent, moderate speed (respect speed warning alerts)
  2. Scanning Pattern: Follow systematic field coverage patterns for optimal data density
  3. Real-time Monitoring: Watch all sensor data streams for consistent readings
  4. Route Visualization: Monitor colored data points appearing on map to verify coverage
  5. Environmental Conditions: Be aware of weather conditions affecting the IP67-rated Scanner

After Scanning

  1. Data Processing: Allow the Scanner’s internal processing to complete before stopping
  2. Status Verification: Confirm scan appears in Database with “Stored” status
  3. Data Download: Export scan data files promptly after completion
  4. Backup Storage: Keep original scan files as backup before uploading to Terra Oracle AI Portal
  5. Equipment Care: Properly clean and store the Scanner hardware after field use

Troubleshooting

  1. Slow Performance: Check Scanner’s System Status for CPU/memory usage and temperature
  2. GPS Issues: Ensure clear sky view and check for physical antenna damage
  3. Sensor Offline: Verify Scanner power connection and hardware status indicators
  4. Wi-Fi Problems: Check wireless signal strength and Scanner network configuration
  5. Data Issues: Use support file feature to generate diagnostic information for technical support

This comprehensive guide covers the complete workflow from Scanner setup through data upload to the Terra Oracle AI Portal. The interface is designed for intuitive operation while providing detailed monitoring and control capabilities for professional agricultural scanning operations.