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.

The swap columns setup allows reversing 2 adjacent fields in Cabrillo - much easier than
doing it in Excel + NotePad!

Running the software:

° After installing Cabrillo Evaluator, run it from the Start | Programs menu. Note: Do not drag CabEvaluator.exe to the desktop to make shortcuts. Right-mouse the .exe and select `Create shortcut`, then drag it to the desktop. Or make one using the wizard. 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. If you add EditPad later, just re-name NotePad.exe to something else. To use NotePad++ or other editor, copy the .exe to the CabEvaluator folder and rename that .exe to NotePad.exe. ° 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. ° 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. ° Hit Click here to Run Batch to run the log evaluation on all logs at one time. Use <Esc> to cancel the batch run - taking note of the callsign. To continue later at that log, hit <F8>, then click that log file. 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. But first, you need to install CabEvaluator v3.0 using the Windows install program and have the software working. If you read the above text, you already have most of the information about how the software works. ----------------------------------------------------------------------------------- ° Disclaimer/Notice: Use my software at your own risk. I write software for Amateur Radio as a fun hobby.