W3KM Cabrillo Evaluator - Initial Use Instructions
             W3KM Cabrillo Evaluator - Initial Use       
           Step-by-step to learn Cabrillo Evaluator

Software Description:
° Scores Cabrillo format logs, with auto load of the contest profile Ini. Automatic
evaluation of up to 2000 logs with duping, claimed score, actual score, cross checking,
N-QSO rule, 5-min QSO rule and 2 profile Ini files support.

° The column formatting of log files is easily handled by the re-format function. CabEval
was written in 2000 when contests used column templates, but uses the white spaces between
exchange fields to format logs.

The software literally has hundreds of scoring functions based on the various setup screens,
plus some hard coded routines. It would be impossible to use just white spaces to parse data.
CabEval uses specific columns and # characters to parse the exchanged data. This is why the
the column re-formatter is used.

Regardless, a function similar to the re-formatter is required to find out why logs do not
score correctly. Additionally, the formatter also checks for field at column 31, date,
contest name, invalid 3-character modes, non-US keyboard characters (diacritic combinations
like   ), slashed zeros(), missing END-OF-LOG: tag (could mean an incomplete log),
missing/extra columns, missing EOL terminations and other quirks that cause scoring errors.

° A Cabrillo template should be published with the contest rules. This will certainly increase
the number of `good` Cabrillo logs received.

The column modifier adds columns (spaces or text), adds placeholder columns, deletes extra
non-compliant columns and fills blank placeholders in existing columns, which is required by the
column re-formatter. This form also shows logs with exchange data not in correct order - they may
not score correctly. Sponsors using their own scoring software tell me they find the column
modifier very useful.

The date/time sorting function checks for standard format and sorts by ascending date/time.

Important:
Always explicitly load your contest Ini file when you run the software. Why? - If you change
the setup by mistake (change a button or checkbox for example), that change will be propagated
to the next session of the software. When you exit the software, the current setup is saved to
the default Ini - Cab_Evaluator.ini - which is loaded when you run the SW again.

