grading-procs.tcl

Publicity: Public Only All

grading-procs.tcl

Test Item grading procs - support for different kind of grading types and schemes.
This file defines the following Objects and Classes: ::xowf::test_item::grading::Grading, ::xowf::test_item::grading::GradingRoundPoints, ::xowf::test_item::grading::GradingRoundPercentage, ::xowf::test_item::grading::GradingRoundNone, ::xowf::test_item::grading::GradingNone

Location:

packages/xowf/tcl/grading-procs.tcl
Author:

Gustaf Neumann

Procedures in this file

Class ::xowf::test_item::grading::Grading (public)
Class ::xowf::test_item::grading::GradingNone (public)
Class ::xowf::test_item::grading::GradingRoundNone (public)
Class ::xowf::test_item::grading::GradingRoundPercentage (public)
Class ::xowf::test_item::grading::GradingRoundPoints (public)
xowf::test_item::grading::Grading instproc calc_grade (protected)
xowf::test_item::grading::Grading instproc grading_dict (public)
xowf::test_item::grading::Grading instproc init (protected)
xowf::test_item::grading::Grading instproc print (public)
xowf::test_item::grading::GradingNone instproc grade (public)
xowf::test_item::grading::GradingRoundNone instproc grade (public)
xowf::test_item::grading::GradingRoundPercentage instproc grade (public)
xowf::test_item::grading::GradingRoundPoints instproc grade (public)
xowf::test_item::grading::flush_grading_schemes (private)
xowf::test_item::grading::grading_scheme_wf_item_id (private)
xowf::test_item::grading::load_grading_schemes (public)

Detailed information

Class ::xowf::test_item::grading::Grading (public)

 ::nx::Class ::xowf::test_item::grading::Grading

Superclass representing a generic grading

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

Class ::xowf::test_item::grading::GradingNone (public)

 ::nx::Class ::xowf::test_item::grading::GradingNone

Grading scheme, which omits grading at all.

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

Class ::xowf::test_item::grading::GradingRoundNone (public)

 ::nx::Class ::xowf::test_item::grading::GradingRoundNone

Implements a grading with no special rounding.

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

Class ::xowf::test_item::grading::GradingRoundPercentage (public)

 ::nx::Class ::xowf::test_item::grading::GradingRoundPercentage

Implements a grading expressed as a rounded percentage

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

Class ::xowf::test_item::grading::GradingRoundPoints (public)

 ::nx::Class ::xowf::test_item::grading::GradingRoundPoints

Implements a grading expressed as a rounded number of points

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::Grading method calc_grade (protected)

 <instance of xowf::test_item::grading::Grading> calc_grade \
    [ -percentage percentage ] [ -points points ] \
    [ -achievable_points achievable_points ]

Return a numeric grade for an exam submission based on percentage and the property "percentage_mapping". On invalid data, return 0. When "-percentage" is provided, use this for calculation Otherwise calculate percentage based on "-points" (which might be custom rounded) and "-achievable_points".

Switches:

-percentage
(optional)
-points
(optional)
-achievable_points
(optional)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::Grading method grading_dict (public)

 <instance of xowf::test_item::grading::Grading> grading_dict \
    achieved_points

Important dict members of "achieved_points": - achievedPoints: points that the student has achieved in her exam - achievablePoints: points that the student could have achieved so far - totalPoints: points that the student can achieve when finishing the exam achieved_points: {achievedPoints 4.0 achievablePoints 4 totalPoints 4} percentage_mapping: {50.0 60.0 70.0 80.0} While "achievedPoints" and "achievablePoints" are calculated by iterating over the submitted values, "totalPoints" contains the sum of points of all questions of the exam, no matter if these were answered or not.

Parameters:
achieved_points

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::Grading method init (protected)

 <instance of xowf::test_item::grading::Grading> init

Provide a default, self-descriptive title

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::Grading method print (public)

 <instance of xowf::test_item::grading::Grading> print \
    -achieved_points achieved_points

Return a dict containing the members "panel" and "csv" depending on the type of rounding options

Switches:

-achieved_points
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
create_test_items

xowf::test_item::grading::GradingNone method grade (public)

 <instance of xowf::test_item::grading::GradingNone> grade \
    -achieved_points achieved_points

No grading scheme defined, return grading 0.

Switches:

-achieved_points
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
create_test_items

xowf::test_item::grading::GradingRoundNone method grade (public)

 <instance of xowf::test_item::grading::GradingRoundNone> grade \
    -achieved_points achieved_points

Return a numeric grade for an exam submission based with no special rounding (2 digits). On invalid data, return 0.

Switches:

-achieved_points
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::GradingRoundPercentage method grade (public)

 <instance of xowf::test_item::grading::GradingRoundPercentage> grade \
    -achieved_points achieved_points

Return a numeric grade for an exam submission based on rounded percentage. On invalid data, return 0.

Switches:

-achieved_points
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::GradingRoundPoints method grade (public)

 <instance of xowf::test_item::grading::GradingRoundPoints> grade \
    -achieved_points achieved_points

Return a numeric grade for an exam submission based on rounded points. On invalid data, return 0.

Switches:

-achieved_points
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::flush_grading_schemes (private)

 xowf::test_item::grading::flush_grading_schemes -package_id package_id \
    -parent_id parent_id

Helper to hide the implementation details of the flushed cache. For now, we flush all grading schemes, but probably it would be sufficient to flush just a subset. The tricky part is that the grading objects are loaded potentially from the foll search hierarchy, starting with the local folder, reaching to the global objects. So, if anything is changed there, we would not notice immediately. Therefore, the passed-in package_id and parent_id are not used currently. This function is called, whenever a grading scheme is edited.

Switches:

-package_id
(required)
-parent_id
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::grading_scheme_wf_item_id (private)

 xowf::test_item::grading::grading_scheme_wf_item_id \
    -package_id package_id -parent_id parent_id

Return and cache the item_id of the edit-grading-scheme.wf. Maybe, we should generalize this function for other cases as well, therefore, we make this for the time being private.

Switches:

-package_id
(required)
-parent_id
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

xowf::test_item::grading::load_grading_schemes (public)

 xowf::test_item::grading::load_grading_schemes -package_id package_id \
    -parent_id parent_id

Load the actual grading scheme objects defined for the package_id and parent_id. It might be the case that this function is called multiple times by a single request (when e.g. multiple exams are on a single page). So we are caching the result to avoid repeated computations of the same result.

Switches:

-package_id
(required)
-parent_id
(required)

Partial Call Graph (max 5 caller/called nodes):

Testcases:
No testcase defined.

[ show source ]