Skip to content
Andreas Kristiansen edited this page Dec 14, 2025 · 14 revisions

Important

The result dropdown is set to a max of 5000 QSOs listed. This is because of performance issues when adding that many lines to the table. If this number was to be increased, the browser would either be very slow, or most likely freeze.

Things you can do in the Advanced Logbook:

  • Filter QSOs
  • Find duplicate QSOs
  • Find "invalid" QSOs
    • Checks for missing mode/band/callsign
    • Checks for an invalid date (01011970)
    • Checks if invalid continent is set
  • Export QSOs to ADIF
  • Print labels
  • Batch edit QSOs
  • Delete QSOs
  • Show a map of filtered QSOs
  • Update QSOs from a callbook (QRZ, HamQTH, QRZCQ, QRZ.ru)
  • See a QSL slideshow with selected QSOs that contain an uploaded image of a QSL card
  • Fix state where at least a 6 char gridsquare is set (only available for a limited set of DXCC's)

Database Tools (DBTools)

(from version 2.2.x - not yet released)

Important

These tools work on ALL QSOs for the user. It does NOT work on just the selected QSOS, and it is NOT per location basis.

The Database Tools module in Wavelog provides a comprehensive suite of utilities for maintaining data integrity and repairing common issues in your logbook data. These tools are accessible through the Advanced Logbook interface and are designed to help operators keep their QSO records accurate and complete.

Overview

DBTools offers automated checking and fixing functionality for various types of QSO metadata that may be missing, incorrect, or outdated.

Available Tools

1. CQ Zone Fixer

  • Purpose: Updates missing CQ zone information
  • Function: Validates DXCC against default CQ zone
  • Use Case: Essential for award applications like CQ WAZ (Worked All Zones awards)

2. ITU Zone Fixer

  • Purpose: Updates missing ITU zone information
  • Function: Validates DXCC against default ITU zone
  • Use Case: Required for ITU-sponsored awards and contests

3. Continent Fixer

  • Purpose: Updates missing or incorrect continent information
  • Function: Determines continent based on DXCC entity
  • Use Case: Useful for continental award tracking and statistics

4. State/Province Fixer

  • Purpose: Updates missing state or province information
  • Function: Uses 6 char (or greater) grid square and location data to determine administrative divisions
  • Use Case: Critical for WAS (Worked All States) and similar award programs

5. Distance Calculator

  • Purpose: Calculates and updates distance information for QSOs
  • Function: Computes great-circle distances between stations based on gridsquare set in station location and on QSO.
  • Use Case: Important for distance-based awards and personal statistics

6. DXCC Data Validator

  • Purpose: Identifies QSOs missing DXCC information
  • Function: Cross-references callsigns and timestamps with DXCC entity database
  • Use Case: Essential for DXCC award tracking and eQSL/LoTW verification

7. DXCC Re-check Tool

  • Purpose: Re-evaluates all QSOs for correct DXCC assignment
  • Function: Overwrites existing DXCC data using current Wavelog database
  • Use Case: Useful when DXCC boundaries have changed or initial imports were incorrect

⚠️ Warning
This tool will overwrite ALL existing DXCC information.

How It Works

Check Process

  1. Scanning: Each tool performs a comprehensive scan of the logbook database
  2. Validation: Data is cross-referenced against various sources (DXCC lists, zone definitions, county/provinces geojson)
  3. Reporting: Results display the number of records needing attention

Batch Processing

  • Tools can process thousands of QSOs efficiently

Safety Features

  • Most tools operate in check mode first, allowing review before applying fixes

Access and Usage

Location

  • Navigate to Advanced LogbookDBTools tab
  • Requires appropriate user permissions (typically admin or logbook owner)

Interface

  • Left Panel: Tool selection and action buttons
  • Right Panel: Real-time results and progress information
  • Actions: Check, Fix, Run or Update buttons depending on tool type

Workflow

  1. Step 1: Use Check buttons to identify issues
  2. Step 2: Review results and affected QSOs
  3. Step 3: Apply fixes using the appropriate action button
  4. Step 4: Wait until the fix is done

Technical Implementation

Data Sources

  • DXCC entity database from CLub Log
  • Zone definitions from CQ and ITU specifications
  • Administrative boundary data for state/province determination

Performance Considerations

  • Batch processing optimized for large logbooks
  • Memory-efficient database queries

Best Practices

  1. Backup First: Always create a logbook backup before running bulk fixes
  2. Review Results: Carefully examine what will be changed before applying fixes
  3. Monitor Progress: For large logbooks, allow adequate processing time
  4. Verify After: Spot-check results after fixes are applied to ensure accuracy

Troubleshooting

Common Issues

  • Memory Limits: Large logbooks may require increased PHP memory limits
  • Timeout Issues: Long operations may need extended execution time limits
  • Coordinate Accuracy: Some fixes depend on accurate grid square data

Clone this wiki locally