When you think something is wrong (your test log doesn`t score as before) - reload your contest
Ini file. Also, save your setup files to BU. Saving your CabEvaluator folder to a USB stick will
save lots of time when you change PCs or HD.

° Hundreds of sample Cabrillo files, plus the Ini files and datafiles are available. Viewing
the WinZip dialog window by `Name` shows the files for a contest. View by `Modified` to show
the new files added. Select the files you want to use and unzip them to the CabEval folder.

° Contests use specific multiplier files that are normally named with the contest name as part
of the filename. Some contests use files not named by contest - they are shared by multiple
contests. Use Summary Write this Contest Ini summary to identify these files.

° Some contests use `extra` Ini setups for scoring not handled in the main setup. Under the
File Extra setups menu, a check-mark highlights the `extra` setup being used. If the profile
Ini files are re-saved with the `extra` setup files loaded, the extra files will load the next
time the main Ini file is loaded.

° Load an Ini profile via standard Windows `File Open` dialog:
- by using the File Load menu.
- by right-mouse clicking the Cabrillo files box.
When the dialog window is displayed, enter a few characters of the wanted contest to display
the files starting with those characters.
- Or first press the <Ctrl> key, then click a log file. When 2 Ini files are used for Home
and non-Home/DX, press <F7>, then click the log file to see the second Ini file.

An auto Ini loading procedure is used when 2 different Ini files are required to score `Home`
and `Away` logs as in DX contests and State QSO parties.

° After the Ini file loads and all logs are formatted and columns checked, click the Cabrillo
file to score it. Turn on the auto open of the results file in the Include menu - or use <F9>
to toggle this function. You do not want `auto open` selected during batch runs. If you copy
NOTEPAD.exe (or EditPad.exe) to the CabEvaluator folder, the results file and other files
written by the software will open in your editor.

° Cab Eval writes summaries of all logs evaluated. Generic summaries, plus 2 preferred
table formats are available in the Summary menu. The generic summaries, retained from version
1.0, have limited usefulness. The Table1 summary is more useful and can be exported to Excel
to sort on Country or Continent for example. Sponsors can request a summary. The cross check
summary puts all log CC results in one file.

° <Esc> or <F3> stops the evaluation being run. <F1> opens the HELP file. If my WinHelp file
does not open, get the WinHlp32.exe file from Microsoft`s WinHlp32 page. The x64 file is for
64-bit OS and x86 is for 32-bit (XP)OS. Or, select the HTML help format from the Help menu.
The WinHelp file is nicer and easier to navigate than the newer HTML format.

° Left-mouse click a Set button to set the datafile to be used. Right-mouse clicking the
Set button opens the file in your editor. If the selected file does not exist, that file
opens in a blank editor screen.

Sponsors evaluating log submissions:
° Optional folder paths are set for (1)Cabrillo logs and (2)`results` files, in the File
Sponsor Setup. This is a must for log checkers, but can be used by contesters.

° The 2-Ini option allows 2 different scoring Ini files to be used - {`Home` and DX or
`Home state` and `non-Home state`} - and are loaded automatically based on DXCC prefix
or ARRL section/State. The section or state is taken from the ARRL-SECTION: or LOCATION:
tag of the Cabrillo. Counties cannot be used to identify the QSO party `home` station
logs. Some contesters will put their grid square or full text for the field. So, use the
Summary Write Cabrillo files list to see that all `home` stations have their state or
section identified in the Cabrillo header. The Ini file used for scoring is listed in
the header of the results text file.

Use descriptive filenames that contain the contest name and their use. New Mexico QSO
Party examples are {NMQP_NM.ini and NMQP_nonNM.ini}.

When 2 Ini files are used for a contest, you can initially load either Ini to score logs.
When you run the batch or single-score a log, the appropriate Ini(s) will load.

State QSO Parties:
1. Some QP`s have scoring functions to add bonus points to the score for activating several
counties. This can now be setup in the File, Sponsor Setup, Ini Options form.

2. In `home state` station logs, 2 mults can be scored for the first `home state` QSO.
1 for the county and 1 for the state. The first VE QSO can be scored as 2 mults as well,
DXCC and province. These 2 scoring variations are selectable.

3. In State QP (and others) the software separates the DXCC multiplier and State/Prov
mult scoring. The look-up datafile is {QSO-Party-List.dat} that turns this function ON.
When the DXCC prefix and State/Prov abbreviation is the same (Portugal=CT Connecticut=CT
is 1 of 8 abbreviations like this), 2 mults would otherwise be scored for DXCC and state.

4. Since the DXCC prefix comes from the callsign, the exchange/QTH field can be either the
DXCC prefix or "DX".

5. QSOs with the same mobile in different counties are not dupes. Each county exchanged
must be a separate QSO.

See points 2-5 in this partial State QSO party results file.

Valid bands:
To score invalid band QSOs as 0 points, use a valid bands lookup file like: CE-Valid-Bands.dat,
selected in the Options Ini setup form. Use the File Sponsor Setup Ini Options menus. Use one
of my valid bands data files, or make your own. See the New Options Ini setup in the help file
for the frequency list.

Invalid exchange:
To score invalid exchange (field length not correct) as 0 points, use the `QSO exchange not
specified length = 0 points` setup in the Options Ini setup form. Use the File Sponsor Setup
Ini Options menus. Turn ON the function and set the field column ID and the character length.
All exchanges not the specified length score 0 points.

Check-boxes:
Don`t assume that when you select the check-box `On` that the initial text is what is being done.
This is my "smart text" programming, where the check-mark changes the displayed text to show what
is being done (or not being done). Click the check box to view the 2 text selections and select
the function you want - regardless of check-mark status. The check-mark on/off status is saved to
the appropriate Ini file.

Batch run scoring:
° Select `Setup for Sponsor` in the File Sponsor Setup menu to activate the `Batch` sequence. Use
the Click here to Run Batch button to run the log evaluation on all logs. Use <Esc> to cancel a
batch run - take note of the log. To continue later at that log, hit <F8>, then click that log file.

° Turn off the `auto open` of the Results/CC files in the Include menu, otherwise all these
files will open in multiple instances of your editor while running the `batch`.

° If being used, create or load the CC Ini file for that contest and select the cross check
functions you want. Re-save the CC Ini file when changes are made. If you use `Save As` to
create a CC file for your contest, be sure to save the Ini for that contest with the CC Ini file
loaded, so CabEval loads that CC Ini. Select whether to re-score the log based on the CC results.
Error in received message = 0 points and 0 mults. In the Sponsor setup you can also select the use
of the N-QSO rule.

° Cross checking cannot be done in State QSO parties that require a log from each county activated,
or accept logged callsigns related to the county - W3AAA/HUD for example.

° In QSO Parties, use the File Tools Check Invalid DXCC/State mults menu to write a file of DXCC
multipliers (and QSOs) to verify.

Summary outputs:
° In the Summary menu, several summary files can be written to document and further evaluate
the log submissions, including 2 user defined Preferred Table outputs. The Table1 summary can
output a summary using headings selected in the setup. Summaries can be exported to Excel to
sort on Category, Country, Continent etc. Table2 is used to write sorted text files. Special
summary outputs are available upon request.

Summary headings added upon request are `Created-By` (software that creates the Cabrillo log
file - no column number ID is needed) and `Category-v3` that pulls both Cabrillo v2 and v3
categories from the header.

° A `State QSO Party` summary can be selected by adding the `State QSO Party` heading at the
bottom of your existing summary setup. If this heading is anywhere in the setup, only the
`State QSO Party` summary is written. This makes it easy to go back to the previous summary
by just removing the last heading. When using the `State QSO Party` heading, the column ID
is not needed.

° Writing the list of Cabrillo logs using Summary Write Cabrillo Files list is useful to insure
that all logs have a QTH identifier, required when using 2-Ini files in state QSO Parties. This
summary is also useful to see that logs have a special category listed in the CATEGORY: tag,
ie: Single-Op B, where B is the power designator that tells the software the power multiplier
for ARCI contests for example.

° Write a `Validated Calls` report to show stations that did not submit a log and made N QSOs
with stations that submitted a log. Using N=3 is a good start to remove typo callsigns. Output
the report alphabetically with N=1 to show the callsign typos.

° A detailed UBN report is available after `batch` run - when cross check is selected.

Contest sponsors migrating to Cabrillo submissions:
° If you want a complete setup for your contest, let me know. Send me the link to the contest
rules and some Cabrillo logs if available. First, install CabEvaluator using the Windows install
program. If you read the above text, you already know how most of the software works.

-----------------------------------------------------------------------------------
° Disclaimer/Notice:
Use my software at your own risk. I write software for Amateur Radio as a fun hobby.