Tsugi

Grader
in package

Score a Quiz1 quiz from submitted student responses.

Matches Common Cartridge QTI 1.2.1 rules used by Qti12Exporter: multiple choice / true-false = one correct choice; multiple response = all-or-nothing; fill-in-the-blank = case-insensitive exact; pattern match = substring (optional case). Essays are not computer-scored.

Does not persist attempts.

Table of Contents

Constants

CORRECT  : mixed = 'correct'
INCORRECT  : mixed = 'incorrect'
UNSCORED  : mixed = 'unscored'

Methods

grade()  : array{earned: int, possible: int, essay_possible: int, items: array>}
gradebookScore()  : array{grade: float, earned: int, total: int, pending_manual: bool}|null
Fraction to store on the result after a finished take.
gradeQuestion()  : array{status: string, earned: int, possible: int, submitted: mixed}
plain()  : mixed
submittedFor()  : mixed
gradeFillBlank()  : mixed
gradeMultipleResponse()  : mixed
gradePatternMatch()  : mixed
gradeSingleChoice()  : mixed

Constants

CORRECT

public mixed CORRECT = 'correct'

INCORRECT

public mixed INCORRECT = 'incorrect'

UNSCORED

public mixed UNSCORED = 'unscored'

Methods

grade()

public static grade(Quiz1 $quiz, array<string, mixed> $post) : array{earned: int, possible: int, essay_possible: int, items: array>}
Parameters
$quiz : Quiz1
$post : array<string, mixed>

Request POST (q{id} / q{id}[])

Return values
array{earned: int, possible: int, essay_possible: int, items: array>}

gradebookScore()

Fraction to store on the result after a finished take.

public static gradebookScore(array{earned?: int, possible?: int, essay_possible?: int} $graded) : array{grade: float, earned: int, total: int, pending_manual: bool}|null

Auto-only quizzes can earn every point by machine, so the fraction is earned over those points. Essay points stay in the denominator and are not yet earned, so four auto points and one ungraded essay is 0.8.

Parameters
$graded : array{earned?: int, possible?: int, essay_possible?: int}
Return values
array{grade: float, earned: int, total: int, pending_manual: bool}|null

gradeQuestion()

public static gradeQuestion(Question $question, mixed $submitted) : array{status: string, earned: int, possible: int, submitted: mixed}
Parameters
$question : Question
$submitted : mixed
Return values
array{status: string, earned: int, possible: int, submitted: mixed}

plain()

public static plain(mixed $html) : mixed
Parameters
$html : mixed

submittedFor()

public static submittedFor(Question $question, array<string, mixed> $post) : mixed
Parameters
$question : Question
$post : array<string, mixed>

gradeFillBlank()

private static gradeFillBlank(Question $question, mixed $submitted) : mixed
Parameters
$question : Question
$submitted : mixed

gradeMultipleResponse()

private static gradeMultipleResponse(Question $question, mixed $submitted) : mixed
Parameters
$question : Question
$submitted : mixed

gradePatternMatch()

private static gradePatternMatch(Question $question, mixed $submitted) : mixed
Parameters
$question : Question
$submitted : mixed

gradeSingleChoice()

private static gradeSingleChoice(Question $question, mixed $submitted) : mixed
Parameters
$question : Question
$submitted : mixed

        
On this page

Search results