268 lines
13 KiB
HTML
268 lines
13 KiB
HTML
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>Course Grading — edX Data 0.1 documentation</title>
|
|
|
|
<link rel="stylesheet" href="../_static/sphinxdoc.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: '../',
|
|
VERSION: '0.1',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="../_static/jquery.js"></script>
|
|
<script type="text/javascript" src="../_static/underscore.js"></script>
|
|
<script type="text/javascript" src="../_static/doctools.js"></script>
|
|
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
|
|
<link rel="top" title="edX Data 0.1 documentation" href="../index.html" />
|
|
<link rel="next" title="XML format of drag and drop input [inputtypes]" href="drag_and_drop/drag_and_drop_input.html" />
|
|
<link rel="prev" title="Course XML Tutorial" href="course_xml.html" />
|
|
</head>
|
|
<body>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="../genindex.html" title="General Index"
|
|
accesskey="I">index</a></li>
|
|
<li class="right" >
|
|
<a href="../py-modindex.html" title="Python Module Index"
|
|
>modules</a> |</li>
|
|
<li class="right" >
|
|
<a href="drag_and_drop/drag_and_drop_input.html" title="XML format of drag and drop input [inputtypes]"
|
|
accesskey="N">next</a> |</li>
|
|
<li class="right" >
|
|
<a href="course_xml.html" title="Course XML Tutorial"
|
|
accesskey="P">previous</a> |</li>
|
|
<li><a href="../index.html">edX Data 0.1 documentation</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="sphinxsidebar">
|
|
<div class="sphinxsidebarwrapper">
|
|
<h3><a href="../index.html">Table Of Contents</a></h3>
|
|
<ul>
|
|
<li><a class="reference internal" href="#">Course Grading</a><ul>
|
|
<li><a class="reference internal" href="#totaling-sections">Totaling sections</a></li>
|
|
<li><a class="reference internal" href="#weighting-problems">Weighting Problems</a></li>
|
|
<li><a class="reference internal" href="#weighting-sections">Weighting Sections</a><ul>
|
|
<li><a class="reference internal" href="#section-format-graders">Section Format Graders</a></li>
|
|
<li><a class="reference internal" href="#single-section-graders">Single Section Graders</a></li>
|
|
<li><a class="reference internal" href="#combining-sub-graders">Combining sub-graders</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a class="reference internal" href="#displaying-the-final-grade">Displaying the final grade</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<h4>Previous topic</h4>
|
|
<p class="topless"><a href="course_xml.html"
|
|
title="previous chapter">Course XML Tutorial</a></p>
|
|
<h4>Next topic</h4>
|
|
<p class="topless"><a href="drag_and_drop/drag_and_drop_input.html"
|
|
title="next chapter">XML format of drag and drop input [inputtypes]</a></p>
|
|
<h3>This Page</h3>
|
|
<ul class="this-page-menu">
|
|
<li><a href="../_sources/course_data_formats/grading.txt"
|
|
rel="nofollow">Show Source</a></li>
|
|
</ul>
|
|
<div id="searchbox" style="display: none">
|
|
<h3>Quick search</h3>
|
|
<form class="search" action="../search.html" method="get">
|
|
<input type="text" name="q" />
|
|
<input type="submit" value="Go" />
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
<p class="searchtip" style="font-size: 90%">
|
|
Enter search terms or a module, class or function name.
|
|
</p>
|
|
</div>
|
|
<script type="text/javascript">$('#searchbox').show(0);</script>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="document">
|
|
<div class="documentwrapper">
|
|
<div class="bodywrapper">
|
|
<div class="body">
|
|
|
|
<div class="section" id="course-grading">
|
|
<h1>Course Grading<a class="headerlink" href="#course-grading" title="Permalink to this headline">¶</a></h1>
|
|
<p>This document is written to help professors understand how a final grade for a
|
|
course is computed.</p>
|
|
<p>Course grading is the process of taking all of the problems scores for a student
|
|
in a course and generating a final score (and corresponding letter grade). This
|
|
grading process can be split into two phases - totaling sections and section
|
|
weighting.</p>
|
|
<div class="section" id="totaling-sections">
|
|
<h2>Totaling sections<a class="headerlink" href="#totaling-sections" title="Permalink to this headline">¶</a></h2>
|
|
<p>The process of totaling sections is to get a percentage score (between 0.0 and
|
|
1.0) for every section in the course. A section is any module that is a direct
|
|
child of a chapter. For example, psets, labs, and sequences are all common
|
|
sections. Only the <em>percentage</em> on the section will be available to compute the
|
|
final grade, <em>not</em> the final number of points earned / possible.</p>
|
|
<div class="admonition important">
|
|
<p class="first admonition-title">Important</p>
|
|
<p class="last">For a section to be included in the final grade, the policies file must set
|
|
<cite>graded = True</cite> for the section.</p>
|
|
</div>
|
|
<p>For each section, the grading function retrieves all problems within the
|
|
section. The section percentage is computed as (total points earned) / (total
|
|
points possible).</p>
|
|
</div>
|
|
<div class="section" id="weighting-problems">
|
|
<h2>Weighting Problems<a class="headerlink" href="#weighting-problems" title="Permalink to this headline">¶</a></h2>
|
|
<p>In some cases, one might want to give weights to problems within a section. For
|
|
example, a final exam might contain four questions each worth 1 point by default.
|
|
This means each question would by default have the same weight. If one wanted
|
|
the first problem to be worth 50% of the final exam, the policy file could specify
|
|
weights of 30, 10, 10, and 10 to the four problems, respectively.</p>
|
|
<p>Note that the default weight of a problem <strong>is not 1</strong>. The default weight of a
|
|
problem is the module’s <cite>max_grade</cite>.</p>
|
|
<p>If weighting is set, each problem is worth the number of points assigned, regardless of the number of responses it contains.</p>
|
|
<p>Consider a Homework section that contains two problems.</p>
|
|
<div class="highlight-xml"><pre><problem display_name=”Problem 1”>
|
|
<numericalresponse> ... </numericalreponse>
|
|
</problem></pre>
|
|
</div>
|
|
<div class="highlight-xml"><pre><problem display_name=”Problem 2”>
|
|
<numericalresponse> ... </numericalreponse>
|
|
<numericalresponse> ... </numericalreponse>
|
|
<numericalresponse> ... </numericalreponse>
|
|
</problem></pre>
|
|
</div>
|
|
<p>Without weighting, Problem 1 is worth 25% of the assignment, and Problem 2 is worth 75% of the assignment.</p>
|
|
<p>Weighting for the problems can be set in the policy.json file.</p>
|
|
<div class="highlight-json"><pre>"problem/problem1": {
|
|
"weight": 2
|
|
},
|
|
"problem/problem2": {
|
|
"weight": 2
|
|
},</pre>
|
|
</div>
|
|
<p>With the above weighting, Problems 1 and 2 are each worth 50% of the assignment.</p>
|
|
<p>Please note: When problems have weight, the point value is automatically included in the display name <em>except</em> when <cite>“weight”: 1</cite>. When the weight is 1, no visual change occurs in the display name, leaving the point value open to interpretation to the student.</p>
|
|
</div>
|
|
<div class="section" id="weighting-sections">
|
|
<h2>Weighting Sections<a class="headerlink" href="#weighting-sections" title="Permalink to this headline">¶</a></h2>
|
|
<p>Once each section has a percentage score, we must total those sections into a
|
|
final grade. Of course, not every section has equal weight in the final grade.
|
|
The policies for weighting sections into a final grade are specified in the
|
|
grading_policy.json file.</p>
|
|
<p>The <cite>grading_policy.json</cite> file specifies several sub-graders that are each given
|
|
a weight and factored into the final grade. There are currently two types of
|
|
sub-graders, section format graders and single section graders.</p>
|
|
<p>We will use this simple example of a grader with one section format grader and
|
|
one single section grader.</p>
|
|
<div class="highlight-json"><pre>"GRADER" : [
|
|
{
|
|
"type" : "Homework",
|
|
"min_count" : 12,
|
|
"drop_count" : 2,
|
|
"short_label" : "HW",
|
|
"weight" : 0.4
|
|
},
|
|
{
|
|
"type" : "Final",
|
|
"name" : "Final Exam",
|
|
"short_label" : "Final",
|
|
"weight" : 0.6
|
|
}
|
|
]</pre>
|
|
</div>
|
|
<div class="section" id="section-format-graders">
|
|
<h3>Section Format Graders<a class="headerlink" href="#section-format-graders" title="Permalink to this headline">¶</a></h3>
|
|
<p>A section format grader grades a set of sections with the same format, as
|
|
defined in the course policy file. To make a vertical named Homework1 be graded
|
|
by the Homework section format grader, the following definition would be in the
|
|
course policy file.</p>
|
|
<div class="highlight-json"><pre>"vertical/Homework1": {
|
|
"display_name": "Homework 1",
|
|
"graded": true,
|
|
"format": "Homework"
|
|
},</pre>
|
|
</div>
|
|
<p>In the example above, the section format grader declares that it will expect to
|
|
find at least 12 sections with the format “Homework”. It will drop the lowest 2.
|
|
All of the homework assignments will have equal weight, relative to each other
|
|
(except, of course, for the assignments that are dropped).</p>
|
|
<p>This format supports forecasting the number of homework assignments. For
|
|
example, if the course only has 3 homeworks written, but the section format
|
|
grader has been told to expect 12, the missing 9 will have an assumed 0% and
|
|
will still show up in the grade breakdown.</p>
|
|
<p>A section format grader will also show the average of that section in the grade
|
|
breakdown (shown on the Progress page, gradebook, etc.).</p>
|
|
</div>
|
|
<div class="section" id="single-section-graders">
|
|
<h3>Single Section Graders<a class="headerlink" href="#single-section-graders" title="Permalink to this headline">¶</a></h3>
|
|
<p>A single section grader grades exactly that - a single section. If a section
|
|
is found with a matching format and display name then the score of that section
|
|
is used. If not, a score of 0% is assumed.</p>
|
|
</div>
|
|
<div class="section" id="combining-sub-graders">
|
|
<h3>Combining sub-graders<a class="headerlink" href="#combining-sub-graders" title="Permalink to this headline">¶</a></h3>
|
|
<p>The final grade is computed by taking the score and weight of each sub grader.
|
|
In the above example, homework will be 40% of the final grade. The final exam
|
|
will be 60% of the final grade.</p>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="displaying-the-final-grade">
|
|
<h2>Displaying the final grade<a class="headerlink" href="#displaying-the-final-grade" title="Permalink to this headline">¶</a></h2>
|
|
<p>The final grade is then rounded up to the nearest percentage point. This is so
|
|
the system can consistently display a percentage without worrying whether the
|
|
displayed percentage has been rounded up or down (potentially misleading the
|
|
student). The formula for the rounding is:</p>
|
|
<div class="highlight-python"><div class="highlight"><pre><span class="n">rounded_percent</span> <span class="o">=</span> <span class="nb">round</span><span class="p">(</span><span class="n">computed_percent</span> <span class="o">*</span> <span class="mi">100</span> <span class="o">+</span> <span class="mf">0.05</span><span class="p">)</span> <span class="o">/</span> <span class="mi">100</span>
|
|
</pre></div>
|
|
</div>
|
|
<p>The grading policy file also specifies the cutoffs for the grade levels. A
|
|
grade is either A, B, or C. If the student does not reach the cutoff threshold
|
|
for a C grade then the student has not earned a grade and will not be eligible
|
|
for a certificate. Letter grades are only awarded to students who have
|
|
completed the course. There is no notion of a failing letter grade.</p>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div class="clearer"></div>
|
|
</div>
|
|
<div class="related">
|
|
<h3>Navigation</h3>
|
|
<ul>
|
|
<li class="right" style="margin-right: 10px">
|
|
<a href="../genindex.html" title="General Index"
|
|
>index</a></li>
|
|
<li class="right" >
|
|
<a href="../py-modindex.html" title="Python Module Index"
|
|
>modules</a> |</li>
|
|
<li class="right" >
|
|
<a href="drag_and_drop/drag_and_drop_input.html" title="XML format of drag and drop input [inputtypes]"
|
|
>next</a> |</li>
|
|
<li class="right" >
|
|
<a href="course_xml.html" title="Course XML Tutorial"
|
|
>previous</a> |</li>
|
|
<li><a href="../index.html">edX Data 0.1 documentation</a> »</li>
|
|
</ul>
|
|
</div>
|
|
<div class="footer">
|
|
© Copyright 2013, edX Team.
|
|
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
|
|
</div>
|
|
</body>
|
|
</html> |