Diff for /loncom/interface/statistics/lonproblemstatistics.pm between versions 1.41 and 1.52

version 1.41, 2003/03/25 23:00:40 version 1.52, 2003/06/10 19:19:57
Line 26 Line 26
 #  #
 # (Navigate problems for statistical reports  # (Navigate problems for statistical reports
 #  #
 ###  ###############################################
   ###############################################
   
   =pod
   
   =head1 NAME
   
   lonproblemstatistics
   
   =head1 SYNOPSIS
   
   Routines to present problem statistics to instructors via tables,
   Excel files, and plots.
   
   =over 4
   
   =cut
   
   ###############################################
   ###############################################
   
 package Apache::lonproblemstatistics;  package Apache::lonproblemstatistics;
   
Line 35  use Apache::lonnet(); Line 54  use Apache::lonnet();
 use Apache::lonhtmlcommon;  use Apache::lonhtmlcommon;
 use Apache::loncoursedata;  use Apache::loncoursedata;
 use Apache::lonstatistics;  use Apache::lonstatistics;
   use Spreadsheet::WriteExcel;
   
 #######################################################  my @Fields = (
 #######################################################             { name => 'problem_num',
                title => 'P#',
                align => 'right',
                color => '#FFFFE6' },
              { name   => 'container',
                title  => 'Sequence or Folder',
                align  => 'left',
                color  => '#FFFFE6',
                sortable => 'yes' },
              { name   => 'title',
                title  => 'Title',
                align  => 'left',
                color  => '#FFFFE6',
                special  => 'link',
                sortable => 'yes', },
              { name   => 'part', 
                title  => 'Part',
                align  => 'left',
                color  => '#FFFFE6' },
              { name   => 'num_students',
                title  => '#Stdnts',
                align  => 'right',
                color  => '#EEFFCC',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of Students Attempting Problem' },
              { name   => 'tries',
                title  => 'Tries',
                align  => 'right',
                color  => '#EEFFCC',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Total Number of Tries' },
              { name   => 'max_tries',
                title  => 'Max Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Maximum Number of Tries' },
              { name   => 'mean_tries',
                title  => 'Mean Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Average Number of Tries' },
              { name   => 'std_tries',
                title  => 'S.D. tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Standard Deviation of Number of Tries' },
              { name   => 'skew_tries',
                title  => 'Skew Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Skew of Number of Tries' },
              { name   => 'deg_of_diff',
                title  => 'DoDiff',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Degree of Difficulty' },
              { name   => 'num_solved',
                title  => '#YES',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of Students able to Solve' },
              { name   => 'num_override',
                title  => '#yes',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of Students given Override' },
              { name   => 'per_wrong',
                title  => '%Wrng',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.1f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Percent Wrong' },
   );
   
   ###############################################
   ###############################################
   
   =pod 
   
   =item &CreateInterface()
   
   Create the main intereface for the statistics page.  Allows the user to
   select sections, maps, and output.
   
   =cut
   
   ###############################################
   ###############################################
 sub CreateInterface {  sub CreateInterface {
     my $Str = '';      my $Str = '';
     $Str .= '<table cellspacing="5">'."\n";      $Str .= '<table cellspacing="5">'."\n";
     $Str .= '<tr>';      $Str .= '<tr>';
     $Str .= '<td align="center"><b>Sections</b></td>';      $Str .= '<td align="center"><b>Sections</b></td>';
       $Str .= '<td align="center"><b>Enrollment Status</b></td>';
     $Str .= '<td align="center"><b>Sequences and Folders</b></td>';      $Str .= '<td align="center"><b>Sequences and Folders</b></td>';
     $Str .= '<td align="center"><b>Output</b></td>';      $Str .= '<td align="center"><b>Output</b></td>';
     $Str .= '</tr>'."\n";      $Str .= '</tr>'."\n";
Line 51  sub CreateInterface { Line 185  sub CreateInterface {
     $Str .= '<tr><td align="center">'."\n";      $Str .= '<tr><td align="center">'."\n";
     $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);      $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);
     $Str .= '</td><td align="center">';      $Str .= '</td><td align="center">';
       $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);
       $Str .= '</td><td align="center">';
     #      #
     my $only_seq_with_assessments = sub {       my $only_seq_with_assessments = sub { 
         my $s=shift;          my $s=shift;
Line 66  sub CreateInterface { Line 202  sub CreateInterface {
     $Str .= &CreateAndParseOutputSelector();      $Str .= &CreateAndParseOutputSelector();
     $Str .= '</td></tr>'."\n";      $Str .= '</td></tr>'."\n";
     $Str .= '</table>'."\n";      $Str .= '</table>'."\n";
       $Str .= '<input type="submit" value="Generate Statistics" />';
     return $Str;      return $Str;
 }  }
   
Line 76  sub CreateInterface { Line 213  sub CreateInterface {
   
 =item &CreateAndParseOutputSelector()  =item &CreateAndParseOutputSelector()
   
   Construct a selection list of options for output and parse output selections.
   The current output selected is indicated by the values of the two package
   variables $output_mode and $show.  @OutputOptions holds the descriptions of
   the output options and the values for $output_mode and $show.
   
   Based on code from lonstudentassessment.pm.
   
 =cut  =cut
   
 #######################################################  #######################################################
Line 104  my @OutputOptions = Line 248  my @OutputOptions =
        mode => 'excel',         mode => 'excel',
        show => 'all',         show => 'all',
      },       },
      { name  => 'Degree of Difficulty Plot',  
        value => 'plot deg diff',  
        description => 'Generate a plot of the degree of difficulty of each '.  
            'problem part.',  
        mode => 'plot',  
        show => 'deg of diff',  
      },  
      { name  => 'Percent Wrong Plot',  
        value => 'plot per wrong',  
        description => 'Generate a plot showing the percent of students who '.  
            'were unable to complete each problem part',  
        mode => 'plot',  
        show => 'per wrong',  
      },  
      );       );
   
 sub OutputDescriptions {  sub OutputDescriptions {
Line 134  sub OutputDescriptions { Line 264  sub OutputDescriptions {
   
 sub CreateAndParseOutputSelector {  sub CreateAndParseOutputSelector {
     my $Str = '';      my $Str = '';
     my $elementname = 'outputmode';      my $elementname = 'statsoutputmode';
     #      #
     # Format for output options is 'mode, restrictions';      # Format for output options is 'mode, restrictions';
     my $selected = 'html, with links';      my $selected = 'HTML problem statistics grouped';
     if (exists($ENV{'form.'.$elementname})) {      if (exists($ENV{'form.'.$elementname})) {
         if (ref($ENV{'form.'.$elementname} eq 'ARRAY')) {          if (ref($ENV{'form.'.$elementname} eq 'ARRAY')) {
             $selected = $ENV{'form.'.$elementname}->[0];              $selected = $ENV{'form.'.$elementname}->[0];
Line 158  sub CreateAndParseOutputSelector { Line 288  sub CreateAndParseOutputSelector {
     # Build the form element      # Build the form element
     $Str = qq/<select size="5" name="$elementname">/;      $Str = qq/<select size="5" name="$elementname">/;
     foreach my $option (@OutputOptions) {      foreach my $option (@OutputOptions) {
           if (exists($option->{'special'}) && 
               $option->{'special'} =~ /do not show/) {
               next;
           }
         $Str .= "\n".'    <option value="'.$option->{'value'}.'"';          $Str .= "\n".'    <option value="'.$option->{'value'}.'"';
         $Str .= " selected " if ($option->{'value'} eq $selected);          $Str .= " selected " if ($option->{'value'} eq $selected);
         $Str .= ">".$option->{'name'}."<\/option>";          $Str .= ">".$option->{'name'}."<\/option>";
Line 169  sub CreateAndParseOutputSelector { Line 303  sub CreateAndParseOutputSelector {
 ###############################################  ###############################################
 ###############################################  ###############################################
   
   =pod 
   
   =item &Gather_Student_Data()
   
   Ensures all student data is up to date.
   
   =cut
   
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub Gather_Student_Data {  sub Gather_Student_Data {
Line 199  sub Gather_Student_Data { Line 341  sub Gather_Student_Data {
 ###############################################  ###############################################
 ###############################################  ###############################################
   
   =pod 
   
   =item &BuildProblemStatisticsPage()
   
   Main interface to problem statistics.
   
   =cut
   
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub BuildProblemStatisticsPage {  sub BuildProblemStatisticsPage {
Line 211  sub BuildProblemStatisticsPage { Line 361  sub BuildProblemStatisticsPage {
     $r->print('<input type="hidden" name="statsfirstcall" value="no" />');      $r->print('<input type="hidden" name="statsfirstcall" value="no" />');
     $r->print('<input type="hidden" name="sortby" value="'.$ENV{'form.sortby'}.      $r->print('<input type="hidden" name="sortby" value="'.$ENV{'form.sortby'}.
               '" />');                '" />');
       $r->print('<input type="hidden" name="plot" value="" />');
     if (! exists($ENV{'form.statsfirstcall'})) {      if (! exists($ENV{'form.statsfirstcall'})) {
         return;          return;
     }      }
Line 229  sub BuildProblemStatisticsPage { Line 380  sub BuildProblemStatisticsPage {
         } elsif ($show eq 'ungrouped') {          } elsif ($show eq 'ungrouped') {
             &output_html_ungrouped($r);              &output_html_ungrouped($r);
         }          }
       } elsif ($output_mode eq 'excel') {
           $r->print("<h2>Preparing Excel Spreadsheet</h2>");
           &output_excel($r);
     } else {      } else {
         $r->print("<h1>Not implemented</h1>");          $r->print("<h1>Not implemented</h1>");
     }      }
     return;      return;
 }  }
   
   ###############################################
   ###############################################
   
   =pod 
   
   =item &output_html_grouped_by_sequence()
   
   Presents the statistics data as an html table organized by the order
   the assessments appear in the course.
   
   =cut
   
   ###############################################
   ###############################################
 sub output_html_grouped_by_sequence {  sub output_html_grouped_by_sequence {
     my ($r) = @_;      my ($r) = @_;
       my $problem_num = 0;
     #$r->print(&ProblemStatisticsLegend());      #$r->print(&ProblemStatisticsLegend());
     my @Header = ("Title","Part","#Stdnts","Tries","Mod",  
                   "Mean","#YES","#yes","%Wrng","DoDiff",  
                   "S.D.","Skew.");#,"D.F.1st","D.F.2nd");  
     # #FFFFE6 #EEFFCC #DDFFFF FFDDDD #DDFFDD #FFDDFF  
     foreach my $sequence (&Apache::lonstatistics::Sequences_with_Assess()) {      foreach my $sequence (&Apache::lonstatistics::Sequences_with_Assess()) {
         next if ($sequence->{'num_assess'}<1);          next if ($sequence->{'num_assess'}<1);
         $r->print("<h3>".$sequence->{'title'}."</h3>");          $r->print("<h3>".$sequence->{'title'}."</h3>");
         $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");          $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");
         $r->print('<table border="0" cellpadding="3">'."\n");          $r->print('<table border="0" cellpadding="3">'."\n");
         $r->print('<tr bgcolor="#FFFFE6"><th>'.          $r->print('<tr bgcolor="#FFFFE6">');
                   join("</th><th>",@Header)."</th></tr>\n");          my $Str = &statistics_table_header('no container no plots');
           $r->print('<tr bgcolor="#FFFFE6">'.$Str."</tr>\n");
         foreach my $resource (@{$sequence->{'contents'}}) {          foreach my $resource (@{$sequence->{'contents'}}) {
             next if ($resource->{'type'} ne 'assessment');              next if ($resource->{'type'} ne 'assessment');
             foreach my $part (@{$resource->{'parts'}}) {              foreach my $part (@{$resource->{'parts'}}) {
                 if ($part == 0) {                  $problem_num++;
                     $part = '&nbsp;';                  my $data = &get_statistics($sequence,$resource,$part,
                 }                                             $problem_num);
                 my ($num,$tries,$mod,$mean,$Solved,$solved,$DegOfDiff,$STD,                  my $option = '';
                     $SKEW) = &Apache::loncoursedata::get_problem_statistics                  $r->print('<tr>'.&statistics_html_table_data($data,
                         (undef,$resource->{'symb'},$part,                                                               'no container').
                          $ENV{'request.course.id'});  
                 my $wrongpercent = 0;  
                 if (defined($num) && $num > 0) {  
                     $wrongpercent=int(10*100*($num-$Solved+$solved)/$num)/10;  
                 }  
                 $r->print('<tr>'.&statistics_html_table_data  
                           ($resource,$part,$num,$tries,$mod,$mean,$Solved,  
                            $solved,$wrongpercent,$DegOfDiff,$STD,$SKEW).  
                           "</tr>\n");                            "</tr>\n");
             }              }
         }          }
Line 277  sub output_html_grouped_by_sequence { Line 435  sub output_html_grouped_by_sequence {
     return;      return;
 }  }
   
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   
   =pod 
   
   =item &output_html_ungrouped()
   
   Presents the statistics data in a single html table which can be sorted by
   different columns.
   
   =cut
   
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub output_html_ungrouped {  sub output_html_ungrouped {
     my ($r) = @_;      my ($r,$option) = @_;
     #      #
     my $sortby = $ENV{'form.sortby'};      if (exists($ENV{'form.plot'}) && $ENV{'form.plot'} ne '') {
     if (! defined($sortby) || $sortby eq '') {          &plot_statistics($r,$ENV{'form.plot'});
         $sortby = 'sequence';  
     }      }
     #      #
       my $problem_num = 0;
     my $show_container = 0;      my $show_container = 0;
       my $show_part = 0;
     #$r->print(&ProblemStatisticsLegend());      #$r->print(&ProblemStatisticsLegend());
     my @Header = ("Title","Part","#Stdnts","Tries","Mod",      my $sortby = undef;
                   "Mean","#YES","#yes","%Wrng","DoDiff",      foreach my $field (@Fields) {
                   "S.D.","Skew.");#,"D.F.1st","D.F.2nd");          if ($ENV{'form.sortby'} eq $field->{'name'}) {
     # #FFFFE6 #EEFFCC #DDFFFF FFDDDD #DDFFDD #FFDDFF              $sortby = $field->{'name'};
           }
       }
       if (! defined($sortby) || $sortby eq '' || $sortby eq 'problem_num') {
           $sortby = 'container';
       }
       # If there is more than one sequence, list their titles
     my @Sequences = &Apache::lonstatistics::Sequences_with_Assess();      my @Sequences = &Apache::lonstatistics::Sequences_with_Assess();
     if (@Sequences > 1) {      if (@Sequences < 1) {
         unshift(@Header,"Container");          $option .= ' no container';
         $show_container = 1;      }
       #
       # Compile the data
       my @Statsarray;
       foreach my $sequence (@Sequences) {
           next if ($sequence->{'num_assess'}<1);
           foreach my $resource (@{$sequence->{'contents'}}) {
               next if ($resource->{'type'} ne 'assessment');
               foreach my $part (@{$resource->{'parts'}}) {
                   $problem_num++;
                   my $data = &get_statistics($sequence,$resource,$part,
                                              $problem_num);
                   $show_part = 1 if ($part ne '0');
                   #
                   push (@Statsarray,$data);
               }
           }
       }
       #
       # Sort the data
       my @OutputOrder;
       if ($sortby eq 'container') {
           @OutputOrder = @Statsarray;
       } else {
           # $sortby is already defined, so we can charge ahead
           if ($sortby =~ /^(title|part)$/i) {
               # Alpha comparison
               @OutputOrder = sort {
                   lc($a->{$sortby}) cmp lc($b->{$sortby}) ||
                       lc($a->{'title'}) cmp lc($b->{'title'}) ||
                           lc($a->{'part'}) cmp lc($b->{'part'});
               } @Statsarray;
           } else {
               # Numerical comparison
               @OutputOrder = sort {
                   my $retvalue = 0;
                   if ($b->{$sortby} eq 'nan') {
                       if ($a->{$sortby} ne 'nan') {
                           $retvalue = -1;
                       } else {
                           $retvalue = 0;
                       }
                   }
                   if ($a->{$sortby} eq 'nan') {
                       if ($b->{$sortby} ne 'nan') {
                           $retvalue = 1;
                       }
                   }
                   if ($retvalue eq '0') {
                       $retvalue = $b->{$sortby} <=> $a->{$sortby} ||
                                   lc($a->{'title'}) <=> lc($b->{'title'}) ||
                                   lc($a->{'part'})  <=> lc($b->{'part'});
                   }
                   $retvalue;
               } @Statsarray;
           }
     }      }
       $option .= 'no part' if (! $show_part);
       my $num_output = 0;
     #      #
       # output the headers
     $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");      $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");
     $r->print('<table border="0" cellpadding="3">'."\n");      $r->print('<table border="0" cellpadding="3">'."\n");
     my $Str = '';      my $Str = &statistics_table_header($option.' sortable');
     foreach (@Header) {  
         $Str .= '<th>'.  
      '<a href="javascript:document.Statistics.sortby.value='."'$_'".  
          ';document.Statistics.submit();">'.  
          $_.'</a></th>';  
     }  
     $r->print('<tr bgcolor="#FFFFE6">'.$Str."</tr>\n");      $r->print('<tr bgcolor="#FFFFE6">'.$Str."</tr>\n");
       #
       foreach my $rowdata (@OutputOrder) {
           $num_output++;
           if ($num_output % 25 == 0) {
               $r->print("</table>\n</td></tr></table>\n");
               #
               $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");
               $r->print('<table border="0" cellpadding="3">'."\n");
               my $Str = &statistics_table_header($option.' sortable');
               $r->print('<tr bgcolor="#FFFFE6">'.$Str."</tr>\n");
               $r->rflush();
           }
           $r->print('<tr>'.&statistics_html_table_data($rowdata,$option).
                     "</tr>\n");
       }
       $r->print("</table>\n");
       $r->print("</td></tr></table>\n");
     $r->rflush();      $r->rflush();
     #      #
     foreach my $sequence (@Sequences) {      return;
   }
   
   ###############################################
   ###############################################
   
   =pod 
   
   =item &output_excel()
   
   Presents the statistical data in an Excel 95 compatable spreadsheet file.
   
   =cut
   
   ###############################################
   ###############################################
   sub output_excel {
       my ($r) = @_;
       my $filename = '/prtspool/'.
           $ENV{'user.name'}.'_'.$ENV{'user.domain'}.'_'.
               time.'_'.rand(1000000000).'.xls';
       #
       my $excel_workbook = undef;
       my $excel_sheet = undef;
       #
       my $rows_output = 0;
       my $cols_output = 0;
       #
       # Create sheet
       $excel_workbook = Spreadsheet::WriteExcel->new('/home/httpd'.$filename);
       #
       # Check for errors
       if (! defined($excel_workbook)) {
           $r->log_error("Error creating excel spreadsheet $filename: $!");
           $r->print("Problems creating new Excel file.  ".
                     "This error has been logged.  ".
                     "Please alert your LON-CAPA administrator");
           return ;
       }
       #
       # The excel spreadsheet stores temporary data in files, then put them
       # together.  If needed we should be able to disable this (memory only).
       # The temporary directory must be specified before calling 'addworksheet'.
       # File::Temp is used to determine the temporary directory.
       $excel_workbook->set_tempdir($Apache::lonnet::tmpdir);
       #
       # Add a worksheet
       my $sheetname = $ENV{'course.'.$ENV{'request.course.id'}.'.description'};
       if (length($sheetname) > 31) {
           $sheetname = substr($sheetname,0,31);
       }
       $excel_sheet = $excel_workbook->addworksheet($sheetname);
       #
       # Put the course description in the header
       $excel_sheet->write($rows_output,$cols_output++,
                      $ENV{'course.'.$ENV{'request.course.id'}.'.description'});
       $cols_output += 3;
       #
       # Put a description of the sections listed
       my $sectionstring = '';
       my @Sections = @Apache::lonstatistics::SelectedSections;
       if (scalar(@Sections) > 1) {
           if (scalar(@Sections) > 2) {
               my $last = pop(@Sections);
               $sectionstring = "Sections ".join(', ',@Sections).', and '.$last;
           } else {
               $sectionstring = "Sections ".join(' and ',@Sections);
           }
       } else {
           if ($Sections[0] eq 'all') {
               $sectionstring = "All sections";
           } else {
               $sectionstring = "Section ".$Sections[0];
           }
       }
       $excel_sheet->write($rows_output,$cols_output++,$sectionstring);
       $cols_output += scalar(@Sections);
       #
       # Put the date in there too
       $excel_sheet->write($rows_output,$cols_output++,
                           'Compiled on '.localtime(time));
       #
       $rows_output++; 
       $cols_output=0;
       #
       # Add the headers
       foreach my $field (@Fields) {
           next if ($field->{'name'} eq 'problem_num');
           $excel_sheet->write($rows_output,$cols_output++,$field->{'title'});
       }
       $rows_output++;
       #
       # Write the data
       my $problem_num=0;
       foreach my $sequence (&Apache::lonstatistics::Sequences_with_Assess()) {
         next if ($sequence->{'num_assess'}<1);          next if ($sequence->{'num_assess'}<1);
         foreach my $resource (@{$sequence->{'contents'}}) {          foreach my $resource (@{$sequence->{'contents'}}) {
             next if ($resource->{'type'} ne 'assessment');              next if ($resource->{'type'} ne 'assessment');
             foreach my $part (@{$resource->{'parts'}}) {              foreach my $part (@{$resource->{'parts'}}) {
                 my ($num,$tries,$mod,$mean,$Solved,$solved,$DegOfDiff,$STD,                  $cols_output=0;
                     $SKEW) = &Apache::loncoursedata::get_problem_statistics                  $problem_num++;
                         (undef,$resource->{'symb'},$part,                  my $data = &get_statistics($sequence,$resource,$part,
                          $ENV{'request.course.id'});                                             $problem_num);
                 if ($part == 0) {                  #
                     $part = '&nbsp;';                  if (!defined($part) || $part eq '') {
                 }                      $part = ' ';
                 my $wrongpercent = 0;  
                 if (defined($num) && $num > 0) {  
                     $wrongpercent=int(10*100*($num-$Solved+$solved)/$num)/10;  
                 }                  }
                 if ($show_container) {                  foreach my $field (@Fields) {
                     $r->print('<tr>'.                      next if ($field->{'name'} eq 'problem_num');
                               '<td bgcolor="#FFFFE6">'.$sequence->{'title'}.                      $excel_sheet->write($rows_output,$cols_output++,
                               '</td>'.                                          $data->{$field->{'name'}});
                               &statistics_html_table_data  
                               ($resource,$part,$num,$tries,$mod,$mean,$Solved,  
                                $solved,$wrongpercent,$DegOfDiff,$STD,$SKEW).  
                               "</tr>\n");  
                 } else {  
                     $r->print('<tr>'.&statistics_html_table_data  
                               ($resource,$part,$num,$tries,$mod,$mean,$Solved,  
                                $solved,$wrongpercent,$DegOfDiff,$STD,$SKEW).  
                               "</tr>\n");  
                 }                  }
                   $rows_output++;
             }              }
         }          }
     }      }
     $r->print("</table>\n");  
     $r->print("</td></tr></table>\n");  
     $r->rflush();  
     #      #
       # Write the excel file
       $excel_workbook->close();
       # Tell the user where to get their excel file
       $r->print('<br />'.
                 '<a href="'.$filename.'">Your Excel spreadsheet.</a>'."\n");
       $r->rflush();
     return;      return;
 }  }
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   
   =pod 
   
   =item &statistics_html_table_data()
   
   Help function used to format the rows for HTML table output.
   
   =cut
   
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub statistics_html_table_data {  sub statistics_html_table_data {
     my ($resource,$part,$num,$tries,$mod,$mean,$Solved,$solved,$wrongpercent,      my ($data,$options) = @_;
         $DegOfDiff,$STD,$SKEW) = @_;  
     my $row = '';      my $row = '';
     $row .= '<td bgcolor="#FFFFE6">'.      foreach my $field (@Fields) {
         '<a href="'.$resource->{'src'}.'" target="_blank" >'.          next if ($options =~ /no $field->{'name'}/);
             $resource->{'title'}.'</a>'.          $row .= '<td bgcolor="'.$field->{'color'}.'"';
                 '</td>';          if (exists($field->{'align'})) {
     $row .= '<td bgcolor="#FFFFE6">'.$part.'</td>' if (defined($part));              $row .= ' align="'.$field->{'align'}.'"';
     foreach ($num,$tries) {              }
         $row .= '<td bgcolor="#EEFFCC" align="right">'.$_.'</td>';          $row .= '>';
     }          if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
     foreach ($mod,$mean) {              $row .= '<a href="'.$data->{$field->{'name'}.'.link'}.
         $row .= '<td bgcolor="#DDFFFF" align="right">'.                  ' target="_blank">';
                   sprintf("%5.2f",$_).'</td>';          }
     }          if (exists($field->{'format'})) {
     foreach ($Solved,$solved) {              $row .= sprintf($field->{'format'},$data->{$field->{'name'}});
         $row .= '<td bgcolor="#DDFFFF" align="right">'.$_.'</td>';          } else {
     }              $row .= $data->{$field->{'name'}};
     foreach ($wrongpercent) {          }
         $row .= '<td bgcolor="#DDFFFF" align="right">'.          if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
                   sprintf("%5.1f",$_).'</td>';              $row.= '</a>';
     }          }
     foreach ($DegOfDiff,$STD,$SKEW) {          $row .= '</td>';
         $row .= '<td bgcolor="#FFDDDD" align="right">'.  
                   sprintf("%5.2f",$_).'</td>';  
     }      }
     return $row;      return $row;
 }  }
   
   sub statistics_table_header {
       my ($options) = @_;
       my $header_row;
       foreach my $field (@Fields) {
           next if ($options =~ /no $field->{'name'}/);
           $header_row .= '<th>';
           if ($options =~ /sortable/ && 
               exists($field->{'sortable'}) && $field->{'sortable'} eq 'yes') {
               $header_row .= '<a href="javascript:'.
                   'document.Statistics.sortby.value='."'".$field->{'name'}."'".
                       ';document.Statistics.submit();">';
           }
           $header_row .= $field->{'title'};
           if ($options =~ /sortable/) {
               $header_row.= '</a>';
           }
           if ($options !~ /no plots/        && 
               exists($field->{'graphable'}) && 
               $field->{'graphable'} eq 'yes') {
               $header_row.=' (';
               $header_row .= '<a href="javascript:'.
                   "document.Statistics.plot.value='$field->{'name'}'".
                       ';document.Statistics.submit();">';
               $header_row .= 'plot</a>)';
           }
           $header_row .= '</th>';
       }
       return $header_row;
   }
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   
 sub BuildGraphicChart {  =pod 
     my ($graph,$cacheDB,$courseDescription,$students,$courseID,$r,$c)=@_;  
     my %cache;  =item &plot_statistics()
     my $max;  
     my $title = '';  =cut
     if($graph eq 'DoDiffGraph') {  
  $title = 'Degree-of-Difficulty';  ###############################################
     } else {  ###############################################
  $title = 'Wrong-Percentage';  sub plot_statistics {
     }      my ($r,$datafield) = @_;
     my $currentSequence = -1;      my @Data;
     my $sortProblems = 'Sort Within Sequence';      #
     my ($result, $orderedProblems) =      #
         &InitializeProblemStatistics($cacheDB, $students, $courseID, $c, $r);      my $sortfield = undef;
     if($result ne 'OK') {      my $title = undef;
         return;      foreach my $field (@Fields) {
           if ($datafield eq $field->{'name'} &&
               exists($field->{'graphable'}) && $field->{'graphable'} eq 'yes') {
               $sortfield = $field->{'name'};
               $title = $field->{'long_title'};
           }
     }      }
     my @values = ();      return if (! defined($sortfield) || $sortfield eq '');
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {      #
         return 'Unable to tie database.7';      my $Max = 0;
     }      my $problem_num = 0;
     foreach(@$orderedProblems) {      foreach my $sequence (&Apache::lonstatistics::Sequences_with_Assess()) {
         my ($sequence,$problem,$part)=split(':', $_);          next if ($sequence->{'num_assess'}<1);
         if($cache{'StatisticsMaps'} ne 'All Maps'  &&          foreach my $resource (@{$sequence->{'contents'}}) {
            $cache{'StatisticsMaps'} ne $cache{$sequence.':title'}) {              next if ($resource->{'type'} ne 'assessment');
              next;              foreach my $part (@{$resource->{'parts'}}) {
         }                  my $problem_number++;
         if( $currentSequence == -1 ||                  my $data = &get_statistics($sequence,$resource,$part,
             ($sortProblems eq 'Sort Within Sequence' &&                                             $problem_num);
             $currentSequence != $sequence)) {                  my $value = $data->{$sortfield};
     if($currentSequence != -1) {                  $Max = $value if ($Max < $value);
  &DrawGraph(\@values,$courseDescription,$title,$max,$r);                  push (@Data,$value);
     }  
             if($sortProblems eq 'Sort Within Sequence') {  
                 $r->print('<br><b>'.$cache{$sequence.':title'}.'</b>'."\n");  
             }              }
             $currentSequence = $sequence;  
             @values = ();  
     $max=0;  
         }  
         my $data = 0;  
         if($graph eq 'DoDiffGraph') {  
             $data = sprintf("%.2f", $cache{$_.':degreeOfDifficulty'}),  
         } else {  
             $data = sprintf("%.1f", $cache{$_.':percentWrong'}),  
         }          }
         if($max < $data) {      }
             $max = $data;      #
       # Print out plot request
       my $yaxis = '';
       if ($sortfield eq 'per_wrong') {
           $yaxis = 'Percent';
       }
       #
       # Determine appropriate value for $Max
       if ($sortfield eq 'deg_of_diff') {
           if ($Max > 0.5) {
               $Max = 1;
           } elsif ($Max > 0.2) {
               $Max = 0.5;
           } elsif ($Max > 0.1) {
               $Max = 0.2;
           }
       } elsif ($sortfield eq 'per_wrong') {
           if ($Max > 50) {
               $Max = 100;
           } elsif ($Max > 25) {
               $Max = 50;
           } elsif ($Max > 20) {
               $Max = 25;
           } elsif ($Max > 10) {
               $Max = 20;
           } elsif ($Max > 5) {
               $Max = 10;
           } else {
               $Max = 5;
         }          }
         push(@values, $data);  
     }      }
     untie(%cache);      
     &DrawGraph(\@values,$courseDescription,$title,$max,$r);      $r->print("<p>".&DrawGraph(\@Data,$title,'Problem Number',$yaxis,
                                  $Max)."</p>\n");
       #
       # Print out the data
       $ENV{'form.sortby'} = 'Contents';
   #    &output_html_ungrouped($r);
     return;      return;
 }  }
   
   ###############################################
   ###############################################
   
   =pod 
   
   =item &DrawGraph()
   
   =cut
   
   ###############################################
   ###############################################
 sub DrawGraph {  sub DrawGraph {
     my ($values,$courseDescription,$title,$Max,$r)=@_;      my ($values,$title,$xaxis,$yaxis,$Max)=@_;
       $title = '' if (! defined($title));
       $xaxis = '' if (! defined($xaxis));
       $yaxis = '' if (! defined($yaxis));
       #
     my $sendValues = join(',', @$values);      my $sendValues = join(',', @$values);
     my $sendCount = scalar(@$values);      my $sendCount = scalar(@$values);
     $r->print("<br>The Maximum Value is: $Max");      $Max =1 if ($Max < 1);
     if ( $Max > 1 ) {      if ( int($Max) < $Max ) {
  if ($Max % 10) {          $Max++;
             if ( int($Max) < $Max ) {          $Max = int($Max);
      $Max++;  
  $Max = int($Max);  
     }  
  }  
     #(10 - $Max % 10);  
     } else { $Max = 1; }  
     my @GData = ('','Problem_number',$title,$Max,$sendCount,$sendValues);  
 #    $r->print('</form>'."\n");  
     $r->print('<br>'."\n");  
     $r->print('<IMG src="/cgi-bin/graph.png?'.  
               (join('&', @GData)).'" border="1" />');  
 #    $r->print('<form>'."\n");  
     $r->print('<br>'."\n");  
 }  
   
 #---- Problem Statistics Web Page ---------------------------------------  
 sub CreateProblemStatisticsTableHeading {  
     my ($headings,$r)=@_;  
     my $Str='';  
     $Str .= '<tr>'."\n";  
     $Str .= '<th bgcolor="#ffffe6">P#</th>'."\n";  
     foreach(@$headings) {  
  $Str .= '<th bgcolor="#ffffe6">';  
         $Str .= '<a href="/adm/statistics?reportSelected=';  
         $Str .= &Apache::lonnet::escape('Problem Statistics');  
         $Str .= '&ProblemStatisticsSort=';  
         $Str .= &Apache::lonnet::escape($_).'">'.$_.'</a>&nbsp</th>'."\n";  
     }      }
     $Str .= "\n".'</tr>'."\n";      my @GData = ($title,$xaxis,$yaxis,$Max,$sendCount,$sendValues);
     return $Str;      return '<IMG src="/cgi-bin/graph.png?'.
           (join('&', @GData)).'" border="1" />';
 }  }
   
 sub BuildStatisticsTable {  sub get_statistics {
     my ($cache,$displayFormat,$sortProblems,$orderedProblems,$headings,      my ($sequence,$resource,$part,$problem_num) = @_;
         $r,$color)=@_;      #
     my $count = 1;      my $symb = $resource->{'symb'};
     my $currentSequence = -1;      my $courseid = $ENV{'request.course.id'};
     foreach(@$orderedProblems) {      #
         my ($sequence,$problem,$part)=split(':', $_);      my $students = \@Apache::lonstatistics::Students;
         if($cache->{'StatisticsMaps'} ne 'All Maps'  &&      if ($Apache::lonstatistics::SelectedSections[0] eq 'all') {
            $cache->{'StatisticsMaps'} ne $cache->{$sequence.':title'}) {          $students = undef;
             next;  
         }  
         if($currentSequence == -1 ||  
            ($sortProblems eq 'Sort Within Sequence' &&  
             $currentSequence != $sequence)) {  
             if($displayFormat ne 'Display CSV Format') {  
                 if($currentSequence ne -1) {  
                     $r->print('</table>');  
                     $r->print('</td></tr></table><br>');  
                 }  
                 if($sortProblems eq 'Sort Within Sequence') {  
                     $r->print('<b>'.$cache->{$sequence.':title'}.'</b>');  
                 }  
                 $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");  
                 $r->print('<table border="0" cellpadding="3">'."\n");  
                 $r->print(&CreateProblemStatisticsTableHeading($headings, $r));  
             } else {  
                 if($sortProblems eq 'Sort Within Sequence') {  
                     $r->print('"'.$cache->{$sequence.':title'}.'"');  
                 }  
                 $r->print('<br>');  
             }  
             $currentSequence = $sequence;  
         }  
         my $ref = '<a href="'.$cache->{$problem.':source'}.  
                   '" target="_blank">'.$cache->{$problem.':title'}.'</a>';  
         my $title = $cache->{$problem.':title'};  
         if($part != 0) {  
             $title .= ' Part '.$part;  
         }  
         my $source = $cache->{$problem.':source'};  
         my $tableData = join('&', $ref, $title, $source,  
                        $cache->{$_.':studentCount'},  
                        $cache->{$_.':totalTries'},  
                        $cache->{$_.':maxTries'},  
                        $cache->{$_.':mean'},  
                        $cache->{$_.':correct'},  
                        $cache->{$_.':correctByOverride'},  
                        $cache->{$_.':percentWrong'},  
                        $cache->{$_.':degreeOfDifficulty'},  
                        $cache->{$_.':standardDeviation'},  
                        $cache->{$_.':skewness'},  
                        $cache->{$_.':discriminationFactor1'},  
                        $cache->{$_.':discriminationFactor2'});  
         &TableRow($displayFormat,$tableData,$count,$r,$color);  
         $count++;  
     }  
     if($displayFormat ne 'Display CSV Format') {  
         $r->print('</table>'."\n");  
         $r->print('</td></tr></table>');  
     } else {  
         $r->print('<br>');  
     }      }
     return;      my $data = &Apache::loncoursedata::get_problem_statistics
                           ($students,$symb,$part,$courseid);
       $data->{'part'}        = $part;
       $data->{'problem_num'} = $problem_num;
       $data->{'container'}   = $sequence->{'title'};
       $data->{'title'}       = $resource->{'title'};
       $data->{'title.link'}  = $resource->{'src'};
       #
       return $data;
 }  }
   
 sub TableRow {  ###############################################
     my ($displayFormat,$Str,$RealIdx,$r,$color)=@_;  ###############################################
     my($ref,$title,$source,$StdNo,$TotalTries,$MxTries,$Avg,$YES,$Override,  
        $Wrng,$DoD,$SD,$Sk,$_D1,$_D2)=split(/\&/,$Str);  
     my $Ptr;  
     if($displayFormat eq 'Display CSV Format') {  
         $Ptr='"'.$RealIdx.'",'."\n".  
              '"'.$title.'",'."\n".  
              '"'.$source.'",'."\n".  
              '"'.$StdNo.'",'."\n".  
              '"'.$TotalTries.'",'."\n".  
              '"'.$MxTries.'",'."\n".  
              '"'.$Avg.'",'."\n".  
              '"'.$YES.'",'."\n".  
              '"'.$Override.'",'."\n".  
              '"'.$Wrng.'",'."\n".  
              '"'.$DoD.'",'."\n".  
              '"'.$SD.'",'."\n".  
              '"'.$Sk.'",'."\n".  
              '"'.$_D1.'",'."\n".  
              '"'.$_D2.'"'."\n".  
              "<br>\n";  
         $r->print("\n".$Ptr);  
     } else {  
         $Ptr='<tr>'."\n".  
              '<td bgcolor="#ffffe6">'.$RealIdx.'</td>'."\n".  
              '<td bgcolor="#ffffe6">'.$ref.'</td>'."\n".  
              '<td bgcolor='.$color->{"yellow"}.'> '.$StdNo.'</td>'."\n".  
              '<td bgcolor='.$color->{"yellow"}.'>'.$TotalTries.'</td>'."\n".  
              '<td bgcolor='.$color->{"yellow"}.'>'.$MxTries.'</td>'."\n".  
              '<td bgcolor='.$color->{"gb"}.'>'.$Avg.'</td>'."\n".  
              '<td bgcolor='.$color->{"gb"}.'> '.$YES.'</td>'."\n".  
              '<td bgcolor='.$color->{"gb"}.'> '.$Override.'</td>'."\n".  
              '<td bgcolor='.$color->{"red"}.'> '.$Wrng.'</td>'."\n".  
              '<td bgcolor='.$color->{"red"}.'> '.$DoD.'</td>'."\n".  
              '<td bgcolor='.$color->{"green"}.'> '.$SD.'</td>'."\n".  
              '<td bgcolor='.$color->{"green"}.'> '.$Sk.'</td>'."\n".  
              '<td bgcolor='.$color->{"purple"}.'> '.$_D1.'</td>'."\n".  
      '<td bgcolor='.$color->{"purple"}.'> '.$_D2.'</td>'."\n";  
         $r->print($Ptr.'</tr>'."\n");  
     }  
     return;  
 }  
   
 # For loading the colored table for display or un-colored for print  =pod 
 sub setbgcolor {  
     my $PrintTable=shift;  =item &ProblemStatisticsLegend()
     my %color;  
     if ($PrintTable){  =cut
  $color{"gb"}="#FFFFFF";  
  $color{"red"}="#FFFFFF";  
  $color{"yellow"}="#FFFFFF";  
  $color{"green"}="#FFFFFF";  
  $color{"purple"}="#FFFFFF";  
     } else {  
  $color{"gb"}="#DDFFFF";  
  $color{"red"}="#FFDDDD";  
  $color{"yellow"}="#EEFFCC";  
  $color{"green"}="#DDFFDD";  
  $color{"purple"}="#FFDDFF";  
     }  
     return \%color;  
 }  
   
 sub ProblemStatisticsButtons {  
     my ($displayFormat, $displayLegend, $sortProblems)=@_;  
     my $Ptr = '<tr><td></td><td align="left">';  
     $Ptr .= '<input type="submit" name="DoDiffGraph" ';  
     $Ptr .= 'value="Plot Degree of Difficulty" />'."\n";  
     $Ptr .= '</td><td align="left">';  
     $Ptr .= '<input type="submit" name="PercentWrongGraph" ';  
     $Ptr .= 'value="Plot Percent Wrong" />'."\n";  
     $Ptr .= '</td></tr><tr><td></td><td>'."\n";  
     $Ptr .= '<input type="submit" name="SortProblems" ';  
     if($sortProblems eq 'Sort All Problems') {  
         $Ptr .= 'value="Sort Within Sequence" />'."\n";  
     } else {  
         $Ptr .= 'value="Sort All Problems" />'."\n";  
     }  
     $Ptr .= '</td><td align="left">';  
     $Ptr .= '<input type="submit" name="DisplayLegend" ';  
     if($displayLegend eq 'Show Legend') {  
         $Ptr .= 'value="Hide Legend" />'."\n";  
     } else {  
         $Ptr .= 'value="Show Legend" />'."\n";  
     }  
     $Ptr .= '</td><td align="left">';  
     $Ptr .= '<input type="submit" name="DisplayCSVFormat" ';  
     if($displayFormat eq 'Display CSV Format') {  
         $Ptr .= 'value="Display Table Format" />'."\n";  
     } else {  
         $Ptr .= 'value="Display CSV Format" />'."\n";  
     }  
     $Ptr .= '</td></tr>';  
     return $Ptr;  
 }  
   
   ###############################################
   ###############################################
 sub ProblemStatisticsLegend {  sub ProblemStatisticsLegend {
     my $Ptr = '';      my $Ptr = '';
     $Ptr = '<table border="0">';      $Ptr = '<table border="0">';
Line 662  sub ProblemStatisticsLegend { Line 908  sub ProblemStatisticsLegend {
     $Ptr .= '<b>Tries</b></td>';      $Ptr .= '<b>Tries</b></td>';
     $Ptr .= '<td>Total number of tries for solving the problem.';      $Ptr .= '<td>Total number of tries for solving the problem.';
     $Ptr .= '</td></tr><tr><td>';      $Ptr .= '</td></tr><tr><td>';
     $Ptr .= '<b>Mod</b></td>';      $Ptr .= '<b>Max Tries</b></td>';
     $Ptr .= '<td>Largest number of tries for solving the problem by a student.';      $Ptr .= '<td>Largest number of tries for solving the problem by a student.';
     $Ptr .= '</td></tr><tr><td>';      $Ptr .= '</td></tr><tr><td>';
     $Ptr .= '<b>Mean</b></td>';      $Ptr .= '<b>Mean</b></td>';

Removed from v.1.41  
changed lines
  Added in v.1.52


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