Annotation of loncom/interface/lonquickgrades.pm, revision 1.60

1.1       bowersj2    1: # The LearningOnline Network with CAPA
                      2: # Quick Student Grades Display
                      3: #
1.60    ! raeburn     4: # $Id: lonquickgrades.pm,v 1.59 2010/12/04 15:02:31 www Exp $
1.1       bowersj2    5: #
                      6: # Copyright Michigan State University Board of Trustees
                      7: #
                      8: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      9: #
                     10: # LON-CAPA is free software; you can redistribute it and/or modify
                     11: # it under the terms of the GNU General Public License as published by
                     12: # the Free Software Foundation; either version 2 of the License, or
                     13: # (at your option) any later version.
                     14: #
                     15: # LON-CAPA is distributed in the hope that it will be useful,
                     16: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     17: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     18: # GNU General Public License for more details.
                     19: #
                     20: # You should have received a copy of the GNU General Public License
                     21: # along with LON-CAPA; if not, write to the Free Software
                     22: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     23: #
                     24: # /home/httpd/html/adm/gpl.txt
                     25: #
                     26: # http://www.lon-capa.org/
                     27: #
                     28: 
                     29: package Apache::lonquickgrades;
                     30: 
                     31: use strict;
                     32: use Apache::Constants qw(:common :http);
1.5       bowersj2   33: use POSIX;
1.25      www        34: use Apache::loncommon;
                     35: use Apache::lonlocal;
