Annotation of loncom/interface/statistics/lonsubmissiontimeanalysis.pm, revision 1.18

1.1       matthew     1: # The LearningOnline Network with CAPA
                      2: #
1.18    ! matthew     3: # $Id: lonsubmissiontimeanalysis.pm,v 1.17 2004/07/06 16:01:48 matthew Exp $
1.1       matthew     4: #
                      5: # Copyright Michigan State University Board of Trustees
                      6: #
                      7: # This file is part of the LearningOnline Network with CAPA (LON-CAPA).
                      8: #
                      9: # LON-CAPA is free software; you can redistribute it and/or modify
                     10: # it under the terms of the GNU General Public License as published by
                     11: # the Free Software Foundation; either version 2 of the License, or
                     12: # (at your option) any later version.
                     13: #
                     14: # LON-CAPA is distributed in the hope that it will be useful,
                     15: # but WITHOUT ANY WARRANTY; without even the implied warranty of
                     16: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                     17: # GNU General Public License for more details.
                     18: #
                     19: # You should have received a copy of the GNU General Public License
                     20: # along with LON-CAPA; if not, write to the Free Software
                     21: # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
                     22: #
                     23: # /home/httpd/html/adm/gpl.txt
                     24: #
                     25: # http://www.lon-capa.org/
                     26: #
                     27: 
                     28: package Apache::lonsubmissiontimeanalysis;
                     29: 
                     30: use strict;
                     31: use Apache::lonnet();
                     32: use Apache::loncommon();
                     33: use Apache::lonhtmlcommon();
                     34: use Apache::loncoursedata();
                     35: use Apache::lonstatistics;
