Diff for /loncom/interface/statistics/lonproblemstatistics.pm between versions 1.43 and 1.101

version 1.43, 2003/03/26 16:26:35 version 1.101, 2005/03/10 17:33: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;
   
 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 Apache::lonstatistics;  use Apache::lonstatistics;
   use LONCAPA::lonmetadata();
   use Apache::lonlocal;
   use Spreadsheet::WriteExcel;
   use Apache::lonstathelpers();
   use Time::HiRes;
   
   my @StatsArray;
   my %SeqStat;    # keys are symbs, values are hash refs
   
   ##
   ## Localization notes:
   ##
   ## in @Fields[0]->{'long_title'} is placed in Excel files and is used as the
   ## header for plots created with Graph.pm, both of which more than likely do
   ## not support localization.
   ##
   #
   #
   ##
   ## Description of Field attributes
   ##
   ## Attribute     Required   Value       Meaning or Use
   ##
   ## name            yes      any scalar  Used to uniquely identify field
   ## title           yes      any scalar  This is what the user sees to identify
   ##                                      the field.  Passed through &mt().
   ## long_title      yes      any scalar  Used as graph heading and in excel
   ##                                      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?
   ##
   ## format          no      sprintf format string
   ##
   ## excel_format    no      excel format type 
   ##                               (see &Apache::loncommon::define_excel_formats
   my @Fields = (
              { name => 'problem_num',
                title => 'P#',
                align => 'right',
                color => '#FFFFE6',
                selectable => 'no',
                defaultselected => 'yes',
              },
              { name   => 'container',
                title  => 'Sequence or Folder',
                align  => 'left',
                color  => '#FFFFE6',
                sortable => 'yes',
                selectable => 'no',
                defaultselected => 'yes',
              },
              { name   => 'title',
                title  => 'Title',
                align  => 'left',
                color  => '#FFFFE6',
                special  => 'link',
                sortable => 'yes', 
                selectable => 'no',
                defaultselected => 'yes',
              },
              { name   => 'part', 
                title  => 'Part',
                align  => 'left',
                color  => '#FFFFE6',
                selectable => 'no',
                defaultselected => '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',
                defaultselected => 'yes',
              },
              { name   => 'tries',
                title  => 'Tries',
                align  => 'right',
                color  => '#EEFFCC',
                format => '%d',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Total Number of Tries',
                selectable => 'yes',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => 'yes',
              },
              { name   => 'tries_per_correct',
                title  => 'tries/correct',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%4.1f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Tries per Correct Answer',
                selectable => 'yes',
                defaultselected => 'yes',
              },
              { name   => 'num_wrong',
                title  => '#Wrng',
                align  => 'right',
                color  => '#FFDDDD',
                format => '%4.1f',
                sortable  => 'yes',
                graphable => 'yes',
                long_title => 'Number of students whose final answer is wrong',
                selectable => 'yes',
                defaultselected => 'yes',
              },
              { name   => 'per_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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => 'yes',
              },
   ##   duedate included for research purposes.  Commented out most of the time.
   #           { name => 'duedate',
   #             title => 'Due Date',
   #             align => 'left',
   #             color => '#FFFFFF',
   #             sortable => 'yes',
   #             graphable => 'no',
   #             long_title => 'Due date of resource for instructor',
   #             selectable => 'no',
   #             defaultselected => 'yes',
   #            },
   ##   opendate included for research purposes.  Commented out most of the time.
   #           { name => 'opendate',
   #             title => 'Open Date',
   #             align => 'left',
   #             color => '#FFFFFF',
   #             sortable => 'yes',
   #             graphable => 'no',
   #             long_title => 'date resource became answerable',
   #             selectable => 'no',
   #             defaultselected => 'yes',
   #            },
   ##   symb included for research purposes.  Commented out most of the time.
   #           { name => 'symb',
   #             title => 'Symb',
   #             align => 'left',
   #             color => '#FFFFFF',
   #             sortable => 'yes',
   #             graphable => 'no',
   #             long_title => 'Unique LON-CAPA identifier for problem',
   #             selectable => 'no',
   #             defaultselected => 'yes',
   #            },
   ##   resptypes included for research purposes.  Commented out most of the time.
   #           { name => 'resptypes',
   #             title => 'Response Types',
   #             align => 'left',
   #             color => '#FFFFFF',
   #             sortable => 'no',
   #             graphable => 'no',
   #             long_title => 'Response Types used in this problem',
   #             selectable => 'no',
   #             defaultselected => 'yes',
   #            },
   ##   maxtries included for research purposes.  Commented out most of the time.
   #           { name => 'maxtries',
   #             title => 'Maxtries',
   #             align => 'left',
   #             color => '#FFFFFF',
   #             sortable => 'no',
   #             graphable => 'no',
   #             long_title => 'Maximum number of tries',
   #             selectable => 'no',
   #             defaultselected => 'yes',
   #            },
   ##   hinttries included for research purposes.  Commented out most of the time.
   #           { name => 'hinttries',
   #             title => 'hinttries',
   #             align => 'left',
   #             color => '#FFFFFF',
   #             sortable => 'no',
   #             graphable => 'no',
   #             long_title => 'Number of tries before a hint appears',
   #             selectable => 'no',
   #             defaultselected => 'yes',
   #            },
   #
   ##   problem weight for instructor
              { name => 'weight',
                title => 'weight',
                align => 'right',
                color => '#FFFFFF',
                sortable => 'no',
                graphable => 'no',
                long_title => 'Problem weight (for instructor)',
                selectable => 'yes',
                defaultselected => 'yes',
               },
   );
   
   my @SeqFields = (
              { name   => 'title',
                title  => 'Sequence',
                align  => 'left',
                color  => '#FFFFE6',
                special  => 'no',
                sortable => 'no', 
                selectable => 'yes',
                defaultselected => 'no',
              },
              { name   => 'items',
                title  => '#Items',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4d',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Number of Items in Sequence',
                selectable => 'yes',
                defaultselected => 'no',
              },
              { name   => 'scoremean',
                title  => 'Score Mean',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Mean Sequence Score',
                selectable => 'yes',
                defaultselected => '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',
                defaultselected => 'no',
              },
              { name   => 'scoremax',
                title  => 'Score Max',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Maximum Sequence Score',
                selectable => 'yes',
                defaultselected => 'no',
              },
              { name   => 'scoremin',
                title  => 'Score Min',
                align  => 'right',
                color  => '#FFFFE6',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Minumum Sequence Score',
                selectable => 'yes',
                defaultselected => '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',
                defaultselected => 'no',
              },
              { name   => 'countmean',
                title  => 'Count Mean',
                align  => 'right',
                color  => '#FFFFFF',
                format => '%4.2f',
                sortable  => 'no',
                graphable => 'no',
                long_title => 'Mean Sequence Score',
                selectable => 'yes',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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',
                defaultselected => '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->{'defaultselected'} eq 'yes') {
                   push(@{$ENV{'form.fieldselections'}},$field->{'name'});
               }
           }
       }
       #
       # Make sure the data we are plotting is there
       my %NeededFields;
       if (exists($ENV{'form.plot'}) && $ENV{'form.plot'} ne '' &&
           $ENV{'form.plot'} ne 'none') {
           if ($ENV{'form.plot'} eq 'degrees') {
               $NeededFields{'deg_of_diff'}++;
               $NeededFields{'deg_of_disc'}++;
           } elsif ($ENV{'form.plot'} eq 'tries statistics') {
               $NeededFields{'mean_tries'}++;
               $NeededFields{'std_tries'}++;
               $NeededFields{'problem_num'}++;
           } else {
               $NeededFields{$ENV{'form.plot'}}++;
           }
       }
       #
       # This should not happen, but in case it does...
       if (ref($ENV{'form.fieldselections'}) ne 'ARRAY') {
           $ENV{'form.fieldselections'} = [$ENV{'form.fieldselections'}];
       }
       #
       # Set the field data and the selected fields (for easier checking)
       undef(%SelectedFields);
       foreach my $field (@Fields) {
           if ($field->{'selectable'} ne 'yes') {
               $field->{'selected'} = 'yes';
           } else {
               $field->{'selected'} = 'no';
           }
           if (exists($NeededFields{$field->{'name'}})) {
               $field->{'selected'} = 'yes';
               $SelectedFields{$field->{'name'}}++;
           }
           foreach my $selection (@{$ENV{'form.fieldselections'}}) {
               if ($selection eq $field->{'name'} || $selection eq 'all') {
                   $field->{'selected'} = 'yes';
                   $SelectedFields{$field->{'name'}}++;
               }
           }
       }
       #
       # Always show all the sequence statistics (for now)
       foreach my $field (@SeqFields) {
           $field->{'selected'} = 'yes';
       }
       return;
   }
   
 #######################################################  sub field_selection_input {
 #######################################################      my $Str = '<select name="fieldselections" multiple size="5">'."\n";
       $Str .= '<option value="all">all</option>'."\n";
       foreach my $field (@Fields) {
           next if ($field->{'selectable'} ne 'yes');
           $Str .= '    <option value="'.$field->{'name'}.'" ';
           if ($field->{'selected'} eq 'yes') {
               $Str .= 'selected ';
           }
           $Str .= '>'.$field->{'title'}.'</option>'."\n";
       }
       $Str .= "</select>\n";
   }
   
   ###############################################
   ###############################################
   
   =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 ($r) = @_;
       #
       &parse_field_selection();
       #
     my $Str = '';      my $Str = '';
       $Str .= &Apache::lonhtmlcommon::breadcrumbs
           (undef,'Overall Problem Statistics','Statistics_Overall_Key');
     $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>'.&mt('Sections').'</b></td>';
     $Str .= '<td align="center"><b>Sequences and Folders</b></td>';      $Str .= '<td align="center"><b>'.&mt('Enrollment Status').'</b></td>';
     $Str .= '<td align="center"><b>Output</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>'."\n";
     #      #
     $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 {       $Str .= &Apache::lonstatistics::map_select('Maps','multiple,all',5);
         my $s=shift;      $Str .= '</td><td>'.&field_selection_input();
         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>'."\n";  
     $Str .= &CreateAndParseOutputSelector();  
     $Str .= '</td></tr>'."\n";      $Str .= '</td></tr>'."\n";
     $Str .= '</table>'."\n";      $Str .= '</table>'."\n";
       #
       $Str .= '<p>'.&mt('Status: [_1]',
                            '<input type="text" '.
                            'name="stats_status" size="60" value="" />'
                            ).
                            '</nobr></p>';
       #
       $Str .= '<input type="submit" name="GenerateStatistics" value="'.
           &mt('Generate Statistics').'" />';
       $Str .= '&nbsp;'x5;
       $Str .= 'Plot '.&plot_dropdown().('&nbsp;'x10);
       #
     return $Str;      return $Str;
 }  }
   
 #######################################################  ###############################################
 #######################################################  ###############################################
   
   =pod 
   
 =pod  =item &BuildProblemStatisticsPage()
   
 =item &CreateAndParseOutputSelector()  Main interface to problem statistics.
   
 =cut  =cut
   
 #######################################################  ###############################################
 #######################################################  ###############################################
 my $output_mode;  my $navmap;
 my $show;  my @sequences;
   
 my @OutputOptions =   
     (  
      { name  => 'problem statistics grouped by sequence',  
        value => 'HTML problem statistics grouped',  
        description => 'Output statistics for the problem parts.',  
        mode => 'html',  
        show => 'grouped',  
      },  
      { name  => 'problem statistics ungrouped',  
        value => 'HTML problem statistics ungrouped',  
        description => 'Output statistics for the problem parts.',  
        mode => 'html',  
        show => 'ungrouped',  
      },  
      { name  => 'problem statistics, Excel',  
        value => 'Excel problem statistics',  
        description => 'Output statistics for the problem parts '.  
            'in an Excel workbook',  
        mode => 'excel',  
        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 BuildProblemStatisticsPage {
     my $Str = '';      my ($r,$c)=@_;
     $Str .= "<h2>Output Modes</h2>\n";      undef($navmap);
     $Str .= "<dl>\n";      undef(@sequences);
     foreach my $outputmode (@OutputOptions) {      #
  $Str .="    <dt>".$outputmode->{'name'}."</dt>\n";      my %Saveable_Parameters = ('Status' => 'scalar',
  $Str .="        <dd>".$outputmode->{'description'}."</dd>\n";                                 '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);
       $r->print($interface);
       $r->print('<input type="hidden" name="sortby" value="'.$ENV{'form.sortby'}.
                 '" />');
       #
       my @CacheButtonHTML = 
           &Apache::lonstathelpers::manage_caches($r,'Statistics','stats_status');
       my $Str;
       foreach my $html (@CacheButtonHTML) {
           $Str.=$html.('&nbsp;'x5);
       }
       #
       $r->print($Str);
       if (! exists($ENV{'form.firstrun'})) {
           $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;
     }      }
     $Str .= "</dl>\n";      $r->rflush();
     return $Str;  
 }  
   
 sub CreateAndParseOutputSelector {  
     my $Str = '';  
     my $elementname = 'outputmode';  
     #      #
     # Format for output options is 'mode, restrictions';      # This probably does not need to be done each time we are called, but
     my $selected = 'html, with links';      # it does not slow things down noticably.
     if (exists($ENV{'form.'.$elementname})) {      &Apache::loncoursedata::populate_weight_table();
         if (ref($ENV{'form.'.$elementname} eq 'ARRAY')) {      #
             $selected = $ENV{'form.'.$elementname}->[0];      ($navmap,@sequences) = 
           &Apache::lonstatistics::selected_sequences_with_assessments();
       if (! ref($navmap)) {
           $r->print('<h1>'.&mt('A course-wide error occured.').'</h1>'.
                     '<h3>'.$navmap.'</h3>');
           return;
       }
       if (exists($ENV{'form.Excel'})) {
           &Excel_output($r);
       } else { 
           $r->print('<input type="submit" name="Excel" value="'.
                     &mt('Produce Excel Output').'" />'.'&nbsp;'x5);
           $r->rflush();
           my $count = 0;
           foreach my $seq (@sequences) {
               my @resources = 
                   &Apache::lonstathelpers::get_resources($navmap,$seq);
               $count += scalar(@resources);
           }
           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 {          } else {
             $selected = $ENV{'form.'.$elementname};              if (defined($plot)) {
                   &make_plot($r,$plot);
               }
               &output_html_stats($r);
               &output_sequence_statistics($r);
         }          }
     }      }
     #      return;
     # Set package variables describing output mode  }
     $output_mode = 'html';  
     $show        = 'all';  sub output_sequence_statistics {
     foreach my $option (@OutputOptions) {      my ($r) = @_;
         next if ($option->{'value'} ne $selected);      my $c=$r->connection();
         $output_mode = $option->{'mode'};      $r->print('<h2>'.&mt('Sequence Statistics').
         $show        = $option->{'show'};        &Apache::loncommon::help_open_topic('Statistics_Sequence').
     }        '</h2>');
     #      $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n".
     # Build the form element                '<table border="0" cellpadding="3">'."\n".
     $Str = qq/<select size="5" name="$elementname">/;                '<tr bgcolor="#FFFFE6">');
     foreach my $option (@OutputOptions) {      $r->print(&sequence_html_header());
         $Str .= "\n".'    <option value="'.$option->{'value'}.'"';      foreach my $seq (@sequences) { 
         $Str .= " selected " if ($option->{'value'} eq $selected);          last if ($c->aborted);
         $Str .= ">".$option->{'name'}."<\/option>";          &compute_sequence_statistics($seq);
           $r->print(&sequence_html_output($seq));
     }      }
     $Str .= "\n</select>";      $r->print('</table>');
     return $Str;      $r->print('</table>');
       $r->rflush();
       return;
 }  }
   
 ###############################################  
 ###############################################  
   
 ###############################################  ##########################################################
 ###############################################  ##########################################################
 sub Gather_Student_Data {  ##
   ## HTML output routines
   ##
   ##########################################################
   ##########################################################
   sub output_html_by_sequence {
     my ($r) = @_;      my ($r) = @_;
     my $c = $r->connection();      my $c = $r->connection();
       $r->print(&html_preamble());
     #      #
     my @Sequences = &Apache::lonstatistics::Sequences_with_Assess();      foreach my $seq (@sequences) {
     #          last if ($c->aborted);
     my @Students = @Apache::lonstatistics::Students;          $r->print("<h3>".$seq->compTitle."</h3>".
     #                    '<table border="0"><tr><td bgcolor="#777777">'."\n".
     # Open the progress window                    '<table border="0" cellpadding="3">'."\n".
     my %prog_state=&Apache::lonhtmlcommon::Create_PrgWin                    '<tr bgcolor="#FFFFE6">'.
         ($r,'Statistics Compilation Status',                    &statistics_table_header('no container')."</tr>\n");
          'Statistics Compilation Progress', scalar(@Students));          my @Data = &compute_statistics_on_sequence($seq);
     #          foreach my $data (@Data) {
     while (my $student = shift @Students) {              $r->print('<tr>'.&statistics_html_table_data($data,
         return if ($c->aborted());                                                           'no container').
         my ($status,undef) = &Apache::loncoursedata::ensure_current_data                        "</tr>\n");
             ($student->{'username'},$student->{'domain'},          }
              $ENV{'request.course.id'});          $r->print('</table>'."\n".'</table>'."\n");
         &Apache::lonhtmlcommon::Increment_PrgWin($r,\%prog_state,          $r->rflush();
                                                  'last student');  
     }      }
     &Apache::lonhtmlcommon::Close_PrgWin($r,\%prog_state);      return;
     $r->rflush();  
 }  }
   
   sub output_html_stats {
       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;
   }
   
   sub html_preamble {
       my $Str='';
       $Str .= "<h2>".
           $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;
   }
   
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   ##
   ## Misc HTML output routines
   ##
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub BuildProblemStatisticsPage {  sub statistics_html_table_data {
     my ($r,$c)=@_;      my ($data,$options) = @_;
     #      my $row = '';
     $output_mode = 'html';      foreach my $field (@Fields) {
     $show = 'grouped';          next if ($options =~ /no $field->{'name'}/);
           next if ($field->{'selected'} ne 'yes');
           $row .= '<td bgcolor="'.$field->{'color'}.'"';
           if (exists($field->{'align'})) {
               $row .= ' align="'.$field->{'align'}.'"';
               }
           $row .= '>';
           if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
               $row .= '<a href="'.$data->{$field->{'name'}.'.link'}.'">';
           }
           if (exists($field->{'format'}) && $data->{$field->{'name'}} !~ /[A-Z]/i) {
               $row .= sprintf($field->{'format'},$data->{$field->{'name'}});
           } else {
               $row .= $data->{$field->{'name'}};
           }
           if (exists($field->{'special'}) && $field->{'special'} eq 'link') {
               $row.= '</a>';
           }
           $row .= '</td>';
       }
       return $row;
   }
   
   sub statistics_table_header {
       my ($options) = @_;
       my $header_row;
       foreach my $field (@Fields) {
           next if ($options =~ /no $field->{'name'}/);
           next if ($field->{'selected'} ne 'yes');
           $header_row .= '<th>';
           if (exists($field->{'sortable'}) && $field->{'sortable'} eq 'yes') {
               $header_row .= '<a href="javascript:'.
                   'document.Statistics.sortby.value='."'".$field->{'name'}."'".
                       ';document.Statistics.submit();">';
           }
           $header_row .= &mt($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 .= &mt('plot').'</a>)';
           }
           $header_row .= '</th>';
       }
       return $header_row;
   }
   
   sub sequence_html_header {
       my $Str .= '<tr>';
       foreach my $field (@SeqFields) {
   #        next if ($field->{'selected'} ne 'yes');
           $Str .= '<th bgcolor="'.$field->{'color'}.'"';
           $Str .= '>'.$field->{'title'}.'</th>';
       }
       $Str .= '</tr>';
       return $Str;
   }
   
   
   sub sequence_html_output {
       my ($seq) = @_;
       my $data = $SeqStat{$seq->symb};
       my $row = '<tr>';
       foreach my $field (@SeqFields) {
           next if ($field->{'selected'} ne 'yes');
           $row .= '<td bgcolor="'.$field->{'color'}.'"';
           if (exists($field->{'align'})) {
               $row .= ' align="'.$field->{'align'}.'"';
           }
           $row .= '>';
           if (exists($field->{'format'})) {
               $row .= sprintf($field->{'format'},$data->{$field->{'name'}});
           } else {
               $row .= $data->{$field->{'name'}};
           }
           $row .= '</td>';
       }
       $row .= '</tr>'."\n";
       return $row;
   }
   
   ####################################################
   ####################################################
   ##
   ##    Plotting Routines
   ##
   ####################################################
   ####################################################
   sub make_plot {
       my ($r,$plot) = @_;
       &compute_all_statistics($r);
       &sort_data($ENV{'form.sortby'});
       if ($plot eq 'degrees') {
           &degrees_plot($r);
       } elsif ($plot eq 'tries statistics') {
           &tries_data_plot($r);
       } else {
           &make_single_stat_plot($r,$plot);
       }
       return;
   }
   
   sub make_single_stat_plot {
       my ($r,$datafield) = @_;
     #      #
     $r->print(&CreateInterface());      my $title; my $yaxis;
     $r->print('<input type="hidden" name="statsfirstcall" value="no" />');      foreach my $field (@Fields) {
     $r->print('<input type="hidden" name="sortby" value="'.$ENV{'form.sortby'}.          next if ($field->{'name'} ne $datafield);
               '" />');          $title = $field->{'long_title'};
     if (! exists($ENV{'form.statsfirstcall'})) {          $yaxis = $field->{'title'};
           last;
       }
       if ($title eq '' || $yaxis eq '') {
           # datafield is something we do not know enough about to plot
           $r->print('<h3>'.
                     &mt('Unable to plot the requested statistic.').
                     '</h3>');
         return;          return;
     }      }
     #      #
     &Gather_Student_Data($r);      # Build up the data sets to plot
       my @Labels; 
       my @Data;
       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;
   }
   
   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;
           }
       }
     #      #
     if ($output_mode eq 'html') {      my $xmax = $Labels[-1];
         $r->print("<h2>".      if ($xmax > 50) {
                   $ENV{'course.'.$ENV{'request.course.id'}.'.description'}.          if ($xmax % 10 != 0) {
                   "</h2>\n");              $xmax = 10 * (int($xmax/10)+1);
         $r->print("<h3>".localtime(time)."</h3>");  
         $r->rflush();  
         if ($show eq 'grouped') {  
             &output_html_grouped_by_sequence($r);  
         } elsif ($show eq 'ungrouped') {  
             &output_html_ungrouped($r);  
         }          }
     } else {      } else {
         $r->print("<h1>Not implemented</h1>");          if ($xmax % 5 != 0) {
               $xmax = 5 * (int($xmax/5)+1);
           }
     }      }
       #
       my $discdata .= '<data>'.join(',',@Labels).'</data>'.$/.
                       '<data>'.join(',',@Disc).'</data>'.$/;
       #
       my $diffdata .= '<data>'.join(',',@Labels).'</data>'.$/.
                       '<data>'.join(',',@Diff).'</data>'.$/;
       #
       my $title = 'Degree of Discrimination\nand Degree of Difficulty';
       if ($xmax > 50) {
           $title = 'Degree of Discrimination and Degree of Difficulty';
       }
       #
       $plot=<<"END";
   <gnuplot 
       texfont="10"
       fgcolor="x000000"
       plottype="Cartesian"
       font="large"
       grid="on"
       align="center"
       border="on"
       transparent="on"
       alttag="Degree of Discrimination and Degree of Difficulty Plot"
       samples="100"
       bgcolor="xffffff"
       height="$height"
       width="$width">
       <key 
           pos="top right"
           title=""
           box="off" />
       <title>$title</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;
 }  }
   
 sub output_html_grouped_by_sequence {  sub tries_data_plot {
     my ($r) = @_;      my ($r)=@_;
     #$r->print(&ProblemStatisticsLegend());      my $count = scalar(@StatsArray);
     my @Header = ("Title","Part","#Stdnts","Tries","Mod",      my $width = 50 + 10*$count;
                   "Mean","#YES","#yes","%Wrng","DoDiff",      $width = 300 if ($width < 300);
                   "S.D.","Skew.");#,"D.F.1st","D.F.2nd");      my $height = 300;
     # #FFFFE6 #EEFFCC #DDFFFF FFDDDD #DDFFDD #FFDDFF      my $plot = '';
     foreach my $sequence (&Apache::lonstatistics::Sequences_with_Assess()) {      my @STD;  my @Mean; my @Max; my @Min;
         my $show_part = 0;      my @Labels;
         next if ($sequence->{'num_assess'}<1);      my $ymax = 5;
         $r->print("<h3>".$sequence->{'title'}."</h3>");      foreach my $data (@StatsArray) {
         $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");          my $max = $data->{'mean_tries'} + $data->{'std_tries'};
         $r->print('<table border="0" cellpadding="3">'."\n");          $ymax = $max if ($ymax < $max);
         $r->print('<tr bgcolor="#FFFFE6"><th>'.          $ymax = $max if ($ymax < $max);
                   join("</th><th>",@Header)."</th></tr>\n");          push(@Labels,$data->{'problem_num'});
         foreach my $resource (@{$sequence->{'contents'}}) {          push(@STD,$data->{'std_tries'});
             next if ($resource->{'type'} ne 'assessment');          push(@Mean,$data->{'mean_tries'});
             foreach my $part (@{$resource->{'parts'}}) {      }
                 my ($num,$tries,$mod,$mean,$Solved,$solved,$DegOfDiff,$STD,      #
                     $SKEW) = &Apache::loncoursedata::get_problem_statistics      # Make sure we show relevant information.
                         (undef,$resource->{'symb'},$part,      my $xmax = $Labels[-1];
                          $ENV{'request.course.id'});      if ($xmax > 50) {
                 #          if ($xmax % 10 != 0) {
                 $show_part = 1 if ($part ne '0');              $xmax = 10 * (int($xmax/10)+1);
                 $part = '&nbsp;' if ($part == 0);          }
                 #      } else {
                 my $wrongpercent = 0;          if ($xmax % 5 != 0) {
                 if (defined($num) && $num > 0) {              $xmax = 5 * (int($xmax/5)+1);
                     $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,  
                            $show_part).  
                           "</tr>\n");  
             }  
         }          }
         $r->print("</table>\n");  
         $r->print("</td></tr></table>\n");  
         $r->rflush();  
     }      }
       $ymax = int($ymax)+1+2;
       #
       my $std_data .= '<data>'.join(',',@Labels).'</data>'.$/.
                       '<data>'.join(',',@Mean).'</data>'.$/;
     #      #
       my $std_error_data .= '<data>'.join(',',@Labels).'</data>'.$/.
                             '<data>'.join(',',@Mean).'</data>'.$/.
                             '<data>'.join(',',@STD).'</data>'.$/;
       #
       my $title = 'Mean and S.D. of Tries';
       if ($xmax > 25) {
           $title = 'Mean and Standard Deviation of Tries';
       }
       #
       $plot=<<"END";
   <gnuplot 
       texfont="10"
       fgcolor="x000000"
       plottype="Cartesian"
       font="large"
       grid="on"
       align="center"
       border="on"
       transparent="on"
       alttag="Mean and S.D of Tries Plot"
       samples="100"
       bgcolor="xffffff"
       height="$height"
       width="$width">
       <title>$title</title>
       <axis xmin="0" ymin="0" xmax="$xmax" ymax="$ymax" color="x000000" />
       <xlabel>Problem Number</xlabel>
       <ylabel>Number of Tries</ylabel>
       <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;      return;
 }  }
   
   sub plot_dropdown {
       my $current = '';
       #
       if (defined($ENV{'form.plot'})) {
           $current = $ENV{'form.plot'};
       }
       #
       my @Additional_Plots = (
                               { graphable=>'yes',
                                 name => 'degrees',
                                 title => 'Difficulty Indexes' },
                               { graphable=>'yes',
                                 name => 'tries statistics',
                                 title => 'Tries Statistics' });
       #
       my $Str= "\n".'<select name="plot" size="1">';
       $Str .= '<option name="none"></option>'."\n";
       $Str .= '<option name="none2">none</option>'."\n";
       foreach my $field (@Additional_Plots,@Fields) {
           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";
       }
       $Str .= '</select>'."\n";
       return $Str;
   }
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   ##
   ## Excel output routines
   ##
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub output_html_ungrouped {  sub Excel_output {
     my ($r) = @_;      my ($r) = @_;
     #      $r->print('<h2>'.&mt('Preparing Excel Spreadsheet').'</h2>');
     my $show_container = 0;      ##
     my $show_part = 0;      ## Compute the statistics
     #$r->print(&ProblemStatisticsLegend());      &compute_all_statistics($r);
     my @Header = ("Title","Part","#Stdnts","Tries","Mod",      my $c = $r->connection;
                   "Mean","#YES","#yes","%Wrng","DoDiff",      return if ($c->aborted());
                   "S.D.","Skew");#,"D.F.1st","D.F.2nd");      #
     #      my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
     my $sortby = undef;      ##
     foreach (@Header) {      ## Create the excel workbook
         if ($ENV{'form.sortby'} eq $_) {      my ($excel_workbook,$filename,$format) =
             $sortby = $_;          &Apache::loncommon::create_workbook($r);
       return if (! defined($excel_workbook));
       #
       # 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'},
                           $format->{'h1'});
       $cols_output += 3;
       #
       # Put a description of the sections listed
       my $sectionstring = '';
       $excel_sheet->write($rows_output,$cols_output++,
                           &Apache::lonstathelpers::sections_description
                               (@Apache::lonstatistics::SelectedSections),
                           $format->{'h3'});
       $cols_output += scalar(@Apache::lonstatistics::SelectedSections);
       #
       # 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).'.';
       }
       if (defined($time_string)) {
           $excel_sheet->write($rows_output,$cols_output++,$time_string);
           $cols_output+= 5;
       }
       #
       # Put the date in there too
       $excel_sheet->write($rows_output,$cols_output++,
                           'Compiled on '.localtime(time));
       #
       $rows_output++; 
       $cols_output=0;
       ##
       ## Sequence Statistics
       ## 
       &write_headers($excel_sheet,$format,\$rows_output,\$cols_output,
                      \@SeqFields);
       foreach my $seq (@sequences) {
           my $data = $SeqStat{$seq->symb};
           $cols_output=0;
           foreach my $field (@SeqFields) {
               next if ($field->{'selected'} ne 'yes');
               my $fieldformat = undef;
               if (exists($field->{'excel_format'})) {
                   $fieldformat = $format->{$field->{'excel_format'}};
               }
               $excel_sheet->write($rows_output,$cols_output++,
                                   $data->{$field->{'name'}},$fieldformat);
           }
           $rows_output++;
           $cols_output=0;
     }      }
     if (! defined($sortby) || $sortby eq '') {      ##
         $sortby = 'Container';      ## Resource Statistics
     }      ##
     # #FFFFE6 #EEFFCC #DDFFFF FFDDDD #DDFFDD #FFDDFF      $rows_output++;
     my @Sequences = &Apache::lonstatistics::Sequences_with_Assess();      $cols_output=0;
     if (@Sequences > 1) {      &write_headers($excel_sheet,$format,\$rows_output,\$cols_output,
         unshift(@Header,"Container");                     \@Fields);
         $show_container = 1;      #
     }      foreach my $data (@StatsArray) {
     #          $cols_output=0;
     $r->print('<table border="0"><tr><td bgcolor="#777777">'."\n");          foreach my $field (@Fields) {
     $r->rflush();              next if ($field->{'selected'} ne 'yes');
     #              next if ($field->{'name'} eq 'problem_num');
     # Compile the data              my $fieldformat = undef;
     my @Statsarray;              if (exists($field->{'excel_format'})) {
     foreach my $sequence (@Sequences) {                  $fieldformat = $format->{$field->{'excel_format'}};
         next if ($sequence->{'num_assess'}<1);  
         foreach my $resource (@{$sequence->{'contents'}}) {  
             next if ($resource->{'type'} ne 'assessment');  
             foreach my $part (@{$resource->{'parts'}}) {  
                 my ($num,$tries,$mod,$mean,$Solved,$solved,$DegOfDiff,$STD,  
                     $SKEW) = &Apache::loncoursedata::get_problem_statistics  
                         (undef,$resource->{'symb'},$part,  
                          $ENV{'request.course.id'});  
                 #  
                 $show_part = 1 if ($part ne '0');  
                 $part = '&nbsp;' if ($part == 0);  
                 #  
                 my $wrongpercent = 0;  
                 if (defined($num) && $num > 0) {  
                     $wrongpercent=int(10*100*($num-$Solved+$solved)/$num)/10;  
                 }  
                 push (@Statsarray,  
                       { 'sequence' => $sequence,  
                         'resource' => $resource,  
                         'Title' => $resource->{'title'},  
                         'Part'  => $part,  
                         '#Stdnts' => $num,  
                         'Tries' => $tries,  
                         'Mod' => $mod,  
                         'Mean' => $mean,  
                         '#YES' => $Solved,  
                         '#yes' => $solved,  
                         '%Wrng' => $wrongpercent,  
                         'DoDiff' => $DegOfDiff,  
                         'S.D.' => $STD,  
                         'Skew' => $SKEW,  
                       });  
             }              }
               $excel_sheet->write($rows_output,$cols_output++,
                                   $data->{$field->{'name'}},$fieldformat);
         }          }
           $rows_output++;
           $cols_output=0;
     }      }
     #      #
     # Table Headers      $excel_workbook->close();
     $r->print('<table border="0" cellpadding="3">'."\n");      #
     my $Str = '';      # Tell the user where to get their excel file
     foreach (@Header) {      $r->print('<br />'.
         next if ($_ eq 'Part' && !$show_part);                '<a href="'.$filename.'">'.
         # Do not allow sorting on some fields                &mt('Your Excel Spreadsheet').'</a>'."\n");
         if ($_ eq $sortby || /^(Part)$/) {        $r->rflush();
             $Str .= '<th>'.$_.'</th>';      return;
   }
   
   ##
   ## &write_headers
   ##
   sub write_headers {
       my ($excel_sheet,$format,$rows_output,$cols_output,$Fields) = @_;
       ##
       ## First the long titles
       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'},
                                   $format->{'bold'});
         } else {          } else {
             $Str .= '<th>'.              $excel_sheet->write($$rows_output,${$cols_output},'');
      '<a href="javascript:document.Statistics.sortby.value='."'$_'".          }
          ';document.Statistics.submit();">'.          ${$cols_output}+= 1;
              $_.'</a></th>';      }
       ${$cols_output} =0;
       ${$rows_output}+=1;
       ##
       ## Then the short titles
       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'},
                               $format->{'bold'});
           $$cols_output+=1;
       }
       ${$cols_output} =0;
       ${$rows_output}+=1;
       return;
   }
   
   ##################################################
   ##################################################
   ##
   ## Statistics Gathering and Manipulation Routines
   ##
   ##################################################
   ##################################################
   sub compute_statistics_on_sequence {
       my ($seq) = @_;
       my @Data;
       foreach my $res (&Apache::lonstathelpers::get_resources($navmap,$seq)) {
           foreach my $part (@{$res->parts}) {
               next if ($res->is_survey($part));
               #
               # This is where all the work happens
               my $data = &get_statistics($seq,$res,$part,scalar(@StatsArray)+1);
               push (@Data,$data);
               push (@StatsArray,$data);
         }          }
     }      }
     $r->print('<tr bgcolor="#FFFFE6">'.$Str."</tr>\n");      return @Data;
   }
   
   sub compute_all_statistics {
       my ($r) = @_;
       if (@StatsArray > 0) {
           # Assume we have already computed the statistics
           return;
       }
       my $c = $r->connection;
       foreach my $seq (@sequences) {
           last if ($c->aborted);
           &compute_sequence_statistics($seq);
           &compute_statistics_on_sequence($seq);
       }
   }
   
   sub sort_data {
       my ($sortkey) = @_;
       return if (! @StatsArray);
     #      #
     # Sort the data      # Sort the data
     my @OutputOrder;      my $sortby = undef;
     if ($sortby eq 'Container') {      foreach my $field (@Fields) {
         @OutputOrder = @Statsarray;          if ($sortkey eq $field->{'name'}) {
     } else {              $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          # $sortby is already defined, so we can charge ahead
         if ($sortby =~ /^(title|part)$/i) {          if ($sortby =~ /^(title|part)$/i) {
             # Alpha comparison              # Alpha comparison
             @OutputOrder = sort {              @StatsArray = sort {
                 lc($a->{$sortby}) cmp lc($b->{$sortby}) ||                  lc($a->{$sortby}) cmp lc($b->{$sortby}) ||
                     lc($a->{'Title'}) cmp lc($b->{'Title'}) ||                  lc($a->{'title'}) cmp lc($b->{'title'}) ||
                         lc($a->{'Part'}) cmp lc($b->{'Part'});                  lc($a->{'part'}) cmp lc($b->{'part'});
             } @Statsarray;              } @StatsArray;
         } else {          } else {
             # Numerical comparison              # Numerical comparison
             @OutputOrder = sort {              @StatsArray = sort {
                 my $retvalue = 0;                  my $retvalue = 0;
                 if ($b->{$sortby} eq 'nan') {                  if ($b->{$sortby} eq 'nan') {
                     if ($a->{$sortby} ne 'nan') {                      if ($a->{$sortby} ne 'nan') {
Line 401  sub output_html_ungrouped { Line 1492  sub output_html_ungrouped {
                     }                      }
                 }                  }
                 if ($retvalue eq '0') {                  if ($retvalue eq '0') {
                     $retvalue = $b->{$sortby} <=> $a->{$sortby} ||                      $retvalue = $b->{$sortby} <=> $a->{$sortby}     ||
                                 lc($a->{'Title'}) <=> lc($b->{'Title'}) ||                              lc($a->{'title'}) <=> lc($b->{'title'}) ||
                                 lc($a->{'Part'})  <=> lc($b->{'Part'});                              lc($a->{'part'})  <=> lc($b->{'part'});
                 }                  }
                 $retvalue;                  $retvalue;
             } @Statsarray;              } @StatsArray;
         }  
     }  
     foreach my $row (@OutputOrder) {  
         $r->print('<tr>');  
         if ($show_container) {  
             $r->print('<td bgcolor="#FFFFE6">'  
                       .$row->{'sequence'}->{'title'}.'</td>');  
         }          }
         $r->print(&stats_row_from_hash($row,$show_part));  
         $r->print("</tr>\n");  
     }      }
     $r->print("</table>\n");  
     $r->print("</td></tr></table>\n");  
     $r->rflush();  
     #      #
       # Renumber the data set
       my $count;
       foreach my $data (@StatsArray) {
           $data->{'problem_num'} = ++$count;
       }
     return;      return;
 }  }
   
 sub stats_row_from_hash {  ########################################################
     my ($data,$show_part) = @_;  ########################################################
     return &statistics_html_table_data($data->{'resource'},$data->{'Part'},  
                                        $data->{'#Stdnts'}, $data->{'Tries'},  =pod
                                        $data->{'Mod'},     $data->{'Mean'},  
                                        $data->{'#YES'},    $data->{'#yes'},  =item &get_statistics()
                                        $data->{"\%Wrng"},  $data->{'DoDiff'},  
                                        $data->{'S.D.'},    $data->{'Skew'},  Wrapper routine from the call to loncoursedata::get_problem_statistics.  
                                        $show_part);  Calls lonstathelpers::get_time_limits() to limit the data set by time
   and &compute_discrimination_factor
   
   Inputs: $sequence, $resource, $part, $problem_num
   
   Returns: Hash reference with statistics data from 
   loncoursedata::get_problem_statistics.
   
   =cut
   
   ########################################################
   ########################################################
   sub get_statistics {
       my ($sequence,$resource,$part,$problem_num) = @_;
       #
       my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
       my $symb = $resource->symb;
       my $courseid = $ENV{'request.course.id'};
       #
       my $data = &Apache::loncoursedata::get_problem_statistics
                           (\@Apache::lonstatistics::SelectedSections,
                            $Apache::lonstatistics::enrollment_status,
                            $symb,$part,$courseid,$starttime,$endtime);
       $data->{'symb'}        = $symb;
       $data->{'part'}        = $part;
       $data->{'problem_num'} = $problem_num;
       $data->{'container'}   = $sequence->compTitle;
       $data->{'title'}       = $resource->compTitle;
       $data->{'title.link'}  = $resource->src.'?symb='.
           &Apache::lonnet::escape($resource->symb);
       #
       if ($SelectedFields{'deg_of_disc'}) {
           $data->{'deg_of_disc'} = 
               &compute_discrimination_factor($resource,$part,$sequence);
       }
       #
       # Store in metadata if computations were done for all students
       if ($data->{'num_students'} > 1) {
           my @Sections = @Apache::lonstatistics::SelectedSections;
           my $sections = '"'.join(' ',@Sections).'"';
           $sections =~ s/&+/_/g;  # Ensure no special characters
           $data->{'sections'}=$sections;
           $data->{'course'} = $ENV{'request.course.id'};
           my $urlres=(&Apache::lonnet::decode_symb($resource->symb))[2];
           $data->{'urlres'}=$urlres;
           my %storestats = 
               &LONCAPA::lonmetadata::dynamic_metadata_storage($data);
           my ($dom,$user) = $urlres=~/^(\w+)\/(\w+)/; 
           &Apache::lonnet::put('nohist_resevaldata',\%storestats,$dom,$user);
       }
       #
       $data->{'tries_per_correct'} = $data->{'tries'} / 
           ($data->{'num_solved'}+0.1);
       #
       # Get the due date for research purposes (commented out most of the time)
   #    $data->{'duedate'} = 
   #        &Apache::lonnet::EXT('resource.'.$part.'.duedate',$symb);
   #    $data->{'opendate'} = 
   #        &Apache::lonnet::EXT('resource.'.$part.'.opendate',$symb);
   #    $data->{'maxtries'} = 
   #        &Apache::lonnet::EXT('resource.'.$part.'.maxtries',$symb);
   #    $data->{'hinttries'} =
   #        &Apache::lonnet::EXT('resource.'.$part.'.hinttries',$symb);
       $data->{'weight'} =
           &Apache::lonnet::EXT('resource.'.$part.'.weight',$symb);
   #    $data->{'resptypes'} = join(',',@{$resource->{'partdata'}->{$part}->{'ResponseTypes'}});
       return $data;
 }  }
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   
   =pod
   
   =item &compute_discrimination_factor()
   
   Inputs: $Resource, $Sequence
   
   Returns: integer between -1 and 1
   
   =cut
   
 ###############################################  ###############################################
 ###############################################  ###############################################
 sub statistics_html_table_data {  sub compute_discrimination_factor {
     my ($resource,$part,$num,$tries,$mod,$mean,$Solved,$solved,$wrongpercent,      my ($resource,$part,$seq) = @_;
         $DegOfDiff,$STD,$SKEW,$show_part) = @_;      my $symb = $resource->symb;
     my $row = '';      my @Resources;
     $row .= '<td bgcolor="#FFFFE6">'.      foreach my $res (&Apache::lonstathelpers::get_resources($navmap,$seq)){
         '<a href="'.$resource->{'src'}.'" target="_blank" >'.          next if ($res->symb eq $symb);
             $resource->{'title'}.'</a>'.          push (@Resources,$res->symb);
                 '</td>';      }
     $row .= '<td bgcolor="#FFFFE6">'.$part.'</td>' if ($show_part);      #
     foreach ($num,$tries) {      # rank
         $row .= '<td bgcolor="#EEFFCC" align="right">'.$_.'</td>';      my ($starttime,$endtime) = &Apache::lonstathelpers::get_time_limits();
     }      my $ranking = 
     foreach ($mod,$mean) {          &Apache::loncoursedata::rank_students_by_scores_on_resources
         $row .= '<td bgcolor="#DDFFFF" align="right">'.          (\@Resources,
                   sprintf("%5.2f",$_).'</td>';           \@Apache::lonstatistics::SelectedSections,
     }           $Apache::lonstatistics::enrollment_status,undef,
     foreach ($Solved,$solved) {           $starttime,$endtime);
         $row .= '<td bgcolor="#DDFFFF" align="right">'.$_.'</td>';      #
     }      # compute their percent scores on the problems in the sequence,
     foreach ($wrongpercent) {      my $number_to_grab = int(scalar(@{$ranking})/4);
         $row .= '<td bgcolor="#DDFFFF" align="right">'.      my $num_students = scalar(@{$ranking});
                   sprintf("%5.1f",$_).'</td>';      my @BottomSet = map { $_->[&Apache::loncoursedata::RNK_student()]; 
     }                        } @{$ranking}[0..$number_to_grab];
     foreach ($DegOfDiff,$STD,$SKEW) {      my @TopSet    = 
         $row .= '<td bgcolor="#FFDDDD" align="right">'.          map { 
                   sprintf("%5.2f",$_).'</td>';              $_->[&Apache::loncoursedata::RNK_student()]; 
             } @{$ranking}[($num_students-$number_to_grab)..($num_students-1)];
       if (! @BottomSet || (@BottomSet == 1 && $BottomSet[0] eq '') ||
           ! @TopSet    || (@TopSet    == 1 && $TopSet[0]    eq '')) {
           return 'nan';
       }
       my ($bottom_sum,$bottom_max) = 
           &Apache::loncoursedata::get_sum_of_scores($symb,$part,\@BottomSet,
                                                     undef,$starttime,$endtime);
       my ($top_sum,$top_max) = 
           &Apache::loncoursedata::get_sum_of_scores($symb,$part,\@TopSet,
                                                     undef,$starttime,$endtime);
       my $deg_of_disc;
       if ($top_max == 0 || $bottom_max==0) {
           $deg_of_disc = 'nan';
       } else {
           $deg_of_disc = ($top_sum/$top_max) - ($bottom_sum/$bottom_max);
     }      }
     return $row;      #&Apache::lonnet::logthis('    '.$top_sum.'/'.$top_max.
       #                         ' - '.$bottom_sum.'/'.$bottom_max);
       return $deg_of_disc;
 }  }
   
   
 ###############################################  ###############################################
 ###############################################  ###############################################
   ##
 sub BuildGraphicChart {  ## Compute KR-21
     my ($graph,$cacheDB,$courseDescription,$students,$courseID,$r,$c)=@_;  ##
     my %cache;  ## To compute KR-21, you need the following information:
     my $max;  ##
     my $title = '';  ## K=the number of items in your test
     if($graph eq 'DoDiffGraph') {  ## M=the mean score on the test
  $title = 'Degree-of-Difficulty';  ## 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;
       my $part_count;
       foreach my $res (&Apache::lonstathelpers::get_resources($navmap,$seq)) {
           push (@Resources,$res->symb);
           $part_count += scalar(@{$res->parts});
       }
       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->compTitle;
       $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 = $part_count;
       my $kr_21;
       if ($K > 1 && $cSTD > 0) {
           $kr_21 =  ($K/($K-1)) * (1 - $cMean*($K-$cMean)/($K*$cSTD**2));
     } else {      } else {
  $title = 'Wrong-Percentage';          $kr_21 = 'nan';
     }  
     my $currentSequence = -1;  
     my $sortProblems = 'Sort Within Sequence';  
     my ($result, $orderedProblems) =  
         &InitializeProblemStatistics($cacheDB, $students, $courseID, $c, $r);  
     if($result ne 'OK') {  
         return;  
     }      }
     my @values = ();      $SeqStat{$symb}->{'countmax'} = $cmax;
     unless(tie(%cache,'GDBM_File',$cacheDB,&GDBM_READER(),0640)) {      $SeqStat{$symb}->{'countmin'} = $cmin;
         return 'Unable to tie database.7';      $SeqStat{$symb}->{'countstd'} = $cSTD;
     }      $SeqStat{$symb}->{'countmean'} = $cMean;
     foreach(@$orderedProblems) {      $SeqStat{$symb}->{'count'} = $ccount;
         my ($sequence,$problem,$part)=split(':', $_);      $SeqStat{$symb}->{'items'} = $K;
         if($cache{'StatisticsMaps'} ne 'All Maps'  &&      $SeqStat{$symb}->{'KR-21'}=$kr_21;
            $cache{'StatisticsMaps'} ne $cache{$sequence.':title'}) {  
              next;  
         }  
         if( $currentSequence == -1 ||  
             ($sortProblems eq 'Sort Within Sequence' &&  
             $currentSequence != $sequence)) {  
     if($currentSequence != -1) {  
  &DrawGraph(\@values,$courseDescription,$title,$max,$r);  
     }  
             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;  
         }  
         push(@values, $data);  
     }  
     untie(%cache);  
     &DrawGraph(\@values,$courseDescription,$title,$max,$r);  
     return;      return;
 }  }
   
 sub DrawGraph {  
     my ($values,$courseDescription,$title,$Max,$r)=@_;  
     my $sendValues = join(',', @$values);  
     my $sendCount = scalar(@$values);  
     $r->print("<br>The Maximum Value is: $Max");  
     if ( $Max > 1 ) {  
  if ($Max % 10) {  
             if ( int($Max) < $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";  
     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 ||  
            ($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;  
 }  
   
 sub TableRow {  =pod 
     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  =item ProblemStatisticsLegend
 sub setbgcolor {  
     my $PrintTable=shift;  
     my %color;  
     if ($PrintTable){  
  $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 {  =over 4
     my $Ptr = '';  
     $Ptr = '<table border="0">';  =item #Stdnts
     $Ptr .= '<tr><td>';  Total number of students attempted the problem.
     $Ptr .= '<b>#Stdnts</b></td>';  
     $Ptr .= '<td>Total number of students attempted the problem.';  =item Tries
     $Ptr .= '</td></tr><tr><td>';  Total number of tries for solving the problem.
     $Ptr .= '<b>Tries</b></td>';  
     $Ptr .= '<td>Total number of tries for solving the problem.';  =item Max Tries
     $Ptr .= '</td></tr><tr><td>';  Largest number of tries for solving the problem by a student.
     $Ptr .= '<b>Mod</b></td>';  
     $Ptr .= '<td>Largest number of tries for solving the problem by a student.';  =item Mean
     $Ptr .= '</td></tr><tr><td>';  Average number of tries. [ Tries / #Stdnts ]
     $Ptr .= '<b>Mean</b></td>';  
     $Ptr .= '<td>Average number of tries. [ Tries / #Stdnts ]';  =item #YES
     $Ptr .= '</td></tr><tr><td>';  Number of students solved the problem correctly.
     $Ptr .= '<b>#YES</b></td>';  
     $Ptr .= '<td>Number of students solved the problem correctly.';  =item #yes
     $Ptr .= '</td></tr><tr><td>';  Number of students solved the problem by override.
     $Ptr .= '<b>#yes</b></td>';  
     $Ptr .= '<td>Number of students solved the problem by override.';  =item %Wrong
     $Ptr .= '</td></tr><tr><td>';  Percentage of students who tried to solve the problem 
     $Ptr .= '<b>%Wrong</b></td>';  but is still incorrect. [ 100*((#Stdnts-(#YES+#yes))/#Stdnts) ]
     $Ptr .= '<td>Percentage of students who tried to solve the problem ';  
     $Ptr .= 'but is still incorrect. [ 100*((#Stdnts-(#YES+#yes))/#Stdnts) ]';  =item DoDiff
     $Ptr .= '</td></tr><tr><td>';  Degree of Difficulty of the problem.  
     $Ptr .= '<b>DoDiff</b></td>';  [ 1 - ((#YES+#yes) / Tries) ]
     $Ptr .= '<td>Degree of Difficulty of the problem.  ';  
     $Ptr .= '[ 1 - ((#YES+#yes) / Tries) ]';  =item S.D.
     $Ptr .= '</td></tr><tr><td>';  Standard Deviation of the tries.  
     $Ptr .= '<b>S.D.</b></td>';  [ sqrt(sum((Xi - Mean)^2)) / (#Stdnts-1) 
     $Ptr .= '<td>Standard Deviation of the tries.  ';  where Xi denotes every student\'s tries ]
     $Ptr .= '[ sqrt(sum((Xi - Mean)^2)) / (#Stdnts-1) ';  
     $Ptr .= 'where Xi denotes every student\'s tries ]';  =item Skew.
     $Ptr .= '</td></tr><tr><td>';  Skewness of the students tries.
     $Ptr .= '<b>Skew.</b></td>';  [(sqrt( sum((Xi - Mean)^3) / #Stdnts)) / (S.D.^3)]
     $Ptr .= '<td>Skewness of the students tries.';  
     $Ptr .= '[(sqrt( sum((Xi - Mean)^3) / #Stdnts)) / (S.D.^3)]';  =item Dis.F.
     $Ptr .= '</td></tr><tr><td>';  Discrimination Factor: A Standard for evaluating the 
     $Ptr .= '<b>Dis.F.</b></td>';  problem according to a Criterion<br>
     $Ptr .= '<td>Discrimination Factor: A Standard for evaluating the ';  
     $Ptr .= 'problem according to a Criterion<br>';  =item [Criterion to group students into %27 Upper Students - 
     $Ptr .= '<b>[Criterion to group students into %27 Upper Students - ';  and %27 Lower Students]
     $Ptr .= 'and %27 Lower Students]</b><br>';  1st Criterion for Sorting the Students: 
     $Ptr .= '<b>1st Criterion</b> for Sorting the Students: ';  Sum of Partial Credit Awarded / Total Number of Tries
     $Ptr .= '<b>Sum of Partial Credit Awarded / Total Number of Tries</b><br>';  2nd Criterion for Sorting the Students: 
     $Ptr .= '<b>2nd Criterion</b> for Sorting the Students: ';  Total number of Correct Answers / Total Number of Tries
     $Ptr .= '<b>Total number of Correct Answers / Total Number of Tries</b>';  
     $Ptr .= '</td></tr>';  =item Disc.
     $Ptr .= '<tr><td><b>Disc.</b></td>';  Number of Students had at least one discussion.
     $Ptr .= '<td>Number of Students had at least one discussion.';  
     $Ptr .= '</td></tr></table>';  =back
     return $Ptr;  
 }  =cut
   
 #---- END Problem Statistics Web Page ----------------------------------------  ############################################################
   ############################################################
   
 1;  1;
 __END__  __END__

Removed from v.1.43  
changed lines
  Added in v.1.101


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