Diff for /loncom/interface/statistics/lonproblemstatistics.pm between versions 1.37 and 1.79

version 1.37, 2002/11/26 16:59:03 version 1.79, 2004/04/01 20:02:56
Line 1 Line 1
 # The LearningOnline Network with CAPA  # The LearningOnline Network with CAPA
 # (Publication Handler  
 #  #
 # $Id$  # $Id$
 #  #
Line 26 Line 25
 # http://www.lon-capa.org/  # http://www.lon-capa.org/
 #  #
 # (Navigate problems for statistical reports  # (Navigate problems for statistical reports
 # YEAR=2001  
 # 5/5,7/9,7/25/1,8/11,9/13,9/26,10/5,10/9,10/22,10/26 Behrouz Minaei  
 # 11/1,11/4,11/16,12/14,12/16,12/18,12/20,12/31 Behrouz Minaei  
 # YEAR=2002  
 # 1/22,2/1,2/6,2/25,3/2,3/26,4/7,5/6 Behrouz Minaei  
 # 5/12,5/26,7/16,7/29,8/5,10/31  Behrouz Minaei  
 #  #
 ###  ###############################################
   ###############################################
   
   =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;
   
 use strict;  use strict;
 use Apache::lonnet();  use Apache::lonnet();
   use Apache::loncommon();
 use Apache::lonhtmlcommon;  use Apache::lonhtmlcommon;
 use Apache::loncoursedata;  use Apache::loncoursedata;
 use GDBM_File;  use Apache::lonstatistics;
   use Apache::lonlocal;
   use Spreadsheet::WriteExcel;
 sub InitializeProblemStatistics {  use Apache::lonstathelpers();
     my ($cacheDB, $students, $courseID, $c, $r)=@_;  use Time::HiRes;
     my %cache;  
   my @StatsArray;
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  my %SeqStat;    # keys are symbs, values are hash refs
         $r->print('Unable to tie database1.');  
         return ('ERROR', undef);  ##
     }  ## Localization notes:
   ##
     # Remove students who don't have the proper section.  ## in @Fields[0]->{'long_title'} is placed in Excel files and is used as the
     my @sectionsSelected = split(':',$cache{'sectionsSelected'});  ## header for plots created with Graph.pm, both of which more than likely do
     for(my $studentIndex=((scalar @$students)-1); $studentIndex>=0;  ## not support localization.
         $studentIndex--) {  ##
         my $value = $cache{$students->[$studentIndex].':section'};  #
         my $found = 0;  #
         foreach (@sectionsSelected) {  ##
             if($_ eq 'none') {  ## Description of Field attributes
                 if($value eq '' || !defined($value) || $value eq ' ') {  ##
                     $found = 1;  ## Attribute     Required   Value       Meaning or Use
                     last;  ##
                 }  ## name            yes      any scalar  Used to uniquely identify field
             } else {  ## title           yes      any scalar  This is what the user sees to identify
                 if($value eq $_) {  ##                                      the field.  Passed through &mt().
                     $found = 1;  ## long_title      yes      any scalar  Used as graph heading and in excel
                     last;  ##                                      output.  NOT translated
                 }  ## align           no    (left|right|center)  HTML cell contents alignment
   ## color           yes      html color  HTML cell background color
   ##                                      used to visually group statistics
   ## special         no          (link)   Indicates a link, target is name.link
   ##                                      Currently set in &get_statistics()
   ## graphable       no      (yes|no)     Can a bar graph of the field be 
   ##                                      produced?
   ## sortable        no      (yes|no)     Should a sort link be put in the
   ##                                      column header?
   ## selectable      yes     (yes|no)     Can the column be removed from the
   ##                                      statistics display?
   ## selected        yes     (yes|no)     Is the column selected by default?
   ##
   my @Fields = (
              { name => 'problem_num',
                title => 'P#',
                align => 'right',
                color => '#FFFFE6',
                selectable => 'no',
                selected => 'yes',
              },
              { name   => 'container',
                title  => 'Sequence or Folder',
                align  => 'left',
                color  => '#FFFFE6',
                sortable => 'yes',
                selectable => 'no',
                selected => 'yes',
              },
              { name   => 'title',
                title  => 'Title',
                align  => 'left',
                color  => '#FFFFE6',
                special  => 'link',
                sortable => 'yes', 
                selectable => 'no',
                selected => 'yes',
              },
              { name   => 'part', 
                title  => 'Part',
                align  => 'left',
                color  => '#FFFFE6',
                selectable => 'no',
                selected => 'yes',
              },
              { name   => 'num_students',
                title  => '#Stdnts',
                align  => 'right',
                color  => '#EEFFCC',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of Students Attempting Problem',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'tries',
                title  => 'Tries',
                align  => 'right',
                color  => '#EEFFCC',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Total Number of Tries',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'max_tries',
                title  => 'Max Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Maximum Number of Tries',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'min_tries',
                title  => 'Min Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Minumum Number of Tries',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'mean_tries',
                title  => 'Mean Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Average Number of Tries',
                selectable => 'yes',
                selected => 'yes',
              },
              { 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',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'skew_tries',
                title  => 'Skew Tries',
                align  => 'right',
                color  => '#DDFFFF',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Skew of Number of Tries',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'num_solved',
                title  => '#YES',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%4.1f',#             format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of Students able to Solve',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'num_override',
                title  => '#yes',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%4.1f',#             format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of Students given Override',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'num_wrong',
                title  => '#Wrng',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%4.1f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Percent of students whose final answer is wrong',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'deg_of_diff',
                title  => 'DoDiff',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%5.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Degree of Difficulty'.
                              '[ 1 - ((#YES+#yes) / Tries) ]',
                selectable => 'yes',
                selected => 'yes',
              },
              { name   => 'deg_of_disc',
                title  => 'DoDisc',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Degree of Discrimination',
                selectable => 'yes',
                selected => 'no',
              },
   );
   
   my @SeqFields = (
              { name   => 'title',
                title  => 'Sequence',
                align  => 'left',
                color  => '#FFFFE6',
                special  => 'no',
                sortable => 'no', 
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'items',
                title  => '#Items',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4d',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Number of Items in Sequence',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'scoremean',
                title  => 'Score Mean',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Mean Sequence Score',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'scorestd',
                title  => 'Score STD',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Standard Deviation of Sequence Scores',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'scoremax',
                title  => 'Score Max',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Maximum Sequence Score',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'scoremin',
                title  => 'Score Min',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Minumum Sequence Score',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'scorecount',
                title  => 'Score N',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4d',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Number of Students in score computations',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'countmean',
                title  => 'Count Mean',
                align  => 'right',
                color  => '#FFFFFF',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Mean Sequence Score',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'countstd',
                title  => 'Count STD',
                align  => 'right',
                color  => '#FFFFFF',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Standard Deviation of Sequence Scores',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'countmax',
                title  => 'Count Max',
                align  => 'right',
                color  => '#FFFFFF',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Maximum Number of Correct Problems',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'countmin',
                title  => 'Count Min',
                align  => 'right',
                color  => '#FFFFFF',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Minumum Number of Correct Problems',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'count',
                title  => 'Count N',
                align  => 'right',
                color  => '#FFFFFF',
                format => '%4d',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Number of Students in score computations',
                selectable => 'yes',
                selected => 'no',
              },
              { name   => 'KR-21',
                title  => 'KR-21',
                align  => 'right',
                color  => '#FFAAAA',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'KR-21 reliability statistic',
                selectable => 'yes',
                selected => 'no',
              },           
   );
   
   my %SelectedFields;
   
   sub parse_field_selection {
       #
       # Pull out the defaults
       if (! defined($ENV{'form.fieldselections'})) {
           $ENV{'form.fieldselections'} = [];
           foreach my $field (@Fields) {
               next if ($field->{'selectable'} ne 'yes');
               if ($field->{'selected'} eq 'yes') {
                   push(@{$ENV{'form.fieldselections'}},$field->{'name'});
             }              }
         }          }
         if($found == 0) {  
             splice(@$students, $studentIndex, 1);  
         }  
     }      }
       #
     my $isNotCached = 0;      # This should not happen, but in case it does...
     my $lastStatus = (defined($cache{'StatisticsLastStatus'})) ?      if (ref($ENV{'form.fieldselections'}) ne 'ARRAY') {
                      $cache{'StatisticsLastStatus'} : 'Nothing';          $ENV{'form.fieldselections'} = [$ENV{'form.fieldselections'}];
     my $whichStudents = join(':::',sort(@$students));      }
     if(!defined($cache{'StatisticsCached'}) ||      #
        $lastStatus ne $cache{'Status'} ||      # Set the field data and the selected fields (for easier checking)
        $whichStudents ne $cache{'StatisticsWhichStudents'}) {      undef(%SelectedFields);
         $isNotCached = 1;      foreach my $field (@Fields) {
           next if ($field->{'selectable'} ne 'yes');
           $field->{'selected'} = 'no';
           foreach my $selection (@{$ENV{'form.fieldselections'}}) {
               if ($selection eq $field->{'name'} || $selection eq 'all') {
                   $field->{'selected'} = 'yes';
                   $SelectedFields{$field->{'name'}}++;
               }
           }
     }      }
       return;
   }
   
     untie(%cache);  sub field_selection_input {
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) {      my $Str = '<select name="fieldselections" multiple size="5">'."\n";
         $r->print('Unable to tie database.2');      $Str .= '<option value="all">all</option>'."\n";
         return ('ERROR', undef);      foreach my $field (@Fields) {
     }          next if ($field->{'selectable'} ne 'yes');
     if($isNotCached && defined($cache{'StatisticsCached'})) {          $Str .= '    <option value="'.$field->{'name'}.'" ';
         my @statkeys = split(':::', $cache{'StatisticsKeys'});          if ($field->{'selected'} eq 'yes') {
         delete $cache{'StatisticsKeys'};              $Str .= 'selected ';
         delete $cache{'StatisticsCached'};  
         foreach(@statkeys) {  
             delete $cache{$_};  
         }          }
           $Str .= '>'.$field->{'title'}.'</option>'."\n";
     }      }
       $Str .= "</select>\n";
   }
   
     untie(%cache);  ###############################################
     if($isNotCached) {  ###############################################
         &Apache::loncoursedata::DownloadStudentCourseDataSeparate($students,  
                                                                   'true',  
                                                                   $cacheDB,  
                                                                   'true',  
                                                                   'true',  
                                                                   $courseID,  
                                                                   $r, $c);  
     }  
     if($c->aborted()) { return ('ERROR', undef); }  
   
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  =pod 
         $r->print('Unable to tie database.3');  
         return ('ERROR', undef);  
     }  
     my $problemData;  
     if($isNotCached) {  
         ($problemData) = &ExtractStudentData(\%cache, $students);  
         &CalculateStatistics($problemData, \%cache, $courseID);  
     }  
     untie(%cache);  
   
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_WRCREAT(),0640)) {  =item &CreateInterface()
         $r->print('Unable to tie database.4');  
         return ('ERROR', undef);  
     }  
     if($isNotCached) {  
         foreach(keys(%$problemData)) {  
             $cache{$_} = $problemData->{$_};  
         }  
         $cache{'StatisticsKeys'} = join(':::', keys(%$problemData));  
         $cache{'StatisticsCached'} = 'true';  
         $cache{'StatisticsLastStatus'} = $cache{'Status'};  
         $cache{'StatisticsWhichStudents'} = $whichStudents;  
     }  
     untie(%cache);  
   
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  Create the main intereface for the statistics page.  Allows the user to
         $r->print('Unable to tie database.5');  select sections, maps, and output.
         return ('ERROR', undef);  
     }  =cut
   
   ###############################################
   ###############################################
   sub CreateInterface {
       &parse_field_selection();
       my $Str = '';
       $Str .= &Apache::lonhtmlcommon::breadcrumbs
           (undef,'Overall Problem Statistics','Statistics_Overall_Key');
       $Str .= '<table cellspacing="5">'."\n";
       $Str .= '<tr>';
       $Str .= '<td align="center"><b>'.&mt('Sections').'</b></td>';
       $Str .= '<td align="center"><b>'.&mt('Enrollment Status').'</b></td>';
       $Str .= '<td align="center"><b>'.&mt('Sequences and Folders').'</b></td>';
       $Str .= '<td align="center"><b>'.&mt('Statistics').'</b></td>';
       $Str .= '<td rowspan="2">'.
           &Apache::lonstathelpers::limit_by_time_form().'</td>';
       $Str .= '</tr>'."\n";
       #
       $Str .= '<tr><td align="center">'."\n";
       $Str .= &Apache::lonstatistics::SectionSelect('Section','multiple',5);
       $Str .= '</td><td align="center">';
       $Str .= &Apache::lonhtmlcommon::StatusOptions(undef,undef,5);
       $Str .= '</td><td align="center">';
       #
       my $only_seq_with_assessments = sub { 
           my $s=shift;
           if ($s->{'num_assess'} < 1) { 
               return 0;
           } else { 
               return 1;
           }
       };
       $Str .= &Apache::lonstatistics::MapSelect('Maps','multiple,all',5,
                                                 $only_seq_with_assessments);
       $Str .= '</td><td>'.&field_selection_input();
       $Str .= '</td></tr>'."\n";
       $Str .= '</table>'."\n";
       $Str .= '<input type="submit" name="GenerateStatistics" value="'.
           &mt('Generate Statistics').'" />';
       $Str .= '&nbsp;'x5;
       $Str .= 'Plot '.&plot_dropdown().('&nbsp;'x10);
       $Str .= '<input type="submit" name="ClearCache" value="'.
           &mt('Clear Caches').'" />';
       $Str .= '&nbsp;'x5;
       $Str .= '<input type="submit" name="UpdateCache" value="'.
           &mt('Update Student Data').'" />';
       $Str .= '&nbsp;'x5;
       $Str .= '<input type="submit" name="Excel" value="'.
           &mt('Produce Excel Output').'" />';
       $Str .= '&nbsp;'x5;
       return $Str;
   }
   
     my $orderedProblems = &SortProblems(\%cache,  ###############################################
                                         $cache{'ProblemStatisticsSort'},  ###############################################
                                         $cache{'SortProblems'},  
                                         $cache{'ProblemStatisticsAscend'});  
     untie(%cache);  
   
     return ('OK', $orderedProblems);  =pod 
 }  
   
 sub BuildProblemStatisticsPage {  =item &BuildProblemStatisticsPage()
     my ($cacheDB, $students, $courseID, $c, $r)=@_;  
   
     my @Header = ("Homework Sets Order","#Stdnts","Tries","Mod",  Main interface to problem statistics.
                   "Mean","#YES","#yes","%Wrng","DoDiff",  
                   "S.D.","Skew.","D.F.1st","D.F.2nd");  
     my $color=&setbgcolor(0);  
     my %cache;  
   
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  =cut
         $r->print('Unable to tie database.6');  
   ###############################################
   ###############################################
   sub BuildProblemStatisticsPage {
       my ($r,$c)=@_;
       #
       my %Saveable_Parameters = ('Status' => 'scalar',
                                  'statsoutputmode' => 'scalar',
                                  'Section' => 'array',
                                  'StudentData' => 'array',
                                  'Maps' => 'array',
                                  'fieldselections'=> 'array');
       &Apache::loncommon::store_course_settings('statistics',
                                                 \%Saveable_Parameters);
       &Apache::loncommon::restore_course_settings('statistics',
                                                   \%Saveable_Parameters);
       #
       &Apache::lonstatistics::PrepareClasslist();
       #
       # Clear the package variables
       undef(@StatsArray);
       undef(%SeqStat);
       #
       # Finally let the user know we are here
       my $interface = &CreateInterface();
       $r->print($interface);
       $r->print('<input type="hidden" name="sortby" value="'.$ENV{'form.sortby'}.
                 '" />');
       #
       if (! exists($ENV{'form.statsfirstcall'})) {
           $r->print('<input type="hidden" name="statsfirstcall" value="yes" />');
           $r->print('<h3>'.
                     &mt('Press "Generate Statistics" when you are ready.').
                     '</h3><p>'.
                     &mt('It may take some time to update the student data '.
                         'for the first analysis.  Future analysis this session '.
                         ' will not have this delay.').
                     '</p>');
         return;          return;
       } elsif ($ENV{'form.statsfirstcall'} eq 'yes' || 
                exists($ENV{'form.UpdateCache'}) ||
                exists($ENV{'form.ClearCache'}) ) {
           $r->print('<input type="hidden" name="statsfirstcall" value="no" />');
           &Apache::lonstatistics::Gather_Student_Data($r);
       } else {
           $r->print('<input type="hidden" name="statsfirstcall" value="no" />');
     }      }
     my $Ptr = '';  
     $Ptr .= '<table border="0" cellspacing="5"><tbody>';  
     $Ptr .= '<tr><td align="right"><b>Select Map</b></td>'."\n";  
     $Ptr .= '<td align="left">';  
     $Ptr .= &Apache::lonhtmlcommon::MapOptions(\%cache, 'Statistics',  
                                                'Statistics');  
     $Ptr .= '</td></tr>'."\n";  
     $Ptr .= '<tr><td align="right"><b>Sorting Type:</b></td>'."\n";  
     $Ptr .= '<td align="left">'."\n";  
     $Ptr .= &Apache::lonhtmlcommon::AscendOrderOptions(  
                                            $cache{'ProblemStatisticsAscend'},  
                                            'ProblemStatistics',  
                                            'Statistics');  
     $Ptr .= '</td></tr>'."\n";  
     $Ptr .= '<tr><td align="right"><b>Select Sections</b>';  
     $Ptr .= '</td>'."\n";  
     $Ptr .= '<td align="left">'."\n";  
     my @sections = split(':',$cache{'sectionList'});  
     my @sectionsSelected = split(':',$cache{'sectionsSelected'});  
     $Ptr .= &Apache::lonhtmlcommon::MultipleSectionSelect(\@sections,  
                                                           \@sectionsSelected,  
                                                           'Statistics');  
     $Ptr .= '</td></tr>'."\n";  
     $Ptr .= &ProblemStatisticsButtons($cache{'DisplayFormat'},  
                                       $cache{'DisplayLegend'},  
                                       $cache{'SortProblems'});  
     $Ptr .= '</table>';  
     if($cache{'DisplayLegend'} eq 'Show Legend') {  
         $Ptr .= &ProblemStatisticsLegend();  
     }  
     $r->print($Ptr);  
     $r->rflush();      $r->rflush();
     untie(%cache);      #
       # This probably does not need to be done each time we are called, but
     my ($result, $orderedProblems) =      # it does not slow things down noticably.
         &InitializeProblemStatistics($cacheDB, $students, $courseID, $c, $r);      &Apache::loncoursedata::populate_weight_table();
     if($result ne 'OK') {      #
         return;      if (exists($ENV{'form.Excel'})) {
           &Excel_output($r);
       } else {
           my $count = 0;
           foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
               $count += $seq->{'num_assess_parts'};
           }
           if ($count > 10) {
               $r->print('<h2>'.
                         &mt('Compiling statistics for [_1] problems',$count).
                         '</h2>');
               if ($count > 30) {
                   $r->print('<h3>'.&mt('This will take some time.').'</h3>');
               }
               $r->rflush();
           }
           #
           my $sortby = $ENV{'form.sortby'};
           $sortby = 'container' if (! defined($sortby) || $sortby =~ /^\s*$/);
           my $plot = $ENV{'form.plot'};
           if ($plot eq '' || $plot eq 'none') {
               undef($plot);
           }
           if ($sortby eq 'container' && ! defined($plot)) {
               &output_sequence_statistics($r);
               &output_html_by_sequence($r);
           } else {
               if (defined($plot)) {
                   &make_plot($r,$plot);
               }
               &output_html_stats($r);
               &output_sequence_statistics($r);
           }
     }      }
       return;
   }
   
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  sub output_sequence_statistics {
         $r->print('Unable to tie database.6');      my ($r) = @_;
         return;      my $c=$r->connection();
       $r->print('<h2>'.&mt('Sequence Statistics').'</h2>');
       $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n".
                 '<table border="0" cellpadding="3">'."\n".
                 '<tr bgcolor="#FFFFE6">');
       $r->print(&sequence_html_header());
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           last if ($c->aborted);
           next if ($seq->{'num_assess'} < 1);
           &compute_sequence_statistics($seq);
           $r->print(&sequence_html_output($seq));
     }      }
     &BuildStatisticsTable(\%cache, $cache{'DisplayFormat'},      $r->print('</table>');
                           $cache{'SortProblems'}, $orderedProblems,      $r->print('</table>');
                           \@Header, $r, $color);      $r->rflush();
     untie(%cache);  
   
     return;      return;
 }  }
   
 sub BuildGraphicChart {  
     my ($graph,$cacheDB,$courseDescription,$students,$courseID,$r,$c)=@_;  
     my %cache;  
     my $max;  
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {  
         return 'Unable to tie database.7';  
     }  
   
     my $title = '';  ##########################################################
     if($graph eq 'DoDiffGraph') {  ##########################################################
  $title = 'Degree-of-Difficulty';  ##
     } else {  ## HTML output routines
  $title = 'Wrong-Percentage';  ##
   ##########################################################
   ##########################################################
   sub output_html_by_sequence {
       my ($r) = @_;
       my $c = $r->connection();
       $r->print(&html_preamble());
       #
       foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
           last if ($c->aborted);
           next if ($seq->{'num_assess'} < 1);
           $r->print("<h3>".$seq->{'title'}."</h3>".
                     '<table border="0"><tr><td bgcolor="#777777">'."\n".
                     '<table border="0" cellpadding="3">'."\n".
                     '<tr bgcolor="#FFFFE6">'.
                     &statistics_table_header('no container')."</tr>\n");
           my @Data = &compute_statistics_on_sequence($seq);
           foreach my $data (@Data) {
               $r->print('<tr>'.&statistics_html_table_data($data,
                                                            'no container').
                         "</tr>\n");
           }
           $r->print('</table>'."\n".'</table>'."\n");
           $r->rflush();
     }      }
       return;
   }
   
     my $currentSequence = -1;  sub output_html_stats {
     my $sortProblems = 'Sort Within Sequence';      my ($r)=@_;
       &compute_all_statistics($r);
       $r->print(&html_preamble());
       &sort_data($ENV{'form.sortby'});
       #
       my $count=0;
       foreach my $data (@StatsArray) {
           if ($count++ % 50 == 0) {
               $r->print("</table>\n</table>\n");
               $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n".
                         '<table border="0" cellpadding="3">'."\n".
                         '<tr bgcolor="#FFFFE6">'.
                         '<tr bgcolor="#FFFFE6">'.
                         &statistics_table_header().
                         "</tr>\n");
           }
           $r->print('<tr>'.&statistics_html_table_data($data)."</tr>\n");
       }
       $r->print("</table>\n</table>\n");
       return;
   }
   
     my ($result, $orderedProblems) =  sub html_preamble {
         &InitializeProblemStatistics($cacheDB, $students, $courseID, $c, $r);      my $Str='';
     if($result ne 'OK') {      $Str .= "<h2>".
         return;          $ENV{'course.'.$ENV{'request.course.id'}.'.description'}.
           "</h2>\n";
       my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
       if (defined($starttime) || defined($endtime)) {
           # Inform the user what the time limits on the data are.
           $Str .= '<h3>'.&mt('Statistics on submissions from [_1] to [_2]',
                              &Apache::lonlocal::locallocaltime($starttime),
                              &Apache::lonlocal::locallocaltime($endtime)
                              ).'</h3>';
     }      }
       $Str .= "<h3>".&mt('Compiled on [_1]',
                          &Apache::lonlocal::locallocaltime(time))."</h3>";
       return $Str;
   }
   
     my @values = ();  
   
     foreach(@$orderedProblems) {  ###############################################
         my ($sequence,$problem,$part)=split(':', $_);  ###############################################
         if($cache{'StatisticsMaps'} ne 'All Maps'  &&  ##
            $cache{'StatisticsMaps'} ne $cache{$sequence.':title'}) {  ## Misc HTML output routines
              next;  ##
         }  ###############################################
   ###############################################
         if( $currentSequence == -1 ||  sub statistics_html_table_data {
             ($sortProblems eq 'Sort Within Sequence' &&      my ($data,$options) = @_;
             $currentSequence != $sequence)) {      my $row = '';
     if($currentSequence != -1) {      foreach my $field (@Fields) {
  &DrawGraph(\@values,$courseDescription,$title,$max,$r);          next if ($options =~ /no $field->{'name'}/);
     }          next if ($field->{'selected'} ne 'yes');
             if($sortProblems eq 'Sort Within Sequence') {          $row .= '<td bgcolor="'.$field->{'color'}.'"';
                 $r->print('<br><b>'.$cache{$sequence.':title'}.'</b>'."\n");          if (exists($field->{'align'})) {
               $row .= ' align="'.$field->{'align'}.'"';
             }              }
           $row .= '>';
             $currentSequence = $sequence;          if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
             @values = ();              $row .= '<a href="'.$data->{$field->{'name'}.'.link'}.'">';
     $max=0;          }
         }          if (exists($field->{'format'})) {
         my $data = 0;              $row .= sprintf($field->{'format'},$data->{$field->{'name'}});
         if($graph eq 'DoDiffGraph') {  
             $data = sprintf("%.2f", $cache{$_.':degreeOfDifficulty'}),  
         } else {          } else {
             $data = sprintf("%.1f", $cache{$_.':percentWrong'}),              $row .= $data->{$field->{'name'}};
         }          }
         if($max < $data) {          if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
             $max = $data;              $row.= '</a>';
         }          }
         push(@values, $data);          $row .= '</td>';
     }      }
     untie(%cache);      return $row;
   
     &DrawGraph(\@values,$courseDescription,$title,$max,$r);  
   
     return;  
 }  }
   
   sub statistics_table_header {
 sub DrawGraph {      my ($options) = @_;
     my ($values,$courseDescription,$title,$Max,$r)=@_;      my $header_row;
     my $sendValues = join(',', @$values);      foreach my $field (@Fields) {
     my $sendCount = scalar(@$values);          next if ($options =~ /no $field->{'name'}/);
     $r->print("<br>The Maximum Value is: $Max");          next if ($field->{'selected'} ne 'yes');
     if ( $Max > 1 ) {          $header_row .= '<th>';
  if ($Max % 10) {          if (exists($field->{'sortable'}) && $field->{'sortable'} eq 'yes') {
             if ( int($Max) < $Max ) {              $header_row .= '<a href="javascript:'.
      $Max++;                  'document.Statistics.sortby.value='."'".$field->{'name'}."'".
  $Max = int($Max);                      ';document.Statistics.submit();">';
     }          }
  }          $header_row .= &mt($field->{'title'});
     #(10 - $Max % 10);          if ($options =~ /sortable/) {
     } else { $Max = 1; }              $header_row.= '</a>';
           }
     my @GData = ('','Problem_number',$title,$Max,$sendCount,$sendValues);          if ($options !~ /no plots/        && 
               exists($field->{'graphable'}) && 
 #    $r->print('</form>'."\n");              $field->{'graphable'} eq 'yes') {
     $r->print('<br>'."\n");              $header_row.=' (';
     $r->print('<IMG src="/cgi-bin/graph.gif?'.              $header_row .= '<a href="javascript:'.
               (join('&', @GData)).'" border="1" />');                  "document.Statistics.plot.value='$field->{'name'}'".
 #    $r->print('<form>'."\n");                      ';document.Statistics.submit();">';
     $r->print('<br>'."\n");              $header_row .= &mt('plot').'</a>)';
           }
           $header_row .= '</th>';
       }
       return $header_row;
 }  }
   
 #---- Problem Statistics Web Page ---------------------------------------  sub sequence_html_header {
       my $Str .= '<tr>';
 sub CreateProblemStatisticsTableHeading {      foreach my $field (@SeqFields) {
     my ($headings,$r)=@_;  #        next if ($field->{'selected'} ne 'yes');
           $Str .= '<th bgcolor="'.$field->{'color'}.'"';
     my $Str='';          $Str .= '>'.$field->{'title'}.'</th>';
     $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";      $Str .= '</tr>';
   
     return $Str;      return $Str;
 }  }
   
 sub BuildStatisticsTable {  
     my ($cache,$displayFormat,$sortProblems,$orderedProblems,$headings,  
         $r,$color)=@_;  
   
     my $count = 1;  
     my $currentSequence = -1;  
     foreach(@$orderedProblems) {  
         my ($sequence,$problem,$part)=split(':', $_);  
         if($cache->{'StatisticsMaps'} ne 'All Maps'  &&  
            $cache->{'StatisticsMaps'} ne $cache->{$sequence.':title'}) {  
             next;  
         }  
   
         if($currentSequence == -1 ||  sub sequence_html_output {
            ($sortProblems eq 'Sort Within Sequence' &&      my ($seq) = @_;
             $currentSequence != $sequence)) {      my $data = $SeqStat{$seq->{'symb'}};
             if($displayFormat ne 'Display CSV Format') {  #    $SeqStat{$symb}->{'max'}
                 if($currentSequence ne -1) {  #    $SeqStat{$symb}->{'min'}
                     $r->print('</table>');  #    $SeqStat{$symb}->{'mean'}
                     $r->print('</td></tr></table><br>');  #    $SeqStat{$symb}->{'std'}
                 }  #    $SeqStat{$symb}->{'count'}
                 if($sortProblems eq 'Sort Within Sequence') {  #    $SeqStat{$symb}->{'max_possible'}
                     $r->print('<b>'.$cache->{$sequence.':title'}.'</b>');      my $row = '<tr>';
                 }      foreach my $field (@SeqFields) {
                 $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");  #        next if ($field->{'selected'} ne 'yes');
                 $r->print('<table border="0" cellpadding="3">'."\n");          $row .= '<td bgcolor="'.$field->{'color'}.'"';
                 $r->print(&CreateProblemStatisticsTableHeading($headings, $r));          if (exists($field->{'align'})) {
             } else {              $row .= ' align="'.$field->{'align'}.'"';
                 if($sortProblems eq 'Sort Within Sequence') {          }
                     $r->print('"'.$cache->{$sequence.':title'}.'"');          $row .= '>';
                 }          if (exists($field->{'format'})) {
                 $r->print('<br>');              $row .= sprintf($field->{'format'},$data->{$field->{'name'}});
             }          } else {
             $currentSequence = $sequence;              $row .= $data->{$field->{'name'}};
         }          }
           $row .= '</td>';
       }
       $row .= '</tr>'."\n";
       return $row;
   }
   
         my $ref = '<a href="'.$cache->{$problem.':source'}.  ####################################################
                   '" target="_blank">'.$cache->{$problem.':title'}.'</a>';  ####################################################
         my $title = $cache->{$problem.':title'};  ##
         if($part != 0) {  ##    Plotting Routines
             $title .= ' Part '.$part;  ##
         }  ####################################################
         my $source = $cache->{$problem.':source'};  ####################################################
         my $tableData = join('&', $ref, $title, $source,  sub make_plot {
                        $cache->{$_.':studentCount'},      my ($r,$plot) = @_;
                        $cache->{$_.':totalTries'},      &compute_all_statistics($r);
                        $cache->{$_.':maxTries'},      &sort_data($ENV{'form.sortby'});
                        $cache->{$_.':mean'},      if ($plot eq 'degrees') {
                        $cache->{$_.':correct'},          &degrees_plot($r);
                        $cache->{$_.':correctByOverride'},      } elsif ($plot eq 'tries statistics') {
                        $cache->{$_.':percentWrong'},          &tries_data_plot($r);
                        $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 {      } else {
         $r->print('<br>');          &make_single_stat_plot($r,$plot);
     }      }
   
     return;      return;
 }  }
   
 sub TableRow {  sub make_single_stat_plot {
     my ($displayFormat,$Str,$RealIdx,$r,$color)=@_;      my ($r,$datafield) = @_;
     my($ref,$title,$source,$StdNo,$TotalTries,$MxTries,$Avg,$YES,$Override,      #
        $Wrng,$DoD,$SD,$Sk,$_D1,$_D2)=split(/\&/,$Str);      my $title; my $yaxis;
     my $Ptr;      foreach my $field (@Fields) {
     if($displayFormat eq 'Display CSV Format') {          next if ($field->{'name'} ne $datafield);
         $Ptr='"'.$RealIdx.'",'."\n".          $title = $field->{'long_title'};
              '"'.$title.'",'."\n".          $yaxis = $field->{'title'};
              '"'.$source.'",'."\n".          last;
              '"'.$StdNo.'",'."\n".      }
              '"'.$TotalTries.'",'."\n".      if ($title eq '' || $yaxis eq '') {
              '"'.$MxTries.'",'."\n".          # datafield is something we do not know enough about to plot
              '"'.$Avg.'",'."\n".          $r->print('<h3>'.
              '"'.$YES.'",'."\n".                    &mt('Unable to plot the requested statistic.').
              '"'.$Override.'",'."\n".                    '</h3>');
              '"'.$Wrng.'",'."\n".          return;
              '"'.$DoD.'",'."\n".      }
              '"'.$SD.'",'."\n".      #
              '"'.$Sk.'",'."\n".      # Build up the data sets to plot
              '"'.$_D1.'",'."\n".      my @Labels; 
              '"'.$_D2.'"'."\n".      my @Data;
              "<br>\n";      my $max = 1;
       foreach my $data (@StatsArray) {
           push(@Labels,$data->{'problem_num'});
           push(@Data,$data->{$datafield});
           if ($data->{$datafield}>$max) {
               $max = $data->{$datafield};
           }
       }
       foreach (1,2,3,4,5,10,15,20,25,40,50,75,100,150,200,250,300,500,600,750,
                1000,1500,2000,2500,3000,3500,4000,5000,7500,10000,15000,20000) {
           if ($max <= $_) {
               $max = $_;
               last;
           }
       }
       if ($max > 20000) {
           $max = 10000*(int($max/10000)+1);
       }
       #
       $r->print("<p>".&Apache::loncommon::DrawBarGraph($title,
                                                        'Problem Number',
                                                        $yaxis,
                                                        $max,
                                                        undef, # colors
                                                        \@Labels,
                                                        \@Data)."</p>\n");
       return;
   }
   
         $r->print("\n".$Ptr);  sub degrees_plot {
       my ($r)=@_;
       my $count = scalar(@StatsArray);
       my $width = 50 + 10*$count;
       $width = 300 if ($width < 300);
       my $height = 300;
       my $plot = '';
       my $ymax = 0;
       my $ymin = 0;
       my @Disc; my @Diff; my @Labels;    
       foreach my $data (@StatsArray) {
           push(@Labels,$data->{'problem_num'});
           my $disc = $data->{'deg_of_disc'};
           my $diff = $data->{'deg_of_diff'};
           push(@Disc,$disc);
           push(@Diff,$diff);
           #
           $ymin = $disc if ($ymin > $disc);
           $ymin = $diff if ($ymin > $diff);
           $ymax = $disc if ($ymax < $disc);
           $ymax = $diff if ($ymax < $diff);
       }
       #
       # Make sure we show relevant information.
       if ($ymin < 0) {
           if (abs($ymin) < 0.05) {
               $ymin = 0;
           } else {
               $ymin = -1;
           }
       }
       if ($ymax > 0) {
           if (abs($ymax) < 0.05) {
               $ymax = 0;
           } else {
               $ymax = 1;
           }
       }
       #
       my $xmax = $Labels[-1];
       if ($xmax > 50) {
           if ($xmax % 10 != 0) {
               $xmax = 10 * (int($xmax/10)+1);
           }
     } else {      } else {
         $Ptr='<tr>'."\n".          if ($xmax % 5 != 0) {
              '<td bgcolor="#ffffe6">'.$RealIdx.'</td>'."\n".              $xmax = 5 * (int($xmax/5)+1);
              '<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");  
     }      }
       #
       my $discdata .= '<data>'.join(',',@Labels).'</data>'.$/.
                       '<data>'.join(',',@Disc).'</data>'.$/;
       #
       my $diffdata .= '<data>'.join(',',@Labels).'</data>'.$/.
                       '<data>'.join(',',@Diff).'</data>'.$/;
       #
       $plot=<<"END";
   <gnuplot 
       texfont="10"
       fgcolor="x000000"
       plottype="Cartesian"
       font="large"
       grid="on"
       align="center"
       border="on"
       transparent="on"
       alttag="Sample Plot"
       samples="100"
       bgcolor="xffffff"
       height="$height"
       width="$width">
       <key 
           pos="top right"
           title=""
           box="off" />
       <title>Degree of Discrmination and Degree of Difficulty</title>
       <axis xmin="0" ymin="$ymin" xmax="$xmax" ymax="$ymax" color="x000000" />
       <xlabel>Problem Number</xlabel>
       <curve 
           linestyle="linespoints" 
           name="DoDisc" 
           pointtype="0" 
           color="x000000">
           $discdata
       </curve>
       <curve 
           linestyle="linespoints" 
           name="DoDiff" 
           pointtype="0" 
           color="xFF0000">
           $diffdata
       </curve>
   </gnuplot>
   END
       my $plotresult = 
           '<p>'.&Apache::lonxml::xmlparse($r,'web',$plot).'</p>'.$/;
       $r->print($plotresult);
     return;      return;
 }  }
   
 # For loading the colored table for display or un-colored for print  sub tries_data_plot {
 sub setbgcolor {      my ($r)=@_;
     my $PrintTable=shift;      my $count = scalar(@StatsArray);
     my %color;      my $width = 50 + 10*$count;
     if ($PrintTable){      $width = 300 if ($width < 300);
  $color{"gb"}="#FFFFFF";      my $height = 300;
  $color{"red"}="#FFFFFF";      my $plot = '';
  $color{"yellow"}="#FFFFFF";      my @STD;  my @Mean; my @Max; my @Min;
  $color{"green"}="#FFFFFF";      my @Labels;
  $color{"purple"}="#FFFFFF";      my $ymax = 5;
     } else {      foreach my $data (@StatsArray) {
  $color{"gb"}="#DDFFFF";          my $max = $data->{'mean_tries'} + $data->{'std_tries'};
  $color{"red"}="#FFDDDD";          $ymax = $max if ($ymax < $max);
  $color{"yellow"}="#EEFFCC";          $ymax = $max if ($ymax < $max);
  $color{"green"}="#DDFFDD";          push(@Labels,$data->{'problem_num'});
  $color{"purple"}="#FFDDFF";          push(@STD,$data->{'std_tries'});
     }          push(@Mean,$data->{'mean_tries'});
       }
     return \%color;      #
 }      # Make sure we show relevant information.
       my $xmax = $Labels[-1];
 sub ProblemStatisticsButtons {      if ($xmax > 50) {
     my ($displayFormat, $displayLegend, $sortProblems)=@_;          if ($xmax % 10 != 0) {
               $xmax = 10 * (int($xmax/10)+1);
     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 {      } else {
         $Ptr .= 'value="Sort All Problems" />'."\n";          if ($xmax % 5 != 0) {
               $xmax = 5 * (int($xmax/5)+1);
           }
     }      }
     $Ptr .= '</td><td align="left">';      $ymax = int($ymax)+1+2;
     $Ptr .= '<input type="submit" name="DisplayLegend" ';      #
     if($displayLegend eq 'Show Legend') {      my $std_data .= '<data>'.join(',',@Labels).'</data>'.$/.
         $Ptr .= 'value="Hide Legend" />'."\n";                      '<data>'.join(',',@Mean).'</data>'.$/;
     } else {      #
         $Ptr .= 'value="Show Legend" />'."\n";      my $std_error_data .= '<data>'.join(',',@Labels).'</data>'.$/.
                             '<data>'.join(',',@Mean).'</data>'.$/.
                             '<data>'.join(',',@STD).'</data>'.$/;
       #
       $plot=<<"END";
   <gnuplot 
       texfont="10"
       fgcolor="x000000"
       plottype="Cartesian"
       font="large"
       grid="on"
       align="center"
       border="on"
       transparent="on"
       alttag="Sample Plot"
       samples="100"
       bgcolor="xffffff"
       height="$height"
       width="$width">
       <title>Mean and S.D. of Tries</title>
       <axis xmin="0" ymin="0" xmax="$xmax" ymax="$ymax" color="x000000" />
       <xlabel>Problem Number</xlabel>
       <curve 
           linestyle="yerrorbars"
           name="S.D. Tries" 
           pointtype="1" 
           color="x666666">
           $std_error_data
       </curve>
       <curve 
           linestyle="points"
           name="Mean Tries" 
           pointtype="1" 
           color="xCC4444">
           $std_data
       </curve>
   </gnuplot>
   END
       my $plotresult = 
           '<p>'.&Apache::lonxml::xmlparse($r,'web',$plot).'</p>'.$/;
       $r->print($plotresult);
       return;
   }
   
   sub plot_dropdown {
       my $current = '';
       #
       if (defined($ENV{'form.plot'})) {
           $current = $ENV{'form.plot'};
       }
       #
       my @Additional_Plots = (
                               { graphable=>'yes',
                                 name => 'degrees',
                                 title => 'DoDisc and DoDiff' },
                               { graphable=>'yes',
                                 name => 'tries statistics',
                                 title => 'Mean and S.D. of Tries' });
       #
       my $Str= "\n".'<select name="plot" size="1">';
       $Str .= '<option name="none"></option>'."\n";
       $Str .= '<option name="none2">none</option>'."\n";
       foreach my $field (@Fields,@Additional_Plots) {
           if (! exists($field->{'graphable'}) ||
               $field->{'graphable'} ne 'yes') {
               next;
           }
           $Str .= '<option value="'.$field->{'name'}.'"';
           if ($field->{'name'} eq $current) {
               $Str .= ' selected ';
           }
           $Str.= '>'.&mt($field->{'title'}).'</option>'."\n";
     }      }
     $Ptr .= '</td><td align="left">';      $Str .= '</select>'."\n";
     $Ptr .= '<input type="submit" name="DisplayCSVFormat" ';      return $Str;
     if($displayFormat eq 'Display CSV Format') {  }
         $Ptr .= 'value="Display Table Format" />'."\n";  
   ###############################################
   ###############################################
   ##
   ## Excel output routines
   ##
   ###############################################
   ###############################################
   sub Excel_output {
       my ($r) = @_;
       $r->print('<h2>'.&mt('Preparing Excel Spreadsheet').'</h2>');
       ##
       ## Compute the statistics
       &compute_all_statistics($r);
       my $c = $r->connection;
       return if ($c->aborted());
       ##
       ## Create the excel workbook
       my $filename = '/prtspool/'.
           $ENV{'user.name'}.'_'.$ENV{'user.domain'}.'_'.
           time.'_'.rand(1000000000).'.xls';
       my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
       #
       # Create sheet
       my $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(&mt("Problems creating new Excel file.  ".
                     "This error has been logged.  ".
                     "Please alert your LON-CAPA administrator."));
           return 0;
       }
       #
       # 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);
       }
       my $excel_sheet = $excel_workbook->addworksheet(
           &Apache::loncommon::clean_excel_name($sheetname));
       ##
       ## Begin creating excel sheet
       ##
       my ($rows_output,$cols_output) = (0,0);
       #
       # 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 {      } else {
         $Ptr .= 'value="Display CSV Format" />'."\n";          if ($Sections[0] eq 'all') {
               $sectionstring = "All sections";
           } else {
               $sectionstring = "Section ".$Sections[0];
           }
     }      }
     $Ptr .= '</td></tr>';      $excel_sheet->write($rows_output,$cols_output++,$sectionstring);
       $cols_output += scalar(@Sections);
       #
       # Time restrictions
       my $time_string;
       if (defined($starttime)) {
           # call localtime but not lonlocal:locallocaltime because excel probably
           # cannot handle localized text.  Probably.
           $time_string .= 'Data collected from '.localtime($time_string);
           if (defined($endtime)) {
               $time_string .= ' to '.localtime($endtime);
           }
           $time_string .= '.';
       } elsif (defined($endtime)) {
           # See note above about lonlocal:locallocaltime
           $time_string .= 'Data collected before '.localtime($endtime).'.';
       }
       #
       # Put the date in there too
       $excel_sheet->write($rows_output,$cols_output++,
                           'Compiled on '.localtime(time));
       #
       $rows_output++; 
       $cols_output=0;
       #
       # Long Headers
       foreach my $field (@Fields) {
           next if ($field->{'name'} eq 'problem_num');
           next if ($field->{'selected'} ne 'yes');
           if (exists($field->{'long_title'})) {
               $excel_sheet->write($rows_output,$cols_output++,
                                   $field->{'long_title'});
           } else {
               $excel_sheet->write($rows_output,$cols_output++,'');
           }
       }
       $rows_output++;
       $cols_output=0;
       # Brief headers
       foreach my $field (@Fields) {
           next if ($field->{'selected'} ne 'yes');
           next if ($field->{'name'} eq 'problem_num');
           # Use english for excel as I am not sure how well excel handles 
           # other character sets....
           $excel_sheet->write($rows_output,$cols_output++,$field->{'title'});
       }
       $rows_output++;
       foreach my $data (@StatsArray) {
           $cols_output=0;
           foreach my $field (@Fields) {
               next if ($field->{'selected'} ne 'yes');
               next if ($field->{'name'} eq 'problem_num');
               $excel_sheet->write($rows_output,$cols_output++,
                                   $data->{$field->{'name'}});
           }
           $rows_output++;
       }
       #
       $excel_workbook->close();
       #
       # Tell the user where to get their excel file
       $r->print('<br />'.
                 '<a href="'.$filename.'">'.
                 &mt('Your Excel Spreadsheet').'</a>'."\n");
       $r->rflush();
       return;
   }
   
     return $Ptr;  ##################################################
   ##################################################
   ##
   ## Statistics Gathering and Manipulation Routines
   ##
   ##################################################
   ##################################################
   sub compute_statistics_on_sequence {
       my ($seq) = @_;
       my @Data;
       foreach my $res (@{$seq->{'contents'}}) {
           next if ($res->{'type'} ne 'assessment');
           foreach my $part (@{$res->{'parts'}}) {
               #
               # This is where all the work happens
               my $data = &get_statistics($seq,$res,$part,scalar(@StatsArray)+1);
               push (@Data,$data);
               push (@StatsArray,$data);
           }
       }
       return @Data;
 }  }
   
 sub ProblemStatisticsLegend {  sub compute_all_statistics {
     my $Ptr = '';      my ($r) = @_;
     $Ptr = '<table border="0">';      if (@StatsArray > 0) {
     $Ptr .= '<tr><td>';          # Assume we have already computed the statistics
     $Ptr .= '<b>#Stdnts</b></td>';          return;
     $Ptr .= '<td>Total number of students attempted the problem.';      }
     $Ptr .= '</td></tr><tr><td>';      my $c = $r->connection;
     $Ptr .= '<b>Tries</b></td>';      foreach my $seq (&Apache::lonstatistics::Sequences_with_Assess()) {
     $Ptr .= '<td>Total number of tries for solving the problem.';          last if ($c->aborted);
     $Ptr .= '</td></tr><tr><td>';          next if ($seq->{'num_assess'} < 1);
     $Ptr .= '<b>Mod</b></td>';          &compute_statistics_on_sequence($seq);
     $Ptr .= '<td>Largest number of tries for solving the problem by a student.';      }
     $Ptr .= '</td></tr><tr><td>';  }
     $Ptr .= '<b>Mean</b></td>';  
     $Ptr .= '<td>Average number of tries. [ Tries / #Stdnts ]';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>#YES</b></td>';  
     $Ptr .= '<td>Number of students solved the problem correctly.';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>#yes</b></td>';  
     $Ptr .= '<td>Number of students solved the problem by override.';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>%Wrong</b></td>';  
     $Ptr .= '<td>Percentage of students who tried to solve the problem ';  
     $Ptr .= 'but is still incorrect. [ 100*((#Stdnts-(#YES+#yes))/#Stdnts) ]';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>DoDiff</b></td>';  
     $Ptr .= '<td>Degree of Difficulty of the problem.  ';  
     $Ptr .= '[ 1 - ((#YES+#yes) / Tries) ]';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>S.D.</b></td>';  
     $Ptr .= '<td>Standard Deviation of the tries.  ';  
     $Ptr .= '[ sqrt(sum((Xi - Mean)^2)) / (#Stdnts-1) ';  
     $Ptr .= 'where Xi denotes every student\'s tries ]';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>Skew.</b></td>';  
     $Ptr .= '<td>Skewness of the students tries.';  
     $Ptr .= '[(sqrt( sum((Xi - Mean)^3) / #Stdnts)) / (S.D.^3)]';  
     $Ptr .= '</td></tr><tr><td>';  
     $Ptr .= '<b>Dis.F.</b></td>';  
     $Ptr .= '<td>Discrimination Factor: A Standard for evaluating the ';  
     $Ptr .= 'problem according to a Criterion<br>';  
     $Ptr .= '<b>[Criterion to group students into %27 Upper Students - ';  
     $Ptr .= 'and %27 Lower Students]</b><br>';  
     $Ptr .= '<b>1st Criterion</b> for Sorting the Students: ';  
     $Ptr .= '<b>Sum of Partial Credit Awarded / Total Number of Tries</b><br>';  
     $Ptr .= '<b>2nd Criterion</b> for Sorting the Students: ';  
     $Ptr .= '<b>Total number of Correct Answers / Total Number of Tries</b>';  
     $Ptr .= '</td></tr>';  
     $Ptr .= '<tr><td><b>Disc.</b></td>';  
     $Ptr .= '<td>Number of Students had at least one discussion.';  
     $Ptr .= '</td></tr></table>';  
   
     return $Ptr;  
 }  
   
 sub ExtractStudentData {  
     my ($cache, $students)=@_;  
   
     my @problemList=();  
     my %problemData;  
     foreach my $sequence (split(':', $cache->{'orderedSequences'})) {  
         foreach my $problemID (split(':', $cache->{$sequence.':problems'})) {  
             foreach my $part (split(/\:/,$cache->{$sequence.':'.  
                                                   $problemID.  
                                                   ':parts'})) {  
                 my $id = $sequence.':'.$problemID.':'.$part;  
                 push(@problemList, $id);  
                 my $totalTries = 0;  
                 my $totalAwarded = 0;  
                 my $correct = 0;  
                 my $correctByOverride = 0;  
                 my $studentCount = 0;  
                 my $maxTries = 0;  
                 my $totalFirst = 0;  
                 my @studentTries=();  
                 foreach(@$students) {  
                     my $code = $cache->{"$_:$problemID:$part:code"};  
   
                     if(defined($cache->{$_.':error'}) || $code eq ' ' ||  
                        $cache->{"$_:$problemID:NoVersion"} eq 'true') {  
                         next;  
                     }  
   
                     $studentCount++;  sub sort_data {
                     my $tries =  $cache->{"$_:$problemID:$part:tries"};      my ($sortkey) = @_;
                     if($maxTries < $tries) {      return if (! @StatsArray);
                         $maxTries = $tries;      #
       # Sort the data
       my $sortby = undef;
       foreach my $field (@Fields) {
           if ($sortkey eq $field->{'name'}) {
               $sortby = $field->{'name'};
           }
       }
       if (! defined($sortby) || $sortby eq '' || $sortby eq 'problem_num') {
           $sortby = 'container';
       }
       if ($sortby ne 'container') {
           # $sortby is already defined, so we can charge ahead
           if ($sortby =~ /^(title|part)$/i) {
               # Alpha comparison
               @StatsArray = 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
               @StatsArray = sort {
                   my $retvalue = 0;
                   if ($b->{$sortby} eq 'nan') {
                       if ($a->{$sortby} ne 'nan') {
                           $retvalue = -1;
                       } else {
                           $retvalue = 0;
                     }                      }
                     $totalTries += $tries;                  }
                     push(@studentTries, $tries);                  if ($a->{$sortby} eq 'nan') {
                       if ($b->{$sortby} ne 'nan') {
                     my $awarded = $cache->{"$_:$problemID:$part:awarded"};                          $retvalue = 1;
                     $totalAwarded += $awarded;  
   
                     if($code eq '*') {  
                         $correct++;  
                         if($tries == 1) {  
                             $totalFirst++;  
                         }  
                     } elsif($code eq '+') {  
                         $correctByOverride++;  
                     }                      }
                 }                  }
                   if ($retvalue eq '0') {
                 my $studentTriesJoined = join(':::', @studentTries);                      $retvalue = $b->{$sortby} <=> $a->{$sortby}     ||
                 $problemData{$id.':sequenceTitle'} =                              lc($a->{'title'}) <=> lc($b->{'title'}) ||
                     $cache->{$sequence.':title'};                              lc($a->{'part'})  <=> lc($b->{'part'});
                 $problemData{$id.':studentCount'} = $studentCount;                  }
                 $problemData{$id.':totalTries'} = $totalTries;                  $retvalue;
                 $problemData{$id.':studentTries'} = $studentTriesJoined;              } @StatsArray;
                 $problemData{$id.':totalAwarded'} = $totalAwarded;  
                 $problemData{$id.':correct'} = $correct;  
                 $problemData{$id.':correctByOverride'} = $correctByOverride;  
                 $problemData{$id.':wrong'} = $studentCount -   
                                              ($correct + $correctByOverride);  
                 $problemData{$id.':maxTries'} = $maxTries;  
                 $problemData{$id.':totalFirst'} = $totalFirst;  
             }  
         }          }
     }      }
       #
       # Renumber the data set
       my $count;
       foreach my $data (@StatsArray) {
           $data->{'problem_num'} = ++$count;
       }
       return;
   }
   
     my @upperStudents1=();  ########################################################
     my @lowerStudents1=();  ########################################################
     my @upperStudents2=();  
     my @lowerStudents2=();  =pod
     my $upperCount = int(0.27*scalar(@$students));  
     # Discriminant Factor criterion 1  =item &get_statistics()
     my $sortedStudents = &SortDivideByTries($students,$cache,':totalAwarded');  
   Wrapper routine from the call to loncoursedata::get_problem_statistics.  
     for(my $i=0; $i<$upperCount; $i++) {  Calls lonstathelpers::get_time_limits() to limit the data set by time
         push(@lowerStudents1, $sortedStudents->[$i]);  and &compute_discrimination_factor
         push(@upperStudents1, $sortedStudents->[(scalar(@$students)-$i-1)]);  
     }  Inputs: $sequence, $resource, $part, $problem_num
   
     $problemData{'studentsUpperListCriterion1'}=join(':::', @upperStudents1);  Returns: Hash reference with statistics data from 
     $problemData{'studentsLowerListCriterion1'}=join(':::', @lowerStudents1);  loncoursedata::get_problem_statistics.
   
     # Discriminant Factor criterion 2  =cut
     $sortedStudents = &SortDivideByTries($students, $cache, ':totalSolved');  
   ########################################################
     for(my $i=0; $i<$upperCount; $i++) {  ########################################################
         push(@lowerStudents2, $sortedStudents->[$i]);  sub get_statistics {
         push(@upperStudents2, $sortedStudents->[(scalar(@$students)-$i-1)]);      my ($sequence,$resource,$part,$problem_num) = @_;
     }      #
     $problemData{'studentsUpperListCriterion2'}=join(':::', @upperStudents2);      my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
     $problemData{'studentsLowerListCriterion2'}=join(':::', @lowerStudents2);      my $symb = $resource->{'symb'};
       my $courseid = $ENV{'request.course.id'};
     $problemData{'problemList'} = join(':::', @problemList);      #
       my $data = &Apache::loncoursedata::get_problem_statistics
     return \%problemData;                          (\@Apache::lonstatistics::SelectedSections,
 }                           $Apache::lonstatistics::enrollment_status,
                            $symb,$part,$courseid,$starttime,$endtime);
 sub SortDivideByTries {      $data->{'part'}        = $part;
     my ($toSort, $data, $sortOn)=@_;      $data->{'problem_num'} = $problem_num;
     my @orderedData = sort { ($data->{$a.':totalTries'}) ?      $data->{'container'}   = $sequence->{'title'};
                              ($data->{$a.$sortOn}/$data->{$a.':totalTries'}):0      $data->{'title'}       = $resource->{'title'};
                              <=>      $data->{'title.link'}  = $resource->{'src'}.'?symb='.
                              ($data->{$b.':totalTries'}) ?          &Apache::lonnet::escape($resource->{'symb'});
                              ($data->{$b.$sortOn}/$data->{$b.':totalTries'}):0      #
                            } @$toSort;      if ($SelectedFields{'deg_of_disc'}) {
           $data->{'deg_of_disc'} = 
     return \@orderedData;              &compute_discrimination_factor($resource,$part,$sequence);
 }      }
       return $data;
 sub SortProblems {  }
     my ($problemData,$sortBy,$sortProblems,$ascend)=@_;  
   ###############################################
     my @problems = split(':::', $problemData->{'problemList'});  ###############################################
     if($sortBy eq "Homework Sets Order") {  
         return \@problems;  =pod
     }  
   =item &compute_discrimination_factor()
     my $data;  
   Inputs: $Resource, $Sequence
     if   ($sortBy eq "#Stdnts") { $data = ':studentCount'; }  
     elsif($sortBy eq "Tries")   { $data = ':totalTries'; }  Returns: integer between -1 and 1
     elsif($sortBy eq "Mod")     { $data = ':maxTries'; }  
     elsif($sortBy eq "Mean")    { $data = ':mean'; }  =cut
     elsif($sortBy eq "#YES")    { $data = ':correct'; }  
     elsif($sortBy eq "#yes")    { $data = ':correctByOverride'; }  ###############################################
     elsif($sortBy eq "%Wrng")   { $data = ':percentWrong'; }  ###############################################
     elsif($sortBy eq "DoDiff")  { $data = ':degreeOfDifficulty'; }  sub compute_discrimination_factor {
     elsif($sortBy eq "S.D.")    { $data = ':standardDeviation'; }      my ($resource,$part,$sequence) = @_;
     elsif($sortBy eq "Skew.")   { $data = ':skewness'; }      my @Resources;
     elsif($sortBy eq "D.F.1st") { $data = ':discriminationFactor1'; }      foreach my $res (@{$sequence->{'contents'}}) {
     elsif($sortBy eq "D.F.2nd") { $data = ':discriminationFactor2'; }          next if ($res->{'symb'} eq $resource->{'symb'});
     else                        { return \@problems; }          push (@Resources,$res->{'symb'});
       }
     my %temp;      #
     my @sequenceList=();      # rank
     foreach(@problems) {      my $ranking = 
         my ($sequence) = split(':', $_);          &Apache::loncoursedata::rank_students_by_scores_on_resources
           (\@Resources,
         my @array=();           \@Apache::lonstatistics::SelectedSections,
         my $tempArray;           $Apache::lonstatistics::enrollment_status,undef);
         if(defined($temp{$sequence})) {      #
             $tempArray = $temp{$sequence};      # compute their percent scores on the problems in the sequence,
         } else {      my $number_to_grab = int(scalar(@{$ranking})/4);
             push(@sequenceList, $sequence);      my $num_students = scalar(@{$ranking});
             $tempArray = \@array;      my @BottomSet = map { $_->[&Apache::loncoursedata::RNK_student()]; 
             $temp{$sequence} = $tempArray;                        } @{$ranking}[0..$number_to_grab];
         }      my @TopSet    = 
           map { 
         push(@$tempArray, $_);              $_->[&Apache::loncoursedata::RNK_student()]; 
     }            } @{$ranking}[($num_students-$number_to_grab)..($num_students-1)];
       my ($bottom_sum,$bottom_max) = 
     my @orderedProblems;          &Apache::loncoursedata::get_sum_of_scores($resource,$part,\@BottomSet);
     if($sortProblems eq "Sort Within Sequence") {      my ($top_sum,$top_max) = 
         foreach(keys(%temp)) {          &Apache::loncoursedata::get_sum_of_scores($resource,$part,\@TopSet);
             my $tempArray = $temp{$_};      my $deg_of_disc;
             my @tempOrder =      if ($top_max == 0 || $bottom_max==0) {
                 sort { $problemData->{$a.$data} <=> $problemData->{$b.$data} }          $deg_of_disc = 'nan';
             @$tempArray;  
             $temp{$_} = \@tempOrder;  
         }  
         foreach(@sequenceList) {  
             my $tempArray = $temp{$_};  
             @orderedProblems = (@orderedProblems, @$tempArray);  
         }  
     } else {      } else {
         @orderedProblems =           $deg_of_disc = ($top_sum/$top_max) - ($bottom_sum/$bottom_max);
             sort { $problemData->{$a.$data} <=> $problemData->{$b.$data} }  
         @problems;  
     }      }
       #&Apache::lonnet::logthis('    '.$top_sum.'/'.$top_max.
       #                         ' - '.$bottom_sum.'/'.$bottom_max);
       return $deg_of_disc;
   }
   
     if($ascend eq 'Descending') {  ###############################################
         @orderedProblems = reverse(@orderedProblems);  ###############################################
   ##
   ## Compute KR-21
   ##
   ## To compute KR-21, you need the following information:
   ##
   ## K=the number of items in your test
   ## M=the mean score on the test
   ## s=the standard deviation of the scores on your test 
   ##
   ## then:
   ## 
   ## KR-21 rk= [K/(K-1)] * [1- (M*(K-M))/(K*s^2))]
   ##
   ###############################################
   ###############################################
   sub compute_sequence_statistics {
       my ($seq) = @_;
       my $symb = $seq->{'symb'};
       my @Resources;
       foreach my $res (@{$seq->{'contents'}}) {
           next if ($res->{'type'} ne 'assessment');
           push (@Resources,$res->{'symb'});
       }
       my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
       #
       # First compute statistics based on student scores
       my ($smin,$smax,$sMean,$sSTD,$scount,$sMAX) = 
           &Apache::loncoursedata::score_stats
                       (\@Apache::lonstatistics::SelectedSections,
                        $Apache::lonstatistics::enrollment_status,
                        \@Resources,$starttime,$endtime,undef);
       $SeqStat{$symb}->{'title'}  = $seq->{'title'};
       $SeqStat{$symb}->{'scoremax'}  = $smax;
       $SeqStat{$symb}->{'scoremin'}  = $smin;
       $SeqStat{$symb}->{'scoremean'} = $sMean;
       $SeqStat{$symb}->{'scorestd'}  = $sSTD;
       $SeqStat{$symb}->{'scorecount'} = $scount;
       $SeqStat{$symb}->{'max_possible'} = $sMAX;
       #
       # Compute statistics based on the number of correct problems
       # 'correct' is taken to mean 
       my ($cmin,$cmax,$cMean,$cSTD,$ccount)=
           &Apache::loncoursedata::count_stats
           (\@Apache::lonstatistics::SelectedSections,
            $Apache::lonstatistics::enrollment_status,
            \@Resources,$starttime,$endtime,undef);
       my $K = $seq->{'num_assess_parts'};
       my $kr_21;
       if ($K > 1 && $cSTD > 0) {
           $kr_21 =  ($K/($K-1)) * (1 - $cMean*($K-$cMean)/($K*$cSTD**2));
       } else {
           $kr_21 = 'nan';
     }      }
       $SeqStat{$symb}->{'countmax'} = $cmax;
       $SeqStat{$symb}->{'countmin'} = $cmin;
       $SeqStat{$symb}->{'countstd'} = $cSTD;
       $SeqStat{$symb}->{'count'} = $ccount;
       $SeqStat{$symb}->{'items'} = $K;
       $SeqStat{$symb}->{'KR-21'}=$kr_21;
   
     return \@orderedProblems;      return;
 }  }
   
 sub CalculateStatistics {  
     my ($data, $cache, $courseID)=@_;  
   
     my @problems = split(':::', $data->{'problemList'});  
     foreach(@problems) {  
         # Mean  
         my $mean = ($data->{$_.':studentCount'}) ?   
             ($data->{$_.':totalTries'} / $data->{$_.':studentCount'}) : 0;  
         $data->{$_.':mean'} = sprintf("%.2f", $mean);  
   
         # %Wrong  =pod 
         my $pw = ($data->{$_.':studentCount'}) ?  
             (($data->{$_.':wrong'} / $data->{$_.':studentCount'}) * 100.0) :   
             100.0;  
         $data->{$_.':percentWrong'} = sprintf("%.1f", $pw);  
   
         # Degree of Difficulty  =item ProblemStatisticsLegend
         my $dod = ($data->{$_.':totalTries'}) ?  
             (1 - (($data->{$_.':correct'} + $data->{$_.':correctByOverride'}) /  
                   $data->{$_.':totalTries'})) : 0;  
   
         $data->{$_.':degreeOfDifficulty'} = sprintf("%.2f", $dod);  =over 4
   
         # Factor in mean  =item #Stdnts
         my @studentTries = split(':::', $data->{$_.':studentTries'});  Total number of students attempted the problem.
         foreach(my $index=0; $index < scalar(@studentTries); $index++) {  
             $studentTries[$index] -= $mean;  
         }  
         my $sumSquared = 0;  
         my $sumCubed = 0;  
         foreach(@studentTries) {  
             my $squared = ($_ * $_);  
             my $cubed = ($squared * $_);  
             $sumSquared += $squared;  
             $sumCubed += $cubed;  
         }  
   
         # Standard deviation  =item Tries
         my $standardDeviation;  Total number of tries for solving the problem.
         if($data->{$_.':studentCount'} - 1 > 0) {  
             $standardDeviation = (sqrt($sumSquared)) /   
                                  ($data->{$_.':studentCount'} - 1);  
         } else {  
             $standardDeviation =  0.0;  
         }  
         $data->{$_.':standardDeviation'} = sprintf("%.1f", $standardDeviation);  
   
         # Skewness  =item Max Tries
         my $skew;  Largest number of tries for solving the problem by a student.
         if($standardDeviation > 0.0999 && $data->{$_.':studentCount'} > 0) {  
             $skew = (((sqrt($sumSquared)) / $data->{$_.':studentCount'}) /   
                      ($standardDeviation *   
                       $standardDeviation *   
                       $standardDeviation));  
         } else {  
             $skew = 0.0;  
         }  
   
         $data->{$_.':skewness'} = sprintf("%.1f", $skew);  =item Mean
   Average number of tries. [ Tries / #Stdnts ]
   
         # Discrimination Factor 1  =item #YES
         my ($sequence, $problem, $part) = split(':', $_);  Number of students solved the problem correctly.
   
         my @upper1 = split(':::', $data->{'studentsUpperListCriterion1'});  =item #yes
         my @lower1 = split(':::', $data->{'studentsLowerListCriterion1'});  Number of students solved the problem by override.
   
         my $upper1Sum=0;  =item %Wrong
         foreach my $name (@upper1) {  Percentage of students who tried to solve the problem 
             $upper1Sum += $cache->{"$name:$problem:$part:awarded"};  but is still incorrect. [ 100*((#Stdnts-(#YES+#yes))/#Stdnts) ]
         }  
         $upper1Sum = (scalar(@upper1)) ? ($upper1Sum/(scalar(@upper1))) : 0;  
   
         my $lower1Sum=0;  =item DoDiff
         foreach my $name (@lower1) {  Degree of Difficulty of the problem.  
             $lower1Sum += $cache->{"$name:$problem:$part:awarded"};  [ 1 - ((#YES+#yes) / Tries) ]
         }  
         $lower1Sum = (scalar(@lower1)) ? ($lower1Sum/(scalar(@lower1))) : 0;  
   
         my $df1 = $upper1Sum - $lower1Sum;  =item S.D.
         $data->{$_.':discriminationFactor1'} = sprintf("%.2f", $df1);  Standard Deviation of the tries.  
   [ sqrt(sum((Xi - Mean)^2)) / (#Stdnts-1) 
   where Xi denotes every student\'s tries ]
   
         # Discrimination Factor 2  =item Skew.
         my @upper2 = split(':::', $data->{'studentsUpperListCriterion2'});  Skewness of the students tries.
         my @lower2 = split(':::', $data->{'studentsLowerListCriterion2'});  [(sqrt( sum((Xi - Mean)^3) / #Stdnts)) / (S.D.^3)]
   
         my $upper2Sum=0;  =item Dis.F.
         foreach my $name (@upper2) {  Discrimination Factor: A Standard for evaluating the 
             $upper2Sum += $cache->{"$name:$problem:$part:awarded"};  problem according to a Criterion<br>
         }  
         $upper2Sum = (scalar(@upper2)) ? ($upper2Sum/(scalar(@upper2))) : 0;  
   
         my $lower2Sum=0;  =item [Criterion to group students into %27 Upper Students - 
         foreach my $name (@lower2) {  and %27 Lower Students]
             $lower2Sum += $cache->{"$name:$problem:$part:awarded"};  1st Criterion for Sorting the Students: 
         }  Sum of Partial Credit Awarded / Total Number of Tries
         $lower2Sum = (scalar(@lower2)) ? ($lower2Sum/(scalar(@lower2))) : 0;  2nd Criterion for Sorting the Students: 
   Total number of Correct Answers / Total Number of Tries
   
         my $df2 = $upper2Sum - $lower2Sum;  =item Disc.
         $data->{$_.':discriminationFactor2'} = sprintf("%.2f", $df2);  Number of Students had at least one discussion.
   
         my %storestats;  =back
         my $Average = ($data->{$_.':studentCount'}) ?   
             $data->{$_.':totalTries'}/$data->{$_.':studentCount'} : 0;  
         $storestats{$courseID.'___'.$cache->{$sequence.':source'}.  
                         '___timestamp'}=time;  
         $storestats{$courseID.'___'.$cache->{$sequence.':source'}.  
                         '___stdno'}=$data->{$_.':studentCount'};  
         $storestats{$courseID.'___'.$cache->{$sequence.':source'}.  
                         '___avetries'}=$Average;  
         $storestats{$courseID.'___'.$cache->{$sequence.':source'}.  
                         '___difficulty'}=$data->{$_.':degreeOfDifficulty'};  
         $cache->{$sequence.':source'} =~ /^(\w+)\/(\w+)/;  
         if($data->{$_.':studentCount'}) {   
             &Apache::lonnet::put('nohist_resevaldata',\%storestats,$1,$2);  
         }  
     }  
   
     return;  =cut
 }  
   
 #---- END Problem Statistics Web Page ----------------------------------------  ############################################################
   ############################################################
   
 1;  1;
 __END__  __END__

Removed from v.1.37  
changed lines
  Added in v.1.79


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