Scan processing

Matholymp has some partial support for processing scans of contestant scripts, using barcoded cover sheets to support automatically splitting up a PDF with scans of multiple scripts.

Matholymp provides a script mo-process-script-scans to do this processing. It expects to be run from a directory containing a file scans.cfg with associated configuration information. The examples/scan-processing/ directory in the matholymp source distribution includes a version of scans.cfg that may be used as a basis for configuring this. The other arguments are the names of multi-script PDFs to process; mo-process-script-scans creates a corresponding log file for each of those files with .log appended to its name.

The file pointed to by cover_sheet_key_file should exist before this command is run, with the same 20 bytes of random data (generated afresh for each year’s event) as in the file used in document generation to generate the cover sheets. The file pointed to by password_file should also exist, containing the password for the registration system account (with the Scan role) to be used to upload scripts.