plom-finish

Plom script for post-grading tasks.

usage: plom-finish [-h] [--version] {status,csv,reassemble,webpage,solutions,rubric,audit,clear} ...

Positional Arguments

command

Possible choices: status, csv, reassemble, webpage, solutions, rubric, audit, clear

options

--version

show program’s version number and exit

Sub-commands:

status

List progress and which tests that have been completed.

plom-finish status [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

csv

Create a spreadsheet of grades named “marks.csv”.

plom-finish csv [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

If grading is not yet complete, the spreadsheet contains partial info and any warnings so far.

reassemble

After papers have been ID’d and marked, this command builds PDFs to return to students. A special case deals with the online-return of papers that were marked offline (before scanning).

plom-finish reassemble [-h] [--skip-existing] [--ided_only] [-s SERVER[:PORT]] [-w PASSWORD] [testnum]

Positional Arguments

testnum

Which test number to reassemble or omit to reassemble all papers.

options

--skip-existing

If a file already exists, don’t rebuild it. Careful: does not check if the file is out of date! Thus turned off by default.

Default: False

--ided_only

Reassemble PDF files for ID’ed (but offline-graded) papers.

Default: False

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

webpage

Prepare HTML page for return using out-of-band per-student secret codes.

plom-finish webpage [-h] [--solutions] [--hex] [--digits N] [--salt SALT] [-s SERVER[:PORT]]

options

--solutions

Add a ‘get solutions’ button to the return website.

Default: False

--hex

Use a string of hexadecimal instead of decimal digits for the secret codes. More secure but may cause problems if you use certain Canvas workarounds to distribute the codes.

Default: False

--digits

Length of the secret code. Defaults to 9.

Default: 9

--salt

Instead of random codes, use a hash of the student ID, salted with the string SALT. The codes will then be reproducible by anyone who knows this string (and the student IDs). As its susceptible to offline attacks, a longer string is recommended: you can put quotes around a phrase e.g., –salt “Many a slip twixt the cup and the lip”.

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

The webpage will be in codedReturn and the secret codes in return_codes.csv.

There may be scripts in share/plom/contrib to assist with distributing the secret codes.

This command must have access to the results of reassemble.

solutions

If all solution images present, then this will build individualised solution PDFs for the students (based on the particular q/v of their test.

plom-finish solutions [-h] [-m] [-s SERVER[:PORT]] [-w PASSWORD] [testnum]

Positional Arguments

testnum

Build a solution for this particular test, or omit to reassemble solutions for all identified and marked papers.

options

-m, --mark

Watermark the solutions with the student number.

Default: False

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

rubric

Download list of rubrics as json and the test-rubric use matrix (indexed by test-number and rubric-key) also as json.

plom-finish rubric [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

audit

Download an audit of all files + bundles used. Saved as ‘audit.json’.

plom-finish audit [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

clear

Clear “manager” login after a crash or other expected event.

plom-finish clear [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-s, --server

Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.

-w, --password

for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.

See help for each subcommand or consult online documentation for an overview reassembling and returning work to students.

Most subcommands communicate with a server, which can be specified on the command line or by setting environment variables PLOM_SERVER and PLOM_MANAGER_PASSWORD.