 VQP                                                              VQP

 NAME
	vqp.pl

 SYNOPSIS
	Perl vqp.pl


 DESCRIPTION
	The Virginia QSO party scoring program for the Sterling Park 
         Amateur Radio Club.

	This software was created for the Sterling Park Amateur Radio
	Club (SPARC) by K2BFY.

	The program searches the current directory for *.cbr files and
         scores all that are found.
       

 INSTALL/USAGE

        Your log file must be named "YourCall.cbr" for example: K2ABC.cbr

        Create a new folder for example: C:\vqp

        Place vqp.exe and your .cbr file into the new folder.

        Open a command window and cd to c:\vqp

        Execute vqp.exe

        Examine the vqp.log file for errors in your .cbr file.

        Also examine the vqp.rpt and vqp.qth files.

        Correct any errors in your .cbr file.
        
 FILES
	The program uses the "contact" object and associated methods
	in the contacts.pm Perl package to automatically archive qso
	data and calculate the score.

	The prefix.pm file is a package that encapsulates the city/county,
	state, province and country data and the rules associated with
	them.

        vqp.pl      - Perl program
	contacts.pm - external Perl package that manages qso data
        prefix.pm   - external Perl package that manages dx country data

        vqp.exe     - Windows executable

        vqp.log     - program error and warning log
        vqp.rpt     - scoring data
        vqp.csv     - Excel spreadsheet data
        vqp.qth     - List of countries

 DESIGN



        VA QSO Party Scoring Algorithm and example.  
        Sample scores are contained in < > angle brackets.

A) Check the log file file for duplicate contacts and remove the duplicates

1) Total number of phone contacts <17>

2) Number of phone contacts with a Virginia mobile <6>

3) Subtract (2) from (1)  <11>
   This is the total number of phone contacts to put
   on the Summary sheet.

4) Total number of CW and digital contacts <2>

5) Number of CW and digital contacts with a Virginia mobile <1>

6) Subtract (5) from (4) <1>
   This is the number of CW and digital contacts for the summary sheet.

7) Add (2) and (5)  <7>
   This is the number of contacts made with a Virginia mobile for the summary sheet.

8) Number of VA counties and cities contacted <4>

9) Number of VA counties and cities you operated from as a 
   virginia mobile or expedition station and made at least 10 contacts 
   that are not counted as a county or city anywhere else on the scoring sheet <1>

10) Number of US States contacted <2> (VA does not count as a state)

11) Number of Canadian Provinces contacted <0>

12) Number of other DX countries contacted <0>

13) Add (8), (9), (10), (11), (12) This is the TOTAL MULTIPLIER POINTS <7>

14) Add (3), 2 X (6),  3 X (7)  This is the TOTAL QSO POINTS <34>  11 + 2 + 21

15) Multiply (13) times (14)  This is TOTAL VIRGINIA QSO PARTY SCORE <238>

16) Number of Virginia counties and cities you operated from as a Virginia mobile 
    or expedition station<3>

17) K4NVA Contact bonus points <500>

18) Multiply (16) times (100) <300>

19) Add (17), (18) <800>
    This is TOTAL BONUS POINTS

20) Add (15),  (19)  <1038>
    This is CONTEST GRAND TOTAL
