Home

Welcome to the Conval wiki!

The Conval library provides a model to describe the rules of amateur radio contests. Since a contest's rules can be rather complicated, the rules description also contains a set of example QSO data, which is used to validate itself.

Equipped with a rules file, you can use Conval to evaluate Cabrillo data in several ways:

• calculate the score of a log file based on a given rule set
• show the performance over time of a contest log file
• calculate statistics for a contest log file

These functions can either be used on the command line, using the conval command, or in your own Go programs, using Conval as a Go library.

The Rules Model

Most contest rules follow a common structure. They define:

• the period of operation
• the allowed bands and modes
• categories and overlays
• restrictions for band changes, operation time, breaks, etc.
• exchanged information
• calculation of QSO points and multipliers

Conval's rules model resembles this structure and tries to represent all the relevant details that are needed to calculate the final score. Besides that, the rules model also contains:

• general information: the name, the Cabrillo identifier, URLs, etc.
• example QSO data to validate the rule description

The latter allows to verify, that even complex rules are described correctly. Providing matching example QSO data feels like the natural way for describing the effects of a rule.

Find all the details about the Rules File Format here in the wiki.