ComputeMarks < ISG

ISG Web>ISGScriptsManPages>ComputeMarks (2016-01-11, YiLee) (raw view)

---++ Name

computeMarks &mdash; Produce an output file for a given rst suite

<div title="Synopsis">
---++ Synopsis

=computeMarks=

</div> <div title="Description">
---++ Description

*computeMarks* is a program that must be written for each *rst* suite. It will be executed for each student.

The computeMarks script is run by default directly on the course account; because of this, it should never execute student code. Its job is to perform any remaining marking and generate an output file.
</div> <div title="computeMarks Environment">
---++ computeMarks Environment
<div title="Environment Variables">
---+++ Environment Variables

Within *computeMarks*, the following environment variables are defined for use. The first several are in common with *runTests*, but there are additional ones only accessible within *computeMarks*.

   $ =submitdir=: <p>The student's submission directory.</p>
   $ =tmpdir=: <p>The temporary scratch directory available for testing of this student's submission. This directory is also the "current directory" when *computeMarks* is started.</p>
   $ =testdir=: <p>The directory containing *runTests*, *computeMarks*, and other files required by the test suite.</p>
   $ =student=: <p>The userid of the student currently being tested.</p>
   $ =assign=: <p>The name of the assignment, as passed to *rst*.</p>
   $ =course=: <p>The name of the course that is running this test suite.</p>
   $ =answerdir=: <p>The directory optionally containing the correct test outputs, generated by *rsta*.</p>
   $ =solutiondir=: <p>The directory containing the model solution.</p>
   $ =marksheet=: <p>The pathname of the mark sheet file for the current student, which will be included at the top of <strong>rst</strong>'s output.</p>
   $ =marklist=: <p>The pathname of a file shared by all students, which may be used (for example) to track the total marks of each student who submitted an assignment.</p>
</div> <div title="Utilities">
---+++ Utilities

There are certain special commands available only within *computeMarks*: *printFile*, *keepFile*, *deProcessFile*, *writeToTestResults* and *writeToMarkList*. _Take care to make use of these_! Always use *keepFile* to include files containing student output instead of dumping them directly into the marksheet, because *keepFile* contains safeguards that take actions such as truncating files that reach a certain length. Use *writeToMarkList* instead of writing to =marklist= directly to avoid concurrency errors among multiple *rst* instances running in parallel on the same assignment and run_id.
</div> </div>

Topic revision: r1 - 2016-01-11 - YiLee

ISG Web

ISG Web Home
- Changes
- Index
- Search

Webs
- AIMAS
- CERAS
- CF
- CrySP
- External
- Faqtest
- HCI
- Himrod
- ISG
- Main
- Multicore
- Sandbox
- TWiki
- TestNewSandbox
- TestWebS
- UW

My links
- People
- CERAS
- WatForm
- Tetherless lab
- Ubuntu Main.HowTo
- eDocs
- RGG NE notes
- RGG
- CS infrastructure
- Grad images

Edit

Instructional Support Group, David R. Cheriton School of Computer Science, University of Waterloo