1.10      matthew    36: use Apache::lonstathelpers;
1.1       matthew    37: use Apache::lonlocal;
                     38: use HTML::Entities();
                     39: use Time::Local();
                     40: use Spreadsheet::WriteExcel();
                     41: 
                     42: my $plotcolors = ['#33ff00', 
                     43:                   '#ff33cc', '#990000', '#aaaa66', '#663399', '#ff9933',
                     44:                   '#66ccff', '#ff9999', '#cccc33', '#660000', '#33cc66',
                     45:                   ]; 
                     46: 
                     47: my @SubmitButtons = (
1.11      matthew    48:                      { name => 'PrevProblemAnalysis',
                     49:                        text => 'Previous Problem' },
                     50:                      { name => 'ProblemAnalysis',
1.1       matthew    51:                        text => 'Analyze Problem Again' },
1.11      matthew    52:                      { name => 'NextProblemAnalysis',
                     53:                        text => 'Next Problem' },
1.1       matthew    54:                      { name => 'SelectAnother',
1.11      matthew    55:                        text => 'Choose a different Problem' },
1.1       matthew    56:                      );
                     57: 
                     58: sub BuildSubmissionTimePage {
                     59:     my ($r,$c)=@_;
1.4       matthew    60:     #
                     61:     my %Saveable_Parameters = ('Status' => 'scalar',
                     62:                                'Section' => 'array');
                     63:     &Apache::loncommon::store_course_settings('submissiontime_analysis',
                     64:                                               \%Saveable_Parameters);
                     65:     &Apache::loncommon::restore_course_settings('submissiontime_analysis',
                     66:                                                 \%Saveable_Parameters);
                     67:     #
                     68:     &Apache::lonstatistics::PrepareClasslist();    
                     69:     #
1.1       matthew    70:     $r->print(&CreateInterface());
                     71:     #
                     72:     my @Students = @Apache::lonstatistics::Students;
                     73:     #
                     74:     if (@Students < 1) {
                     75:         $r->print('<h2>There are no students in the sections selected</h2>');
                     76:     }
                     77:     #
1.15      matthew    78:     my @CacheButtonHTML = 
                     79:         &Apache::lonstathelpers::manage_caches($r,'Statistics','stats_status');
1.1       matthew    80:     $r->rflush();
                     81:     #
                     82:     if (! exists($ENV{'form.problemchoice'}) ||
                     83:         exists($ENV{'form.SelectAnother'})) {
                     84:         $r->print('<input type="submit" name="" value="'.
                     85:                   &mt('Graph Problem Submission Times').'" />');
                     86:         $r->print('&nbsp;'x5);
                     87:         $r->print('<h3>'.&mt('Please select a problem to analyze').'</h3>');
1.18    ! matthew    88:         $r->print(&Apache::lonstathelpers::problem_selector('.'));
1.1       matthew    89:     } else {
                     90:         foreach my $button (@SubmitButtons) {
                     91:             $r->print('<input type="submit" name="'.$button->{'name'}.'" '.
                     92:                       'value="'.&mt($button->{'text'}).'" />');
                     93:             $r->print('&nbsp;'x5);
                     94:         }
1.15      matthew    95:         foreach my $html (@CacheButtonHTML) {
                     96:             $r->print($html.('&nbsp;'x5));
                     97:         }
                     98:         $r->rflush();
1.11      matthew    99:         #
                    100:         # Determine which problem we are to analyze
                    101:         my $current_problem = &Apache::lonstathelpers::get_target_from_id
                    102:             ($ENV{'form.problemchoice'});
                    103:         #
1.18    ! matthew   104:         my ($navmap,$prev,$curr,$next) = 
1.11      matthew   105:             &Apache::lonstathelpers::get_prev_curr_next($current_problem,
                    106:                                                         '.',
                    107:                                                         'part');
                    108:         if (exists($ENV{'form.PrevProblemAnalysis'}) && defined($prev)) {
                    109:             $current_problem = $prev;
                    110:         } elsif (exists($ENV{'form.NextProblemAnalysis'}) && defined($next)) {
                    111:             $current_problem = $next;
                    112:         } else {
                    113:             $current_problem = $curr;
                    114:         }
                    115:         #
                    116:         # Store the current problem choice and send it out in the form
                    117:         $ENV{'form.problemchoice'} = 
                    118:             &Apache::lonstathelpers::make_target_id($current_problem);
1.1       matthew   119:         $r->print('<input type="hidden" name="problemchoice" value="'.
                    120:                   $ENV{'form.problemchoice'}.'" />');
                    121:         #
                    122:         $r->print('<hr />');
                    123:         $r->rflush();
                    124:         #
1.11      matthew   125:         my $resource = $current_problem->{'resource'};
1.1       matthew   126:         if (! defined($resource)) {
                    127:             $r->print('resource is undefined');
                    128:         } else {
1.18    ! matthew   129:             $r->print('<h1>'.$resource->compTitle.'</h1>');
        !           130:             $r->print('<h3>'.$resource->src.'</h3>');
1.1       matthew   131:             $r->rflush();
1.10      matthew   132:             $r->print(&Apache::lonstathelpers::render_resource($resource));
1.15      matthew   133:             $r->print('<br />');
1.1       matthew   134:             $r->rflush();
1.18    ! matthew   135:             $r->print(&analyze_times($r,$resource->symb,\@Students,
1.11      matthew   136:                                      $current_problem->{'part'}));
1.1       matthew   137:         }
                    138:         $r->print('<hr />');
                    139:     }
                    140: }
                    141: 
                    142: #########################################################
                    143: #########################################################
                    144: ##
                    145: ##                  Time Analysis
                    146: ##
                    147: #########################################################
                    148: #########################################################
                    149: sub get_week_start {
                    150:     my ($randomtime) = @_;
                    151:     my ($sec,$min,$hour,$mday,$month,$year,$wday,$yday,$isdst) = 
                    152:         localtime($randomtime);
                    153:     $randomtime -= $wday * 86400;
                    154:     ($sec,$min,$hour,$mday,$month,$year,$wday,$yday,$isdst) = 
                    155:         localtime($randomtime);
                    156:     my $week_start = &Time::Local::timelocal(0,0,0,$mday,$month,$year);
                    157:     return $week_start;
                    158: }
                    159: 
                    160: sub analyze_times {
1.18    ! matthew   161:     my ($r,$symb,$students,$part) = @_;
1.16      matthew   162:     my $htmltable;
1.2       matthew   163:     #
                    164:     # Convenience arrays
                    165:     my @FullWeekDay = (qw/Sunday Monday Tuesday Wednesday Thursday Friday
                    166:                        Saturday/);
                    167:     my @WeekDay = (qw/SUN MON TUE WED THU FRI SAT SUN/);
                    168:     my @Month = (qw/Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec/);
                    169:     #
1.1       matthew   170:     my $html; # holds results of analysis
                    171:     # Get the data
                    172:     my $SubData = &Apache::loncoursedata::get_response_time_data
1.18    ! matthew   173:         (\@Apache::lonstatistics::SelectedSections,
        !           174:          $Apache::lonstatistics::enrollment_status,
        !           175:          $symb,$part);
1.1       matthew   176:     if (! defined($SubData) || ! ref($SubData)) {
1.18    ! matthew   177:         $html.= '<h2>There is no submission data for this problem at all</h2>';
1.1       matthew   178:         return $html;
                    179:     }
                    180:     my $NumSub = scalar(@{$SubData});
                    181:     if (! @{$SubData}) {
1.9       matthew   182:         $html.= '<h2>There is no submission data for this problem</h2>';
1.1       matthew   183:         return $html;
                    184:     }
                    185:     # Process the data
                    186:     #
                    187:     my (undef,undef,undef,$mday,$month,$year,$wday,$yday,$isdst) = 
                    188:         localtime(&get_time_from_row($SubData->[0]));
                    189:     my $day_start = &Time::Local::timelocal(0,0,0,$mday,$month,$year);
                    190:     #
1.2       matthew   191:     # Configure the bins used to store the data.
1.1       matthew   192:     my $binsize = 3600; # seconds
                    193:     my $bins_per_day = 86400/$binsize;
                    194:     my $bincount = 0;
                    195:     my $endtime = $day_start;
                    196:     #
1.2       matthew   197:     # Initialize loop variables
1.17      matthew   198:     my $max;            # The sum of @Ydata
                    199:     my @Ydata=(0);      # number of submissions
                    200:     my @AnsData=(0);    # number of correct submissions
                    201:     my @Xlabel=($WeekDay[$wday]); # Labels of itmes
                    202:     my @BinEnd;                   # The end time of each bin
                    203:     my $cumulative_answers = 0;   # The sum of @AnsData
1.2       matthew   204:     #
1.1       matthew   205:     foreach my $row (@$SubData) {
                    206:         my $subtime = &get_time_from_row($row);
                    207:         while ($subtime > $endtime && $endtime < time) {
                    208:             # Create a new bin
                    209:             $bincount++;
1.17      matthew   210:             $Ydata[$bincount]   = 0;
                    211:             $AnsData[$bincount] = 0;
1.1       matthew   212:             $endtime += $binsize;
1.16      matthew   213:             push(@BinEnd,$endtime);
1.1       matthew   214:             if ($bincount % (86400/$binsize) == 0) {
1.2       matthew   215:                 $wday++;
1.1       matthew   216:                 $wday %= 7;
1.2       matthew   217:                 $Xlabel[$bincount] = $WeekDay[$wday];
1.1       matthew   218:             } else {
                    219:                 $Xlabel[$bincount] = '';
                    220:             }
                    221:         }
                    222:         $Ydata[$bincount]++;
                    223:         $max = $Ydata[$bincount] if ($max < $Ydata[$bincount]);
                    224:         $AnsData[$bincount] += &successful_submission($row);
                    225:         $cumulative_answers += &successful_submission($row);
                    226:     }
1.17      matthew   227:     #
                    228:     # Pad the data to a full day
1.1       matthew   229:     while ($bincount % $bins_per_day != 0) {
                    230:         $bincount++;
                    231:         $Ydata[$bincount]=0;
1.17      matthew   232:         $AnsData[$bincount]=0;
1.1       matthew   233:         $endtime += $binsize;
1.17      matthew   234:         push(@BinEnd,$endtime);
1.1       matthew   235:         if ($bincount % (86400/$binsize) == 0) {
1.2       matthew   236:             $wday ++;
                    237:             $wday %= 7;
1.1       matthew   238:             $Xlabel[$bincount] = $WeekDay[$wday];
                    239:         } else {
                    240:             $Xlabel[$bincount] = '';
                    241:         }
                    242:     }
1.6       matthew   243:     my $numstudents = scalar(@$students);
1.17      matthew   244:     #
                    245:     # Determine a nice maximum value to use
                    246:     foreach my $maximum (10,15,20,25,30,40,50,60,70,80,90,100,
                    247:                           120,150,200,250,300,350,400,450,500,
                    248:                           600,700,800,900,1000,1100,1200,1500,2000,
                    249:                           2500,3000,4000,5000) {
                    250:         if ($max < $maximum) {
                    251:             $max = $maximum;
                    252:             last;
                    253:         }
                    254:     }
                    255:     #
                    256:     # Build the data table
1.16      matthew   257:     $htmltable = '<p>'.
                    258:         '<table rules="groups" frame="border" '.
                    259:         'summary="Student submission data">'.
                    260:         '<thead>'.
                    261:         '<tr>'.
1.17      matthew   262:         '<th valign="bottom">'.&mt('Begin').'</th>'.
1.16      matthew   263:         '<th>'.('&nbsp;'x3).'</th>'.
1.17      matthew   264:         '<th valign="bottom">'.&mt('End').'</th>'.
1.16      matthew   265:         '<th valign="bottom">'.&mt('Submissions').'</th>'.
                    266:         '<th>'.('&nbsp;'x3).'</th>'.
1.17      matthew   267:         '<th valign="bottom">'.&mt('Correct Submissions').'</th>'.
1.16      matthew   268:         '<th>'.('&nbsp;'x3).'</th>'.
1.17      matthew   269:         '<th valign="bottom">'.&mt('Cumulative Percent Correct').'</th>'.
1.16      matthew   270:         '</tr>'.
                    271:         '</thead>'.
                    272:         '<tbody>';
1.17      matthew   273:     my @CumulativeCorrect=(0);
                    274:     my @CumulativeCorrectPercent;
                    275:     for (my $i=0;$i<=$#Ydata;$i++) {
                    276:         $CumulativeCorrect[$i]=$CumulativeCorrect[-1]+$AnsData[$i];
                    277:         $CumulativeCorrectPercent[$i] = (int(100*$CumulativeCorrect[$i]/$numstudents));
1.16      matthew   278:         if ($Ydata[$i] != 0) {
                    279:             next if (! defined($BinEnd[$i]) || $BinEnd[$i] == 0);
                    280:             $htmltable .= 
                    281:                 '<tr>'.
1.17      matthew   282:                 '<td align="right"><nobr>'.
1.16      matthew   283:                 &Apache::lonlocal::locallocaltime($BinEnd[$i]-$binsize).
1.17      matthew   284:                 '</nobr></td>'.
1.16      matthew   285:                 '<td>&nbsp;</td>'.
1.17      matthew   286:                 '<td align="right"><nobr>'.
1.16      matthew   287:                     &Apache::lonlocal::locallocaltime($BinEnd[$i]).'</td>'.
1.17      matthew   288:                 '</nobr></td>'.
1.16      matthew   289:                 '<td align="right">'.$Ydata[$i].('&nbsp;'x3).'</td>'.
                    290:                 '<td>&nbsp;</td>'.
1.17      matthew   291:                 '<td align="right">'.$AnsData[$i].('&nbsp;'x3).'</td>'.
                    292:                 '<td>&nbsp;</td>'.
                    293:                 '<td align="right">'.$CumulativeCorrectPercent[$i].'</td>'.
1.16      matthew   294:                 '</tr>'.$/;
                    295:         }
1.6       matthew   296:     }
1.16      matthew   297:     $htmltable .= '</tbody></table></p>';
1.17      matthew   298:     #
                    299:     # Build the plot
                    300:     my $title = '';#'Number of Submissions and Number Correct';
1.1       matthew   301:     my $xlabel;
1.2       matthew   302:     (undef,undef,undef,$mday,$month,$year,$wday) = localtime($day_start);
                    303:     $xlabel .= $FullWeekDay[$wday].' '.
                    304:         join(' ',($Month[$month],$mday,1900+$year)).' - ';
                    305:     (undef,undef,undef,$mday,$month,$year,$wday) = localtime($endtime);
                    306:     $xlabel .= $FullWeekDay[$wday].' '.
                    307:         join(' ',($Month[$month],$mday,1900+$year));
1.8       matthew   308:     my $width = 50+2*$bincount;
                    309:     if ($width < 250) {
                    310:         $width = 250;
                    311:     }
1.17      matthew   312:     #
1.1       matthew   313:     $html .= &Apache::loncommon::DrawXYYGraph($title,
                    314:                                               $xlabel,
1.6       matthew   315:                                               'Submissions vs Time',
1.1       matthew   316:                                               $plotcolors,
                    317:                                               \@Xlabel,
1.17      matthew   318:                                               \@Ydata,0,$max,
                    319:                                               \@CumulativeCorrectPercent,0,100,
1.1       matthew   320:                                               (xskip => $bins_per_day,
                    321:                                                x_ticks => $bins_per_day,
                    322:                                                x_tick_offset => $bins_per_day,
1.8       matthew   323:                                                width => $width,
1.7       matthew   324:                       y1_label=>'Number of Submissions per hour',
                    325:                       y2_label=>'Percent of Students answering Correctly',
                    326:                      'data.1.label'=>'Submissions per hour',
                    327:                      'data.2.label'=>'Percent correct',
                    328:                                                )
1.1       matthew   329:                                               );
1.16      matthew   330:     $html .= '<br />'.$htmltable;
1.1       matthew   331:     return $html;
                    332: }
                    333: 
                    334: sub successful_submission {
                    335:     my ($row) = @_;
                    336:     if (ref($row) eq 'ARRAY') {
1.3       matthew   337:         return $row->[&Apache::loncoursedata::RT_awarded()];
1.1       matthew   338:     }
                    339:     return undef;
                    340:     return 0;
                    341: }
                    342: 
                    343: sub get_time_from_row {
                    344:     my ($row) = @_;
                    345:     if (ref($row) eq 'ARRAY') {
1.3       matthew   346:         return $row->[&Apache::loncoursedata::RT_timestamp()];
1.1       matthew   347:     } 
                    348:     return undef;
                    349: }
                    350: 
                    351: sub get_tries_from_row {
                    352:     my ($row) = @_;
                    353:     if (ref($row) eq 'ARRAY') {
1.3       matthew   354:         return $row->[&Apache::loncoursedata::RT_tries()];
1.1       matthew   355:     }
                    356:     return undef;
                    357: }
                    358: 
                    359: sub Process_Row {
                    360:     my ($row) = @_;
                    361:     my %RowData;
                    362:     my ($student_id,$award,$tries,$time) = @$row;
                    363:     return %RowData;
                    364: }
                    365: 
                    366: #########################################################
                    367: #########################################################
                    368: ##
                    369: ##   Generic Interface Routines
                    370: ##
                    371: #########################################################
                    372: #########################################################
                    373: sub CreateInterface {
                    374:     ##
                    375:     ## Environment variable initialization
                    376:     if (! exists$ENV{'form.AnalyzeOver'}) {
                    377:         $ENV{'form.AnalyzeOver'} = 'Tries';
                    378:     }
                    379:     ##
                    380:     ## Build the menu
                    381:     my $Str = '';
1.14      matthew   382:     $Str .= &Apache::lonhtmlcommon::breadcrumbs(undef,'Submission Time Plots');
1.15      matthew   383:     $Str .= '<p>';
1.1       matthew   384:     $Str .= '<table cellspacing="5">'."\n";
                    385:     $Str .= '<tr>';
1.16      matthew   386:     $Str .= '<th align="center">'.&mt('Sections').'</th>';
                    387:     $Str .= '<th align="center">'.&mt('Enrollment Status').'</th>';
1.1       matthew   388:     $Str .= '</tr>'."\n";
                    389:     ##
                    390:     ## 
                    391:     $Str .= '<tr><td align="center">'."\n";
1.16      matthew   392:     $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',4);
1.1       matthew   393:     $Str .= '</td>';
                    394:     #
                    395:     $Str .= '<td align="center">';
1.16      matthew   396:     $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,4);
1.1       matthew   397:     $Str .= '</td>';
1.16      matthew   398:     #
1.15      matthew   399:     $Str .= '</tr>'."\n";
                    400:     $Str .= '</table>'."\n";
1.1       matthew   401:     #
1.15      matthew   402:     $Str .= '<nobr>'.&mt('Status: [_1]',
                    403:                          '<input type="text" '.
                    404:                          'name="stats_status" size="60" value="" />').
                    405:             '</nobr>'.'</p>';
1.1       matthew   406:     ##
                    407:     return $Str;
                    408: }
                    409: 
                    410: 1;
                    411: 
                    412: __END__

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