1.36      albertel   36: use Apache::lonnet;
1.38      bowersj2   37: use Apache::grades;
1.1       bowersj2   38: 
                     39: sub handler {
                     40:     my $r = shift;
1.5       bowersj2   41:     return real_handler($r);
                     42: }
                     43: 
                     44: sub real_handler {
                     45:     my $r = shift;
1.1       bowersj2   46: 
                     47:     &Apache::loncommon::get_unprocessed_cgi($ENV{QUERY_STRING});
                     48: 
                     49:     # Handle header-only request
1.40      albertel   50:     if ($env{'browser.mathml'}) {
                     51: 	&Apache::loncommon::content_type($r,'text/xml');
                     52:     } else {
                     53: 	&Apache::loncommon::content_type($r,'text/html');
                     54:     }
1.1       bowersj2   55:     if ($r->header_only) {
1.40      albertel   56: 	$r->send_http_header;
1.1       bowersj2   57:         return OK;
                     58:     }
                     59: 
                     60:     # Send header, don't cache this page
                     61:     &Apache::loncommon::no_cache($r);
                     62:     $r->send_http_header;
                     63: 
1.55      www        64:     my $showPoints =
1.36      albertel   65:         $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'standard';
1.55      www        66:     my $notshowSPRSlink =
1.49      www        67:         (($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'external')
                     68:       || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals'));
                     69:     my $notshowTotals=
                     70:         $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals';
1.50      www        71:     my $showCategories=
                     72:         $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories';
                     73: 
1.17      bowersj2   74: 
1.47      schafran   75:     my $title = "Grading and Statistics";#$showPoints ? "Points Display" : "Completed Problems Display";
1.46      raeburn    76:     my $brcrum = [{href=>"/adm/quickgrades",text => "Points Display"}];
                     77:     $r->print(&Apache::loncommon::start_page($title,undef,
                     78:                                             {'bread_crumbs' => $brcrum})
                     79:              );
1.1       bowersj2   80: 
1.55      www        81:     &startGradeScreen($r,'quick');
1.17      bowersj2   82: 
                     83:     $r->rflush();
1.53      www        84: 
1.54      www        85: #    my $uname='korte';
                     86: #    my $udom='gerd';
                     87: 
                     88:     my $uname;
                     89:     my $udom;
1.53      www        90: 
                     91:     my ($navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=
                     92:        &getData($showPoints,$uname,$udom);
                     93: 
                     94:     if ($showCategories) {
                     95:        &outputCategories($r,$showPoints,$notshowTotals,
                     96:                  $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
                     97:     } else {
                     98:        &outputTable($r,$showPoints,$notshowTotals,
1.51      www        99:                  $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
1.53      www       100:     }
1.55      www       101:     &endGradeScreen($r);
1.51      www       102:     return OK;
                    103: 
                    104: }
1.2       bowersj2  105: 
1.55      www       106: sub startGradeScreen {
                    107:     my ($r,$mode)=@_;
                    108: 
                    109:     my $showPoints =
                    110:         $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'standard';
                    111:     my $notshowSPRSlink =
                    112:         (($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'external')
                    113:       || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals')
                    114:       || ($env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories'));
                    115:     my $notshowTotals=
                    116:         $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'externalnototals';
                    117:     my $showCategories=
                    118:         $env{'course.'.$env{'request.course.id'}.'.grading'} eq 'categories';
                    119: 
                    120:     my $allowed_to_view =  &Apache::lonnet::allowed('vgr',$env{'request.course.id'});
                    121:     my $allowed_to_edit =  &Apache::lonnet::allowed('mgr',$env{'request.course.id'});
                    122: 
                    123:     if ($allowed_to_view) {
1.60    ! raeburn   124:        $r->print('<div class="LC_head_subbox">');
1.56      www       125:        if ($notshowTotals)  { $r->print ('&nbsp;'.&mt('Students do not see total points.').'&nbsp;'); }
                    126:        if ($notshowSPRSlink){ $r->print ('&nbsp;'.&mt('Students do not see link to spreadsheet.').'&nbsp;'); }
                    127:        if ($showPoints)     { $r->print ('&nbsp;'.&mt('Students will see points based on problem weights.').'&nbsp;'); }
                    128:        if ($showCategories) { $r->print ('&nbsp;'.&mt('Students will see points based on categories.').'&nbsp;'); }
                    129:        $r->print('&nbsp;'.&Apache::lonhtmlcommon::coursepreflink(&mt('Grade display settings'),'grading').'</div>');
1.55      www       130:     }
                    131: 
                    132: 
1.56      www       133:     $r->print("\n".'<ul class="LC_TabContentBigger" id="main">');
1.57      www       134:     $r->print("\n".'<li'.($mode eq 'quick'?' class="active"':'').'><a href="/adm/quickgrades"><b>&nbsp;&nbsp;&nbsp;&nbsp;'.
                    135:                                           ($showPoints?&mt('Points Overview'):($showCategories?&mt('Grades Overview'):&mt('Completion Overview'))).
                    136:                                           '&nbsp;&nbsp;&nbsp;&nbsp;</b></a></li>');
1.55      www       137: 
                    138:     if (!($showPoints || $notshowSPRSlink) || ($allowed_to_view)) {
1.56      www       139:        $r->print("\n".'<li'.($mode eq 'spreadsheet'?' class="active"':'').'><a href="/adm/'.($allowed_to_view?'classcalc':'studentcalc').'"><b>'.
1.57      www       140:                                                                  &mt('Spreadsheet (Detailed)').'</b></a></li>');
1.55      www       141:     }
1.58      www       142:     if ($allowed_to_view) {
                    143:        $r->print("\n".'<li'.($mode eq 'chart'?' class="active"':'').'><a href="/adm/statistics?reportSelected=student_assessment"><b>'.
                    144:                                                                  &mt('Assessment Overview Chart').'</b></a></li>');
                    145: 
                    146:     }
1.59      www       147:     if ($allowed_to_edit) {
                    148:        $r->print("\n".'<li'.($mode eq 'grading'?' class="active"':'').'><a href="/adm/grades"><b>&nbsp;&nbsp;&nbsp;&nbsp;'.
                    149:                                                                  &mt('Problem Grading').'&nbsp;&nbsp;&nbsp;&nbsp;</b></a></li>');
                    150:     }
1.56      www       151:     $r->print("\n".'</ul>'."\n");
1.55      www       152:     $r->print('<div class="LC_Box" style="clear:both;margin:0;"><div id="maincoursedoc" style="margin:0 0;padding:0 0;"><div class="LC_ContentBox" id="mainCourseDocuments" style="display: block;">');
                    153: }
                    154: 
                    155: sub endGradeScreen {
                    156:    my ($r)=@_;
                    157:    $r->print('</div></div></div>');
                    158: }
                    159: 
                    160: 
1.51      www       161: sub getData {
                    162: 
1.53      www       163:     my ($showPoints,$uname,$udom)=@_;
                    164: 
                    165:     &Apache::lonnet::logthis("About to call with $uname $udom");
1.51      www       166: 
                    167:     # Create the nav map
1.53      www       168:     my $navmap = Apache::lonnavmaps::navmap->new($uname,$udom);
1.51      www       169: 
                    170:     my $res = $navmap->firstResource(); # temp resource to access constants
1.1       bowersj2  171: 
                    172:     my $iterator = $navmap->getIterator(undef, undef, undef, 1);
                    173:     my $depth = 1;
                    174:     $iterator->next(); # ignore first BEGIN_MAP
                    175:     my $curRes = $iterator->next();
1.4       bowersj2  176:     
1.5       bowersj2  177:     # General overview of the following: Walk along the course resources.
                    178:     # For every problem in the resource, tell its parent maps how many
                    179:     # parts and how many parts correct it has. After that, each map will
                    180:     # have a count of the total parts underneath it, correct and otherwise.
                    181:     # After that, we will walk through the course again and read off
                    182:     # maps in order, with their data. 
                    183:     # (If in the future people decide not to be cumulative, only add
                    184:     #  the counts to the parent map.)
1.17      bowersj2  185:     # For convenience, "totalParts" is also "totalPoints" when we're looking
                    186:     #  at points; I can't come up with a variable name that makes sense
                    187:     #  equally for both cases.
1.5       bowersj2  188: 
                    189:     my $totalParts = 0; my $totalPossible = 0; my $totalRight = 0;
1.28      bowersj2  190:     my $totalAttempted = 0;
1.14      bowersj2  191:     my $now = time();
1.28      bowersj2  192:     my $topLevelParts = 0; my $topLevelRight = 0; my $topLevelAttempted = 0;
1.5       bowersj2  193: 
                    194:     # Pre-run: Count parts correct
1.1       bowersj2  195:     while ( $depth > 0 ) {
                    196:         if ($curRes == $iterator->BEGIN_MAP()) {$depth++;}
                    197:         if ($curRes == $iterator->END_MAP()) { $depth--; }
                    198: 
1.7       bowersj2  199:         if (ref($curRes) && $curRes->is_problem() && !$curRes->randomout)
1.5       bowersj2  200:         {
                    201:             # Get number of correct, incorrect parts
                    202:             my $parts = $curRes->parts();
                    203:             my $partsRight = 0;
1.17      bowersj2  204: 	    my $partsCount = 0;
1.28      bowersj2  205: 	    my $partsAttempted = 0;
1.5       bowersj2  206:             my $stack = $iterator->getStack();
                    207:             
                    208:             for my $part (@{$parts}) {
1.28      bowersj2  209: 		my $completionStatus = $curRes->getCompletionStatus($part);
                    210: 		my $dateStatus = $curRes->getDateStatus($part);
                    211: 		
                    212:                 if ($completionStatus == $curRes->EXCUSED()) {
1.21      matthew   213:                     next;
                    214:                 }
1.17      bowersj2  215: 		if ($showPoints) {
1.28      bowersj2  216: 		    my $score = 0;
                    217: 		    # If we're not telling status and the answer date isn't passed yet, 
                    218: 		    # it's an "attempted" point
1.42      raeburn   219: 		    if ((($curRes->problemstatus($part) eq 'no') ||
                    220:                         ($curRes->problemstatus($part) eq 'no_feedback_ever')) &&
1.28      bowersj2  221: 			($dateStatus != $curRes->ANSWER_OPEN)) {
1.31      albertel  222: 			my $status = $curRes->simpleStatus($part);
                    223: 			if ($status == $curRes->ATTEMPTED) {
                    224: 			    $partsAttempted += $curRes->weight($part);
                    225: 			    $totalAttempted += $partsAttempted;
                    226: 			}
1.28      bowersj2  227: 		    } else {
1.39      albertel  228: 			$score = &Apache::grades::compute_points($curRes->weight($part), $curRes->awarded($part));
1.28      bowersj2  229: 		    }
1.17      bowersj2  230: 		    $partsRight += $score;
                    231: 		    $totalRight += $score;
1.19      bowersj2  232: 		    $partsCount += $curRes->weight($part);
1.18      bowersj2  233: 
1.17      bowersj2  234: 		    if ($curRes->opendate($part) < $now) {
1.20      bowersj2  235: 			$totalPossible += $curRes->weight($part);
1.17      bowersj2  236: 		    }
1.19      bowersj2  237: 		    $totalParts += $curRes->weight($part);
1.17      bowersj2  238: 		} else {
1.27      bowersj2  239: 		    my $status = $curRes->simpleStatus($part);
1.17      bowersj2  240: 		    my $thisright = 0;
                    241: 		    $partsCount++;
1.37      albertel  242: 		    if ($status == $curRes->CORRECT ||
                    243: 			$status == $curRes->PARTIALLY_CORRECT ) {
1.17      bowersj2  244: 			$partsRight++;
                    245: 			$totalRight++;
                    246: 			$thisright = 1;
                    247: 		    }
1.28      bowersj2  248: 
                    249: 		    if ($status == $curRes->ATTEMPTED) {
                    250: 			$partsAttempted++;
                    251: 			$totalAttempted++;
                    252: 		    }
1.17      bowersj2  253: 		    
                    254: 		    my $dateStatus = $curRes->getDateStatus($part);
1.19      bowersj2  255: 		    $totalParts++;
1.17      bowersj2  256: 		    if ($curRes->opendate($part) < $now) {
                    257: 			$totalPossible++;
                    258: 		    }
                    259: 		}
1.5       bowersj2  260:             }
1.15      bowersj2  261: 
                    262:             if ($depth == 1) { # in top-level only
1.19      bowersj2  263: 		$topLevelParts += $partsCount;
1.15      bowersj2  264: 		$topLevelRight += $partsRight;
1.28      bowersj2  265: 		$topLevelAttempted += $partsAttempted;
1.15      bowersj2  266: 	    }
                    267: 
1.5       bowersj2  268:             # Crawl down stack and record parts correct and total
                    269:             for my $res (@{$stack}) {
                    270:                 if (ref($res) && $res->is_map()) {
                    271:                     if (!defined($res->{DATA}->{CHILD_PARTS})) {
                    272:                         $res->{DATA}->{CHILD_PARTS} = 0;
                    273:                         $res->{DATA}->{CHILD_CORRECT} = 0;
1.28      bowersj2  274: 			$res->{DATA}->{CHILD_ATTEMPTED} = 0;
1.5       bowersj2  275:                     }
                    276:                     
1.17      bowersj2  277:                     $res->{DATA}->{CHILD_PARTS} += $partsCount;
1.5       bowersj2  278:                     $res->{DATA}->{CHILD_CORRECT} += $partsRight;
1.28      bowersj2  279: 		    $res->{DATA}->{CHILD_ATTEMPTED} += $partsAttempted;
1.5       bowersj2  280:                 }
                    281:             }
                    282:         }
                    283:         $curRes = $iterator->next();
                    284:     }
1.51      www       285:     return ($navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted);
                    286: }
                    287: 
                    288: #
                    289: # Outputting everything.
                    290: #
                    291: 
                    292: sub outputTable {
1.5       bowersj2  293: 
1.51      www       294:     my ($r,$showPoints,$notshowTotals,
                    295:            $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=@_;
1.5       bowersj2  296: 
1.7       bowersj2  297:     my @start = (255, 255, 192);
1.5       bowersj2  298:     my @end   = (0, 192, 0);
                    299: 
                    300:     my $indentString = '&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;';
                    301: 
                    302:     # Second pass: Print the maps.
1.43      bisitz    303:     $r->print(&Apache::loncommon::start_data_table()
                    304:              .&Apache::loncommon::start_data_table_header_row()
                    305:              .'<th>'.&mt('Folder').'</th>');
1.51      www       306:     my $title = &mt($showPoints ? "Points Scored" : "Done");
1.28      bowersj2  307:     if ($totalAttempted) {
1.51      www       308:         $title .= " / " . &mt("Attempted");
1.28      bowersj2  309:     }
1.49      www       310:     $r->print("<th>$title".($notshowTotals?'':" / ".&mt('Total')).'</th>'
1.43      bisitz    311:              .&Apache::loncommon::end_data_table_header_row());
1.51      www       312: #
                    313: # Output of folder scores
                    314: #
                    315: 
                    316:     my $iterator = $navmap->getIterator(undef, undef, undef, 1);
                    317:     my $depth = 1;
                    318:     $iterator->next(); # ignore first BEGIN_MAP
                    319:     my $curRes = $iterator->next();
                    320: 
1.5       bowersj2  321:     while ($depth > 0) {
                    322:         if ($curRes == $iterator->BEGIN_MAP()) {$depth++;}
                    323:         if ($curRes == $iterator->END_MAP()) { $depth--; }
                    324: 
                    325:         if (ref($curRes) && $curRes->is_map()) {
                    326:             my $title = $curRes->compTitle();
                    327:             
                    328:             my $correct = $curRes->{DATA}->{CHILD_CORRECT};
                    329:             my $total = $curRes->{DATA}->{CHILD_PARTS};
1.28      bowersj2  330: 	    my $attempted = $curRes->{DATA}->{CHILD_ATTEMPTED};
1.5       bowersj2  331: 
1.6       bowersj2  332:             if ($total > 0) {
                    333:                 my $ratio;
                    334:                 $ratio = $correct / $total;
1.51      www       335:                 my $color = &mixColors(\@start, \@end, $ratio);
1.43      bisitz    336:                 $r->print(&Apache::loncommon::start_data_table_row()
                    337:                          .'<td style="background-color:'.$color.';">');
1.6       bowersj2  338:                 
1.15      bowersj2  339: 		my $thisIndent = '';
                    340:                 for (my $i = 1; $i < $depth; $i++) { $thisIndent .= $indentString; }
1.6       bowersj2  341:                 
1.15      bowersj2  342:                 $r->print("$thisIndent$title</td>");
1.28      bowersj2  343: 		if ($totalAttempted) {
1.45      bisitz    344: 		    $r->print('<td valign="top">'
                    345:                              .$thisIndent
                    346:                              .'<span class="LC_nobreak">'
1.49      www       347:                              .$correct.' / '.$attempted.($notshowTotals?'':' / '.$total)
1.45      bisitz    348:                              .'</span></td>'
                    349:                              .&Apache::loncommon::end_data_table_row()
                    350:                     );
1.28      bowersj2  351: 		} else {
1.45      bisitz    352: 		    $r->print('<td valign="top">'
                    353:                              .$thisIndent
                    354:                              .'<span class="LC_nobreak">'
1.49      www       355:                              .$correct.($notshowTotals?'':' / '.$total)
1.45      bisitz    356:                              .'</span></td>'
1.43      bisitz    357:                              .&Apache::loncommon::end_data_table_row());
1.28      bowersj2  358: 		}
1.6       bowersj2  359:             }
1.5       bowersj2  360:         }
1.4       bowersj2  361: 
1.5       bowersj2  362:         $curRes = $iterator->next();
                    363:     }
1.4       bowersj2  364: 
1.6       bowersj2  365:     # If there were any problems at the top level, print an extra "catchall"
1.15      bowersj2  366:     if ($topLevelParts > 0) {
                    367:         my $ratio = $topLevelRight / $topLevelParts;
1.6       bowersj2  368:         my $color = mixColors(\@start, \@end, $ratio);
1.43      bisitz    369:         $r->print(&Apache::loncommon::start_data_table_row()
                    370:                  .'<td style="background-color:'.$color.';">');
1.25      www       371:         $r->print(&mt("Problems Not Contained In A Folder")."</td><td>");
1.43      bisitz    372:         $r->print("$topLevelRight / $topLevelParts</td>"
                    373:                  .&Apache::loncommon::end_data_table_row());
1.6       bowersj2  374:     }
1.4       bowersj2  375: 
1.51      www       376: #
                    377: # show totals (if applicable), close table
                    378: #
1.35      albertel  379:     if ($showPoints) {
1.51      www       380:         my $maxHelpLink = Apache::loncommon::help_open_topic("Quick_Grades_Possibly_Correct");
1.2       bowersj2  381: 
1.51      www       382:         $title = $showPoints ? "Points" : "Parts Done";
                    383:         my $totaltitle = $showPoints ? &mt("Awarded Total Points") : &mt("Total Parts Done");
                    384:         $r->print(&Apache::loncommon::start_data_table_row()
1.48      bisitz    385:                  .'<td colspan="2" align="right">'.$totaltitle.': <b>'.$totalRight.'</b><br />');
1.51      www       386:         $r->print(&mt('Max Possible To Date')." $maxHelpLink: <b>$totalPossible</b><br />");
                    387:         $title = $showPoints ? "Points" : "Parts";
                    388:         $r->print(&mt("Total $title In Course").': <b>'.$totalParts.'</b></td>'
1.43      bisitz    389:                  .&Apache::loncommon::end_data_table_row());
1.34      www       390:     }
1.1       bowersj2  391: 
1.43      bisitz    392:     $r->print(&Apache::loncommon::end_data_table()
                    393:              .&Apache::loncommon::end_page());
1.1       bowersj2  394: 
1.5       bowersj2  395: }
                    396: 
1.53      www       397: #
                    398: # Outputting category-based grades.
                    399: #
                    400: 
                    401: sub outputCategories {
                    402: 
                    403:     my ($r,$showPoints,$notshowTotals,
                    404:            $navmap,$totalParts,$totalPossible,$totalRight,$totalAttempted,$topLevelParts,$topLevelRight,$topLevelAttempted)=@_;
                    405: }
                    406: 
1.5       bowersj2  407: # Pass this two refs to arrays for the start and end color, and a number
                    408: # from 0 to 1 for how much of the latter you want to mix in. It will
                    409: # return a string ready to show ("#FFC309");
1.51      www       410: 
1.5       bowersj2  411: sub mixColors {
                    412:     my $start = shift;
                    413:     my $end = shift;
                    414:     my $ratio = shift;
                    415:     
1.9       matthew   416:     my ($a,$b);
1.5       bowersj2  417:     my $final = "";
1.9       matthew   418:     $a = $start->[0]; $b = $end->[0];
1.5       bowersj2  419:     my $mix1 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
1.9       matthew   420:     $a = $start->[1]; $b = $end->[1];
1.5       bowersj2  421:     my $mix2 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
1.9       matthew   422:     $a = $start->[2]; $b = $end->[2];
1.5       bowersj2  423:     my $mix3 = POSIX::floor((1-$ratio)*$a + $ratio*$b);
                    424: 
1.16      bowersj2  425:     $final = sprintf "%02x%02x%02x", $mix1, $mix2, $mix3;
1.5       bowersj2  426:     return "#" . $final;
1.1       bowersj2  427: }
                    428: 
                    429: 1;

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>